'\" t
.TH HION 1 "2/10/94"
.SH NAME
.I hion 
- hungarian language preprocessor for TeX

.SH VERSION
Release 2.5

.SH "SYNOPSIS"
.nf
hion [-FUNction=func] [-MAKe | -BUIld] [-[NO]BARs] [-ICHarset=ichar]
.in +5
[-NOHYPhen] [-GENerate=type] [-DICTionary=file] [-OCHarset=ochar]
[-[NO]FILTer] [-[NO]LIGatures] [-HELP] [-INput=file] 
[-OUTput=file] [-UMlaut=char] [-HUMlaut=char] [-APOStrophe=char] 
[-[NO]LATex] [-[NO]IGEkoto] [-[NO]SAG] [-[NO]SEG] 
[-[NO]POSTHyphen] [-[NO]PROTection] [-[NO]STATistics] 
[-[DONT_]USE_dictionary] [-DISCRetionary=mode] [-[NO]1letter] 
[-[NO]WARNings] [-[NO]BRACkets] input_file output_file
.in -5
.fi

.SH DESCRIPTION
.I HioN 
is a hungarian language preprocessor for (La)TeX written by Peter Verhas, 
based on the original program 
.I ETEX 
written by Gabor Toth. 
.I HioN 
recognizes several 'dialects', as the Babai notation (accent=', umlaut=~, 
Hungarian umlat="), the 123 notation (123 respectively), the CWI 
layouts and the ISO_Latin2 codepage.
On the output 
.I HioN 
generates a MATEX, CWI, ISO_Latin2, 123 or
.I TeX
file. 
.I HioN
also takes care about the correct hyphenation, recognizes even the
exceptional cases using a dictionary.

.RE
.SS Switches
Switches are not one character abbreviations, but usually whole words. 
However they can be abbreviated. The minimal word which is recognized by
.I HioN
is denoted by uppercase letters. The switches are case insensitive, but
the arguments are translated to uppercase. To avoid it one has to put
the arguments in quotation marks.
.TP 5
.BI \-FUNction=func
func is one of HION, HUON, HUOFF, NUMOFF, DICC. The HION convert the
input text to TeX format with hyphenation, the HUON converts the whole
input text without hyphenation. HUOFF convert the TeX text into a form
using numerical accents, NUMOFF converts the text to a form without
accents. The function DICC converts the 
.I hion.dct
ascii dictionary file to the
.I hion.dcb
binary format.
.nf
default: HION
.fi
.TP 5
.BI \-MAKe
.TP 5
.BI \-BUIld
The make flag instructs
.I HioN
to MAKE the conversion only if the input file is more recent as the 
output file. The BUILD switch forces the conversion anyway.
.nf
default: MAKE
.fi
.TP5
.BI \-[NO]BARS
The formatting characters (@ and |) are usually not written to the output.
Turning this switch on, this characters will appear on the output (mostly
used in conversion mode).
.nf
default: NOBARS
.fi
.TP5
.BI \-ICHARSET=ichar
ichar is one of BABAI, [NO]123, [NO]CWI, [NO]ISO_latin2, [NO]852. This switch
specifies the format of the input file. More than one switch can be specified
(see the Examples). A user defined table can be passed specifying a filename
for ichar. The format of the file is:

.ce 1
	ASCII code	raw_character	modifier

The ASCII code defines the character to convert. It can be given by a number
(decimal), or the character itself can be typed immediately after a backslash.
The raw_character specifies the character without the accent, and the modifier
gives the accent, namely: 256 for ', 512 for ~, and 768 for "
(in BABAI notation). The newer versions also accepts 1, 2 and 3 respectively.
The fields can be separated by any number of spaces and
tabulators.
.nf
default: BABAI, 123, CWI, DEC
.fi
.TP5
.BI \-NOHYPhen
Turns off the hyphenation facility of
.I HioN
.nf
default: hyphenation is on.
.fi
.TP5
.BI \-GENerate=[ASCii|BINary]
Specifies the format of the
.I hion.dcb
file, generated from
.I hion.dct
The ascii file is readable (for debugging purposes), but not usable by
.I HioN
.nf
default: binary
.fi
.TP5
.BI \-DICTionary=file
Specifies the file the dictionary is read from.
.nf
default: hion.dcb
.fi
.TP5
.BI \-OCHarset=ichar
ichar is one of MATEX, 123, CWI, ISO_latin2. This switch
specifies the format of the output file.
.nf
default: TEX
.fi
.TP5
.BI \-[NO]FILTer
The
.I HioN
works as a filter, that is the input is taken from the standard input, the
output is produced on standard output.
.nf
default: NOFILTER
.fi
.TP5
.BI \-[NO]LIGatures
The produced output should not confuse the TeX ligature algorithm, that is
the pairs ff fl fi should be kept together.
.nf
default: LIGATURES
.fi
.TP5
.BI \-HELP
Gives a short information on the usage of the program
.TP5
.BI \-INput=[STANdard|FILE]
Specifies the input. If STANdard is given, the input is 
taken from the standard input, otherwise the file name is the first
argument.
.TP5
.BI \-OUTput=file
Specifies the output. If STANdard is given, the output is 
written to the standard output, otherwise the second argument is name
of the output file.
.TP5
.BI \-UMlaut=char
Specifies the character used for double dots.
.nf
default: 2
.fi
.TP5
.BI \-HUMlaut
Specifies the character used for the long Hungarian umlaut
.nf
default: 3
.fi
.TP5
.BI \-APOStrophe=char
Specifies the character used for the accent.
.nf
default: 1
.fi
.TP5
.BI \-[NO]LATex
Turns on the recognition of LaTeX control sequences (does not hyphenate 
the LaTeX sequences).
.nf
default: NOLATEX
.fi
.TP5
.BI \-[NO]IGEKOTO
Turns on the recognition of prefixes to mark the proper hyphenation.
.nf
default: IGEKOTO
.fi
.TP5
.BI \-SAG
.TP5
.BI \-SEG
Turns on the recognition of postfixes SAG, SEG to mark the proper hyphenation.
The two options are equivalent.
.nf
default: SAG
.fi
.TP5
.BI \-[NO]POSTHyphen
TeX tries to hyphenate the words, which does not contain the \\- control
sequence. Some Hungarian words therefore are hyphenated improperly (such
as h\\-ogy). The switch prevents the hyphenation of such words inserting a \\-
sequence after them. WARNING:
the options does not work perfectly in that release of
.I HioN.
.nf
default: NOPOSTHYPHEN
.fi
.TP5
.BI \-[NO]PROTection
Turns on the protection of that TeX control words not beginning with \\ .
.nf
default: PROTECTION
.fi
.TP5
.BI \-[NO]STATistics
Turns on the collection of statistical information related with the
conversion. When this switch is turned on at the end of the run
.I HioN
writes out a statistics.
.nf
default: STATISTICS
.fi
.TP5
.BI \-[DONT_]USE_dictionary
When turned on, 
.I HioN
tries to load the dictionary (for the exceptions), and use it in the
hyphenation.
.nf
default: USE_DICTIONARY
.fi
.TP5
.BI \-DISCRetionary=[FULL|UNIque|NOne]
This switch controls the level of hyphenation. With UNIQUE 
.I HioN
hyphenates only the nontrivial words (ex. preprocessor for MATEX).
.nf
default: FULL
.fi
.TP5
.BI \-[NO]1LETTER
Defines the minimal length of syllables. This is 1 if the switch is turned
on, 2 otherwise.
.nf
default: NO1LETTER
.fi
.TP5
.BI \-[NO]WARNings
Turns on the warning messages.
.nf
default: WARNINGS
.fi
.TP5
.BI \-[NO]BRACkets
Specifies that the double characters of the hungarian alphabet should be
enclosed in braces {} or not. This feature is useful for processing BiBTeX
files.
.nf
default: NOBRACKETS
.fi

.SH ENVIRONMENT
.I HioN
looks for the environmental variable HION_OPT, and reads the options from it.
Use 
.ce 1
export HION_OPT="-lat -nostat"
in Bourne and Korn shell, and
.ce 1
setenv HION_OPT "-lat -nostat"
in C shell. The command line switches can change the options set by
HION_OPT.

.I HioN 
looks for the dictionary file
.I hion.dcb
in the current directory, in the user's HOME directory and in /usr/local/lib
in that order. This directories but the first could me modified by your
system administrator, so blame him if something goes wrong....

.SH EXAMPLE
1. To convert an input file hion.hun containing CWI characters into LaTeX file
hion.tex suppressing statistics
.in +5

hion -ich=cwi -ich=no123 -lat -nostat hion.hun hion.tex

.in -5
2. The same as the previous example, but using environmental variable in 
Korn (Bourne) shell
.in +5

.nf
export HION_OPT="-ich=cwi -ich=no123 -lat -nostat"
hion hion.hun hion.tex
.fi

.in -5
3. Make a conversion from BABAI notation to 123 notation
.in +5

hion -ich=babai -och=123 -nohyphen babai.hun 123.hun

.in -5
Note that the hun file switching characters | and @ are removed during
conversion.

4. Make the conversion to TeX format using own character mapping specified
in file my.map
.in +5

hion -ich=\\"my.map\\" blabla.hun

.in -5
Note the \\" sequence. The backslash prevents the " to be interpreted by the
shell, and the quote prevents the filename to be converted to uppercase by
the HioN.

.TE

.SH AUTHOR
.nf
Peter Verhas (Pe1ter Verha1s)
Currently at Digital Equipment Hungary Ltd.
Phone: (36 1) 166-8011
Fax:   (36 1) 166-9715
eMail: verhas@bpsof.enet.dec.com
.fi
Note that the development of HioN was done mainly before being employed by 
Digital and out of working hours.

The man page was written by Gabor Papp
.nf
E-mail: pg@hal9000.elte.hu
.fi

.SH "SEE ALSO"
tex(1), latex(1) , drtc(1)