summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-06-30 20:51:48 +0000
committerKarl Berry <karl@freefriends.org>2023-06-30 20:51:48 +0000
commit1ac7cb6b83a70441b3a878626b3fad127987740e (patch)
treeeeda546f2d6be680e0abfb4cbdf32ceedbd4b609 /Master/texmf-dist/doc
parent4f781dbd163d1420e48aa24bf2967ba2eee0af03 (diff)
blopentype (30jun23)
git-svn-id: svn://tug.org/texlive/trunk@67517 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/luatex/blopentype/LICENSE21
-rw-r--r--Master/texmf-dist/doc/luatex/blopentype/README.md15
-rw-r--r--Master/texmf-dist/doc/luatex/blopentype/blopentype.md36
3 files changed, 54 insertions, 18 deletions
diff --git a/Master/texmf-dist/doc/luatex/blopentype/LICENSE b/Master/texmf-dist/doc/luatex/blopentype/LICENSE
new file mode 100644
index 00000000000..bfed4c5d960
--- /dev/null
+++ b/Master/texmf-dist/doc/luatex/blopentype/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Luis Rivera
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/Master/texmf-dist/doc/luatex/blopentype/README.md b/Master/texmf-dist/doc/luatex/blopentype/README.md
index 4a0a3930f26..c93988bad15 100644
--- a/Master/texmf-dist/doc/luatex/blopentype/README.md
+++ b/Master/texmf-dist/doc/luatex/blopentype/README.md
@@ -1,5 +1,5 @@
# blopentype
-Basic LuaTeX OpenType Handler
+Basic LuaTeX OpenType Manager
# Description
@@ -11,9 +11,9 @@ In his terse documentation for `PiTeX`, Paul Isambert lists, among the "mandator
| fonts.ptxlua | The Lua fontloader; should become independant some day. |
| foundry-settings.lua | Default settings for the fontloader. |
-Well: the day has come, and the fontloader has now become `blopentype`: a *Basic LuaTeX OpenType Handler*.
+Well: the day has come, and the fontloader has now become `blopentype`: a *Basic LuaTeX OpenType Manager*.
-The basic code is copied almost verbatim from Isambert's `PiTeX`, save the adoption of the filename extensions `ltm` for *LuaTeX macros*, `lts` for *LuaTeX scripts*, and `blot-sets.lua` for the basic basic settings.
+The basic code is copied almost verbatim from Isambert's `PiTeX`, save the adoption of the canonical filename extensions `tex` for *LuaTeX macros*, `lua` for *LuaTeX scripts*, and `blot-sets.lua` for the basic basic settings.
The required dependencies are Isambert packages [texapi](https://ctan.org/pkg/texapi), [YaX](https://ctan.org/pkg/yax) and [Gates](https://ctan.org/pkg/gates), as stated in `DEPENDS.txt`.
You may find an example of usage in the `blottest.[tex|pdf]` files, and some basic documentation in `blopentype.md`.
@@ -22,16 +22,17 @@ You may find an example of usage in the `blottest.[tex|pdf]` files, and some bas
The macros are still barely documented, and massively keep the names of their parent (`PiTeX`) package; that may be fixed some day.
-The font database is loaded at `$HOME/texmf/luatex/foundry/readable.txt`; it is not updated automatically after installing new fonts: you have to edit it manually, or else delete/rename(backup) it and rerun LuaTeX to rebuild it.
+The font database is stored at `$TEXMFLOCAL/texmf/luatex/blotfonts/readable.txt`.
+It is updated automatically after installing *and using* new fonts, but you may edit it, or else delete/rename(backup) the database by hand, and rerun LuaTeX to rebuild it.
-The character table for each typeface is stored in the `luatex/foundry` directory as a flat `lua` file; it would be nice to have it compiled as a `luac` file to save some space.
+The character table for each typeface is stored in the `luatex/blotfonts` directory as a flat `lua` file; it would be nice to have it compiled as a `luac/luc` file to save some space, some day.
Good luck, and happy LuaTeXing
# Authors
-Version 0.0.0 (C) 2022 Paul Isambert (massively) and Luis Rivera (minor surgeon; or rather: kludger).
+Version 0.0.2 (C) 2023 Paul Isambert (author) and Luis Rivera (maintainer).
LaTeX Project Public License, LPPL Version 1.3c 2008-05-04 or MIT License
-December 28, 2022 \ No newline at end of file
+June 29, 2023
diff --git a/Master/texmf-dist/doc/luatex/blopentype/blopentype.md b/Master/texmf-dist/doc/luatex/blopentype/blopentype.md
index a42d55ec489..651f57f2815 100644
--- a/Master/texmf-dist/doc/luatex/blopentype/blopentype.md
+++ b/Master/texmf-dist/doc/luatex/blopentype/blopentype.md
@@ -1,24 +1,38 @@
-# Basic LuaTeX OpenType Handler Minimal User Guide
+# Basic LuaTeX OpenType Manager Minimal User Guide
-As for version 0.0.0 December 2022
+As of version 0.0.1 May 2023
-Fonts (fonts.ltm and fonts.lts)
-==================================
+Loading the macros
+==================
+
+This is a Plain TeX macro package, so simply type
+
+```
+\input blot
+```
+
+and you are halfway through: there are font parameter defaults, but no font is loaded
+automatically, since it must depend on your system; so you have to load fonts
+on your own.
+
+Fonts
+=====
The fontloader uses gates, but only superficially. They won't be
documented here.
To load a given font, you define it in YaX syntax with the `\setfont` command.
+Thus, the instruction:
-```\setfont <command>:<attributes>```
+```\setfont <fontcommand>:<attributes>```
-Sets <command> to call the font described in <attributes>; all defaults
-to the values of the `metafont` parameter. If `<command>` is `\mainfont`,
-as the name of the main font for the document, the font is called at once;
-any other `\command` requires explicit calls.
+sets <fontcommand> to call the font described in <attributes>; all new fonts default
+to the values of the `metafont` parameter described elsewhere.
+If `<fontcommand>` is `\mainfont`, the font is called at once;
+any other `\fontcommand` requires an explicit call.
-You may thing of `\setfont <command>` as similar to DEKTeX's `\font\cmr10 at 12pt`
-or whatever font definition, but now the call is to an array of font attributes.
+You may thing of `\setfont <fontcommand>` as similar to DEKTeX's `\font<fontcommand> <parameters>`,
+but now the call is to an array of font attributes, enumerated below.
`name`
The family name of the font; e.g. Palatino Linotype for the main text of