/*
 * Author:	William Chia-Wei Cheng (william@cs.ucla.edu)
 *
 * @(#)$Header: /u/tangram/u/william/X11/TGIF2/Chinese/RCS/README,v 1.5 1993/01/05 17:48:27 william Exp $
 */

This is the ``cgif'' README file.

Cgif (Chinese tgif) is a tgif varient that supports bitmap Chinese characters
	throught the <Meta>s command.  Chinese characters are inputed through
	the use of Zhu-Yin-Fu-Hao.  Use the left mouse button to select
	the Zhu-Yin-Fu-Hao symbols; use the middle button to fetch the
	Chinese characters; use the right button as back-space for the
	Zhu-Yin-Fu-Hao symbols.  Doulbe click on a Chinese character
	to instantiate it in the drawing area.
The Chinese bitmap characters are stored in the .obj format, they are
	available in a seperate compressed tar file, "chinese-words.tar.Z".

1) The cgif distribution should be in the 'Chinese' subdirectory of the
   directory where the source of tgif can be found.  Cgif assumes that
   tgif has been built in the parent directory and that all the .o files
   are intact.  The chinese-words.tar file should be un-tared in the
   the directory where cgif is compiled (a subdirectory called "chinese-words"
   will be created).

2) Please read the tgif Copyright file for the copyright information.

3) Please read tgif.man, the man pages that comes with the tgif distribution.
   No additional documentation is provided.
	nroff -t -man tgif.man | more	<== to view
	psroff -man tgif.man		<== to print

4) Modify Makefile.noimake or Imakefile such that TGIFDIR is set to the
   directory where tgif's source code is located.

5) If you don't have imake, just do the following,
	cp Makefile.noimake Makefile
	make cgif

   If you have imake and xmkmf, do the following,
	xmkmf
	make cgif

'Sample.obj' contains a sample address book.  <Meta>x can be used to
perform some functions:  (This only works if the file is organized
similar to 'Sample.obj'.  The files portrait_1.obj and portrait_2.obj
are required.)

	a) The "ReadExcel" entry is not valid.  The
	b) "SortDrawing" can be used to sort the content of the file
	   (according to the settings of Tgif*FirstKey, Tgif*SecondKey, and
	   Tgif*ThirdKey -- please see cgif.Xdefault for an example).
	c) "OutputMultiPage" can be used to generate multi-page output.
	d) "FilterDrawing" can be used to filter out certain entries
	   (according to the setting of Tgif*StateConstraints -- please
	   also see cgif.Xdefault for an example).
	e) "GenerateLabel" can be used to generate an ASCII label file "Labels"
	   for Excel.  The generated "Labels" file contains <CR><LF> at the
	   end of each line; this may not work with Mac.  Please compile the
	   unixtomac program and run 'unixtomac < Labels > Labels.mac'.