TTFQuery 2.0.0b1__tar.gz → 2.1.0__tar.gz

ttfquery-2.1.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: TTFQuery
+Version: 2.1.0
+Summary: FontTools-based package for querying system fonts
+Home-page: http://ttfquery.sourceforge.net/
+Author: Mike C. Fletcher
+Author-email: "Mike C. Fletcher" <mcfletch@users.sourceforge.net>
+License: THIS SOFTWARE IS NOT FAULT TOLERANT AND SHOULD NOT BE USED IN ANY
+        SITUATION ENDANGERING HUMAN LIFE OR PROPERTY.
+        
+        TTFQuery License
+        
+        	Copyright (c) 2003-2018, Michael C. Fletcher and Contributors
+        	All rights reserved.
+        	
+        	Redistribution and use in source and binary forms, with or without
+        	modification, are permitted provided that the following conditions
+        	are met:
+        	
+        		Redistributions of source code must retain the above copyright
+        		notice, this list of conditions and the following disclaimer.
+        	
+        		Redistributions in binary form must reproduce the above
+        		copyright notice, this list of conditions and the following
+        		disclaimer in the documentation and/or other materials
+        		provided with the distribution.
+        	
+        		The name of Michael C. Fletcher, or the name of any Contributor,
+        		may not be used to endorse or promote products derived from this 
+        		software without specific prior written permission.
+        	
+        	THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+        	``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+        	LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+        	FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+        	COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+        	INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+        	(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        	SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+        	HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+        	STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+        	ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+        	OF THE POSSIBILITY OF SUCH DAMAGE. 
+        
+        
+Project-URL: Homepage, http://ttfquery.sourceforge.net/
+Keywords: fonttools,ttf,truetype,outline,font,curve,system fonts
+Platform: Any
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: fonttools
+Requires-Dist: numpy
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Dynamic: author
+Dynamic: home-page
+Dynamic: platform
+
+# TTFQuery
+
+FontTools-based package for querying system fonts
+
+TTFQuery builds on the FontTools package to allow the Python programmer to accomplish a number of tasks:
+
+* query the system to find installed fonts
+* retrieve metadata about any TTF font file (even those not yet installed)
+    * abstract family type
+    * proper font name
+    * glyph outlines
+* build simple metadata registries for run-time font matching
+
+With these functionalities, it is possible to readily create OpenGL solid-text
+rendering libraries which can accept abstract font-family names as font
+specifiers and deliver platform-specific TTF files to match those libraries.
+
+TTFQuery doesn't provide rendering services, but a sample implementation can be
+found in the OpenGLContext project, from which TTFQuery was refactored.

ttfquery-2.1.0/README.md

@@ -0,0 +1,19 @@
+# TTFQuery
+
+FontTools-based package for querying system fonts
+
+TTFQuery builds on the FontTools package to allow the Python programmer to accomplish a number of tasks:
+
+* query the system to find installed fonts
+* retrieve metadata about any TTF font file (even those not yet installed)
+    * abstract family type
+    * proper font name
+    * glyph outlines
+* build simple metadata registries for run-time font matching
+
+With these functionalities, it is possible to readily create OpenGL solid-text
+rendering libraries which can accept abstract font-family names as font
+specifiers and deliver platform-specific TTF files to match those libraries.
+
+TTFQuery doesn't provide rendering services, but a sample implementation can be
+found in the OpenGLContext project, from which TTFQuery was refactored.

ttfquery-2.1.0/TTFQuery.egg-info/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: TTFQuery
+Version: 2.1.0
+Summary: FontTools-based package for querying system fonts
+Home-page: http://ttfquery.sourceforge.net/
+Author: Mike C. Fletcher
+Author-email: "Mike C. Fletcher" <mcfletch@users.sourceforge.net>
+License: THIS SOFTWARE IS NOT FAULT TOLERANT AND SHOULD NOT BE USED IN ANY
+        SITUATION ENDANGERING HUMAN LIFE OR PROPERTY.
+        
+        TTFQuery License
+        
+        	Copyright (c) 2003-2018, Michael C. Fletcher and Contributors
+        	All rights reserved.
+        	
+        	Redistribution and use in source and binary forms, with or without
+        	modification, are permitted provided that the following conditions
+        	are met:
+        	
+        		Redistributions of source code must retain the above copyright
+        		notice, this list of conditions and the following disclaimer.
+        	
+        		Redistributions in binary form must reproduce the above
+        		copyright notice, this list of conditions and the following
+        		disclaimer in the documentation and/or other materials
+        		provided with the distribution.
+        	
+        		The name of Michael C. Fletcher, or the name of any Contributor,
+        		may not be used to endorse or promote products derived from this 
+        		software without specific prior written permission.
+        	
+        	THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+        	``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+        	LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+        	FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+        	COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+        	INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+        	(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        	SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+        	HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+        	STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+        	ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+        	OF THE POSSIBILITY OF SUCH DAMAGE. 
+        
+        
+Project-URL: Homepage, http://ttfquery.sourceforge.net/
+Keywords: fonttools,ttf,truetype,outline,font,curve,system fonts
+Platform: Any
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: fonttools
+Requires-Dist: numpy
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Dynamic: author
+Dynamic: home-page
+Dynamic: platform
+
+# TTFQuery
+
+FontTools-based package for querying system fonts
+
+TTFQuery builds on the FontTools package to allow the Python programmer to accomplish a number of tasks:
+
+* query the system to find installed fonts
+* retrieve metadata about any TTF font file (even those not yet installed)
+    * abstract family type
+    * proper font name
+    * glyph outlines
+* build simple metadata registries for run-time font matching
+
+With these functionalities, it is possible to readily create OpenGL solid-text
+rendering libraries which can accept abstract font-family names as font
+specifiers and deliver platform-specific TTF files to match those libraries.
+
+TTFQuery doesn't provide rendering services, but a sample implementation can be
+found in the OpenGLContext project, from which TTFQuery was refactored.

{TTFQuery-2.0.0b1 → ttfquery-2.1.0}/TTFQuery.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 MANIFEST.in
+README.md
 license.txt
-setup.cfg
+pyproject.toml
 setup.py
 TTFQuery.egg-info/PKG-INFO
 TTFQuery.egg-info/SOURCES.txt
@@ -8,6 +9,11 @@ TTFQuery.egg-info/dependency_links.txt
 TTFQuery.egg-info/entry_points.txt
 TTFQuery.egg-info/requires.txt
 TTFQuery.egg-info/top_level.txt
+tests/test_describe.py
+tests/test_findsystem_linux.py
+tests/test_findsystem_win32.py
+tests/test_glyphquery.py
+tests/test_registry.py
 ttfquery/__init__.py
 ttfquery/_scriptregistry.py
 ttfquery/describe.py

{TTFQuery-2.0.0b1 → ttfquery-2.1.0}/TTFQuery.egg-info/entry_points.txt

@@ -3,4 +3,3 @@ ttffamily = ttfquery.ttffamily:main
 ttffiles = ttfquery.ttffiles:main
 ttfgroups = ttfquery.ttfgroups:main
 ttfmetadata = ttfquery.ttfmetadata:main
-

ttfquery-2.1.0/TTFQuery.egg-info/requires.txt

@@ -0,0 +1,6 @@
+fonttools
+numpy
+
+[test]
+pytest
+pytest-cov

ttfquery-2.1.0/pyproject.toml

@@ -0,0 +1,102 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "TTFQuery"
+dynamic = ["version"]
+description = "FontTools-based package for querying system fonts"
+readme = "README.md"
+license = { file = "license.txt" }
+authors = [
+    { name = "Mike C. Fletcher", email = "mcfletch@users.sourceforge.net" },
+]
+requires-python = ">=3.9"
+dependencies = [
+    "fonttools",
+    "numpy",
+]
+keywords = [
+    "fonttools",
+    "ttf",
+    "truetype",
+    "outline",
+    "font",
+    "curve",
+    "system fonts",
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Topic :: Multimedia :: Graphics",
+]
+
+[project.urls]
+Homepage = "http://ttfquery.sourceforge.net/"
+
+[project.optional-dependencies]
+test = [
+    "pytest",
+    "pytest-cov",
+]
+
+[project.scripts]
+ttffiles = "ttfquery.ttffiles:main"
+ttffamily = "ttfquery.ttffamily:main"
+ttfgroups = "ttfquery.ttfgroups:main"
+ttfmetadata = "ttfquery.ttfmetadata:main"
+
+[tool.setuptools]
+packages = ["ttfquery"]
+
+[tool.setuptools.dynamic]
+version = { attr = "ttfquery.__version__" }
+
+# uv decides whether its cached metadata for a source tree is still current
+# from pyproject.toml, setup.py and setup.cfg alone. This project's version
+# lives in ttfquery/__init__.py, so name that file too: without it a version
+# bump leaves uv answering with the previous number, and a dependent requiring
+# the new one resolves against PyPI rather than this checkout.
+[tool.uv]
+cache-keys = [{ file = "pyproject.toml" }, { file = "ttfquery/__init__.py" }]
+
+# Named explicitly rather than left to ruff's default, which has widened
+# between releases: a gate whose meaning moves when a tool is upgraded is not a
+# gate. `E,W,F,B` is what the other pre-2010 projects here hold to.
+[tool.ruff.lint]
+select = ["E", "W", "F", "B"]
+# `_name` as well as `_`: an underscore prefix is how Python says a name is
+# bound but deliberately unused.
+dummy-variable-rgx = "^(_[a-zA-Z0-9_]*|err)$"
+ignore = [
+    'E501', # long lines, kept readable by hand
+]
+
+# The package's own declarations, checked as a consumer's checker reads them.
+# `check_untyped_defs` rather than `disallow_untyped_defs`: this package is
+# older than annotations, and its bodies being checked is the half that finds
+# defects -- the other half is a job of its own, tracked as one.
+[tool.mypy]
+# Named here so that `mypy` with no arguments checks the package: the tox
+# environment and a developer's bare `mypy` are then the same run.
+files = ["ttfquery"]
+python_version = "3.12"
+check_untyped_defs = true
+warn_unused_ignores = true
+ignore_missing_imports = true
+
+# `findsystem` reads the Windows font directories out of the registry, and
+# `winreg` is a module Linux does not have. Checked as Windows sees it in a
+# second run -- see tools/preflight.toml -- so this keeps the Linux run from
+# reporting nine absent names as defects.
+[[tool.mypy.overrides]]
+module = "ttfquery.findsystem"
+disable_error_code = ["attr-defined"]

{TTFQuery-2.0.0b1 → ttfquery-2.1.0}/setup.cfg

@@ -1,5 +1,4 @@
 [egg_info]
 tag_build = 
 tag_date = 0
-tag_svn_revision = 0
 

{TTFQuery-2.0.0b1 → ttfquery-2.1.0}/setup.py

@@ -5,7 +5,7 @@ Run:
     python setup.py install
 to install the package from the source archive.
 """
-import sys, os, string
+import os
 from setuptools import setup
 HERE = os.path.dirname(__file__)
 
@@ -32,11 +32,10 @@ if __name__ == "__main__":
             'ttfquery':'ttfquery',
         },
         packages = [
-            'ttfquery', 
+            'ttfquery',
         ],
-	install_requires = ['fonttools','numpy'],
+    install_requires = ['fonttools','numpy'],
         classifiers= [
-            """License :: OSI Approved :: BSD License""",
             """Programming Language :: Python""",
             """Topic :: Software Development :: Libraries :: Python Modules""",
             """Intended Audience :: Developers""",
@@ -75,4 +74,4 @@ which TTFQuery was refactored.
             ]
         }
     )
-    
+

ttfquery-2.1.0/tests/test_describe.py

@@ -0,0 +1,56 @@
+from __future__ import print_function
+from ttfquery import describe, findsystem
+import unittest
+
+class TestDescribe(unittest.TestCase):
+    def test_describe_system_fonts(self):
+        for fontfile in list(findsystem.findFonts())[:100]:
+            try:
+                font = describe.openFont(fontfile)
+            except Exception as err:
+                err.args += ('Error opening font', font)
+                raise
+            else:
+                short = describe.shortName( font )
+                assert short, "Null name for font %s"%(fontfile,)
+                family = describe.family( font )
+                assert len(family)==2, family
+                modifiers = describe.modifiers( font )
+                assert describe.weightName(modifiers[0])
+
+
+class TestTheNameIsText:
+    """`shortName` answers what the font calls itself, as text.
+
+    A name record is bytes in one of two encodings, and answering those bytes
+    put `b'Open Sans'` into every message that named a font and left the font
+    registry decoding what this had just encoded.
+    """
+
+    def a_font(self):
+        from ttfquery import findsystem
+        for path in findsystem.findFonts():
+            try:
+                return describe.openFont(path)
+            except Exception:
+                continue
+        return None
+
+    def test_both_halves_are_strings(self):
+        font = self.a_font()
+        if font is None:
+            import pytest
+            pytest.skip('no readable font on this machine')
+        name, family = describe.shortName(font)
+        assert isinstance(name, str), repr(name)
+        assert isinstance(family, str), repr(family)
+
+    def test_a_two_byte_record_is_read_as_utf_16(self):
+        assert describe._recordText('Ångstrom'.encode('utf-16-be')) == \
+            'Ångstrom'
+
+    def test_a_single_byte_record_is_read_as_latin_1(self):
+        assert describe._recordText(b'Open Sans') == 'Open Sans'
+
+    def test_text_is_left_as_it_is(self):
+        assert describe._recordText('Open Sans') == 'Open Sans'

ttfquery-2.1.0/tests/test_findsystem_linux.py

@@ -0,0 +1,18 @@
+from __future__ import print_function
+from ttfquery import findsystem
+import pytest
+import sys
+import unittest
+pytestmark = pytest.mark.skipif(
+    not sys.platform.startswith('linux'),
+    reason='Linux tests'
+)
+
+class TestLinux(unittest.TestCase):
+    def test_font_directory(self):
+        """Validate that at least one font directory can be found"""
+        directories = findsystem.linuxFontDirectories()
+        assert directories, "No font directories were found, *something* should be there"
+    def test_fonts_from_registry(self):
+        fonts = findsystem.findFonts()
+        assert fonts, "No fonts were found in our default font-search paths"

ttfquery-2.1.0/tests/test_findsystem_win32.py

@@ -0,0 +1,20 @@
+from __future__ import print_function
+from ttfquery import findsystem
+import pytest
+import os
+import sys
+import glob
+import unittest
+pytestmark = pytest.mark.skipif(not sys.platform == 'win32', reason='Win32 tests')
+
+class TestWin32(unittest.TestCase):
+    def test_font_directory(self):
+        """Validate that the fonts directory windows reports is not empty"""
+        dirname = findsystem.win32FontDirectory()
+        assert glob.glob(os.path.join(dirname,'*.ttf')), "No .ttf files found in Win32 font directory %s"%(
+            dirname,
+        )
+    def test_fonts_from_registry(self):
+        dirname = 'c:\\should-not-exist-and-if-it-does-you-know-you-did-it'
+        fontpaths = findsystem.win32InstalledFonts(dirname)
+        assert fontpaths, "Did not find any registry-supplied fonts"

ttfquery-2.1.0/tests/test_glyphquery.py

@@ -0,0 +1,47 @@
+from __future__ import print_function
+from ttfquery import ttffiles, describe, glyphquery, glyph
+import os
+import unittest
+import tempfile
+import shutil
+
+class TestGlyphQuery(unittest.TestCase):
+    def setUp(self):
+        self.workdir = tempfile.mkdtemp(prefix='ttfquery-',suffix='-tests')
+        self.registry = os.path.join(self.workdir,'fonts.cache')
+        class fakeoptions:
+            directories = []
+            registry = self.registry
+        self.options = fakeoptions
+        self.registry = ttffiles.registry_for_options(self.options)
+    def tearDown(self):
+        shutil.rmtree(self.workdir)
+
+    def test_has_a_glyph(self):
+        has,total = 0,0
+        for _name,metadata in self.registry.specificFonts.items():
+            font = describe.openFont(metadata.file_name)
+            glyphquery.charHeight(font)
+            glyphquery.lineHeight(font)
+            glyphquery.charDescent(font)
+            if glyphquery.hasGlyph(font,'a'):
+                glyphName = glyphquery.explicitGlyph(font,'a')
+                if glyphName:
+                    glyphquery.width(font,glyphName)
+                    has += 1
+
+                    shape = glyph.Glyph(glyphName)
+                    shape.compile(font)
+                    assert shape.contours, "No contours generated"
+                    assert shape.outlines, "No outlines generated"
+                    assert shape.width, "Width of `a` character was null"
+                    assert shape.height, "Width of `a` character was null"
+
+            else:
+                glyphName = glyphquery.glyphName(font,'a')
+                assert glyphName, """Didn't get a placeholder for the 'a' character"""
+                glyphquery.width(font,glyphName)
+            total += 1
+        assert total, "No specific fonts on this system?"
+        assert has/float(total) > .2, "More than 4/5 of fonts on this system are missing a glyph for `a`? %s/%s"%(has,total)
+

ttfquery-2.1.0/tests/test_registry.py

@@ -0,0 +1,60 @@
+from __future__ import print_function
+from ttfquery import ttffiles, ttfgroups, ttfmetadata, ttffamily
+import os
+import unittest
+import tempfile
+import shutil
+
+class TestRegistry(unittest.TestCase):
+    def setUp(self):
+        self.workdir = tempfile.mkdtemp(prefix='ttfquery-',suffix='-tests')
+        self.registry = os.path.join(self.workdir,'fonts.cache')
+        class fakeoptions:
+            directories = []
+            registry = self.registry
+        self.options = fakeoptions
+        self.registry = ttffiles.registry_for_options(self.options)
+    def tearDown(self):
+        shutil.rmtree(self.workdir)
+    def test_registry_setup(self):
+        registry = self.registry
+        assert registry.fonts, "No fonts loaded"
+        assert registry.families, "No families extracted"
+        assert registry.specificFonts, "No final/specific font classes registered"
+        assert registry.files, "No files registered/added"
+        assert registry.shortFiles, "No short filenames registered"
+        assert not registry.DIRTY, "Registry was just saved, should be clean"
+
+        font = None
+        for name in ('Arial','Helvetica','SANS'):
+            try:
+                font = registry.matchName(name)
+            except KeyError:
+                pass
+            if font:
+                break
+        if not font:
+            raise RuntimeError("Unable to find any of Arial/Helvetica/SANS")
+
+    def test_ttfgroups(self):
+        registry = self.registry
+        table = ttfgroups.buildTable(registry)
+        ttfgroups.run_report(table)
+
+        parser = ttfgroups.get_options()
+        assert 'font-groups' in parser.description, parser.description
+
+    def test_ttfmetadata(self):
+        registry = self.registry
+        for name in registry.fonts.keys():
+            ttfmetadata.find_match(name,registry)
+
+        parser = ttfmetadata.get_options()
+        assert 'Query/search' in parser.description, parser.description
+
+    def test_ttffamily(self):
+        registry = self.registry
+        for family,subfams in registry.families.items():
+            ttffamily.search(registry,family)
+            for subfam in subfams.keys():
+                ttffamily.search(registry,family,subfam)

{TTFQuery-2.0.0b1 → ttfquery-2.1.0}/ttfquery/__init__.py

@@ -1,2 +1,2 @@
 """Fonttools package for querying and sorting system fonts"""
-__version__ = "2.0.0b1"
+__version__ = "2.1.0"

{TTFQuery-2.0.0b1 → ttfquery-2.1.0}/ttfquery/_scriptregistry.py

@@ -1,7 +1,7 @@
 """The singleton "registry" object (an instance of :class:`ttfquery.ttffiles.Registry`
-is the only member of note).  This registry with be created in a file 
-in the user's $HOME directory ``.font.cache`` if the $HOME environment variable 
-is defined.  Otherwise will be created in the ttfquery source code directory 
+is the only member of note).  This registry with be created in a file
+in the user's $HOME directory ``.font.cache`` if the $HOME environment variable
+is defined.  Otherwise will be created in the ttfquery source code directory
 (which is obviously not a very good solution).
 
 .. note::