From: Jingbai Wang,   September 1989

J.B. Wang
1921 Letsche St.
Pittsburgh, Pa 15214
(412)-323-2060

jbw@unix.cis.pitt.edu
jwang@pittvms.bitnet


This package is a self-contain mainframe version Chinese text handler. It
includes ChText that is an Chinese editor and interpreter, ChTeX/Scribe that
is a TeX/LaTeX and Scribe preprocessor of Chinese text, Chinese->PostScript
device driver, and troff-like Chinese/English text formatter; ChViewer is to
view Chinese text on a text terminal and CzW is a utility file to translate
Chinese to and from a standard ASCII text file for telecommunication purposes.

The package is primarily designed for mainframe systems, and today, it is 
configurated for VAX/VMS and Berkeley UNIX systems. ChTeX/Scribe/WStroff part
(chtex) is also tuned for MS/PC-DOS system. chtext.c is debugged for DOS
but no compiled program is supplied yet. Consideration is also given to
Macintosh, but debugging part is not completed. Minimum debugging was done
for UNIX System V (AT & T UNIX).

The package also contains a on-line info system and the documentation files
for the included C programs. The info system consists of a C program cdoc.c
and a document list file docfile.lis that can be edited to included more
document files at any time. It is recommended that cdoc be installed prior
to ch-series.

To compile on BSD UNIX, just type
%make
or SUN UNIX
%make -f Makefile.SUN

Sometimes, it will not work properly under certain BSD versions, then you can
try 
%make -f Makefile.SUN

To compile on System V, but you can give a shot at,
%make -f Makefile.V

To compile on VMS, type

@makevms

For DOS, you need to use Huge memory model under any compiler, and some 
part of the codes may not have implemented #if for DOS options. Some C files
I still need to put in 'fseek' to avoid keeping a large array in the memory.

Contents:

chtext.c  ---  Chinese text inputter, Chinese pinyin dictionary
chtex.c   ---  Chinese Scribe, TeX
WStroff.c ---  WStroff (which is part of chtex)
chviewer.c --- Chinese Viewer
CzW.c      --- Chinese->ASCII and ASCII->Chinese encoder and decoder
psscribe.c --- PostScript file manager for Scribe .ps and WStroff .ps files
		it can cut a .ps file into smaller ones, extract a part from
		it, sort it into odd and even pages, and more
cdoc.c     --- a on-line info system to provide help and news
docfile.lis --- a list of documentation files. cdoc reads in this file to 
		locate documentation files. This file should be edited before
		you install the package.
jbwlpt.raw
README
Makefile
Makefile.SUN
Makefile.V
makevms.com
cclib.24
cclib.16
cclib.48  (too big, not included)
Ci2Dian3.chi

doc/
doc/README
doc/Makefile

doc/chtext.doc     \
doc/chtex.doc       \
doc/chviewer.doc     \
doc/CzW.doc           } documentation files for the programs
doc/psscribe.doc     /
doc/cdoc.doc        /
texint.doc  \   to be obtained from TeXGuide.tar.Z from june.cs.washington.edu
dvi2ps.doc  /    under ~/tmp of anonymous
*********************
doc/foreword.txt     -- Chinese text file, it serves as chtex -w sample file
doc/pinyin1.txt \   pinyin<->Chinese mapping part 1 
doc/pinyin2.txt /   pinyin<->Chinese mapping part 2
doc/font.hdr      -- a include file for font.txt
doc/mkdoc.c       -- a C program that can be compiled to generate 6 files below
    fonts.txt     -- it is a file to demonstrate the fonts that are useable
		   in chtex -w WStroff. It has to be translated into PostScript
		   for printing by
                 %chtex -w fonts.txt
    gbtable0.txt\
    gbtable1.txt \
    gbtable2.txt  }  GuoBiao table
    gbtable3.txt /
    gbtable4.txt/
                All above *.txt files are Chinese/English text files and 
		 need to be translated into PostScript by
		%chtex -w pinyin1.txt
		%chtex -w pinyin2.txt
		%chtex -w gbtable0.txt
		...
		%chtex -w foreword.txt

PStfms/*.tfm     % TFM files for Adobe fonts that are used by chtex -w
	    % many sites already have it. Search by TFMarea path

tfm/chfont0.tfm~chfont40.tfm

samples/chtex.mss   -- sample Chinese manuscript for ChScribe
samples/chtext.txt   -- sample Chinese manuscript for ChTeX
samples/chtex.ps   -- PostScript output of chtex.mss
samples/chtext.ps   -- PostScript output of chtext.txt
samples/chtext.pin   -- source chtext file in PinYin that you can filter
			with chtext to obtain chtext.txt
samples/chtext.Pin   -- a PinYin file generated by chtext from chtext.txt
			it can be converted back to chtext.txt with chtext
sampels/mines.txt    -- a Chinese text file generated with Chinese WordStar
			serves here as a sample file for chtex -w
			It contains minimal amount of WStroff commands and
			no fill mode is used. To convert it into PostScript
			type
			%chtex -w mines.txt
samples/ideas.txt   -- a WStroff sample file,
                        %chtex -w ideas.txt

Misssing files: TeX and LaTeX font macro files to handle fonts at
		different sizes.



Please report bugs to:

jWANG@pittvms.bitnet
jbw@cisunx.UUCP

