starlight-cli 1.0.12 → 1.0.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ Dimitar Zhekov <dimitar.zhekov@gmail.com>
@@ -0,0 +1,94 @@
1
+ Copyright (c) 2014 Dimitar Toshkov Zhekov,
2
+ with Reserved Font Name "Terminus Font".
3
+
4
+ This Font Software is licensed under the SIL Open Font License, Version 1.1.
5
+ This license is copied below, and is also available with a FAQ at:
6
+ http://scripts.sil.org/OFL
7
+
8
+
9
+ -----------------------------------------------------------
10
+ SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
11
+ -----------------------------------------------------------
12
+
13
+ PREAMBLE
14
+ The goals of the Open Font License (OFL) are to stimulate worldwide
15
+ development of collaborative font projects, to support the font creation
16
+ efforts of academic and linguistic communities, and to provide a free and
17
+ open framework in which fonts may be shared and improved in partnership
18
+ with others.
19
+
20
+ The OFL allows the licensed fonts to be used, studied, modified and
21
+ redistributed freely as long as they are not sold by themselves. The
22
+ fonts, including any derivative works, can be bundled, embedded,
23
+ redistributed and/or sold with any software provided that any reserved
24
+ names are not used by derivative works. The fonts and derivatives,
25
+ however, cannot be released under any other type of license. The
26
+ requirement for fonts to remain under this license does not apply
27
+ to any document created using the fonts or their derivatives.
28
+
29
+ DEFINITIONS
30
+ "Font Software" refers to the set of files released by the Copyright
31
+ Holder(s) under this license and clearly marked as such. This may
32
+ include source files, build scripts and documentation.
33
+
34
+ "Reserved Font Name" refers to any names specified as such after the
35
+ copyright statement(s).
36
+
37
+ "Original Version" refers to the collection of Font Software components as
38
+ distributed by the Copyright Holder(s).
39
+
40
+ "Modified Version" refers to any derivative made by adding to, deleting,
41
+ or substituting -- in part or in whole -- any of the components of the
42
+ Original Version, by changing formats or by porting the Font Software to a
43
+ new environment.
44
+
45
+ "Author" refers to any designer, engineer, programmer, technical
46
+ writer or other person who contributed to the Font Software.
47
+
48
+ PERMISSION & CONDITIONS
49
+ Permission is hereby granted, free of charge, to any person obtaining
50
+ a copy of the Font Software, to use, study, copy, merge, embed, modify,
51
+ redistribute, and sell modified and unmodified copies of the Font
52
+ Software, subject to the following conditions:
53
+
54
+ 1) Neither the Font Software nor any of its individual components,
55
+ in Original or Modified Versions, may be sold by itself.
56
+
57
+ 2) Original or Modified Versions of the Font Software may be bundled,
58
+ redistributed and/or sold with any software, provided that each copy
59
+ contains the above copyright notice and this license. These can be
60
+ included either as stand-alone text files, human-readable headers or
61
+ in the appropriate machine-readable metadata fields within text or
62
+ binary files as long as those fields can be easily viewed by the user.
63
+
64
+ 3) No Modified Version of the Font Software may use the Reserved Font
65
+ Name(s) unless explicit written permission is granted by the corresponding
66
+ Copyright Holder. This restriction only applies to the primary font name as
67
+ presented to the users.
68
+
69
+ 4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
70
+ Software shall not be used to promote, endorse or advertise any
71
+ Modified Version, except to acknowledge the contribution(s) of the
72
+ Copyright Holder(s) and the Author(s) or with their explicit written
73
+ permission.
74
+
75
+ 5) The Font Software, modified or unmodified, in part or in whole,
76
+ must be distributed entirely under this license, and must not be
77
+ distributed under any other license. The requirement for fonts to
78
+ remain under this license does not apply to any document created
79
+ using the Font Software.
80
+
81
+ TERMINATION
82
+ This license becomes null and void if any of the above conditions are
83
+ not met.
84
+
85
+ DISCLAIMER
86
+ THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
87
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
88
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
89
+ OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
90
+ COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
91
+ INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
92
+ DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
93
+ FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
94
+ OTHER DEALINGS IN THE FONT SOFTWARE.
@@ -0,0 +1,340 @@
1
+ NOTE: This directory contains the terminus font compiled to a JSON format.
2
+
3
+ Contents:
4
+
5
+ 1. About.
6
+ 1.1. Quick installation.
7
+ 1.2. Legend.
8
+ 1.3. Variants.
9
+ 1.4. Notes.
10
+
11
+ 2. Linux console.
12
+ 2.1. consoletools.
13
+ 2.2. kbd.
14
+ 2.3. Quick reference.
15
+ 2.4. Legend.
16
+ 2.5. Notes.
17
+
18
+ 3. UNIX console.
19
+ 3.1. bsd-pcvt.
20
+ 3.2. Legend.
21
+ 3.3. Notes.
22
+
23
+ 4. X11 Window System.
24
+ 4.1. Installation.
25
+ 4.2. Notes.
26
+
27
+ 5. Frequently Asked Questions.
28
+
29
+ 6. Legal information.
30
+ 6.1. Licenses.
31
+ 6.2. Copyright.
32
+
33
+
34
+ 1. About.
35
+
36
+ This archive contains source code for generating and installing Terminus
37
+ Font for Linux console, BSD console and X11 Window System.
38
+
39
+ - version 4.39
40
+ - sizes 6x12, 8x14, 8x16, 10x18, 10x20, 11x22, 12x24, 14x28, 16x32
41
+ - styles normal, bold, EGA/VGA bold
42
+ - characters 891
43
+ - format Bitmap Distribution Format (BDF) version 2.1
44
+
45
+ The character set covers about 120 language sets and supports ISO8859-1/2/5/
46
+ 7/9/13/15/16, Paratype-PT154/PT254, KOI8-R/U/E/F, Esperanto and many IBM,
47
+ Windows and Macintosh code pages, as well as the IBM VGA, vt100 and xterm
48
+ pseudographic characters.
49
+
50
+ 1.1. Quick installation.
51
+
52
+ The commands:
53
+
54
+ $ ./configure [--prefix=PREFIX]
55
+ $ make
56
+ # make install fontdir
57
+
58
+ compile and install the Linux console and X11 Window System fonts.
59
+ The default PREFIX is /usr/local.
60
+
61
+ 1.2. Legend.
62
+
63
+ The file names are structured as follows:
64
+
65
+ ter-u<SIZE><STYLE>.bdf
66
+
67
+ where <SIZE> is the font height, and <STYLE> is n for normal (all sizes), b
68
+ for bold (all sizes except 6x12) and v for EGA/VGA bold (8x14 and 8x16 only,
69
+ makes use of the eight character matrix column).
70
+
71
+ 1.3. Variants.
72
+
73
+ Some characters are implemented in two variants. To use the alternate
74
+ variant, execute:
75
+
76
+ $ patch -p1 -i alt/<NAME>.diff
77
+
78
+ before installation. See the font page for examples about the differences.
79
+ If you want to combine hi2 with dv1 and/or ka2, apply hi2 and then hi2-dv1
80
+ and/or hi2-ka2.
81
+
82
+ 1.4. Notes.
83
+
84
+ The commands marked with $ can be executed by a regular user.
85
+ The configure commands are optional.
86
+ The make commands require GNU make.
87
+
88
+ A lot of characters are available only under X11/ISO10646-1 (UTF+8/Unicode).
89
+
90
+ Sizes 6x12, 11x22, 14x28-bold and 16x32-normal are worse than the others.
91
+ Avoid them.
92
+
93
+ 210E and 210F are not italic.
94
+
95
+
96
+ 2. Linux console.
97
+
98
+ - sizes all available, see "About"
99
+ - styles normal, bold, framebuffer-bold
100
+ - code pages ISO8859-1/ISO8859-15/Windows-1252, ISO8859-2/Windows-1250,
101
+ Windows-1251/ISO8859-5, ISO8859-9/Windows-1254, ISO8859-16,
102
+ ISO8859-7/Windows-1253, ISO8859-13/Windows-1257, IBM-437,
103
+ Bulgarian-MIK, KOI8-R, KOI8-U, Paratype-PT154, combined
104
+ - format PC Screen Font (PSF) with unicode data
105
+
106
+ 2.1. consoletools.
107
+
108
+ $ ./configure [--prefix=PREFIX | --psfdir=DIRECTORY]
109
+ $ make psf
110
+ # make install-psf
111
+
112
+ The files are compressed with gzip and installed in DIRECTORY. The default
113
+ DIRECTORY is PREFIX/share/consolefonts. Requires Perl.
114
+
115
+ If you lack mappings for Windows-1252/1250/1251/1254/1253/1257, ISO8859-16,
116
+ IBM-437, KOI8-R, Bulgarian-MIK or Paratype-PT154/PT254, also run:
117
+
118
+ $ ./configure [--prefix=PREFIX | --acmdir=DIRECTORY]
119
+ $ make txt
120
+ # make install-acm
121
+
122
+ The default DIRECTORY is PREFIX/share/consoletrans. Requires awk.
123
+ Uninstallation of the mappings is not supported. To load a font:
124
+
125
+ $ consolechars [-m MAPPING] -f ter-<X><SIZE><STYLE>
126
+
127
+ where <X> is a character identifying the code page as listed in p.2.4.
128
+
129
+ 2.2. kbd.
130
+
131
+ $ ./configure [--psfdir=DIRECTORY]
132
+ $ make psf
133
+ # make install-psf
134
+
135
+ where DIRECTORY should be either PREFIX/lib/kbd/consolefonts or
136
+ PREFIX/share/kbd/consolefonts, depending on kbd version. Missing mappings
137
+ are installed with:
138
+
139
+ $ ./configure [--prefix=PREFIX | --unidir=DIRECTORY]
140
+ $ make txt
141
+ # make install-uni
142
+
143
+ The default DIRECTORY is PREFIX/share/kbd/consoletrans. Requires awk. To
144
+ load a font:
145
+
146
+ $ setfont [-m MAPPING] ter-<X><SIZE><STYLE>
147
+
148
+ where <X> is a character identifying the code page as listed in p.2.4.
149
+
150
+ 2.3. Quick reference.
151
+
152
+ The commands:
153
+
154
+ $ ./configure [--prefix=PREFIX | --psfdir=DIRECTORY | --ref=FILENAME]
155
+ # make install-ref
156
+
157
+ install the text from p.2.4 as FILENAME (the default is README.terminus)
158
+ in DIRECTORY.
159
+
160
+ 2.4. Legend.
161
+
162
+ names mappings covered codepage(s)
163
+
164
+ ter-1* iso01, iso15, cp1252 ISO8859-1, ISO8859-15, Windows-1252
165
+ ter-2* iso02, cp1250 ISO8859-2, Windows-1250
166
+ ter-7* iso07, cp1253 ISO8859-7, Windows-1253
167
+ ter-9* iso09, cp1254 ISO8859-9, Windows-1254
168
+ ter-c* cp1251, iso05 Windows-1251, ISO8859-5
169
+ ter-d* iso13, cp1257 ISO8859-13, Windows-1257
170
+ ter-g* iso16 ISO8859-16
171
+ ter-i* cp437 IBM-437
172
+ ter-k* koi8r KOI8-R
173
+ ter-m* mik Bulgarian-MIK
174
+ ter-p* pt154 Paratype-PT154
175
+ ter-u* koi8u KOI8-U
176
+ ter-v* all listed above all listed above and many others (about 110
177
+ and many others language sets), 8 foreground colors
178
+
179
+ names style
180
+
181
+ ter-*n normal
182
+ ter-*b bold
183
+ ter-*f framebuffer-bold
184
+
185
+ 2.5. Notes.
186
+
187
+ The combined code page is based on IBM-437 (character 0xFF is ogonek).
188
+ The ISO8859-16 font also includes all letters and accents from Windows-1250.
189
+
190
+
191
+ 3. UNIX console.
192
+
193
+ - sizes 8x14 and 8x16 only
194
+ - styles normal, bold, framebuffer-bold
195
+ - code pages ISO8859-1/Windows-1252, ISO8859-2, ISO8859-5, ISO8859-7,
196
+ ISO8859-9/Windows-1254, ISO8859-13, ISO8859-15, ISO8859-16,
197
+ Windows-1251, IBM-437, KOI8-R, KOI8-U, Paratype-PT154
198
+ - format raw data
199
+
200
+ 3.1. bsd-pcvt.
201
+
202
+ $ ./configure [--prefix=PREFIX | --rawdir=DIRECTORY]
203
+ $ make raw
204
+ # make install.raw
205
+
206
+ or, for file names with minus instead of period:
207
+
208
+ # make install-raw
209
+
210
+ The default DIRECTORY is PREFIX/share/misc/pcvtfonts. The fonts are
211
+ installed uncompressed. Requires Perl. To load a font:
212
+
213
+ $ loadfont -f /usr/share/misc/pcvtfonts/ter-<X><STYLE>.8<SIZE>
214
+
215
+ or, for file names with minus instead of period:
216
+
217
+ $ loadfont -f /usr/share/misc/pcvtfonts/ter-<X><STYLE>-8x<SIZE>
218
+
219
+ where <X> is a character identifying the code page as listed in p.3.2.
220
+
221
+ 3.2. Legend.
222
+
223
+ names covered codepage(s)
224
+
225
+ ter-1* ISO8859-1, Windows-1252
226
+ ter-2* ISO8859-2
227
+ ter-5* ISO8859-5
228
+ ter-7* ISO8859-7
229
+ ter-9* ISO8859-9, Windows-1254
230
+ ter-c* Windows-1251
231
+ ter-d* ISO8859-13
232
+ ter-f* ISO8859-15
233
+ ter-g* ISO8859-16
234
+ ter-i* IBM-437
235
+ ter-k* KOI8-R
236
+ ter-p* Paratype-PT154
237
+ ter-u* KOI8-U
238
+
239
+ names style
240
+
241
+ ter-*n normal
242
+ ter-*b bold
243
+ ter-*f framebuffer-bold
244
+
245
+ 3.3. Notes.
246
+
247
+ The RAW font contains data only and should be compatible with all UNIX
248
+ systems. If any of the bold fonts doesn't look good try framebuffer-bold,
249
+ or, if you are using an EGA/VGA adapter, program it to to clear column 8 of
250
+ the character matrix (attribute controller register 0x10 bit 0x02).
251
+
252
+
253
+ 4. X11 Window System.
254
+
255
+ - sizes all available, see "About"
256
+ - styles normal, bold
257
+ - code pages ISO8859-1/Windows-1252, ISO8859-2, ISO8859-5, ISO8859-7,
258
+ ISO8859-9/Windows-1254, ISO8859-13, ISO8859-15, ISO8859-16,
259
+ Windows-1251, KOI8-R, KOI8-U, Paratype-PT154, ISO10646-1
260
+ - format Portable Compiled Font (PCF)
261
+
262
+ 4.1. Installation.
263
+
264
+ $ ./configure [--prefix=PREFIX | --x11dir=DIRECTORY]
265
+ $ make pcf
266
+ # make install-pcf
267
+
268
+ The files are compressed with gzip and installed in DIRECTORY. The default
269
+ DIRECTORY is PREFIX/share/fonts/terminus. Requires Perl and bdftopcf.
270
+
271
+ A copy of the normal 6x12 font is installed as "bold", because some X11
272
+ libraries and applications substitute the missing bold fonts by shifting the
273
+ normal fonts, and others do not recognize the bold style at all if the
274
+ lowest font size lacks it. To install only the normal font, use "n12"
275
+ instead of "pcf" in the above commands.
276
+
277
+ To update the font cache in DIRECTORY after (un)installation, run:
278
+
279
+ # make fontdir
280
+
281
+ The configuration file which lists the font directories must contain
282
+ DIRECTORY. If xfs or the X-server were active during the installation, they
283
+ should be restarted so the font list can be updated.
284
+
285
+ 4.2. Notes.
286
+
287
+ The ISO8859-1 and ISO8859-9 fonts contain the Windows Western characters and
288
+ can be used as Windows-1252 and Windows-1254 respectively.
289
+
290
+
291
+ 5. Frequently Asked Questions.
292
+
293
+ Q. Italic version?
294
+
295
+ A. No. The quality is significantly lower, and preserving the font width
296
+ requires overlapping characters, which are not handled very well by X11/Xft.
297
+ If you need it than much, try mkitalic from FreeBSD or bdfslant from Debian.
298
+
299
+ Q. Scalable version?
300
+
301
+ A. Long story short, when the average display resolution becomes at least
302
+ 150 DPI. Prefferably 200.
303
+
304
+ Q. How about some new characters?
305
+
306
+ A. Contact me and be ready to help.
307
+
308
+ Q. The bold 6x12 font...
309
+
310
+ A. ...does not exist, there is no space for a bold font in a 6x12 matrix.
311
+ However, the "normal" font is somewhere between.
312
+
313
+ Q. The font works in X11/Motif, but not in GNOME/KDE/Xfce.
314
+
315
+ A. Try adding 75-yes-terminus.conf to the Fontconfig configuration files.
316
+ See also mkfontscale(1), mkfontdir(1), fc-cache(1), xorg.conf(5), xfs(1),
317
+ xlsfonts(1), fonts-conf(5) etc.
318
+
319
+
320
+ 6. Legal information.
321
+
322
+ 6.1. Licenses.
323
+
324
+ Terminus Font is licensed under the SIL Open Font License, Version 1.1.
325
+ The license is included as OFL.TXT, and is also available with a FAQ at:
326
+ http://scripts.sil.org/OFL
327
+
328
+ The files configure, configure.help, bdftopsf.pl and ucstoany.pl are
329
+ distributed under the GNU General Public License version 2.0 or (at your
330
+ choice) any later version.
331
+
332
+
333
+ 6.2. Copyright.
334
+
335
+ Terminus Font 4.39, Copyright (C) 2014 Dimitar Toshkov Zhekov.
336
+ Report bugs to <dimitar.zhekov@gmail.com>
337
+
338
+
339
+ Thanks to Anton Zinoviev, Tim Allen, Kir Koliushkin, Antonios Galanopoulos
340
+ and all the others who helped.