$Id: README,v 1.4 1998/09/09 03:41:07 yjlee Exp $
h2ps - Hangul (ksc5601-1987) to PostScript converter.
http://cglab.snu.ac.kr/~yjlee/n3f/applications/h2ps.html


Copyright (c) 1998 by Lee yongjae, in dept. of Computer Science
in Seoul National University, Korea.

Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted, 
provided that the above copyright notice appear in all copies and
that both that copyright notice and this permission notice appear in
supporting documentation, and that the name of the copyright holder
not be used in advertising or publicity pertaining to distribution
of the software without specific, written prior permission.

This software is provided "as is" without express or implied warranty.


DESCRIPTION
-----------

This program codes are made from the scratch. There is no relation with a2ps
but the appearance of the output.

h2ps is a file converter to print Hangul in a simple way. The output
PostScript file is self-contained. Because it appends Hangul font, the
output PS file can be printed in everywhere with PostScript printer.

This program uses Type 1 fonts, a n3f font named "n3f-5" for hangul, and
"Times-Roman" font for english (instead of "Courier" in a2ps). So the
horizontal allocations of characters are not preserved.

h2ps folds long lines which does not fit in the output area and treats
backspace charactor to show nroff'ed man pages properly.


INSTALL
-------

Unpack the archive and just do 'make' in the directory, then you can get the
binary file "h2ps". Copy it to appropriate directory.


USAGE

usage: h2ps [ options ] [ infile [ ... ] ] ]

options:
    -l     : landscape (default)
    -p     : portrait
    -1|2|3 : 1, 2 or 3 columns (default: 2 column mode)
    -c n   : n columns (1 <= n <= 10)
    -n     : line numbering
    -f n   : font size (n is real number)
    -H     : do not display heading
    -q     : quiet
    -L     : use Letter page size (default: A4)
    -D     : do not draw decoration box and heading (default: draw decoration)
    -h     : this message

default format:
    A4 landscape, two column mode with decoration and heading.

The usage of h2ps is the similar to a2ps. If you want to print xxx which
contains hangul, do just as:

    % h2ps xxx | lp

or

    % h2ps xxx > xxx.ps
    % lp xxx.ps


CHANGES
-------

2.06	narrower margin space.
2.05	bug fix on page numbering.


COMMENT
-------

This program uses n3f resources: ncode.c and npsr.c.
You can get some resources about PostScript hangul printing with N3F (n-byte
3-BeulSik hangul font) at N3F homepage (http://cglab.snu.ac.kr/~yjlee/n3f/)

Any questions or comments are welcomed.


----------------
Lee YongJae
Email: yjlee@cglab.snu.ac.kr
Homepage: http://cglab.snu.ac.kr/~yjlee/
