tops - text filter into PostScript, shell script version
revision: 20010928

Copyright (C) 2001 Taiji Yamada <taiji@aihara.co.jp>
This program is provided under BSD license.


HOW TO INSTALL
--------------
	$ make PREFIX=/usr/local
	$ su
	# make PREFIX=/usr/local install


HOW TO USE
----------
	$ tops -2       -I big5         [files...] | lpr
	$ tops -4 -l    -I euc-cn       [files...] | lpr
	$ tops -8 -tfb  -I iso-2022-jp  [files...] | lpr
	$ tops -P A5 -V -I euc-kr       [files...] | lpr
	$ tops -1       -I iso-2022-cjk [iso-2022-7bit files...] | gv -

For details, please read `tops -h`.

If you would like to test, do `make test` in this package and various
PostScript files will be generated. Please try to preview them by
using gs, gs-cjk and so on.

To customize default setting, please edit the shell script "tops".


REQUIREMENT
-----------
	<encoding>	<comments>
	b5-eten		Chinese enabled PostScript or GS
	big5		CIDFont enabled PostScript or GS, gs-cjk
	euc-china	Chinese OCF or CIDFont enabled PostScript or gs-cjk
	euc-cn		CIDFont enabled PostScript or GS, gs-cjk
	euc-japan	Japanese OCF or CIDFont enabled PostScript or gs-cjk
	euc-jp		CIDFont enabled PostScript or GS, gs-cjk
	euc-jp2		CIDFont enabled PostScript or GS, gs-cjk
	euc-korea	Korean OCF or CIDFont enabled PostScript or gs-cjk
	euc-kr		CIDFont enabled PostScript or GS, gs-cjk
	euc-tw		CIDFont enabled PostScript or GS, gs-cjk
	euccn		Chinese OCF or CIDFont enabled PostScript or GS
	eucjp		Japanese OCF or CIDFont enabled PostScript or GS
	euckr		Korean OCF or CIDFont enabled PostScript or GS
	gbk2k		Chinese enabled PostScript or GS
	hkscs		Chinese enabled PostScript or GS
	iso-2022-cjk	CJK enabled PostScript or gs-cjk, and CJK fonts
	iso-2022-cn	Chinese enabled PostScript or GS
	iso-2022-jp	Japanese enabled PostScript or GS
	iso-2022-jp2	Japanese enabled PostScript or GS, and Hojo kanji font
	iso-2022-kr	Korean enabled PostScript or GS
	iso-2022-m17n	CJK enabled PostScript or gs-cjk, and lots of fonts
	shift_jis	CIDFont enabled PostScript or GS, gs-cjk
	sjis		Japanese enabled PostScript or GS
	uhc		Korean enabled PostScript or GS
	utf8-cn		CIDFont enabled PostScript or GS, gs-cjk
	utf8-jp		CIDFont enabled PostScript or GS, gs-cjk
	utf8-kr		CIDFont enabled PostScript or GS, gs-cjk
	utf8-tw		CIDFont enabled PostScript or GS, gs-cjk
	iso-6429	-

At all encodings, ``cshow'' operator is used at permission to fold
lines, but gs-cjk (release M2-R1 and earlier) and VFlib patched GS are
unstable at handling ``cshow'' operator.

At euc-china, euc-japan and euc-korea encodings,
``(begin|end)rearrangedfont'' operator is used to compose latin and
CJK CID fonts, but gs-cjk (release M2-R1 and earlier) has not
supported ``(begin|end)rearrangedfont'' operator yet.

At all CJK encodings, in the case of vertical mode, gs-cjk (release
M2-R1 and earlier) returns an illegal value of ``stringwidth,'' so it
doesn't work.

	<encoding>	<comments>
	iso-8859-1	-
	iso-8859-2	central European fonts
#	iso-8859-3	south European fonts
#	iso-8859-4	north European fonts
	iso-8859-5	Cyrillic fonts
	#iso-8859-6	Arabic fonts
#	iso-8859-7	Greek fonts
	#iso-8859-8	Hebrew fonts
	iso-8859-9	central European fonts
#	iso-8859-10	north European fonts
	iso-8859-13	central European fonts
#	iso-8859-14	Latin8 fonts
	iso-8859-15	central European fonts
	koi8-r		Cyrillic fonts
	#mac-arabic	Arabic fonts
	mac-ce		central European fonts
	mac-croatian	Croatian fonts
	mac-cyrillic	Cyrillic fonts
#	mac-greek	Greek fonts
	#mac-hebrew	Hebrew fonts
#	mac-icelandic	Icelandic fonts
#	mac-roman	Roman fonts
#	mac-romanian	Romanian fonts
#	mac-turkish	Turkish fonts
	#ms-cp874	Thai fonts
	ms-cp1250	central European fonts
	ms-cp1251	Cyrillic fonts
	ms-cp1252	-
#	ms-cp1253	Greek fonts
	ms-cp1254	central European fonts
	#ms-cp1255	Hebrew fonts
	#ms-cp1256	Arabic fonts
	ms-cp1257	central European fonts
#	ms-cp1258	Vietnamese fonts

Encoding vectors are automatically generated from Adobe glyph list
(1.2) and mapping tables of <ftp.unicode.org>. If you find a problem
in these encoding vectors, please report it to me.

About comment-out lines, I have not yet confirmed these encodings with
actual fonts, and Right-to-left printing is not yet supported.


REPORTING BUGS
--------------
	Report bugs to <taiji@aihara.co.jp>.
