summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/platex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-09 00:44:40 +0000
committerKarl Berry <karl@freefriends.org>2006-01-09 00:44:40 +0000
commitb4fc5f639874db951177ec539299d20908adb654 (patch)
tree52f08823ca58fffe3db6a9b075635038c567626c /Master/texmf-dist/doc/latex/platex
parentdec3d98ebe442d7ea93efbaa8dd2e2be8149a467 (diff)
doc 4
git-svn-id: svn://tug.org/texlive/trunk@80 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/platex')
-rw-r--r--Master/texmf-dist/doc/latex/platex/base/00readme307
-rw-r--r--Master/texmf-dist/doc/latex/platex/base/conowego.txt94
-rw-r--r--Master/texmf-dist/doc/latex/platex/base/czytaj.txt229
-rw-r--r--Master/texmf-dist/doc/latex/platex/base/platex.html316
-rw-r--r--Master/texmf-dist/doc/latex/platex/base/r22.mps78
-rw-r--r--Master/texmf-dist/doc/latex/platex/base/readme.txt26
-rw-r--r--Master/texmf-dist/doc/latex/platex/base/tstlatex.tex117
7 files changed, 1167 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/platex/base/00readme b/Master/texmf-dist/doc/latex/platex/base/00readme
new file mode 100644
index 00000000000..3ac6e0794fd
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/platex/base/00readme
@@ -0,0 +1,307 @@
+%% Staszek Wawrykiewicz (StaW@gust.org.pl), January 2003. Public domain.
+%% Web2c (teTeX, fpTeX, TeX Live) and MiKTeX 2.x revision
+PLaTeX and pdfPLaTeX
+
+Dokumentacja po polsku i po angielsku (nizej).
+The documentation in Polish and in English (below).
+
+------------------------------------------------------------------------
+POLSKI (iso8859-2):
+------------------------------------------------------------------------
+
+Dokumentacja niniejsza omawia pokrótce tworzenie formatów dla programów tex
+i pdftex (wersji TeX-a tworzącej od razu pliki PDF) ze wsparciem dla języka
+polskiego i ich użycie w środowisku opartym na web2c (dystrybucje TeX
+Live/teTeX/fpTeX) lub MiKTeX.
+
+Poniżej pokazano prosty przykład tworzenia pliku z użyciem pakietu PLaTeX.
+Pakiet ten dostarcza narzędzi potrzebnych do składu dokumentów w języku
+polskim LaTeXem 2e.
+Autorzy pakietu: Mariusz Olko i Marcin Woliński.
+Więcej informacji na temat samego pakietu -- patrz plik czytaj.txt
+dystrybucji PLaTeX.
+
+Ponadto w dystrybucjach dołączono przykładowy plik
+doc/latex/platex/tstlatex.tex. służący do przetestowania poprawnego
+działania formatu LaTeX/PLaTeX. Początkującym użytkownikom zaleca się
+zapoznanie z zawartością tego pliku. Plik ten dostępny jest także na
+serwerze GUST. Techniczne szczegóły dotyczące użycia pakietu polski.sty
+(główny element pakietu platex) dostępne są po dwukrotnym uruchomieniu:
+platex polski.dtx
+platex polski.dtx
+i wyświetleniu wynikowego polski.dvi.
+
+---------------------------------------------------------------------------
+
+I. Przygotowanie formatu LaTeX2e do obsługi języka polskiego
+
+Format w systemie TeX to wstępnie prekompilowany (aby przyspieszyć jego
+analizę przez program tex/pdftex) zestaw makrodefinicji oraz reguł
+przenoszenia wyrazów dla wybranego zestawu języków. Plik formatu z reguły
+posiada rozszerzenie .fmt. Tworzenie formatu to, w skrócie, uruchomienie
+programu tex/pdftex z opcją --ini i wczytanie odpowiedniego pliku
+inicjującego (dla LateX jest to plik latex.ltx). W LaTeX 2e zestaw reguł
+przenoszenia wyrazów jest zwyczajowo deklarowany w pliku o nazwie
+language.dat. Plik ten znajduje się zwykle w podkatalogu
+tex/generic/config/language.dat lokalnej konfiguracji systemu TeX bądź
+w identycznym podkatalogu katalogu głównego instalacji. Modyfikacja
+language.dat polega na usunięciu w tym pliku znaku komentarza `%' w wierszu
+polish plhyph.tex
+i ewentualnym zablokowaniu takim znakiem niepożądanych deklaracji wzorców
+dzielenia wyrazów. Przygotowanie formatu:
+
+ * standardowe: w teTeX należy uruchomić program texconfig, uaktywnić
+ reguły dzielenia wyrazów dla języka polskiego (menu Hyphenation
+ uruchamia edycję pliku language.dat; po zapisaniu zmian w pliku
+ i zakończeniu edycji, zostanie automatyczne wygenerowany format
+ latex.fmt zawierający wybrane wzorce dzielenia oraz mechanizm Babel
+ przełączania języków; texconfig tworzy ponadto dowiązanie (lub
+ program) latex.
+ Dla dociekliwych: powyższe odpowiada uruchomieniu z linii poleceń:
+ fmtutil --byfmt latex
+ zaś na niższym poziomie -- poleceniu
+ tex --ini --progname=latex latex.ini
+ W instalacji MiKTeX (od wersji 2.0) należy uruchomić menu MiKTeX
+ Options, zaznaczyć w podmenu Languages: polish reguły przenoszenia
+ wyrazów, po czym w menu TeX Formats wygenerować (przyciskiem Build)
+ nowy format latex.fmt, zawierający polskie wzorce.
+ Format pdflatex.fmt dla programu pdftex tworzony jest analogicznie.
+
+ * niestandardowe, które tworzy ,,czysty'' format LaTeX2e zawierający
+ jedynie wybrane wzorce dzielenia wyrazów, bez zbędnych mechanizmów
+ Babel. Jest to metoda preferowana przez wielu polskich użytkownikow.
+ ;-) Dlaczego PLaTeX a nie Babel? O tym poniżej. Dla odróżnienia
+ przyjęto nazywać taki format platex (lub pdfplatex dla pdfTeX).
+ Formaty te korzystają z ,,prywatnej'' kopii pliku language.dat
+ z zadeklarowanymi od razu polskimi i angloamerykanskimi wzorcami
+ przenoszenia wyrazów. Procedura opisana w poprzednim punkcie pozwala
+ na wygenerowanie takich formatów za pomocą programu texconfig: menu
+ Formats uruchamia edycję pliku fmtutil.cnf, należy tu odblokować
+ wiersz dotyczący formatu platex lub pdfplatex (usunąć znak # przed
+ deklaracją interesującego nas formatu) i , po zapisaniu pliku,
+ powrócić do menu nadrzędnego; ,,w tle'' zostanie wykonany program
+ fmtutil; utworzone zostanie ponadto dowiązanie platex (pdfplatex).
+ W wypadku gdy nie mamy (jeszcze) programu texconfig (fpTeX dla
+ Windows) procedura generowania formatu platex (lub pdfplatex) da się
+ przedstawić następująco:
+ 1. należy odszukać plik texmf/web2c/fmtutil.cnf (edytujemy kopię
+ tego pliku znajdującą sią w lokalnym drzewie katalogów TeX-owych
+ użytkownika lub w drzewie przeznaczonym na lokalne konfiguracje;
+ położenie właściwego pliku pokaże uruchomienie polecenia
+ kpsewhich fmtutil.cnf);
+ 2. w pliku fmtutil.cnf należy odblokować wiersz dotyczący formatu
+ platex lub pdfplatex (usunąć znak #);
+ 3. uruchomić polecenie: fmtutil --byfmt platex --dolinks (lub
+ fmtutil --byfmt pdfplatex --dolinks).
+ Dla MiKTeX (od wersji 2.0) należy uruchomić menu MiKTeX Options,
+ w podmenu TeX Formats zaznaczyć format PLaTeX (lub pdfPLaTeX)
+ i utworzyć (przyciskiem Build) potrzebne formaty.
+
+ W omawianych wyżej przypadkach tworzony jest plik formatu platex.fmt
+ (lub pdfplatex.fmt), który jest umieszczany w katalogu właściwym dla
+ tego rodzaju plików, oraz tworzony jest program platex lub pdfplatex
+ (uruchamia on program tex lub pdftex z odpowiednim formatem).
+
+Dlaczego PLaTeX a nie Babel?
+
+(Fragment ten jest cytatem z listu nadesłanego na listę dyskusyjną GUST
+przez Marcina Wolińskiego).
+W porównaniu do pakietu Babel, PLaTeX ma kilka mniej lub bardziej istotnych
+zalet:
+
+ * PLaTeX udostępnia tradycyjne definicje nazw polskich funkcji
+ trygonometrycznych \tg, \ctg, \arc i polskich znaków mniejsze-równe
+ oraz większe-równe.
+ * PLaTeX umie poprawne przenosić wyrazy złożone (tj. takie jak np.
+ biało-czerwony) udostępniając do tego celu polecenie \dywiz.
+ * PLaTeX wstawia prawidłowe odstępy na końcu zdania.
+ * Babel nie wspiera do końca fontów w układzie OT4 (fontów PL), co
+ powoduje, że polskie znaki diakrytyczne w wyrazach wstawianych
+ automatycznie przez LaTeX (dokładnie ,,ę'' w słowie część oraz ,,ą''
+ w słowie ,,załącznik'') sklejane z dwóch znaków. Jest to drobny, ale
+ ciągle nie usunięty błąd. (Można go poprawić samodzielnie dokonując
+ niewielkiej modyfikacji pliku polish.sty z dystrybucji pakietu Babel.)
+ Obwiedniowe fonty OT4 są niezastąpione przy tworzeniu plików
+ w formacie PDF.
+
+Podsumowując: jeżeli nie potrzebujemy środowiska wielojęzycznego to dużo
+mniejsza objętość pakietu PLaTeX oznacza także mniejszą liczbę błędów
+i potencjalnych kolizji z innymi częściami LaTeXa.
+[achiwum GUST-L, list z 06/06/1997]
+---------------------------------------------------------------------------
+
+II. Użycie
+
+Aktualne implementacje, oparte na Web2c, a także MiKTeX pozwalają na
+prawidłowe przekodowanie znaków diakrytycznych w pliku TeX-owym na
+wewnętrzną reprezentację, stosowaną przez programy. W Polsce, niestety,
+stosowane są różne ,,standardy'' kodowania diakrytyków w tworzonych przez
+użytkownika plikach, zależnie od systemu operacyjnego. Dla potrzeb systemu
+TeX używamy zewnętrznych, tekstowych plików TCX, pozwalających ,,obsłużyć''
+różne spotykane ,,standardy''. Dzięki temu przekodowanie działa też w drugą
+stronę, kiedy TeX wyświetla komunikaty i zapisuje pliki .log, a także pliki
+ze spisem treści, skorowidzem itp.
+
+Uruchomienie polecenia:
+latex --translate-file=TCXFILE myfile.tex
+oznacza uruchomienia TeX-a z formatem latex.fmt i z odpowiednią tablicą
+przekodowań (ich lista znajduje się poniżej). W identyczny sposób
+uruchamiamy polecenie platex.
+
+Przekodowanie (plik TCX) może być deklarowane bezpośrednio w pliku
+TeX-owym. Począwszy od wersji Web2c 7.4, wymaga to podania w wierszu
+poleceń opcji --parse lub włączenia jej na stałe, co wymaga zmiany
+w głównym pliku konfiguracyjnym texmf.cnf:
+parse_first_line = t
+(t -- od `true', zamiast domyślnego przypisania f -- od `false').
+
+Przykładowo, jeśli pierwszy wiersz pliku zawiera komentarz strukturalny
+postaci
+%&platex --translate-file=il2-pl
+to plik może być przetworzony za pomocą polecenia tex plik.tex; zostanie
+wtedy wczytany format platex.fmt oraz tablica il2-pl.tcx przekodowania
+z układu iso8859-2 (latin2) do układu fontów PL (wewnętrznego dla programu
+TeX; w LaTeX-u ma on kryptonim OT4).
+
+Tym samym zbędne są deklaracje w preambule pliku LaTeX-owego:
+\usepackage[latin2]{inputenc}
+\usepackage[OT4]{fontenc}
+
+W dystrybucjach dostarczono szereg plikow TCX. Można je znaleźć w katalogu
+texmf/web2c/:
+ amiga-pl.tcx AmigaPL do PL
+ il2-pl.tcx iso8859-2 (latin2) do PL
+ cp1250pl.tcx Windows cp1250 do PL
+ cp852-pl.tcx IBM cp852 do PL
+ macce-pl.tcx Apple MacCE do PL
+ maz-pl.tcx Mazovia do PL
+
+A oto przykład pliku LaTeX-owego:
+
+ %& --translate-file=cp1250pl
+ \documentclass[a4paper]{article}
+ \usepackage{polski}
+ \begin{document}
+ Polskie literki piszemy w standardzie Windows cp1250: .....
+ \end{document}
+
+Jak widać, nasz plik ma krótką preambułę -- pakiet polski korzysta
+domyślnie z zainstalowanych fontów PL (odpowiada mu układ OT4, więc zbędna
+jest deklaracja \usepackage[OT4]{fontenc}). Jeśli korzystamy
+z fontów EC nasza preambuła powinna zawierać dodatkowy wiersz:
+\usepackage[T1]{fontenc}
+
+III. Polskie fonty PostScriptowe
+
+Aktualne dystrybucje zawierają fonty serii PL (spolonizowane standardowe
+dla TeX-a fonty CM) w wersji Type 1 (postscriptowe). Można je także znaleźć
+w najbliższym węźle CTAN lub jego kopii, np.:
+ftp://sunsite.icm.edu.pl/CTAN/fonts/psfonts/polish/plpsfont/.
+Pliki .pfb powinny znaleźć się w podkatalogu texmf/fonts/type1/public/pl/
+naszej instalacji, zaś pliki map fontowych (.map) oraz wektory kodowań
+(.enc) -- w katalogu texmf/dvips/pl/
+
+W dystrybucjach opartych na Web2c zautomatyzowano, poprzez użycie programu
+updmap, proces tworzenia map fontowych dla programów dvips, pdftex
+i dvipdfm. Poniżej omówiono więc jedynie czego ten proces dotyczy.
+
+Sterownik dvips (zamieniający wynik pracy TeX-a, plik DVI, do formatu
+PostScript) wymaga aby deklaracje map fontowych (dla fontów PL konkretnie
+zawartość texmf/dvips/pl/pl.map) były dołączone do pliku
+texmf/dvips/config/psfonts.map. Mapy fontowe można alternatywnie dołączyć
+w pliku texmf/dvips/config/config.ps (lub jego lokalnej kopii), dopisując
+wiersz:
+p +pl.map
+po deklaracji głównej mapy fontowej: p psfonts.map.
+
+Aby fonty Type 1 były użyte przez program pdfTeX, należy sprawdzić jakie
+mapy fontowe są deklarowane w pliku texmf/dvips/config/pdftex.map --
+powinien on także zawierać deklaracje map fontowych dla fontów PL.
+
+W dystrybucjach wszystkie aktualnie dostępne polskie fonty Type1 są gotowe
+do użycia zarówno przez program dvips, jak i pdftex.
+
+Bardziej szczegółowe omówienie instalacji fontów Type1 zawarte jest
+w artykule Instalowanie fontów Type1/True Type.
+
+------------------------------------------------------------------------
+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 (or platex.fmt)
+for Polish and usage in MiKTeX environement.
+See readme.txt for more informations about the PLaTeX package.
+
+I. Preparing LaTeX2e format for Polish
+ There are two methods:
+ 1. `standard': just activate polish hyphenation patterns in the file
+ language.dat (menu `Hyphenation' in teTeX's texconfig or `Languages'
+ in `MiKTeX Options') and recompile latex.ltx (for MiKTeX 2.x from the
+ menu `TeX Formats'); as a result, latex.fmt including Babel machinery
+ will be generated.
+ 2. `non standard': it produces a clean and generic LaTeX2e without Babel
+ deadwood, containing only patterns for Polish and US English; this
+ method is prefered by many users in Poland. ;-)
+ The distribution allows to generate such a format: platex.fmt
+ (or pdfplatex.fmt) from teTeX's texconfig `Formats' menu (for MiKTeX
+ `TeX Formats' menu).
+
+II. Usage: the current implementations based on web2c, and MiKTeX
+ 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 we use latex.fmt with Polish patterns we can compile our file
+ with the command `latex --translate-file=TCXFILE myfile.tex'.
+ If the parse_fist_line is enabled (`--parse' option in the command line
+ or, permanently, parse_fist_line=t in texmf.cnf)
+ and the *first* line of TeX's file contains a structured comment
+ of the form
+ %&platex --translate-file=il2-pl
+ it suffices to run `tex file.tex' with platex.fmt and il2-pl.tcx
+ translation table (iso8859-2 to internal PL reencoding, which in fact
+ is recognized as LaTeX's OT4).
+ You can use TCX tables instead of LaTeX's
+ \usepackage[latin2]{inputenc}
+ \usepackage[OT4]{fontenc}
+ We can make a `platex' command available making on Unix a soft link
+ to tex, or (Windows) making a copy tex.exe into platex.exe in the
+ directory containing binaries.
+ Thus `platex -translate-file=TCXFILE myfile.tex' can be used as well.
+ Several TCX files are provided; they can be found in the .../web2c/
+ directory:
+ amiga-pl.tcx AmigaPL <--> PL encoding
+ il2-pl.tcx iso8859-2 (latin2) <--> PL encoding
+ cp1250pl.tcx Windows cp1250 <--> PL encoding
+ cp852-pl.tcx IBM cp852 <--> PL encoding
+ macce-pl.tcx Apple MacCE <--> PL
+ maz-pl.tcx Mazovia <--> PL encoding
+
+III. Polish PostScript fonts in Type 1 format
+ The installation can already contain Type 1 PL fonts;
+ they can be also downloaded from the nearest CTAN node or its mirror:
+ CTAN//fonts/psfonts/polish/plpsfont/
+ or copied from the CD TeX Live.
+ .pfb files should reside in the directory: .../fonts/type1/public/pl/ ;
+ font map and encoding files should go to .../dvips/pl/ directory.
+
+ The preparation of map files are now automatized by running updmap
+ program.
+
+ Dvips can be prepared for using PL fonts in Type 1 format in two ways:
+ * the contents of texmf/dvips/pl/pl.map should be included
+ into the standard texmf/dvips/config/psfonts.map.
+ * in texmf/dvips/config/config.ps the additional map file can be
+ declared after standard `p psfonts.map' line:
+ p +pl.map
+
+ In order to use Type 1 fonts with pdfTeX, the contents of
+ texmf/dvips/config/pdftex.map file can be updated with
+ the contents of pl.map, or the line
+ map +pl.map
+ can be added to the file texmf/pdftex/config/pdftex.cfg.
+
+---------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/platex/base/conowego.txt b/Master/texmf-dist/doc/latex/platex/base/conowego.txt
new file mode 100644
index 00000000000..aa4621095f2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/platex/base/conowego.txt
@@ -0,0 +1,94 @@
+Zmiany w pakiecie PLaTeX
+========================
+
+Wersja 1.3.1 (2003/05/09):
+==========================
+
+* Niekompatybilna zmiana makra \today: już nie ma ' roku' na końcu.
+ Poprzednie zachowanie można uzyskać za pomocą opcji pakietu 'roku'.
+ Opcja 'r.' daje wariant '9 maja 2003 r.'.
+
+Wersja 1.3.0 (2003/03/19):
+==========================
+
+* Z tajemniczych powodów cotangens nazywał się \ctan zamiast \cot.
+ Poprawione.
+* Dodana funkcja \nwd jako tłumaczenie \gcd.
+* Dodana opcja QX (analogiczna do OT4 i T1).
+* Polecenia \mathit, \mathbf, ... będą działać poprawnie z polskimi
+ znakami, o ile użyte z TCX.
+* Nowe opcje prefixinginverb i noprefixinginverb.
+
+Wersja 1.2.4:
+=============
+
+* Poprawiony błąd w trybie \prefixing: /l i /L zżerało odstępy w
+ spisie treści (zgłosił Bogusław Jackowski, dzięki!)
+
+Wersja 1.2.3:
+=============
+
+* Poprawiony błąd w trybie \prefixing: // powodowało błędy w spisie treści
+* Nowa wersja układu QX zawiera znak Euro
+
+Wersja 1.2.2:
+=============
+
+* Poprawiony błąd w opcji MeX związany z makrem \=
+
+Wersja 1.2.1:
+=============
+
+* dodany plik qxenc.def definiujacy układ fontow QX
+* drobne zmiany dokumentacji
+* wylaczono tworzenie pliku ot4enc.def, poniewaz jest on juz w
+ dystrybucji LaTeXa (dla starszych dystrybucji wystarczy usunac
+ komentarz w oznaczonym miejscu pliku platex.ins)
+
+Wersja 1.2:
+============
+
+* rozpowszechniana na zasadach LaTeX Project Public License
+* zmienione wszystkie pliki .fd odwzorowujace LaTeXowe nazwy krojow
+ pisma w nazwy plikow metrycznych. Nowe definicje pozwalaja na
+ zaladowanie fontow PL w dowolnym stopniu pisma. Pliki sa zgodne ze
+ starymi w tym sensie, ze wszystkie uprzednio dostepne kombinacje
+ kroj/grubosc/odmiana/stopien powoduja zaladowanie tego samego fontu,
+ co poprzednio
+* nowe polecenia \pauza i \ppauza generujace pauze i polpauze z
+ dwupunktowymi odstepami
+* zmienione makro \seename (uzywane przez makeidx.sty w pozycjach
+ odsylaczowych skorowidza) (bylo ,,Patrz'', jest ,,zob.'')
+* zmienione \refname na ,,Literatura'' i \bibname na ,,Bibliografia''
+* drobne poprawki: bardziej robustna procedura hyphen.cfg
+
+
+Wersja 1.01:
+============
+
+* nowe polecenie \selecthyphenation umozliwiajace zmiane uzywanych
+ wzorcow dzielenia wyrazow (krotkie wstawki w obcych jezykach)
+* poprawione w formacie bledne wartosci \*hyphenmin dla angielskiego
+
+
+Wersja 1.0:
+============
+
+* zmiana nazwy --- dawniej ,,Po polsku''
+* nowy sposob generowania formatu, konfiguracja przy pomocy pliku
+ language.dat
+* dokumenty uzywajace pakietu beda sie poprawnie skladac przy pomocy
+ formatu wygenerowanego przez Babel
+* format wygenerowany przy pomocy hyphen.cfg z PLaTeXa pozwala na
+ poprawny sklad dokumentow uzywajacych pakietu babel
+* zostala ulepszona zgodnosc PLaTeXa z MeXem/LaMeXem
+* dostosowano nazwy plikow do zmienionego standardu LaTeXa ---
+ wszystkie nazwy sa pisane wylacznie minuskulami
+* wyeliminowano pewna ilosc bledow (np. blad w pierwszej formule w
+ dokumentach skladanych z uzyciem fontow PL; w trybie zgodnosci z
+ MeXem problem z uzyciem \= w przypisach)
+* deklaracja \prefixing jest teraz lokalna
+* dodano dwa pakiety (plprefix i ot1patch) wspomagajace sklad w
+ trudnych warunkach (tj. gdy standardowy sposob instalacji PLaTeXa z
+ jakichs powodow jest nieodpowiedni)
+
diff --git a/Master/texmf-dist/doc/latex/platex/base/czytaj.txt b/Master/texmf-dist/doc/latex/platex/base/czytaj.txt
new file mode 100644
index 00000000000..15c53504392
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/platex/base/czytaj.txt
@@ -0,0 +1,229 @@
+**********************************************************************
+* *
+* PLaTeX czyli LaTeX2e po polsku *
+* *
+* *
+* *
+* Copyright (C) 1994 by Mariusz Olko. *
+* Copyright (C) 1997 by Mariusz Olko and Marcin Woli\'nski. *
+* Copyright (C) 2000,2002,2003 by Marcin Woli\'nski. *
+* *
+**********************************************************************
+
+
+--- Informacje ogolne
+
+Pakiet PLaTeX dostarcza narzedzi potrzebnych do skladu dokumentow
+w jezyku polskim LaTeXem 2e. Glowne cechy pakietu
+
+* wspiera sklad czcionkami `pl' pochodzacymi z pakietu MeX
+* wspiera sklad czcionkami w ukladzie T1 znanymi jako czcionki EC
+* wspiera sklad czcionkami w ukladzie QX, w szczegolnosci krojami
+ 'Quasi' tworzonymi przez JNS Team
+* umozliwia skompilowanie dokumentu nawet wtedy gdy dostepne sa
+ jedynie czcionki `CM'
+* wspolpracuje z polskimi wzorcami przenoszenia
+* dziala z _formatem_ Babel z polskimi wzorcami przenoszenia
+* pozwala wygenerowac format LaTeX z polskimi wzorcami przenoszenia,
+ zgodny z Bablem ale bez jego makr
+* wspomaga notacje `ciachowa'
+* posiada tryb 99.99% zgodnosci z LaMeXem
+* wspomaga prace z roznymi wejsciowymi stronami kodowymi
+
+Dodatkowo dolaczone sa dwa style, ktore pozwola posluzyc sie
+LaTeXem 2e w najbardziej nawet nieprzyjaznym otoczeniu.
+
+* styl plprefix pozwala na uzyskanie polskich liter przy pomocy
+ notacji prefiksowej z dowolnie wybranym prefiksem (pomocny
+ np. do robienia wydrukow z CWEBa).
+* styl OT1patch dorabia ogonki wg najlepszych znanych standardow do
+ oryginalnych czcionek CM (kod Leszka Holenderskiego).
+
+Nie zachecamy do stosowania tych pakietow, poza szczegolnymi
+przypadkami.
+
+ Obecnie nie ma powodów ze strony samego TeXa żeby nie używać dla
+polskich znaków naturalnej notacji ośmiobitowej. Notacja prefiksowa
+staje się z wolna nienaturalnym dziwactwem. Wyjątek stanowią jeszcze
+pewne nieprzyjazne środowiska obliczeniowe. Na tę okoliczność
+polski.sty oferuje notację ciachową. Niezaleznie od opinii na dobor
+takiego czy innego znaku jako prefix uwazamy, ze im mniej sprzecznych
+,,standardow'' tym lepiej. Jeśli trzeba, używajcie ciacha!
+
+ Polskie znaki sa powszechnie dostepne w MeXu od lat a obecnie
+rowniez w zestawie czcionek EC dostepnych w wiekszosci dystrybucji
+TeXa i zawsze beda dawac lepsze efekty niz stosowanie protez zawartych
+w OT1patch. Poza tym uzywanie OT1patch nie pozwala na pelne
+zastosowanie polskich wzorcow przenoszenia.
+
+--- Licencja
+
+PLaTeX stanowi oprogramowanie swobodne, może być dystrybuowany w
+zgodzie z licencją LaTeX Project Public License (zob. plik lppl.txt w
+dystrybucji LaTeXa; CTAN:macros/latex/base/lppl.txt).
+
+--- Pliki wchodzace w sklad pakietu
+
+W sklad pakietu wchodzi kilka plikow zawierajacych udokumentowane
+(w wiekszosci :-) zrodla makr.
+
+* polski.dtx - zawiera zrodla pakietu polski
+* strony.dtx - plik z wejsciowymi stronami kodowymi dla LaTeXa oraz
+ definicja ukladu czcionek OT4
+* plfonts.fdd - definicje czcionek `PL' do wykorzystania w LaTeXu
+* platex.ins - glowny skrypt instalacyjny
+* polski.ins - skrypt generujacy podstawowe pliki pakietu
+* plprefix.dtx - zawiera zrodla stylu pozwalajacego na uzyskiwanie
+ polskich liter przy pomocy znakow innych niz /
+* plprefix.ins - skrypt instalacyjny dla plprefix.sty
+* ot1patch.dtx - zawiera zrodla stylu dorabiajacego ogonki
+ do czcionek CM
+* ot1patch.ins - skrypt instalacyjny dla ot1patch.sty
+* czytaj.txt - ten plik
+* readme.txt - opis instalacji po angielsku
+* conowego.txt - lista zmian w pakiecie
+
+--- Instalacja pakietu
+
+Po rozpakowaniu pakietu nalezy wygenerowac wszystkie potrzebne pliki
+uruchamiajac skrypt platex.ins
+ tex platex.ins
+Skrypt wygeneruje na poczatek podstawowe pliki pakietu tzn. styl
+polski.sty, plik konfigurujacy wzorce przenoszenia wyrazow wczytywane
+przez LaTeX oraz opisy wejsciowych stron kodowych. Nastepnie
+uzytkownik jest pytany czy ma zainstalowane czcionki `PL' pochodzace z
+instalacji MeXa. Jesli czcionki sa zainstalowane, generowane sa pliki
+definiujace polskie czcionki dla LaTeXa. Jesli czcionki nie sa
+zainstalowane w systemie, nalezy zadbac aby nie bylo tez pliku
+ot4cmr.fd na sciezce LaTeXa, aby nie wprowadzic w blad procedury
+rozpoznajacej srodowisko w stylu polski.sty. Na zakonczenie nalezy
+skopiowac pliki *.fd *.sty *.def *.cfg oraz plhyph.tex do katalogu
+czytanego przez TeXa podczas kompilacji.
+
+Ostatnim etapem jest wygenerowanie nowego formatu LaTeXa. Jest to
+potrzebne dla umieszczenia w formacie polskich wzorcow przenoszenia.
+Sposob generowania formatu zalezy od implementacji. W wiekszosci
+wspolczesnych implementacji trzeba wywolac program tex ze specjalna
+opcja na pliku latex.ltx. W teTeXu, web2c, TeXlive jest to
+ tex -ini latex.ltx
+w emTeXu
+ tex386 /i/o/r /mt13000 latex.ltx
+
+Uwaga: wygenerowanie formatu przy pomocy plikow konfiguracyjnych
+zawartych w PLaTeXu powiedzie sie tylko jezeli LaTeX znajdzie pliki
+hyphen.cfg i language.dat _przed_ analogicznymi plikami z pakietu
+Babel, ktore moga jednoczesnie byc obecne w systemie. Mozna to
+osiagnac manipulujac zmiennymi w srodowisku (stosownie do
+implementacji) lub umieszczajac hyphen.cfg i language.dat w biezacym
+katalogu.
+Uwaga 2: wspolczesne implementacje czesto zawieraja pomocnicze
+narzedzia automatyzujace generowanie formatow.
+
+--- Dokumentacja
+
+Pliki dtx zawieraja teksty makr wraz z dokumentacja. Sa one gotowe
+do wydruku po przepuszczeniu przez LaTeX. Instrukcje poslugiwania sie
+stylem polski mozna uzyskac uruchamiajac
+ latex polski.dtx
+a dalej uzywajac swojego ulubionego podgladacza.
+
+
+--- Osmiobitowe wprowadzanie polskich liter
+
+Niezawodnym sposobem wprowadzania polskich znakow jest skorzystanie z
+przekodowywania znaków na postać wewnętrzną przez samego TeXa. W
+chwili obecnej stosowne wsparcie jest obecne co najmniej w web2c,
+teTeXu, TeXlive, fpTeXu, mikTeXu i emTeXu.
+
+W implementacjach, które nie dają takiego wsparcia, można zastosować
+podejście przez znaki aktywne implementowane w standardowym pakiecie
+inputenc.
+
+Przekodowywanie nie pozwala na pracę z kilkoma wejściowymi stronami
+kodowymi w jednym dokumencie ani fontami o różnych układach polskich
+znaków. Jest za to bardziej bezpieczne ze wzgledu na współpracę z
+programami zewnetrznymi. Należy również zwrócić uwagę, że
+przekodowanie na poziomie implementacji jest zależne od układu
+stosowanych fontów. Definicje przekodowania przygotowane dla fontów
+PL z konieczności mapują tylko ,,polskie znaki''. Dla kontrastu
+definicje stron kodowych pakietu inputenc (np. cp1250 czy cp852)
+obejmują wszystkie znaki (włącznie ze znakami nieliterowymi).
+
+Oto szczegóły specyficzne dla implementacji:
+
+------ web2c, teTeX, TeXlive, fpTeX, mikTeX
+
+W tych implementacjach kodowanie dokumentu zadaje się przy pomocy
+opcji --translate-file zadającej plik definiujący przekodowanie. Na
+przykład
+ latex --translate-file=il2-pl dokument.tex
+przetwarza dokument z polskimi znakami zapisanymi w kodzie ISO Latin-2.
+Można również, i jest to rozwiązanie zalecane, zadać kod w pierwszej
+linii dokumentu przy pomocy następującego ,,magicznego'' komentarza:
+
+%&latex --translate-file=il2-pl
+
+W tym przypadku do przetwarzania dokumentu wystarczy
+
+ latex dokument.tex
+
+W standardowej dystrybucji zawarta jest spora garść plików
+definiujących przekodowanie. Pliki te mają rozszerzenie .tcx i
+rezydują w podkatalogu texmf/web2c korzenia instalacji. Są to pliki
+tekstowe, o realizowanym przekodowaniu można dowiedzieć się z
+komentarza w pierwszych liniach pliku.
+
+------ emTeX
+
+W przypadku pracy z emTeXem przekodowanie musi zostać ,,zaszyte'' w
+plik formatu. Jeżeli ma się do czynienia z dokumentami w różnych
+układach, konieczny jest oddzielny plik formatu dla każdego układu.
+
+Pliki przekodowań dla polskich znaków dla emTeXa dostarczane są z
+MeXem. Na przykład poniższe polecenie generuje format LaTeX z
+kodowaniem Mazovii:
+
+ tex386 /i/o/r /cmaz2pl /mt13000 latex.ltx
+
+
+------ implementacje nie zapewniające przekodowania
+
+W przypadku korzystania z takiej implementacji (lub chęci użycia w
+jednym dokumencie różnie zakodowanych fragmentów) należy do preambuły
+dokumentu dodać wywołanie pakietu inputenc z opcją wskazującą stronę
+kodową, np.
+ \documentclass{article}
+ \usepackage{polski}
+ \usepackage[mazovia]{inputenc}
+Podczas instalacji PLaTeXa tworzone sa pliki ze stronami kodowymi:
+
+mazovia - dla popularnej (kiedyś) strony kodowej na PCetach.
+amigapl - dla polskiej strony kodowej uzywanej na Amidze
+
+Ponadto w dystrybucji LaTeXa zawarte są następujące strony
+interesujące dla polskiego użytkownika:
+
+cp1250 - dla Windowsowej strony centralnoeuropejskiej CP1250
+latin2 - kodowanie ISO 8859-2 (Latin-2)
+cp852 - dla DOS-owej strony CP852 (tzw. IBM Latin-2)
+
+Wiekszosc instalacji TeXowych czyta osmiobitowe znaki zawarte w
+dokumentach. Niektore starsze implementacje wymagaja uzycia do tego
+specjalnej opcji podczas generowania formatu. W przypadku emTeXa jest
+to opcja /8, format nalezy wygenerowac komenda
+ tex386 /i /8 /mt13000 latex.ltx
+Parametr /mt zwieksza wewnetrzne tablice emTeXa tak by zmiescily sie
+dwa komplety wzorcow przenoszenia, amerykanski i polski.
+
+--- Podziekowania
+
+* Markowi i Jackowi za MeXa i LaMeXa
+* Robert Ramiega przyslal tablice kodowa uzywana na Amidze
+
+
+
+
+**********************************************************************
+ Marcin Woli\'nski mailto:wolinski@gust.org.pl
+ http://www.mimuw.edu.pl/~wolinski
+**********************************************************************
diff --git a/Master/texmf-dist/doc/latex/platex/base/platex.html b/Master/texmf-dist/doc/latex/platex/base/platex.html
new file mode 100644
index 00000000000..ed8482ea347
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/platex/base/platex.html
@@ -0,0 +1,316 @@
+<HTML>
+<HEAD>
+<meta http-equiv="content-type" content="text/html; charset=iso-8859-2">
+<TITLE>PLaTeX, pdfPLaTeX</TITLE>
+</HEAD>
+
+<BODY>
+
+<!-- January 2003. Staszek Wawrykiewicz (StaW@gust.org.pl).
+teTeX 2.0 revision. Public domain. -->
+
+<center>
+<h2>PLaTeX i pdfPLaTeX</h2>
+</center>
+
+Dokumentacja niniejsza omawia pokrótce tworzenie formatów dla programów
+<code>tex</code> i&nbsp;<code>pdftex</code> (wersji TeX-a tworzącej od razu
+pliki PDF) ze wsparciem dla języka polskiego i&nbsp;ich użycie
+w&nbsp;środowisku opartym na <code>web2c</code> (dystrybucje
+TeX Live/teTeX/fpTeX) lub MiKTeX. <p>
+
+<p>
+Poniżej pokazano prosty przykład tworzenia pliku z użyciem
+pakietu PLaTeX. Pakiet ten dostarcza narzędzi potrzebnych do składu
+dokumentów w&nbsp;języku polskim LaTeXem&nbsp;2e.<br>
+Autorzy pakietu: Mariusz Olko i Marcin Woliński.<br>
+Więcej informacji na temat samego pakietu -- patrz plik
+<code>czytaj.txt</code> dystrybucji PLaTeX.
+
+<p>
+Ponadto w&nbsp;dystrybucjach
+dołączono przykładowy plik <code>doc/latex/platex/tstlatex.tex</code>.
+służący do przetestowania poprawnego
+działania formatu LaTeX/PLaTeX. Początkującym użytkownikom zaleca się
+zapoznanie z&nbsp;zawartością tego pliku.
+Plik ten dostępny jest także na serwerze
+<a href="ftp://ftp.gust.org.pl/pub/TeX/GUST/contrib/zaczynam/">GUST</a>.
+Techniczne szczegóły dotyczące użycia pakietu polski.sty
+(główny element pakietu platex) dostępne są po dwukrotnym uruchomieniu:<br>
+ <code>platex polski.dtx</code><br>
+ <code>platex polski.dtx</code><br>
+i wyświetleniu wynikowego <code>polski.dvi</code>.<p>
+
+<hr>
+
+<h3>I. Przygotowanie formatu LaTeX2e do obsługi języka polskiego</h3>
+
+Format w&nbsp;systemie TeX to wstępnie prekompilowany (aby przyspieszyć
+jego analizę przez program <code>tex/pdftex</code>) zestaw makrodefinicji oraz reguł
+przenoszenia wyrazów dla wybranego zestawu języków.
+Plik formatu z&nbsp;reguły posiada rozszerzenie <code>.fmt</code>.
+Tworzenie formatu to, w&nbsp;skrócie, uruchomienie programu
+<code>tex/pdftex</code>
+z&nbsp;opcją <code>--ini</code> i&nbsp;wczytanie odpowiedniego pliku
+inicjującego (dla LateX jest to plik <code>latex.ltx</code>).
+W&nbsp;LaTeX&nbsp;2e zestaw reguł przenoszenia wyrazów jest zwyczajowo
+deklarowany w&nbsp;pliku o&nbsp;nazwie <code>language.dat</code>.
+Plik ten znajduje się zwykle w&nbsp;podkatalogu
+<code>tex/generic/config/language.dat</code> lokalnej konfiguracji systemu
+TeX bądź w&nbsp;identycznym podkatalogu katalogu głównego instalacji. Modyfikacja
+<code>language.dat</code> polega na usunięciu w&nbsp;tym pliku znaku komentarza
+`%' w&nbsp;wierszu<br>
+<code>polish plhyph.tex</code><br>
+i&nbsp;ewentualnym
+zablokowaniu takim znakiem niepożądanych deklaracji wzorców dzielenia wyrazów.
+
+Przygotowanie formatu:
+<ul>
+ <li> <b>standardowe</b>: w teTeX należy uruchomić program <code>texconfig</code>,
+ uaktywnić reguły dzielenia wyrazów dla języka polskiego (menu
+ <code>Hyphenation</code> uruchamia edycję pliku
+ <code>language.dat</code>; po zapisaniu zmian w&nbsp;pliku
+ i&nbsp;zakończeniu edycji, zostanie automatyczne wygenerowany format
+ <code>latex.fmt</code> zawierający
+ wybrane wzorce dzielenia oraz mechanizm Babel przełączania języków;
+ <code>texconfig</code> tworzy ponadto dowiązanie (lub program)
+ <code>latex</code>.<br>
+ Dla dociekliwych: powyższe odpowiada uruchomieniu z&nbsp;linii
+ poleceń:<br>
+ <code>fmtutil --byfmt latex</code><br>
+ zaś na niższym poziomie -- poleceniu<br>
+ <code>tex --ini --progname=latex latex.ini</code><br>
+ W instalacji MiKTeX (od wersji 2.0) należy uruchomić menu
+ <code>MiKTeX Options</code>, zaznaczyć w&nbsp;podmenu
+ <code>Languages: polish</code> reguły przenoszenia wyrazów, po czym
+ w&nbsp;menu <code>TeX Formats</code> wygenerować (przyciskiem
+ <code>Build</code>) nowy format <code>latex.fmt</code>, zawierający
+ polskie wzorce.<br>
+ Format <code>pdflatex.fmt</code> dla programu <code>pdftex</code>
+ tworzony jest analogicznie.
+<li> <b>niestandardowe</b>, które tworzy ,,czysty'' format LaTeX2e zawierający
+ jedynie wybrane wzorce dzielenia wyrazów, bez zbędnych mechanizmów Babel.
+ Jest to metoda preferowana przez wielu polskich użytkownikow. ;-)
+ <a href=#AA1>Dlaczego PLaTeX a&nbsp;nie Babel?</a> O&nbsp;tym poniżej.
+ Dla odróżnienia przyjęto nazywać taki format <code>platex</code>
+ (lub <code>pdfplatex</code> dla pdfTeX). Formaty te korzystają z&nbsp;,,prywatnej''
+ kopii pliku <code>language.dat</code> z&nbsp;zadeklarowanymi od razu
+ polskimi i&nbsp;angloamerykanskimi wzorcami przenoszenia wyrazów.
+ Procedura opisana
+ w&nbsp;poprzednim punkcie pozwala na wygenerowanie takich formatów
+ za pomocą programu <code>texconfig</code>: menu
+ <code>Formats</code>
+ uruchamia edycję pliku <code>fmtutil.cnf</code>, należy tu
+ odblokować wiersz dotyczący formatu <code>platex</code> lub
+ <code>pdfplatex</code> (usunąć znak # przed deklaracją interesującego nas
+ formatu) i&nbsp;, po zapisaniu pliku, powrócić do menu nadrzędnego;
+ ,,w tle'' zostanie wykonany program <code>fmtutil</code>;
+ utworzone zostanie ponadto dowiązanie
+ <code>platex</code> (<code>pdfplatex</code>).<br>
+ W wypadku gdy nie mamy (jeszcze) programu <code>texconfig</code> (fpTeX dla
+ Windows) procedura generowania formatu <code>platex</code> (lub
+ <code>pdfplatex</code>) da się przedstawić następująco:<br>
+<ol>
+<li>należy odszukać plik <code>texmf/web2c/fmtutil.cnf</code> (edytujemy
+ kopię tego pliku
+ znajdującą sią w&nbsp;lokalnym drzewie katalogów TeX-owych użytkownika
+ lub w&nbsp;drzewie przeznaczonym na lokalne konfiguracje; położenie
+ właściwego pliku pokaże uruchomienie polecenia
+ <code>kpsewhich fmtutil.cnf</code>);
+<li> w&nbsp;pliku fmtutil.cnf należy odblokować wiersz dotyczący formatu
+ <code>platex</code> lub <code>pdfplatex</code> (usunąć znak #);
+<li> uruchomić polecenie: <code>fmtutil --byfmt platex --dolinks</code> (lub
+ <code>fmtutil --byfmt pdfplatex --dolinks</code>).
+</ol>
+
+ Dla MiKTeX (od wersji 2.0)
+ należy uruchomić menu <code>MiKTeX Options</code>, w&nbsp;podmenu
+ <code>TeX Formats</code> zaznaczyć format
+ <code>PLaTeX</code> (lub <code>pdfPLaTeX</code>) i&nbsp;utworzyć
+ (przyciskiem <code>Build</code>) potrzebne formaty.
+
+<p>
+W&nbsp;omawianych wyżej przypadkach tworzony jest plik formatu
+ <code>platex.fmt</code> (lub <code>pdfplatex.fmt</code>), który jest
+ umieszczany w&nbsp;katalogu właściwym dla tego rodzaju
+ plików, oraz tworzony jest program <code>platex</code> lub
+ <code>pdfplatex</code> (uruchamia on program <code>tex</code> lub
+ <code>pdftex</code> z&nbsp;odpowiednim formatem).
+</ul>
+<p>
+
+
+<a name=AA1>
+<h4>Dlaczego PLaTeX a&nbsp;nie Babel?</h4>
+
+(Fragment ten jest cytatem z&nbsp;listu nadesłanego na listę dyskusyjną GUST
+przez Marcina Wolińskiego).<br>
+
+W&nbsp;porównaniu do pakietu Babel, PLaTeX ma kilka mniej lub bardziej
+istotnych zalet:
+
+</para>
+<ul>
+<li>
+ PLaTeX udostępnia tradycyjne definicje nazw polskich funkcji
+ trygonometrycznych <code>\tg</code>, <code>\ctg</code>, <code>\arc</code>
+ i&nbsp;polskich znaków mniejsze-równe oraz większe-równe.
+<li>
+ PLaTeX umie poprawne przenosić wyrazy złożone (tj. takie jak np.
+ biało-czerwony) udostępniając do tego celu polecenie <code>\dywiz</code>.
+<li>
+ PLaTeX wstawia prawidłowe odstępy na końcu zdania.
+<li>
+ Babel nie wspiera do końca fontów w&nbsp;układzie OT4 (fontów PL),
+ co powoduje,
+ że polskie znaki diakrytyczne w&nbsp;wyrazach wstawianych automatycznie
+ przez LaTeX (dokładnie ,,ę'' w&nbsp;słowie część oraz ,,ą'' w&nbsp;słowie
+ ,,załącznik'') sklejane z&nbsp;dwóch znaków. Jest to drobny, ale ciągle
+ nie usunięty błąd. (Można go poprawić samodzielnie dokonując niewielkiej
+ modyfikacji pliku polish.sty z&nbsp;dystrybucji pakietu Babel.)
+ Obwiedniowe fonty OT4 są niezastąpione przy tworzeniu plików
+ w&nbsp;formacie PDF.
+</ul>
+<para>
+ Podsumowując: jeżeli nie potrzebujemy środowiska wielojęzycznego to dużo
+ mniejsza objętość pakietu PLaTeX oznacza także mniejszą liczbę błędów
+ i&nbsp;potencjalnych kolizji z&nbsp;innymi częściami LaTeXa.<br>
+ [achiwum GUST-L, list z 06/06/1997]
+</para>
+
+<hr>
+
+<h3>II. Użycie</h3>
+
+Aktualne implementacje, oparte na Web2c, a&nbsp;także MiKTeX pozwalają
+na prawidłowe przekodowanie znaków diakrytycznych w&nbsp;pliku TeX-owym
+na wewnętrzną reprezentację, stosowaną przez programy.
+W&nbsp;Polsce, niestety,
+stosowane są różne ,,standardy'' kodowania diakrytyków w&nbsp;tworzonych przez
+użytkownika plikach, zależnie od systemu operacyjnego. Dla potrzeb systemu
+TeX używamy zewnętrznych, tekstowych plików TCX, pozwalających ,,obsłużyć''
+różne spotykane ,,standardy''. Dzięki temu przekodowanie działa też
+w&nbsp;drugą stronę, kiedy TeX wyświetla komunikaty i&nbsp;zapisuje pliki
+<code>.log</code>, a&nbsp;także pliki ze spisem treści, skorowidzem itp.<p>
+
+Uruchomienie polecenia:<br>
+<code>latex --translate-file=TCXFILE myfile.tex</code><br>
+oznacza uruchomienia TeX-a z&nbsp;formatem <code>latex.fmt</code>
+i&nbsp;z&nbsp;odpowiednią tablicą przekodowań (ich lista znajduje się
+poniżej). W&nbsp;identyczny sposób uruchamiamy polecenie <code>platex</code>.<p>
+
+Przekodowanie (plik TCX) może być deklarowane bezpośrednio w&nbsp;pliku
+TeX-owym. Począwszy od wersji Web2c&nbsp;7.4, wymaga to podania
+w&nbsp;wierszu poleceń opcji <code>--parse</code> lub włączenia jej na
+stałe, co wymaga zmiany w&nbsp;głównym pliku
+konfiguracyjnym <code>texmf.cnf</code>:<br>
+<code>parse_first_line = t</code><br>
+(t -- od `true', zamiast domyślnego przypisania f -- od `false').
+
+<p>
+Przykładowo, jeśli <b>pierwszy</b> wiersz pliku zawiera
+ komentarz strukturalny postaci<br>
+ <code>%&platex --translate-file=il2-pl</code><br>
+ to plik może być przetworzony za pomocą polecenia <code>tex plik.tex</code>;
+ zostanie wtedy wczytany format <code>platex.fmt</code> oraz tablica
+ <code>il2-pl.tcx</code>
+ przekodowania z&nbsp;układu iso8859-2 do układu fontów PL (wewnętrznego
+ dla programu TeX; w&nbsp;LaTeX-u ma on kryptonim OT4).<p>
+
+Tym samym zbędna jest deklaracja w&nbsp;preambule pliku LaTeX-owego:<br>
+ <code>\usepackage[latin2]{inputenc}</code><p>
+ <code>\usepackage[OT4]{fontenc}</code><p>
+
+
+W&nbsp;dystrybucjach dostarczono szereg plikow TCX. Można je znaleźć
+w&nbsp;katalogu <code>texmf/web2c/</code>:<br>
+<table border>
+<tr>
+ <td> amiga-pl.tcx </td> <td> AmigaPL do PL </td>
+</tr>
+<tr>
+ <td>il2-pl.tcx</td> <td> iso8859-2 (latin2) do PL </td>
+</tr>
+<tr>
+ <td>cp1250pl.tcx</td> <td> Windows cp1250 do PL </td>
+</tr>
+<tr>
+ <td>cp852-pl.tcx</td> <td> IBM cp852 do PL </td>
+</tr>
+<tr>
+ <td>macce-pl.tcx</td> <td> Apple MacCE do PL </td>
+</tr>
+<tr>
+ <td>maz-pl.tcx</td> <td> Mazovia do PL </td>
+</tr>
+</table>
+
+<p>
+A oto przykład pliku LaTeX-owego:
+
+<pre>
+ %& --translate-file=cp1250pl
+ \documentclass[a4paper]{article}
+ \usepackage{polski}
+ \begin{document}
+ Polskie literki piszemy w standardzie Windows cp1250: .....
+ \end{document}
+</pre>
+
+ Jak widać, nasz plik ma krótką preambułę -- pakiet <code>polski</code>
+ korzysta domyślnie z&nbsp;zainstalowanych fontów PL (odpowiada mu układ
+ OT4, więc zbędna jest deklaracja <code>\usepackage[OT4]{fontenc}</code>).
+ Jeśli korzystamy
+ z&nbsp;fontów EC nasza preambuła powinna zawierać dodatkowy wiersz:<br>
+ <code>\usepackage[T1]{fontenc}</code>
+
+
+<h3> III. Polskie fonty PostScriptowe</h3>
+
+ Aktualne dystrybucje zawierają fonty serii PL
+ (spolonizowane standardowe dla TeX-a fonty CM) w&nbsp;wersji
+ Type&nbsp;1 (postscriptowe).
+ Można je także znaleźć w&nbsp;najbliższym węźle CTAN lub jego kopii,
+ np.:<br>
+ <code>ftp://sunsite.icm.edu.pl/CTAN/fonts/psfonts/polish/plpsfont/</code>.<br>
+ Pliki <code>.pfb</code> powinny znaleźć się w&nbsp;podkatalogu
+ <code>texmf/fonts/type1/public/pl/</code> naszej instalacji, zaś pliki
+ map fontowych (<code>.map</code>) oraz wektory kodowań
+(<code>.enc</code>) -- w&nbsp;katalogu <code>texmf/dvips/pl/</code>
+<p>
+W dystrybucjach opartych na Web2c zautomatyzowano, poprzez użycie programu
+<code>updmap</code>, proces tworzenia map fontowych dla programów
+<code>dvips</code>, <code>pdftex</code>
+i&nbsp;<code>dvipdfm</code>. Poniżej omówiono więc jedynie czego ten proces
+dotyczy.
+<p>
+ Sterownik <code>dvips</code> (zamieniający wynik pracy TeX-a, plik DVI,
+ do formatu PostScript) wymaga aby deklaracje map fontowych
+ (dla fontów PL konkretnie zawartość <code>texmf/dvips/pl/pl.map</code>)
+ były dołączone do pliku <code>texmf/dvips/config/psfonts.map</code>.
+ Mapy fontowe można alternatywnie dołączyć w&nbsp;pliku
+ <code>texmf/dvips/config/config.ps</code> (lub jego lokalnej kopii),
+ dopisując wiersz:<br>
+ <code>p +pl.map</code><br>
+ po deklaracji głównej mapy fontowej: <code>p psfonts.map</code>. <p>
+
+ Aby fonty Type&nbsp;1 były użyte przez program <code>pdfTeX</code>,
+ należy sprawdzić jakie mapy fontowe są deklarowane w&nbsp;pliku
+ <code>texmf/dvips/config/pdftex.map</code> -- powinien on także
+ zawierać deklaracje map fontowych dla fontów PL.<p>
+
+W&nbsp;dystrybucjach wszystkie aktualnie dostępne polskie fonty
+Type1 są gotowe do użycia zarówno przez program <code>dvips</code>,
+jak i&nbsp;<code>pdftex</code>.<p>
+
+Bardziej szczegółowe omówienie instalacji fontów Type1 zawarte
+jest w&nbsp;artykule <a href="http://www.gust.org.pl/fonty/fonthint.html">Instalowanie
+fontów Type1/True Type</a>. <p>
+
+<hr>
+
+<i>Staszek Wawrykiewicz</i> (StaW@gust.org.pl), 13.01.2003.
+
+</BODY>
+</HTML>
+
diff --git a/Master/texmf-dist/doc/latex/platex/base/r22.mps b/Master/texmf-dist/doc/latex/platex/base/r22.mps
new file mode 100644
index 00000000000..89c068fbe52
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/platex/base/r22.mps
@@ -0,0 +1,78 @@
+%!PS
+%%BoundingBox: -1 -22 158 72
+%%Creator: MetaPost
+%%CreationDate: 1999.03.23:1034
+%%Pages: 1
+%*Font: plbx8 7.97011 7.97011 78:8
+%*Font: plr6 5.97758 5.97758 31:c
+%*Font: plsy6 5.97758 5.97758 30:8
+%*Font: plex10 9.96265 9.96265 7a:f
+%%EndProlog
+%%Page: 1 1
+ 0 0.5 dtransform truncate idtransform setlinewidth pop [] 0 setdash
+ 1 setlinecap 1 setlinejoin 10 setmiterlimit
+newpath 0 0 moveto
+102.04723 0 lineto stroke
+newpath 98.35153 -1.53084 moveto
+102.04723 0 lineto
+98.35153 1.53084 lineto
+ closepath
+gsave fill grestore stroke
+newpath 0 0 moveto
+153.07042 0 lineto stroke
+newpath 149.37401 -1.53114 moveto
+153.07042 0 lineto
+149.37401 1.53114 lineto
+ closepath
+gsave fill grestore stroke
+newpath 0 0 moveto
+56.69281 42.5196 lineto stroke
+newpath 54.65497 39.07784 moveto
+56.69281 42.5196 lineto
+52.81812 41.52693 lineto
+ closepath
+gsave fill grestore stroke
+ 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth
+ [3 3 ] 0 setdash
+newpath 56.69281 0 moveto
+56.69281 42.5196 lineto stroke
+ [] 0 setdash
+newpath 0 0 moveto
+0 70.86601 lineto stroke
+59.69281 40.76117 moveto
+(x) plbx8 7.97011 fshow
+64.8457 43.57397 moveto
+(0) plsy6 5.97758 fshow
+64.8457 38.14436 moveto
+(2) plr6 5.97758 fshow
+97.39522 -6.5423 moveto
+(x) plbx8 7.97011 fshow
+102.54811 -7.6326 moveto
+(1) plr6 5.97758 fshow
+148.41841 -9.1337 moveto
+(x) plbx8 7.97011 fshow
+153.5713 -6.32089 moveto
+(0) plsy6 5.97758 fshow
+153.5713 -11.7505 moveto
+(1) plr6 5.97758 fshow
+2.8346 -7.1843 moveto
+(|) plex10 9.96265 fshow
+ 0 1.1955 dtransform truncate idtransform setlinewidth pop 0 setlinecap
+newpath 7.3178 -6.5865 moveto
+23.86319 -6.5865 lineto stroke
+23.86319 -7.1843 moveto
+({z) plex10 9.96265 fshow
+newpath 32.82959 -6.5865 moveto
+49.375 -6.5865 lineto stroke
+49.375 -7.1843 moveto
+(}) plex10 9.96265 fshow
+ 0 0.5 dtransform truncate idtransform setlinewidth pop 1 setlinecap
+newpath 0 -21.25981 moveto
+8.50392 -8.50392 lineto stroke
+newpath 7.72768 -12.4278 moveto
+8.50392 -8.50392 lineto
+5.1804 -10.72958 lineto
+ closepath
+gsave fill grestore stroke
+showpage
+%%EOF
diff --git a/Master/texmf-dist/doc/latex/platex/base/readme.txt b/Master/texmf-dist/doc/latex/platex/base/readme.txt
new file mode 100644
index 00000000000..aca970483b5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/platex/base/readme.txt
@@ -0,0 +1,26 @@
+Copyright (C) 1994 by Mariusz Olko. All rights reserved.
+Copyright (C) 1997 by Mariusz Olko and Marcin Woli\'nski.
+Copyright (C) 2000,2002,2003 by Marcin Woli\'nski.
+
+Bundle `PLaTeX' provides tools to typeset documents in Polish using
+LaTeX2e. Documented source code is in *.dtx and *.fdd files.
+
+`PLaTeX' is free software redistributable in according to LaTeX
+Project Public License version 1 or above (see lppl.txt in base LaTeX
+distribution).
+
+To install `PLaTeX' run TeX on instalation script platex.ins
+ tex platex.ins
+which will extract individual pieces of the bundle from the *.dtx
+files.
+
+During the instalation you will be asked question whether you have
+`PL' fonts installed on your system or not. If you have them
+installation script will generate a number of font description files
+for Polish fonts. In case you don't have those font the ot4cmr.fd
+file should not be present on the system, as it will confuse
+environment scanning routine in `polski.sty'.
+
+More info can be found in documentation of polski.sty source code. To
+obtain DVI file with documentation run
+ latex polski.dtx
diff --git a/Master/texmf-dist/doc/latex/platex/base/tstlatex.tex b/Master/texmf-dist/doc/latex/platex/base/tstlatex.tex
new file mode 100644
index 00000000000..284b36f2d78
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/platex/base/tstlatex.tex
@@ -0,0 +1,117 @@
+%& --translate-file=il2-pl
+%% Staszek Wawrykiewicz (staw@gust.org.pl). Styczeń 2000. Public domain.
+%% Przykładowy plik LaTeX-owy; ilustruje proste polecenia składu, zmiany
+%% kroju pisma i włączanie grafiki.
+%% Plik przetwarzamy DWUKROTNIE z użyciem formatu platex: platex tstlatex
+%% lub pdfplatex: pdfplatex tstlatex (w tym wypadku otrzymamy plik .pdf)
+%% Warto obejrzeć cały plik!
+% =========
+% Znak % w wierszu oznacza komentarz; od tego znaku
+% do końca wiersza tekst jest ignorowany w składzie.
+% Wyjątkiem jest pierwszy wiersz pliku, zaczynający się
+% od znaków %& i zawierający deklarację użytego w tekście
+% kodowania znaków.
+% === dokumenty przetwarzane przez LaTeX-a mają obowiązkową preambułę:
+\documentclass{article}
+\usepackage{polski} % pakiet makr wspomagający skład w jęz. polskim
+
+\usepackage{graphicx} % pakiet makr do włączania grafiki do tekstu
+ % (deklarowany w razie potrzeby)
+
+\begin{document} % Rozpoczynamy!
+
+\tableofcontents % po drugim przetworzeniu pliku wygenerowany
+ % zostanie w tym miejscu spis treści
+
+\section{Proste teksty}
+
+Najpierw test polskich liter (iso8859-2): ąćęłńóśźż ĄĆĘŁŃÓŚŹŻ
+
+Jak zobaczysz po przetworzeniu tego pliku, kolejny akapit zaczyna się
+wcięciem. Domyślnie ma ono wielkość 20~pt, ale, jak wszystko w~\TeX-u,
+może to być zmienione.
+Skład prostych tekstów jest bardzo łatwy; \TeX{} automatycznie łamie
+akapity i~numeruje strony. Pisząc tekst nie musisz się martwić o~spacje,
+wcięcia itp., skupiasz się tylko na treści. Wiele
+spacji w~pisanym tekście czy wiersz złamany w~wygodnym
+dla nas miejscu
+da nam
+identyczny efekt w~składzie. Zauważyłeś pewnie znaczek tyldy, który
+pojawia się w~tekście źródłowym; służy on do zaznaczenia spacji,
+na których \TeX{} nie powinien przełamać wiersza.
+Pojedyncze litery na końcu wiersza nie wyglądają zbyt ładnie, prawda?
+
+\noindent % usuń wcięcie dla tego akapitu
+Ten akapit nie ma wcięcia. Tekst składany jest domyślnym fontem 10~pt
+o~nazwie plr10. \textit{To tekst kursywą}, a~to \textbf{tekst pogrubiony}.
+I~znów przywracamy krój prosty.
+
+Jedną z~największych zalet systemu \TeX{} jest elegancki skład wyrażeń
+matematycznych, nawet bardzo skomplikowanych, zarówno w~ramach samego
+akapitu $\sum_{n\in A} {1\over n}$, jak i~wyeksponowanych w~osi strony:
+\begin{equation}
+\sum_{n\in A} {1\over n}
+\end{equation}
+Czy widzisz różnicę w składzie takiego samego zapisu?
+
+\section{Nieco bardziej skomplikowane}
+
+\LaTeX{} oferuje gotowe polecenia opisu struktury dokumentu. Zaczęliśmy
+właśnie nową część dokumentu i~program sam ustalił kolejny numer
+części, krój pisma i~jego wielkość dla wyróżnienia tytułu, wstawił
+pionowe odstępy itd.
+
+Pokażemy teraz mechanizm odsyłaczy do równań matematycznych (patrz
+równanie~\ref{eq:aa1}), jak i~do rysunków (patrz rys.~\ref{pic:bqq1}).
+Odsyłacze mogą wskazywać miejsca w~dokumencie, nawet takie, które
+występują w~dalszej jego części. Właśnie dla rozwiązania odesłań tekst
+niniejszy powinien być przetworzony dwukrotnie.
+
+A~oto przykład bardziej skomplikowanego wyrażenia i~fragment tekstu
+matematycznego:
+\begin{equation} \label{eq:aa1}
+ e_{\min} = \frac{1}{t_I}\int_{t_1}^{t_2}|f(t)|^2 dt -
+ \sum_{i=1}^n |c_i|^2 \frac{e_i}{t_I}.
+\end{equation}
+
+Rozpatrzmy trójwymiarową przestrzeń $\mathcal{V}$ rozpiętą na
+trzech wzajemnie prostopadłych wektorach $\mathbf{x}_1$,
+$\mathbf{x}_2$, $\mathbf{x}_3$ (rys.~\ref{pic:bqq1}).
+Niech $\mathcal{W}$ będzie płaszczyzną (podprzestrzenią) w~przestrzeni
+$\mathcal{V}$ rozpiętą na wektorach $\mathbf{x}_1$ i~$\mathbf{x}_2$.
+Załóżmy, że istnieje wektor $\mathbf{y}$ należący
+do przestrzeni $\mathcal{V}$, ale nie należący do płaszczyzny~$\mathcal{W}$
+
+% wstawiamy rysunek utworzony w innym programie
+\begin{figure}[!tbhp]
+\hbox to\textwidth{\hss\includegraphics{r22.mps}\hss}
+\caption{Ilustracja typowych przebiegów $x_n(t)$ \label{pic:bqq1}}
+\end{figure}
+
+Rysunek~\ref{pic:bqq1} został utworzony przez program MetaPost i~nie ma
+pewności, że zostanie prawidłowo wyświetlony przez program Windvi, YAP, czy
+Xdvi (programy te wyświetlają wynik składu -- plik DVI i~głównie
+przeznaczone są do oglądania tekstu).
+Jeśli intensywnie korzystasz z~plików graficznych, warto wynik składu
+przetworzyć programem Dvips:
+\begin{verbatim}
+ dvips tstlatex -o tstlatex.ps
+\end{verbatim}
+i~oglądać \verb|tstlatex.ps| (plik PostScript-owy) w~przeglądarce GSview.
+
+\section{Zakończenie}
+
+Pokazane przykłady prezentują jedynie drobny fragment możliwości
+\LaTeX-a. Więcej informacji znajdziesz np. w~podręczniku
+,,Nie za krótkie wprowadzenie do systemu \LaTeX2$\epsilon$'', dostępnym
+na:
+\begin{verbatim}
+http://www.gust.org.pl
+\end{verbatim}
+
+A~teraz spróbuj złożyć taki sam dokument np. w~MS~Word!
+
+\end{document}
+Po tym poleceniu możesz pisać dowolne komentarze.
+I tak nie ukażą się w składzie.
+