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.