From 170f83f02682c3e91e784a303de0efb8e90d133d Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Mon, 9 Jun 2014 23:33:57 +0200 Subject: [doc] add skeleton for luaotfloadrc manpage --- doc/luaotfload.conf.rst | 68 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 doc/luaotfload.conf.rst (limited to 'doc/luaotfload.conf.rst') diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst new file mode 100644 index 0000000..932afad --- /dev/null +++ b/doc/luaotfload.conf.rst @@ -0,0 +1,68 @@ +======================================================================= + luaotfload.conf +======================================================================= + Luaotfload configuration +----------------------------------------------------------------------- + +:Date: 2014-06-09 +:Copyright: GPL v2.0 +:Version: 2.5 +:Manual section: 5 +:Manual group: text processing + +SYNOPSIS +======================================================================= + +**XDG_CONFIG_HOME/luaotfload/luaotfload.conf** +**XDG_CONFIG_HOME/luaotfload/luaotfloadrc** +**~/.luaotfloadrc** + +DESCRIPTION +======================================================================= + + +EXAMPLE +======================================================================= + +* TODO, small example snippet + + +SYNTAX +======================================================================= + +* TODO, short intro to ``.ini`` file syntax + +VARIABLES +======================================================================= + +* TODO, list variables + + +FILES +======================================================================= + +* file locations + + +SEE ALSO +======================================================================= + +**luaotfload-tool** (1), **luatex** (1), **lua** (1) + +* ``texdoc luaotfload`` to display the PDF manual for the *Luaotfload* + package +* Luaotfload development ``_ +* LuaLaTeX mailing list ``_ +* LuaTeX ``_ +* Luaotfload on CTAN ``_ + + +AUTHORS +======================================================================= + +*Luaotfload* is maintained by the LuaLaTeX dev team +(``_). + +This manual page was written by Philipp Gesang +. + -- cgit v1.2.3 From 866d0a23432a936f74cd59eee787808f7968f11b Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Mon, 9 Jun 2014 23:50:49 +0200 Subject: [doc] make manpage source well-formed reStructuredText --- doc/luaotfload.conf.rst | 2 ++ 1 file changed, 2 insertions(+) (limited to 'doc/luaotfload.conf.rst') diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst index 932afad..bd080d1 100644 --- a/doc/luaotfload.conf.rst +++ b/doc/luaotfload.conf.rst @@ -1,6 +1,8 @@ ======================================================================= luaotfload.conf ======================================================================= + +----------------------------------------------------------------------- Luaotfload configuration ----------------------------------------------------------------------- -- cgit v1.2.3 From 992a8e8b1967486291cc1f480fd3ff83d904576c Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Sat, 12 Jul 2014 13:55:04 +0200 Subject: [doc] describe config file search sequence in manpage --- doc/luaotfload.conf.rst | 33 ++++++++++++++++++++++++++++----- 1 file changed, 28 insertions(+), 5 deletions(-) (limited to 'doc/luaotfload.conf.rst') diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst index bd080d1..eb7788e 100644 --- a/doc/luaotfload.conf.rst +++ b/doc/luaotfload.conf.rst @@ -3,7 +3,7 @@ ======================================================================= ----------------------------------------------------------------------- - Luaotfload configuration + Luaotfload configuration file ----------------------------------------------------------------------- :Date: 2014-06-09 @@ -15,13 +15,16 @@ SYNOPSIS ======================================================================= -**XDG_CONFIG_HOME/luaotfload/luaotfload.conf** -**XDG_CONFIG_HOME/luaotfload/luaotfloadrc** -**~/.luaotfloadrc** +- **./luaotfload{.conf,rc}** +- **XDG_CONFIG_HOME/luaotfload/luaotfload{.conf,rc}** +- **~/.luaotfloadrc** DESCRIPTION ======================================================================= +The file ``luaotfload.conf`` contains configuration options for +*Luaotfload*, a font loading and font management component for LuaTeX. + EXAMPLE ======================================================================= @@ -37,13 +40,27 @@ SYNTAX VARIABLES ======================================================================= + * TODO, list variables FILES ======================================================================= -* file locations +Luaotfload only processes the first configuration file it encounters at +one of the search locations. The file name may be either +``luaotfload.conf`` or ``luaotfloadrc``, except for the dotfile in the +user’s home directory which is expected at ``~/.luaotfloadrc``. + +Configuration files are located following a series of steps. The search +terminates as soon as a suitable file is encountered. The sequence of +locations that Luaotfload looks at is + +i. The current working directory of the LuaTeX process. +ii. The subdirectory ``luaotfload/`` inside the XDG configuration + tree, e. g. ``/home/oenothea/config/luaotfload/``. +iii. The dotfile. +iv. The *TEXMF* (using kpathsea). SEE ALSO @@ -59,6 +76,12 @@ SEE ALSO * Luaotfload on CTAN ``_ +REFERENCES +======================================================================= + +* The XDG base specification + ``_. + AUTHORS ======================================================================= -- cgit v1.2.3 From cff9bd20679420af3e56b43d035f08c03f6a257e Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Sat, 12 Jul 2014 22:21:21 +0200 Subject: [doc] describe configuration options --- doc/luaotfload.conf.rst | 176 +++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 174 insertions(+), 2 deletions(-) (limited to 'doc/luaotfload.conf.rst') diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst index eb7788e..9c8153a 100644 --- a/doc/luaotfload.conf.rst +++ b/doc/luaotfload.conf.rst @@ -40,8 +40,180 @@ SYNTAX VARIABLES ======================================================================= +Variables in belong into a configuration section and their values must +be of a certain type. Some of them have further constraints. For +example, the “color callback” must be a string of one of the values +``pre_linebreak_filter`` or ``pre_output_filter``, defined in the +section *run*. -* TODO, list variables +Currently, the configuration is organized into four sections: + +db + Options relating to the font index. + +misc + Options without a clearly defined category. + +paths + Path and file name settings. + +run + Options controlling runtime behavior of Luaotfload. + +The list of valid variables, the sections they are part of and their +type is given below. Types represent Lua types that the values must be +convertible to; they are abbreviated as follows: ``s`` for the *string* +type, ``n`` for *number*, ``b`` for *boolean*. A value of ``nil`` means +the variable is unset. + + +Section ``db`` +----------------------------------------------------------------------- + ++---------------+--------+---------------------------+ +| variable | type | default | ++---------------+--------+---------------------------+ +| compress | b | ``true`` | ++---------------+--------+---------------------------+ +| formats | s | ``"otf,ttf,ttc,dfont"`` | ++---------------+--------+---------------------------+ +| max_fonts | n | ``2^51`` | ++---------------+--------+---------------------------+ +| scan_local | b | ``false`` | ++---------------+--------+---------------------------+ +| skip_read | b | ``false`` | ++---------------+--------+---------------------------+ +| strip | b | ``true`` | ++---------------+--------+---------------------------+ +| update_live | b | ``true`` | ++---------------+--------+---------------------------+ + +The flag ``compress`` determines whether the font index (usually +``luaotfload-names.lua[.gz]`` will be stored in compressed forms. +If unset it is equivalent of passing ``--no-compress`` to +**luaotfload-tool**. Since the file is only created for convenience +and has no effect on the runtime behavior of Luaotfload, the flag +should remain set. Most editors come with zlib support anyways. + +The list of ``formats`` must be a comma separated sequence of strings +containing one or more of these elements: + +* ``otf`` (OpenType format), +* ``ttf`` and ``ttc`` (TrueType format), +* ``dfont`` (Macintosh TrueType format), +* ``afm`` (Adobe Font Metrics), +* ``pfb`` and ``pfa`` (PostScript format). + +It corresponds loosely to the ``--formats`` option to +**luaotfload-tool**. Invalid or duplicate members are ignored; if the +list does not contain any useful identifiers, the default list +``"otf,ttf,ttc,dfont"`` will be used. + +The variable ``max_fonts`` determines after processing how many font +files the font scanner will terminate the search. This is useful for +debugging issues with the font index and has the same effect as the +option ``--max-fonts`` to **luaotfload-tools**. + +The ``scan_local`` flag, if set, will incorporate the current working +directory as a font search location. NB: This will potentially slow +down document processing because a font index with local fonts will not +be saved to disk, so these fonts will have to be re-indexed whenever +the document is built. + +The ``skip_read`` flag is only useful for debugging: It makes +Luaotfload skip reading fonts. The font information for rebuilding the +index is taken from the presently existing one. + +Unsetting the ``strip`` flag prevents Luaotfload from removing data +from the index that is only useful when processing font files. NB: this +can increase the size of the index files significantly and has no +effect on the runtime behavior. + +If ``update_live`` is set, Luaotfload will reload the database if it +cannot find a requested font. Those who prefer to update manually using +**luaotfload-tool** should unset this flag. + + +Section ``misc`` +----------------------------------------------------------------------- + ++---------------+--------+-------------------------+ +| variable | type | default | ++---------------+--------+-------------------------+ +| statistics | b | ``false`` | ++---------------+--------+-------------------------+ +| termwidth | n | ``nil`` | ++---------------+--------+-------------------------+ +| version | s | ``luaotfload.version`` | ++---------------+--------+-------------------------+ + +With ``statistics`` enabled, extra statistics will be collected during +index creation and appended to the index file. It may then be queried +at the Lua end or inspected by reading the file itself. + +The value of ``termwidth``, if set, overrides the value retrieved by +querying the properties of the terminal in which Luatex runs. This is +useful if the engine runs with ``shell_escape`` disabled and the actual +terminal dimensions cannot be retrieved. + +The value of ``version`` is derived from the version string hard-coded +in the Luaotfload source. Override at your own risk. + + +Section ``paths`` +----------------------------------------------------------------------- + ++------------------+--------+------------------------------------+ +| variable | type | default | ++------------------+--------+------------------------------------+ +| cache_dir | s | ``"fonts"`` | ++------------------+--------+------------------------------------+ +| names_dir | s | ``"names"`` | ++------------------+--------+------------------------------------+ +| index_file | s | ``"luaotfload-names.lua"`` | ++------------------+--------+------------------------------------+ +| lookups_file | s | ``"luaotfload-lookup-cache.lua"`` | ++------------------+--------+------------------------------------+ + +The paths ``cache_dir`` and ``names_dir`` determine the subdirectory +inside the Luaotfload subtree of the ``luatex-cache`` directory where +the font cache and the font index will be stored, respectively. + +Inside the index directory, the names of the index file and the font +lookup cache will be derived from the respective values of +``index_file`` and ``lookups_file``. This is the filename base for the +bytecode compiled version as well as -- for the index -- the gzipped +version. + + +Section ``run`` +----------------------------------------------------------------------- + ++------------------+--------+------------------------------+ +| variable | type | default | ++------------------+--------+------------------------------+ +| color_callback | s | ``"pre_linebreak_filter"`` | ++------------------+--------+------------------------------+ +| definer | s | ``"patch"`` | ++------------------+--------+------------------------------+ +| log_level | n | ``0`` | ++------------------+--------+------------------------------+ +| resolver | s | ``"cached"`` | ++------------------+--------+------------------------------+ + +The ``color_callback`` option determines the stage at which fonts that +defined with a ``color=xxyyzz`` feature will be colorized. By default +this happens in a ``pre_linebreak_filter`` but alternatively the +``pre_output_filter`` may be chosen, which is faster but might produce +inconsistent output. The latter also was the default in the 1.x series +of Luaotfload. + +The value of ``log_level`` set the default verbosity of messages +printed by Luaotfload. Only messages defined with a verbosity of less +than or equal to the supplied value will be output on the terminal. +At a log level of five Luaotfload can be very noisy. Also, printing too +many messages will slow down the interpreter due to line buffering +being disabled (see **setbuf**\(3)). FILES @@ -66,7 +238,7 @@ iv. The *TEXMF* (using kpathsea). SEE ALSO ======================================================================= -**luaotfload-tool** (1), **luatex** (1), **lua** (1) +**luaotfload-tool**\(1), **luatex**\(1), **lua**\(1) * ``texdoc luaotfload`` to display the PDF manual for the *Luaotfload* package -- cgit v1.2.3 From 992b0150c8182c10cd3415d696bf66c10a381dd7 Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Sun, 13 Jul 2014 12:19:47 +0200 Subject: [doc] extend documentation of config options in manpage --- doc/luaotfload.conf.rst | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) (limited to 'doc/luaotfload.conf.rst') diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst index 9c8153a..f25fc88 100644 --- a/doc/luaotfload.conf.rst +++ b/doc/luaotfload.conf.rst @@ -29,7 +29,7 @@ The file ``luaotfload.conf`` contains configuration options for EXAMPLE ======================================================================= -* TODO, small example snippet + SYNTAX @@ -208,13 +208,27 @@ this happens in a ``pre_linebreak_filter`` but alternatively the inconsistent output. The latter also was the default in the 1.x series of Luaotfload. -The value of ``log_level`` set the default verbosity of messages +The ``definer`` allows for switching the ``define_font`` callback. +Apart from the default ``patch`` one may also choose the ``generic`` +one that comes with the vanilla fontloader. Beware that this might +break tools like Fontspect that rely on the ``patch_font`` callback +provided by Luaotfload to perform important corrections on font data. + +The value of ``log_level`` sets the default verbosity of messages printed by Luaotfload. Only messages defined with a verbosity of less than or equal to the supplied value will be output on the terminal. At a log level of five Luaotfload can be very noisy. Also, printing too many messages will slow down the interpreter due to line buffering being disabled (see **setbuf**\(3)). +The ``resolver`` setting allows choosing the font name resolution +function: With the default value ``cached`` Luaotfload saves the result +of a successful font name request to a cache file to speed up +subsequent lookups. The alternative, ``normal`` circumvents the cache +and resolves every request individually. (Since to the restructuring of +the font name index in Luaotfload 2.4 the performance difference +between the cached and uncached lookups should be marginal.) + FILES ======================================================================= -- cgit v1.2.3 From 42554adf7de06013127c9a2d63431456c82f447f Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Sun, 13 Jul 2014 12:52:18 +0200 Subject: [doc] fix variable identifiers --- doc/luaotfload.conf.rst | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) (limited to 'doc/luaotfload.conf.rst') diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst index f25fc88..762f412 100644 --- a/doc/luaotfload.conf.rst +++ b/doc/luaotfload.conf.rst @@ -77,15 +77,15 @@ Section ``db`` +---------------+--------+---------------------------+ | formats | s | ``"otf,ttf,ttc,dfont"`` | +---------------+--------+---------------------------+ -| max_fonts | n | ``2^51`` | +| max-fonts | n | ``2^51`` | +---------------+--------+---------------------------+ -| scan_local | b | ``false`` | +| scan-local | b | ``false`` | +---------------+--------+---------------------------+ -| skip_read | b | ``false`` | +| skip-read | b | ``false`` | +---------------+--------+---------------------------+ | strip | b | ``true`` | +---------------+--------+---------------------------+ -| update_live | b | ``true`` | +| update-live | b | ``true`` | +---------------+--------+---------------------------+ The flag ``compress`` determines whether the font index (usually @@ -109,18 +109,18 @@ It corresponds loosely to the ``--formats`` option to list does not contain any useful identifiers, the default list ``"otf,ttf,ttc,dfont"`` will be used. -The variable ``max_fonts`` determines after processing how many font +The variable ``max-fonts`` determines after processing how many font files the font scanner will terminate the search. This is useful for debugging issues with the font index and has the same effect as the option ``--max-fonts`` to **luaotfload-tools**. -The ``scan_local`` flag, if set, will incorporate the current working +The ``scan-local`` flag, if set, will incorporate the current working directory as a font search location. NB: This will potentially slow down document processing because a font index with local fonts will not be saved to disk, so these fonts will have to be re-indexed whenever the document is built. -The ``skip_read`` flag is only useful for debugging: It makes +The ``skip-read`` flag is only useful for debugging: It makes Luaotfload skip reading fonts. The font information for rebuilding the index is taken from the presently existing one. @@ -129,7 +129,7 @@ from the index that is only useful when processing font files. NB: this can increase the size of the index files significantly and has no effect on the runtime behavior. -If ``update_live`` is set, Luaotfload will reload the database if it +If ``update-live`` is set, Luaotfload will reload the database if it cannot find a requested font. Those who prefer to update manually using **luaotfload-tool** should unset this flag. @@ -166,22 +166,22 @@ Section ``paths`` +------------------+--------+------------------------------------+ | variable | type | default | +------------------+--------+------------------------------------+ -| cache_dir | s | ``"fonts"`` | +| cache-dir | s | ``"fonts"`` | +------------------+--------+------------------------------------+ -| names_dir | s | ``"names"`` | +| names-dir | s | ``"names"`` | +------------------+--------+------------------------------------+ -| index_file | s | ``"luaotfload-names.lua"`` | +| index-file | s | ``"luaotfload-names.lua"`` | +------------------+--------+------------------------------------+ -| lookups_file | s | ``"luaotfload-lookup-cache.lua"`` | +| lookups-file | s | ``"luaotfload-lookup-cache.lua"`` | +------------------+--------+------------------------------------+ -The paths ``cache_dir`` and ``names_dir`` determine the subdirectory +The paths ``cache-dir`` and ``names-dir`` determine the subdirectory inside the Luaotfload subtree of the ``luatex-cache`` directory where the font cache and the font index will be stored, respectively. Inside the index directory, the names of the index file and the font lookup cache will be derived from the respective values of -``index_file`` and ``lookups_file``. This is the filename base for the +``index-file`` and ``lookups-file``. This is the filename base for the bytecode compiled version as well as -- for the index -- the gzipped version. @@ -192,16 +192,16 @@ Section ``run`` +------------------+--------+------------------------------+ | variable | type | default | +------------------+--------+------------------------------+ -| color_callback | s | ``"pre_linebreak_filter"`` | +| color-callback | s | ``"pre_linebreak_filter"`` | +------------------+--------+------------------------------+ | definer | s | ``"patch"`` | +------------------+--------+------------------------------+ -| log_level | n | ``0`` | +| log-level | n | ``0`` | +------------------+--------+------------------------------+ | resolver | s | ``"cached"`` | +------------------+--------+------------------------------+ -The ``color_callback`` option determines the stage at which fonts that +The ``color-callback`` option determines the stage at which fonts that defined with a ``color=xxyyzz`` feature will be colorized. By default this happens in a ``pre_linebreak_filter`` but alternatively the ``pre_output_filter`` may be chosen, which is faster but might produce @@ -214,7 +214,7 @@ one that comes with the vanilla fontloader. Beware that this might break tools like Fontspect that rely on the ``patch_font`` callback provided by Luaotfload to perform important corrections on font data. -The value of ``log_level`` sets the default verbosity of messages +The value of ``log-level`` sets the default verbosity of messages printed by Luaotfload. Only messages defined with a verbosity of less than or equal to the supplied value will be output on the terminal. At a log level of five Luaotfload can be very noisy. Also, printing too -- cgit v1.2.3 From 18aceb2612c0352535aa07ca9628d9cbc5285c19 Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Sun, 13 Jul 2014 13:02:17 +0200 Subject: [doc] add short example file to configuration man page --- doc/luaotfload.conf.rst | 28 +++++++++++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) (limited to 'doc/luaotfload.conf.rst') diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst index 762f412..561ca97 100644 --- a/doc/luaotfload.conf.rst +++ b/doc/luaotfload.conf.rst @@ -29,7 +29,33 @@ The file ``luaotfload.conf`` contains configuration options for EXAMPLE ======================================================================= - +A small Luaotfload configuration file with few customizations could +look as follows: :: + + [db] + formats = afm, pfa, pfb + compress = false + + [misc] + termwidth = 60 + + [run] + log-level = 6 + +This will make Luaotfload ignore all font files except for PostScript +formats. NB: With a default Tex Live install the PS fonts will take +much longer to index than OpenType or TrueType ones. Also, an +uncompressed index file will be dumped which is going to be much larger +due to the huge amount of PostScript fonts indexed. The terminal width +is truncated to 60 characters which influences the verbose output +during indexing. Finally, the verbosity is increased greatly: each font +file being processed will be printed to the stdout on a separate line, +along with lots of other information. + +To observe the difference in behavior, save above snippet to +``./luaotfload.conf`` and update the font index: :: + + luaotfload --update --force SYNTAX -- cgit v1.2.3 From dcbfa2c743d14a60037ac3c61f0d7cba339696cd Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Sun, 13 Jul 2014 13:17:18 +0200 Subject: [conf] add example configuration file --- doc/luaotfload.conf.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc/luaotfload.conf.rst') diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst index 561ca97..9940be2 100644 --- a/doc/luaotfload.conf.rst +++ b/doc/luaotfload.conf.rst @@ -170,7 +170,7 @@ Section ``misc`` +---------------+--------+-------------------------+ | termwidth | n | ``nil`` | +---------------+--------+-------------------------+ -| version | s | ``luaotfload.version`` | +| version | s | | +---------------+--------+-------------------------+ With ``statistics`` enabled, extra statistics will be collected during -- cgit v1.2.3 From f66b2ffe8fdc30e517d00b4796c142acd0e4438d Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Sun, 13 Jul 2014 15:15:46 +0200 Subject: [doc] describe feature settings and config file syntax in manpage --- doc/luaotfload.conf.rst | 44 +++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 43 insertions(+), 1 deletion(-) (limited to 'doc/luaotfload.conf.rst') diff --git a/doc/luaotfload.conf.rst b/doc/luaotfload.conf.rst index 9940be2..774095b 100644 --- a/doc/luaotfload.conf.rst +++ b/doc/luaotfload.conf.rst @@ -61,7 +61,29 @@ To observe the difference in behavior, save above snippet to SYNTAX ======================================================================= -* TODO, short intro to ``.ini`` file syntax +The configuration file syntax follows the common INI format. For a more +detailed description please refer to the section “CONFIGURATION FILE” +of **git-config**\(1). A brief list of rules is given below: + + * Blank lines and lines starting with a semicolon (``;``) are ignored. + + * A configuration file is partitioned into sections that are declared + by specifying the section title in brackets on a separate line: :: + + [some-section] + ... section content ... + + * Sections consist of one or more variable assignments of the form + ``variable-name = value`` E. g.:: + + [foo] + bar = baz + quux = xyzzy + ... + + * Section and variable names may contain only uppercase and lowercase + letters as well as dashes (``-``). + VARIABLES ======================================================================= @@ -160,6 +182,26 @@ cannot find a requested font. Those who prefer to update manually using **luaotfload-tool** should unset this flag. +Section ``default-features`` +----------------------------------------------------------------------- + +By default Luaotfload enables ``node`` mode and picks the default font +features that are prescribed in the OpenType standard. This behavior +may be overridden in the ``default-features`` section. Global defaults +that will be applied for all scripts can be set via the ``global`` +option, others by the script they are to be applied to. For example, +a setting of :: + + [default-features] + global = mode=base,color=0000FF + dflt = smcp,onum + +would force *base* mode, tint all fonts blue and activate small +capitals and text figures globally. Features are specified as a comma +separated list of variables or variable-value pairs. Variables without +an explicit value are set to ``true``. + + Section ``misc`` ----------------------------------------------------------------------- -- cgit v1.2.3