| blob | ff2231140ef362c6f829674c0b29b7b6cc6090d7 |
1 .\" FIGlet
2 .\" Copyright (C) 1991, 1993, 1994 Glenn Chappell and Ian Chai
3 .\" Internet: <info@figlet.org>
4 .\" Portions Copyright 1996, 1997, 1998, 1999, 2000, 2001 by John Cowan <cowan@ccil.org>
5 .\" Portions Copyright 2002 by Christiaan Keet
6 .\" Portions Copyright 2011, 2012 by Claudio Matsuoka
7 .\" FIGlet, along with the various FIGlet fonts and documentation, may
8 .\" be freely copied and distributed.
9 .\" If you use FIGlet, please send an e-mail message to
10 .\" <info@figlet.org>
11 .\"
12 .TH FIGLET 6 "31 May 2012" "v2.2.5"
14 .SH NAME
15 FIGlet \- display large characters made up of ordinary screen characters
17 .SH SYNOPSIS
18 .B figlet
19 [
20 .B \-cklnoprstvxDELNRSWX
21 ]
22 [
23 .B \-d
24 .I fontdirectory
25 ]
26 .PD 0
27 .IP
28 .PD
29 [
30 .B \-f
31 .I fontfile
32 ]
33 [
34 .B \-m
35 .I layoutmode
36 ]
37 .PD 0
38 .IP
39 .PD
40 [
41 .B \-w
42 .IR outputwidth
43 ]
44 [
45 .B \-C
46 .I controlfile
47 ]
48 .PD 0
49 .IP
50 .PD
51 [
52 .B \-I
53 .I infocode
54 ]
55 [
56 .I message
57 ]
59 .SH DESCRIPTION
60 .B FIGlet
61 prints its input using large characters
62 (called ``FIGcharacters'')made up of ordinary
63 screen characters
64 (called ``sub-characters'').
65 .B FIGlet
66 output is generally reminiscent of the
67 sort of ``signatures'' many people like to put at the end of e-mail
68 and UseNet messages. It is also reminiscent of the output of some banner
69 programs, although it is oriented normally, not sideways.
71 .B FIGlet
72 can print in a variety of fonts, both left-to-right and right-to-left,
73 with adjacent FIGcharacters kerned and ``smushed'' together in various ways.
74 .B FIGlet
75 fonts are stored in
76 separate files, which can be identified by the suffix
77 .RB `` .flf ''.
78 In systems with UTF-8 support
79 .B FIGlet
80 may also support TOIlet
81 .RB `` .tlf ''
82 fonts. Most
83 .B FIGlet
84 font files will be stored in
85 .B FIGlet's
86 default font directory.
88 .B FIGlet
89 can also use ``control files'', which tell it to map certain input
90 characters to certain other characters, similar to the Unix
91 .B tr
92 command. Control files can be identified by the suffix
93 .RB `` .flc ''.
94 Most
95 .B FIGlet
96 control files will be stored in
97 .B FIGlet's
98 default font directory.
100 You can store
101 .B FIGlet
102 fonts and control files
103 in compressed form.
104 See
105 .BR "COMPRESSED FONTS" .
107 .SH USAGE
108 Just start up
109 .B FIGlet
110 (type
111 .RB `` figlet '')
112 and then type whatever you want.
113 Alternatively, pipe a file or the output of another command through
114 .BR FIGlet ,
115 or put input on the command line
116 after the options.
117 See
118 .B EXAMPLES
119 for other things to do.
121 .SH OPTIONS
122 .B FIGlet
123 reads command line options from left to right, and only the last
124 option that affects a parameter has any effect. Almost every option
125 has an inverse, so that, for example, if
126 .B FIGlet
127 is customized with a shell
128 .BR alias ,
129 all the options are usually still available.
131 Commonly-used options are
132 .BR \-f ,
133 .BR \-c ,
134 .BR \-k ,
135 .BR \-t ,
136 .B \-p
137 and
138 .BR \-v .
140 .TP
141 .BI \-f \ fontfile
142 Select the font. The
143 .B .flf
144 suffix may be left off of
145 .IR fontfile ,
146 in which case
147 .B FIGlet
148 automatically appends it.
149 .B FIGlet
150 looks for the file first in the default font directory and then
151 in the current directory, or, if
152 .I fontfile
153 was given as a full pathname, in the given directory.
154 If the
155 .B \-f
156 option is not specified,
157 .B FIGlet
158 uses the font that was specified
159 when it was compiled. To find out which font this is, use the
160 .B \-I3
161 option.
163 .TP
164 .BI \-d \ fontdirectory
165 Change the default font directory.
166 .B FIGlet
167 looks for fonts first in the
168 default directory and then in the current directory.
169 If the
170 .B \-d
171 option is not specified,
172 .B FIGlet
173 uses the directory that was specified
174 when it was compiled. To find out which directory this is, use the
175 .B \-I2
176 option.
178 .TP
179 .B \-c
180 .PD 0
181 .TP
182 .B \-l
183 .PD 0
184 .TP
185 .B \-r
186 .PD 0
187 .TP
188 .B \-x
189 .PD
190 These options handle the justification of
191 .B FIGlet
192 output.
193 .B \-c
194 centers the output horizontally.
195 .B \-l
196 makes the output flush-left.
197 .B \-r
198 makes it flush-right.
199 .B \-x
200 (default) sets the justification according to whether left-to-right or
201 right-to-left text is selected. Left-to-right text will be flush-left,
202 while right-to-left text will be flush-right. (Left-to-right versus
203 right-to-left text is controlled by
204 .BR \-L ,
205 .B \-R
206 and
207 .BR \-X .)
209 .TP
210 .B \-t
211 .PD 0
212 .TP
213 .BI \-w \ outputwidth
214 .PD
215 These options control the
216 .IR outputwidth ,
217 or the screen width
218 .B FIGlet
219 assumes when formatting its output.
220 .B FIGlet
221 uses the
222 .I outputwidth
223 to determine when to break lines and how to center
224 the output. Normally,
225 .B FIGlet
226 assumes 80 columns so that people with wide terminals
227 won't annoy the people they e-mail
228 .B FIGlet
229 output to.
230 .B \-t
231 sets the
232 .I outputwidth
233 to the terminal width. If the terminal width cannot be determined,
234 the previous
235 .I outputwidth
236 is retained.
237 .B \-w
238 sets the
239 .I outputwidth
240 to the given integer. An
241 .I outputwidth
242 of 1 is a special value that tells
243 .B FIGlet
244 to print each non-space FIGcharacter, in its entirety, on a separate line,
245 no matter how wide it is.
247 .TP
248 .B \-p
249 .PD 0
250 .TP
251 .B \-n
252 .PD
253 These options control how
254 .B FIGlet
255 handles newlines.
256 .B \-p
257 puts
258 .B FIGlet
259 into ``paragraph mode'', which eliminates some unnecessary line
260 breaks when piping a multi-line file through
261 .BR FIGlet .
262 In paragraph mode,
263 .B FIGlet
264 treats line breaks within a paragraph as if they were merely blanks
265 between words. (Specifically,
266 .B \-p
267 causes
268 .B FIGlet
269 to convert any newline which is not preceded by a newline and not
270 followed by a space character into a blank.)
271 .B \-n
272 (default) puts
273 .B FIGlet
274 back to normal, in which every newline
275 .B FIGlet
276 reads causes it to produce a line break.
278 .TP
279 .B \-D
280 .PD 0
281 .TP
282 .B \-E
283 .PD
284 .B \-D
285 switches to the German (ISO 646-DE) character set. Turns `[', `\e'
286 and `]' into umlauted A, O and U, respectively. `{', `|' and `}' turn
287 into the respective lower case versions of these. `~' turns into s-z.
288 .B \-E
289 turns off
290 .B \-D
291 processing.
292 These options are deprecated,
293 which means they probably will not appear
294 in the next version of
295 .BR FIGlet .
297 .TP
298 .BI \-C \ controlfile
299 .PD 0
300 .TP
301 .B \-N
302 .PD
303 These options deal with
304 .B FIGlet
305 .IR controlfiles .
306 A
307 .I controlfile
308 is a file containing a list of commands that
309 .B FIGlet
310 executes each time it reads a character. These commands can map certain
311 input characters to other characters, similar to the Unix
312 .B tr
313 command or the
314 .B FIGlet
315 .B \-D
316 option.
317 .B FIGlet
318 maintains a list of
319 .IR controlfiles ,
320 which is empty when
321 .B FIGlet
322 starts up.
323 .B \-C
324 adds the given
325 .I controlfile
326 to the list.
327 .B \-N
328 clears the
329 .I controlfile
330 list, cancelling the effect of any previous
331 .BR \-C .
332 .B FIGlet
333 executes the commands in all
334 .I controlfiles
335 in the list. See
336 the file
337 .IR figfont.txt ,
338 provided with FIGlet,
339 for details on how to write a
340 .IR controlfile .
342 .TP
343 .B \-s
344 .PD 0
345 .TP
346 .B \-S
347 .PD 0
348 .TP
349 .B \-k
350 .PD 0
351 .TP
352 .B \-W
353 .PD
354 .TP
355 .B \-o
356 .PD
357 These options control how
358 .B FIGlet
359 spaces the FIGcharacters that it outputs.
360 .B \-s
361 (default) and
362 .B \-S
363 cause ``smushing''.
364 The FIGcharacters are displayed
365 as close together as possible,
366 and overlapping sub-characters are removed.
367 Exactly which sub-characters count as ``overlapping''
368 depends on the font's
369 .IR layoutmode ,
370 which is defined by the font's author.
371 .B \-k
372 causes ``kerning''. As many blanks as possible are
373 removed between FIGcharacters, so that they
374 touch, but the FIGcharacters are not smushed.
375 .B \-W
376 makes
377 .B FIGlet
378 display all FIGcharacters at their full width,
379 which may be fixed or variable, depending on the font.
381 The difference between
382 .B \-s
383 and
384 .B \-S
385 is that
386 .B \-s
387 will not smush a font whose author specified
388 kerning or full width as the default
389 .IR layoutmode ,
390 whereas
391 .B \-S
392 will attempt to do so.
394 If there is no information in the font
395 about how to smush,
396 or if the
397 .B \-o
398 option is specified,
399 then the FIGcharacters are ``overlapped''.
400 This means that after kerning,
401 the first subcharacter of
402 each FIGcharacter is removed.
403 (This is not done if a FIGcharacter
404 contains only one subcharacter.)
406 .TP
407 .BI \-m \ layoutmode
408 Specifies an explicit
409 .I layoutmode
410 between
411 .B 1
412 and
413 .BR 63 .
414 .I Smushmodes
415 are explained in
416 .IR figfont.txt ,
417 which also provides complete information
418 on the format of a
419 .B FIGlet
420 font.
421 For the sake of backward compatibility
422 with versions of
423 .B FIGlet
424 before 2.2,
425 .B \-m0
426 is equivalent to
427 .BR \-k ,
428 .B \-m-1
429 is equivalent to
430 .BR \-W ,
431 and
432 .B \-m-2
433 is equivalent to
434 .BR \-s .
435 The
436 .B \-m
437 switch is normally
438 used only by font designers testing the various
439 .I layoutmodes
440 with a new font.
442 .TP
443 .B \-v
444 .PD 0
445 .TP
446 .BI \-I \ infocode
447 .PD
448 These options print various information about
449 .BR FIGlet ,
450 then exit. If several of these options are given on the command line, only
451 the last is executed, and only after
452 all other command-line options have been dealt with.
454 .B \-v
455 prints version and copyright information, as well as a ``Usage: ...''
456 line.
457 .B \-I
458 prints the information corresponding to the given
459 .I infocode
460 in a consistent, reliable (i.e., guaranteed to be the same in
461 future releases) format.
462 .B \-I
463 is primarily intended to be used by programs that use
464 .BR FIGlet .
465 .I infocode
466 can be any of the following.
467 .RS
468 .TP
469 .BR -1 " Normal operation (default)."
470 This
471 .I infocode
472 indicates that
473 .B FIGlet
474 should operate normally, not giving any informational printout,
475 printing its input in the selected font.
476 .TP
477 .BR 0 " Version and copyright."
478 This is identical to
479 .BR \-v .
480 .TP
481 .BR 1 " Version (integer)."
482 This will print the version of your copy of
483 .B FIGlet
484 as a decimal integer. The main version number is multiplied by 10000,
485 the sub-version number is multiplied by 100, and the sub-sub-version
486 number is multiplied by 1. These are added together, and the result is
487 printed out. For example,
488 .B FIGlet
489 2.2 will print
490 .RB `` 20200 ''
491 , version 2.2.1 will print
492 .RB `` 20201 ''.
493 Similarly, version 3.7.2 would print
494 .RB `` 30702 ''.
495 These numbers are guaranteed to be
496 ascending, with later versions having higher numbers. Note that
497 the first major release of
498 .BR FIGlet ,
499 version 2.0, did not have the
500 .B \-I
501 option.
502 .TP
503 .BR 2 " Default font directory."
504 This will print the default font directory. It is affected by the
505 .B \-d
506 option.
507 .TP
508 .BR 3 " Font."
509 This will print the name of the font
510 .B FIGlet
511 would use. It is affected by
512 the
513 .B \-f
514 option.
515 This is not a filename; the
516 .RB `` .flf ''
517 suffix is not printed.
518 .TP
519 .BR 4 " Output width."
520 This will print the value
521 .B FIGlet
522 would use for
523 .IR outputwidth ,
524 the number of columns wide
525 .B FIGlet
526 assumes the screen is.
527 It is affected by the
528 .B \-w
529 and
530 .B \-t
531 options.
532 .TP
533 .BR 5 " Supported font formats."
534 This will list font formats supported by
535 .B FIGlet .
536 Possible formats are
537 .RB `` flf2 ''
538 for FIGfont Version 2
539 .B .flf
540 files and
541 .RB `` tlf2 ''
542 for TOIlet
543 .B .tlf
544 files.
545 .RE
546 .IP
547 If
548 .I infocode
549 is any other positive value,
550 .B FIGlet
551 will simply exit without printing anything.
553 .TP
554 .B \-L
555 .PD 0
556 .TP
557 .B \-R
558 .PD 0
559 .TP
560 .B \-X
561 .PD
562 These options control whether
563 .B FIGlet
564 prints left-to-right or right-to-left.
565 .B \-L
566 selects left-to-right printing.
567 .B \-R
568 selects right-to-left printing.
569 .B \-X
570 (default) makes
571 .B FIGlet
572 use whichever is specified in the font file.
574 Once the options are read,
575 if there are any remaining words on the command line,
576 they are used instead
577 of standard input as the source of text.
578 This feature
579 allows shell scripts to generate large letters without having to dummy
580 up standard input files.
582 An empty argument, obtained by two sequential quotes,
583 results in a line break.
585 .SH EXAMPLES
586 To use
587 .B FIGlet
588 with its default settings, simply type
589 .RS
590 .nf
591 .ft B
593 example% figlet
595 .ft R
596 .fi
597 .RE
598 and then type whatever you like.
600 To change the font, use the
601 .B \-f
602 option, for example,
603 .RS
604 .nf
605 .ft B
607 example% figlet \-f script
609 .ft R
610 .fi
611 .RE
613 Use the
614 .B \-c
615 option if you would prefer centered output:
616 .RS
617 .nf
618 .ft B
620 example% figlet \-c
622 .ft R
623 .fi
624 .RE
626 We have found that the most common use of
627 .B FIGlet
628 is making up large text to be placed in e-mail messages. For this
629 reason,
630 .B FIGlet
631 defaults to 80 column output. If you are using a wider terminal, and
632 would like
633 .B FIGlet
634 to use the full width of your terminal, use the
635 .B \-t
636 option:
637 .RS
638 .nf
639 .ft B
641 example% figlet \-t
643 .ft R
644 .fi
645 .RE
647 If you don't want
648 .B FIGlet
649 to smush FIGcharacters into each other, use the
650 .B \-k
651 option:
652 .RS
653 .nf
654 .ft B
656 example% figlet \-k
658 .ft R
659 .fi
660 .RE
662 If
663 .B figlet
664 gets its input from a file, it is often a good idea to use
665 .BR \-p :
666 .RS
667 .nf
668 .ft B
670 example% figlet \-p < myfile
672 .ft R
673 .fi
674 .RE
676 Of course, the above can be combined:
677 .RS
678 .nf
679 .ft B
681 example% figlet \-ptk \-f shadow < anotherfile
682 example% figlet \-cf slant
684 .ft R
685 .fi
686 .RE
688 Finally, if you want to have
689 .B FIGlet
690 take the input from the command
691 line instead of a file:
692 .RS
693 .nf
694 .ft B
696 example% figlet Hello world
698 .ft R
699 .fi
700 .RE
702 .SS Other Things to Try
703 On many systems nice effects can be obtained from the
704 .B lean
705 font by piping it through
706 .BR tr .
707 Some you might want to try are the following:
709 .RS
710 .nf
711 .ft B
712 example% figlet \-f lean | tr ' _/' ' ()'
713 example% figlet \-f lean | tr ' _/' './\e\e'
714 example% figlet \-f lean | tr ' _/' ' //'
715 example% figlet \-f lean | tr ' _/' '/ '
716 .ft R
717 .fi
718 .RE
720 Similar things can be done with the
721 .B block
722 font and many of the other
723 .B FIGlet
724 fonts.
726 .SH COMPRESSED FONTS
727 You can compress the fonts and controlfiles
728 using the
729 .B zip
730 archiving program.
731 Place only one font or controlfile in each archive,
732 and rename the archive file (which will have a name
733 ending in
734 .BR .zip )
735 back to
736 .B .flf
737 or
738 .B .flc
739 as the case may be.
740 If you don't rename the file appropriately,
741 .B FIGlet
742 won't be able to find it.
744 .B FIGlet
745 does not care what the filename within the
746 .B .zip
747 archive is, and will process only the first file.
749 The
750 .B .zip
751 format was chosen because tools to create and manipulate it
752 are widely available for free
753 on many platforms.
755 .SH THE STANDARD FONTS
757 Here are a few notes about some of the fonts provided with
758 .IR FIGlet .
759 You can get many other font from the Web site
760 .br
761 http://www.figlet.org/ This location
762 should also contain the latest version of
763 .B FIGlet
764 and other related utilities.
766 The font
767 .I standard
768 is the basic
769 .B FIGlet
770 font, used when no other font is specified.
771 (This default can be changed when
772 .B FIGlet
773 is compiled on your system.)
774 The
775 .I controlfiles
776 .IR 8859-2 ,
777 .IR 8859-3 ,
778 .IR 8859-4 ,
779 and
780 .I 8859-9
781 are provided for interpreting those character sets,
782 also known as ISO Latin-2 through Latin-5 respectively.
783 The character set 8859-1 (ISO Latin-1) is
784 .B FIGlet's
785 default and requires no special
786 .IR controlfile .
788 Closely related are the fonts
789 .IR slant ,
790 .IR shadow ,
791 .IR small ,
792 .I smslant
793 (both small and slanted),
794 .IR smshadow ,
795 (both small and shadowed),
796 and
797 .IR big .
798 These fonts support only Latin-1, except that
799 .I big
800 supports Greek FIGcharacters as well;
801 the
802 .I controlfiles
803 .I frango
804 (for Greek text written in Latin characters, so-called
805 .RI `` frangovlakhika ''),
806 and
807 .I 8859-7
808 (for mixed Latin/Greek text)
809 are provided.
811 The
812 .I ivrit
813 font is a right-to-left font
814 including both Latin and Hebrew FIGcharacters;
815 the Latin characters are those of the
816 .I standard
817 font.
818 The available
819 .I controlfiles
820 are
821 .IR ilhebrew ,
822 which maps the letters you get
823 by typing on a U.S. keyboard
824 as if it were a Hebrew keyboard;
825 .IR ushebrew ,
826 which makes a reasonable mapping from
827 Latin letters to Hebrew ones;
828 and
829 .IR 8859-8 ,
830 which supports mixed Latin/Hebrew text.
831 .B Warning:
832 .B FIGlet
833 doesn't support bidirectional text,
834 so everything will come out right-to-left,
835 even Latin letters.
837 The fonts
838 .IR terminal ,
839 .IR digital ,
840 and
841 .I bubble
842 output the input character with some decoration around it
843 (or no decoration,
844 in the case of
845 .IR terminal ).
846 The characters coded 128 to 159,
847 which have varying interpretations, are output as-is.
848 You can use the appropriate
849 .I controlfiles
850 to process Latin-2, Latin-3, or Latin-4 (but not Latin-5) text,
851 provided your output device
852 has screen or printer fonts that
853 are appropriate for these character sets.
855 Two script fonts are available:
856 .IR script ,
857 which is larger than
858 .IR standard ,
859 and
860 .IR smscript ,
861 which is smaller.
863 The font
864 .I lean
865 is made up solely of `/' and `_' sub-characters;
866 .I block
867 is a straight (non-leaning) version of it.
869 The font
870 .I mini
871 is very small, and especially suitable for e-mail signatures.
873 The font
874 .I banner
875 looks like the output of the
876 .B banner
877 program;
878 it is a capitals and small capitals font
879 that doesn't support the ISO Latin-1 extensions
880 to plain ASCII.
881 It does, however, support the Japanese
882 .I katakana
883 syllabary;
884 the
885 .I controlfile
886 .I uskata
887 maps the upper-case and lower-case Latin letters
888 into the 48 basic
889 .I katakana
890 characters,
891 and the
892 .I controlfile
893 .I jis0201
894 handles JIS 0201X (JIS-Roman)
895 mixed Latin and
896 .I katakana
897 text.
898 Furthermore, the
899 .I banner
900 font also supports Cyrillic (Russian)
901 FIGcharacters; the
902 .I controlfile
903 .I 8859-5
904 supports mixed Latin and Cyrillic text,
905 the
906 .I controlfile
907 .I koi8r
908 supports the popular KOI8-R mapping of mixed text,
909 and the
910 .I controlfile
911 .I moscow
912 supports a
913 sensible mapping from Latin to Cyrillic,
914 compatible with the
915 .I moscow
916 font (not supplied).
918 The fonts
919 .I mnemonic
920 and
921 .I safemnem
922 support the mnemonic character set
923 documented in RFC 1345.
924 They implement a large subset of Unicode
925 (over 1800 characters) very crudely,
926 using ASCII-based mnemonic sequences,
927 and are good for getting a quick look
928 at UTF-8 unicode files,
929 using the controlfile
930 .IR utf8 .
932 .SH ENVIRONMENT
933 .TP
934 .B FIGLET_FONTDIR
935 If
936 .RB $ FIGLET_FONTDIR
937 is set, its value is used as a path to search for font files.
939 .SH FILES
940 .PD 0
941 .TP 20
942 .IB file .flf
943 .B FIGlet
944 font file
945 .TP 20
946 .IB file .flc
947 .B FIGlet
948 control file
949 .PD
951 .SH DIAGNOSTICS
952 .B FIGlet's
953 diagnostics are intended to be self-explanatory. Possible
954 messages are
956 .RS
957 .nf
958 .ft B
959 Usage: ...
960 Out of memory
961 Unable to open font file
962 Not a FIGlet 2 font file
963 Unable to open control file
964 Not a FIGlet 2 control file
965 "\-t" is disabled, since ioctl is not fully implemented.
966 .ft R
967 .fi
968 .RE
970 This last message is printed when the
971 .B \-t
972 option is given, but the operating system in use does not include
973 the system call
974 .B FIGlet
975 uses to determine the terminal width.
977 .B FIGlet
978 also prints an explanatory message if the
979 .B \-F
980 option is given on the command line.
981 The earlier version of
982 .BR FIGlet ,
983 version 2.0, listed the available fonts when the
984 .B \-F
985 option was given. This option has been removed from
986 .B FIGlet
987 2.1. It has been replaced by the
988 .B figlist
989 script, which is part of the standard
990 .B FIGlet
991 package.
993 .SH ORIGIN
994 .RB `` FIGlet ''
995 stands for ``Frank, Ian and Glenn's LETters''. Inspired by Frank's .sig,
996 Glenn wrote (most of) it, and Ian helped.
998 Most of the standard
999 .B FIGlet
1000 fonts were inspired by signatures on various UseNet
1001 articles. Since typically hundreds of people use the same style of
1002 letters in their signatures, it was often not deemed necessary to give
1003 credit to any one font designer.
1005 .SH BUGS
1006 Very little error checking is done on font and control files. While
1007 .B FIGlet
1008 tries to be forgiving of errors, and should (hopefully) never actually
1009 crash, using an improperly-formatted file with
1010 .B FIGlet
1011 will produce unpredictable output.
1013 .B FIGlet
1014 does not handle format characters in a very intelligent way.
1015 A tab character is converted to a blank, and vertical-tab, form-feed and
1016 carriage-return are each converted to a newline. On many systems, tabs
1017 can be handled better by piping files through
1018 .B expand
1019 before piping through
1020 .BR FIGlet .
1022 .B FIGlet
1023 output is quite ugly if it is displayed in a proportionally-spaced font.
1024 I suppose this is to be expected.
1026 Please report any errors you find in this man page or the program to
1027 <info@figlet.org>
1028 .SH WEBSITE AND MAILING LIST
1029 You can get many fonts which are not in the basic
1030 .B FIGlet
1031 package from the Web site
1032 http://www.figlet.org/ It
1033 should also contain the latest version of
1034 .B FIGlet
1035 and other utilities related to
1036 .BR FIGlet .
1038 There is a mailing list for
1039 .B FIGlet
1040 for general discussions about
1041 .B FIGlet
1042 and a place where you can ask questions or share ideas
1043 with other
1044 .B FIGlet
1045 users. It is also the place where we will publish
1046 news about new fonts, new software updates etc.
1048 To subscribe or unsubscribe from the
1049 .B FIGlet
1050 mailing list,
1051 please send email to figlet-subscribe@figlet.org or figlet-unsubscribe@figlet.org or visit the
1052 following web page: http://www.figlet.org/mailman/listinfo/figlet
1054 .SH AUTHORS
1055 Glenn Chappell did most of the work.
1056 You can e-mail him but he is not an e-mail fanatic; people who e-mail
1057 Glenn will probably get answers, but if you e-mail his best friend:
1059 Ian Chai, who
1060 .I is
1061 an e-mail fanatic, you'll get answers, endless conversation about the
1062 mysteries of life, invitations to join some 473 mailing lists and a
1063 free toaster. (Well, ok, maybe not the free toaster.)
1065 Frank inspired this whole project with his .sig, but don't e-mail
1066 him; he's decidedly an un-e-mail-fanatic.
1068 Gilbert "The Mad Programmer" Healton added the
1069 .B \-A
1070 option for version 2.1.1. This option specified input from
1071 the command line; it is still allowed,
1072 but has no effect.
1074 John Cowan added the
1075 .BR \-o ,
1076 .BR \-s ,
1077 .BR \-k ,
1078 .BR \-S ,
1079 and
1080 .B \-W
1081 options, and
1082 the support for Unicode mapping tables,
1083 ISO 2022/HZ/Shift-JIS/UTF-8 input,
1084 and compressed fonts
1085 and control files.
1086 He also revised this documentation,
1087 with a lot of input from
1088 Paul Burton.
1090 Claudio Matsuoka added the support for
1091 .B .tlf
1092 files for version 2.2.4 and performs random hacks and bugfixes.
1094 As a fan of FIGlet, Christiaan Keet revised the official FIGlet documentation
1095 and set up the new FIGlet website at http://www.figlet.org/ (and the
1096 corresponding ftp://ftp.figlet.org/pub/figlet/)
1098 .SH SEE ALSO
1099 .BR figlist (6),
1100 .BR chkfont (6),
1101 .BR showfigfonts (6),
1102 .BR toilet (1)