March 1999. Staszek Wawrykiewicz (StaW@gust.org.pl). Public domain.

Dokumentacja po polsku (document in Polish, English version see below)

Polski:
Pakiet PLaTeX dostarcza narzedzi potrzebnych do skladu dokumentow
w jezyku polskim LaTeXem 2e.
Autorzy pakietu: Mariusz Olko i Marcin Woli\'nski.
Wiecej informacji na temat pakietu -- patrz plik czytaj.txt.

I. Przygotowanie formatu LaTeX2e do obslugi jez. polskiego
   Istnieja tu dwie metody:
   1. tzw. ,,standardowa'' i prosta: nalezy uruchomic program texconfig, 
      uaktywnic reguly dzielenia wyrazow dla jez. polskiego (usunac znak
      `%' przed plhyph.tex i ew. zablokowac takim znakiem niepozadane
      wzorce dzielenia); wygenerowany zostanie format latex.fmt zawierajacy
      wybrane wzorce dzielenia oraz mechanizm Babel; texconfig tworzy ponadto 
      dowiazanie (lub program) uruchamiane poleceniem `latex'.
   2. ,,niestandardowa'', ktora tworzy ,,czysty'' format LaTeX2e zawierajacy
      jedynie wybrane wzorce dzielenia wyrazow, bez zbednego smiecia Babel. 
      Jest to metoda preferowana przez wielu polskich uzytkownikow. ;-) 
      Wiecej informacji na ten temat w pakiecie platex: CTAN/language/polish/
   Uwaga: w podobny sposob mozna wygenerowac format pdflatex.fmt
   dla programu pdfTeX -- wersji TeX-a tworzacej od razu pliki PDF.

II. Uzycie: aktualne implementacje bazujace na webc 7.3 pozwalaja wreszcie
      na prawidlowe przekodowanie znakow diakrytycznych w pliku TeX-owym
      na wewnetrzna reprezentacje. Nareszcie przekodowanie dziala tez w druga
      strone, kiedy TeX wyswietla komunikaty i zapisuje pliki .log, .toc,
      .idx itp. Do tego celu uzywa sie zewnetrznych, czytelnych plikow TCX.
      Co wiecej, przekodowanie (plik TCX) moze byc deklarowane bezposrednio
      w pliku TeX-owym. Jesli _pierwszy_ wiersz pliku zawiera np.:
           %&latex --translate-file=il2-pl
      moze byc przetworzony za pomoca polecenia: `tex plik.tex'.
      Zostanie wtedy wczytany format latex.fmt oraz tablica il2-pl.tcx
      przekodowania z iso8859-2 (latin2) do ukladu fontow PL (wewnetrznego
      dla programu TeX). Tym samym zbedna jest deklaracja w preambule pliku
      LaTeX-owego
           \usepackage[latin2]{inputenc}
      Mozemy uzyc takze polecenia:
          `latex --translate-file=TCXFILE myfile.tex' lub wrecz
          `latex myfile.tex'
      gdy plik `myfile.tex' zawiera w pierwszym wierszu:	   
           %& --translate-file=TCXFILE
      W tej dystrybucji dostarczono szereg plikow TCX. Mozna je znalezc
      w katalogu texmf/web2c/:
        amiga-pl.tcx   AmigaPL do PL
        il2-pl.tcx     iso8859-2 (latin2) do PL
        cp1250-pl.tcx  Windows cp1250 do PL
        cp852-pl.tcx   IBM cp852 do PL
        maz-pl.tcx     Mazovia do PL

III. Polskie fonty PostScriptowe
     Dystrybucja nie zawiera wersji Type 1 fontow PL (nie dotyczy CD TeX Live).
     Fonty te mozna pobrac z najblizszego wezla CTAN lub jego kopii:
     CTAN/fonts/psfonts/polish/plpsfont/
     Pliki .pfb nalezy skopiowac do nowo utworzonego katalogu instalacji:
        texmf/fonts/type1/public/plpsfont/
     po czym nalezy zaktualizowac baze danych instalacji (`mktexlsr').
     Sterownik dvips jest przygotowany do pracy z fontami PL, wystarczy
     uruchomic:
        dvips -Pplps plik.dvi
     Po dolaczeniu zawartosci pliku texmf/dvips/config/plpsfont.map
     do pliku texmf/dvips/config/psfonts.map podawanie parametru `-Pplps'
     bedzie zbedne i polskie fonty .pfb beda ladowane przez program dvips.
     Aby fonty Type 1 byly uzyte przez program pdfTeX nalezy sprawdzic
     zawartosc pliku texmf/pdftex/config/pdftex.cfg -- powinien on zawierac
     wiersz: map +plpsfont.map

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

English:
PLaTeX provides tools to typeset documents in Polish using LaTeX2e.
Authors: Mariusz Olko & Marcin Woli\'nski.
This document describes shortly creation of latex.fmt and usage
in web2c based environement.
See readme.txt for more informations about the PLaTeX package.

I. Preparing LaTeX2e format for Polish
   There are two methods:
   1. `standard' and simple: just run texconfig and activate polish
       hyphenation patterns.  This produces latex.fmt with Babel machinery
       included.
   2. `non standard', which makes clean and generic LaTeX2e without Babel
       mess, containing only patterns for Polish and US English. This is
       prefered by many users in Poland. ;-)
       More info how to do it: see platex package on CTAN/language/polish/

II. Usage: the current implementations based on web2c 7.3 allow (hopefully)
       proper reencoding of input national characters into internal TeX's, 
       and back again, for all messages, .log, .toc, .idx files written by
       TeX, etc. External readable TCX translation files are used and they
       can be specified explicitly in the TeX file or in the command line.
       If the _first_ line of TeX's file contains a structured comment
       of the form
           %&latex --translate-file=il2-pl
       it suffice to run `tex file.tex' with latex.fmt and
       il2-pl.tcx translation table (iso8859-2 latin2 to internal PL
       reencoding). We can use TCX tables instead of LaTeX's
           \usepackage[latin2]{inputenc}
       If we use latex.fmt with Polish patterns we can compile our file
       with the command `latex --translate-file=TCXFILE myfile.tex'
       or just `latex myfile.tex' where the first line of myfile.tex contains
          %& --translate-file=TCXFILE
       Several TCX files are provided in this distribution and can be found
       in texmf/web2c/ directory.

III. Polish PostScript fonts in Type 1 format
     This distribution usually do not contain Type 1 PL fonts, except
     CD TeX Live. PFB files can be dowloaded from the nearest CTAN
     node or its mirror:
         CTAN/fonts/psfonts/polish/plpsfont/
     Next, they should be copied to the newly created directory of
     our installation:
         texmf/fonts/type1/public/plpsfont/
     The final step is refreshing ls-R database of installation: `mktexlsr'.
     Dvips is already prepared for PL fonts in Type 1, just run:
         dvips -Pplps myfile.dvi
     If the contents of texmf/dvips/config/plpsfont.map is included
     into the standard texmf/dvips/config/psfonts.map, `-Pplps' is not even
     needed.
     In order to use Type 1 fonts with pdfTeX check the contents
     of texmf/pdftex/config/pdftex.cfg: the line
         map +plpsfont.map 
     should be included in this file.

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