Provided by: a2ps_4.15.5-2_amd64 
NAME
ogonkify - international support for PostScript
SYNOPSIS
ogonkify [-p procset] [-e encoding] [-r Old=New] [-a] [-c] [-h] [-t] [-A] [-C] [-H] [-T]
[-AT] [-CT] [-ATH] [-CTH] [-E] [-N] [-M] [-mp] [-SO] [-AX] [-F] [-RS] [--] file ...
DESCRIPTION
ogonkify does various munging of PostScript files related to printing in different
languages. Its main use is to filter the output of Netscape, Mosaic and other programs in
order to print in languages that don't use the standard Western-European encoding (ISO
8859-1).
SUMMARY USAGE
Installation instructions are provided in the file INSTALL. Assuming the installation has
been correctly completed, save the PostScript output of Netscape or Mosaic to a file, say
output.ps. Then print it using
% ogonkify -AT -N output.ps | lpr
in the case of Netscape, or
% ogonkify -AT -M output.ps | lpr
in the case of Mosaic.
You may want to change the -AT option to -CT in order to use a high quality Courier font
from IBM (at the price of slower printing).
An alternative way to print from Netscape is to set the printing command in the printing
dialog box to:
ogonkify -AT -N | lpr
For more details, see the USAGE section below.
OPTIONS
-p Includes the specified procset in the output file.
-e Set the encoding of the output. Defaults to L2 (ISO 8859-2, a.k.a. ISO Latin-2).
Other possible values are L1 (ISO 8859-1, a.k.a. ISO Latin-1), L3 (ISO 8859-3,
a.k.a. ISO Latin-3), L4 (ISO 8859-4, a.k.a. ISO Latin-4), L5 (ISO 8859-9, a.k.a.
ISO Latin-5), L6 (ISO 8859-10, a.k.a. ISO Latin-6), L7 (ISO 8859-13, a.k.a. ISO
Latin-7), L9 (ISO 8859-15, a.k.a. ISO Latin-9), CP1250 (Microsoft Code Page 1250,
a.k.a. CeP), ibmpc (Original IBM-PC encoding), mac (Apple Macintosh encoding) and
hp (HP Roman Encoding).
-r Use the font New in place of Old. Will lead to ugly or unreadable output when the
metrics mismatch.
-a Do the right font remappings for using Courier-Ogonki in place of Courier (the a
stands for Adobe Courier). This avoids downloading any fonts to the printer.
-c Do the right font remappings for using IBM Courier in place of Adobe Courier.
-t Do the right font remappings for using Times-Roman-Ogonki in place of Times-Roman.
-h Do the right font remappings for using Helvetica-Ogonki in place of Helvetica.
-A Like -a but also downloads the Courier-Ogonki fonts.
-C Like -c, but also downloads the IBM Courier fonts.
-H Like -h, but also downloads the Helvetica-xxx-Ogonki fonts.
-T Like -t, but also downloads the Times-xxx-Ogonki fonts.
-CT Equivalent to -C -T.
-CTH Equivalent to -C -T -H.
-E Add the Euro currency sign to all standard fonts (use with -e L9).
-N Do Netscape processing.
-M Do Mosaic processing.
-mp Do mp processing. Will not work with the -A option (use -C instead).
-SO Do StarOffice processing.
-AX Do ApplixWare processing.
-F Do XFig processing.
-RS Recode standard fonts. This is likely to work with applications that leave fonts
in AdobeStandardEncoding, typically applications that do not even support printing
even of characters.
-- End options.
USAGE
Let us assume that you want to print a WWW page encoded in ISO Latin-2. Netscape
stubbornly insists on printing it as ISO Latin-1. By using the File->Print command, have
Netscape send the output to a file, say alamakota.ps.
As ogonkify is configured for ISO Latin-2 by default, passing it the PostScript generated
by Netscape will correct the encoding of the fonts. It is enough to do:
% ogonkify -N <alamakota.ps | lpr
However, most printers do not have fonts with the needed characters installed; synthesized
fonts will be downloaded and used instead of Courier and Times-Roman with -AT, and a very
good Courier font from IBM will be used with: -CT. The command will therefore typically
be:
% ogonkify -N -AT <alamakota.ps | lpr
or eventually
% ogonkify -N -CT <alamakota.ps | lpr
Typical usage with other programs is:
% ogonkify -M -AT <alamakota.ps | lpr
% ogonkify -mp -AT <alamakota.ps | lpr
% ogonkify -SO -AT <alamakota.ps | lpr
% ogonkify -AX -ATH <alamakota.ps | lpr
% ogonkify -XF -ATH <alamakota.ps | lpr
BUGS
Characters with an `ogonek' should be constructed differently (for instance, the `ogonek'
used with an `a' should be differently shaped than the one used with an `e'.)
It would be better to patch the programs we have the sources to than to post-process the
produced PostScript.
The program is written in Perl.
NOTES
In order to view the output PostScript with Ghostscript, you might need to run gs with the
flag -dNOPLATFONTS, and ghostview with the flag -arguments -dNOPLATFONTS.
Netscape, IBM, Adobe, PostScript, StarOffice, ApplixWare and possibly others are
registered trademarks.
THANKS
Much of the composite character data have been provided by Primoz Peterlin, H. Turgut
Uyar, Ricardas Cepas, Kristof Petrovay and Jan Prikryl.
Jacek Pliszka provided the support for StarOffice. Andrzej Baginski provided the support
for ApplixWare.
Markku Rossi wrote genscript and provided many useful encoding vectors with the
distribution.
Throughout writing the Postscript code, I used the ghostscript interpreter, by Peter
Deutsch.
Larry Wall wrote perl, the syntax and semantics of which are a never ending source of
puzzlement.
AUTHOR
Juliusz Chroboczek <jec@dcs.ed.ac.uk>, with help from loads of people.