In order to make, just type make.
You should have gcc.

If you find some errors or something, please let me know.

You should have font files in order to use this simple package.

For example, You can find the font files, the bdf files, at the location of
ftp://ftp.kreonet.re.kr/pub/X11/ftp.x.org/pub/R6.3/xc/fonts/bdf
You do not need to download all the font files at your hard disk.
Download selectively.

The font files that I used can be found at the location of
ftp://sensor.kaist.ac.kr/pub/hbanner/sample.fonts


To see how to use this package, see the files demo*.



------------------------------------------------------------------------------

[0] USAGE of banner:



In order to use banner, just type "banner some.bdf.file", for example,
"banner courB18.bdf".

The default column number is 80, and this value can be overrided by an
option "-size #" where # is any number that you want.  "-size 120" means
that the banner will try to wrap the output at the 120th column.  If you
give "-size 0", then banner will not wrap at all.

You can type anything as an input, but A SPECIAL CHARACTER '\' ACTS AS
AN ESCAPE CHARACTER.  For example,

You typed	The output.

I love you	"I love you"
\		"\"
\\		"\"
\*		"*"
*		"*"
\aacute		"a acute"
\onehalf	"1/2"
!		"!"
\exclam		"!"
"		"""
\quotedbl	"""
etc..

Here "\onehalf" and "\onehalf;" means the same thing "1/2".  The optional
character ';' of "\onehalf;" is to terminate "\onehalf".  This TERMINATOR
character ';' can be omitted when there is no ambiguity.

The names like "aacute" and "onehalf" are specified at the input .bdf file.
Following is the list of those of courB18.bdf
-------------
space		N		bar		Edieresis	ugrave
exclam		O		braceright	Igrave		uacute
quotedbl	P		asciitilde	Iacute		ucircumflex
numbersign	Q		space		Icircumflex	udieresis
dollar		R		exclamdown	Idieresis	yacute
percent		S		cent		Eth		thorn
ampersand	T		sterling	Ntilde		ydieresis
quoteright	U		currency	Ograve		Lslash
parenleft	V		yen		Oacute		OE
parenright	W		brokenbar	Ocircumflex	Scaron
asterisk	X		section		Otilde		Ydieresis
plus		Y		dieresis	Odieresis	Zcaron
comma		Z		copyright	multiply	breve
minus		bracketleft	ordfeminine	Oslash		bullet
period		backslash	guillemotleft	Ugrave		caron
slash		bracketright	logicalnot	Uacute		circumflex
zero		asciicircum	hyphen		Ucircumflex	dagger
one		underscore	registered	Udieresis	daggerdbl
two		quoteleft	macron		Yacute		dotaccent
three		a		degree		Thorn		dotlessi
four		b		plusminus	germandbls	ellipsis
five		c		twosuperior	agrave		emdash
six		d		threesuperior	aacute		endash
seven		e		acute		acircumflex	fi
eight		f		mu		atilde		fl
nine		g		paragraph	adieresis	florin
colon		h		periodcentered	aring		fraction
semicolon	i		cedilla		ae		grave
less		j		onesuperior	ccedilla	guilsinglleft
equal		k		ordmasculine	egrave		guilsinglright
greater		l		guillemotright	eacute		hungarumlaut
question	m		onequarter	ecircumflex	lslash
at		n		onehalf		edieresis	oe
A		o		threequarters	igrave		ogonek
B		p		questiondown	iacute		perthousand
C		q		Agrave		icircumflex	quotedblbase
D		r		Aacute		idieresis	quotedblleft
E		s		Acircumflex	eth		quotedblright
F		t		Atilde		ntilde		quotesinglbase
G		u		Adieresis	ograve		quotesingle
H		v		Aring		oacute		ring
I		w		AE		ocircumflex	scaron
J		x		Ccedilla	otilde		tilde
K		y		Egrave		odieresis	trademark
L		z		Eacute		divide		zcaron
M		braceleft	Ecircumflex	oslash
-------------

If you want to see the above list more dynamically, please visit
ftp://sensor.kaist.ac.kr/pub/xfed-1.0.tar.gz


------------------------------------------------------------------------------
[1] USAGE of hbanner---------korean version of banner

options:
	-ko hangle.bdf.font.file.name
	-en english.bdf.font.file.name
	-size #

where # is the desired column number.  See the Usage of banner to see the
meaning of this #.  Default values of the font file names are HARD-CODED as

default hangul.bdf.font.file.name = johabshg16.bdf
default english.bdf.font.file.name = courB18.bdf

A SPECIAL CHARACTER '\' ACTS AS A ESCAPE CHARACTER.
\1234 stands for the character whose encoding is 1234 in hangul font.
\something stands for the character whose character name is "something" in
	english font.

If you want to see the encoding number of a character more dynamically,
please visit ftp://sensor.kaist.ac.kr/pub/xfed-1.0.tar.gz

please see the file named demo.hbanner

------------------------------------------------------------------------------
[2] USAGE of mkbit

usage: mkbit any.ascii.file

If you saved the result of the banner or hbanner program, you can tranform
the result into xbm, and xpm format automatically using mkbit.

You should better see the demo.mkbit file to see how to use this mkbit program.
I think the produced xbm and xpm files can be useful thing in the X-window
programming.

If you want to change the xpm and xbm file, it is better to edit the output
of banner or hbanner, then after re-editing the output, do mkbit!

Please see the source code of mkbit and demo.mkbit
