cstex (9may14)

git-svn-id: svn://tug.org/texlive/trunk@33942 c570f23f-e606-0410-a88d-b1316a301751

7 files changed, 1531 insertions, 98 deletions

diff --git a/Master/texmf-dist/doc/cstex/README-opmac b/Master/texmf-dist/doc/cstex/README-opmac
index 53632ef9a14..b3a34b07dc5 100644
--- a/Master/texmf-dist/doc/cstex/README-opmac
+++ b/Master/texmf-dist/doc/cstex/README-opmac
@@ -1,7 +1,8 @@
 The documentation of the OPmac is:
 
-opmac-u.tex,pdf  ... user documentation (in Czech)
-opamc-d.tex,pdf  ... technical documentation (in Czech)
+opmac-u.tex,pdf    ... user documentation (in Czech)
+opmac-u-en.tex,pdf ... user documentation (in English)
+opamc-d.tex        ... technical documentation (in Czech)
 
 See http://petr.olsak.net/opmac.html for more information.
 
diff --git a/Master/texmf-dist/doc/cstex/opmac-d.pdf b/Master/texmf-dist/doc/cstex/opmac-d.pdf
deleted file mode 100644
index 3bba0387253..00000000000
--- a/Master/texmf-dist/doc/cstex/opmac-d.pdf
+++ /dev/null
diff --git a/Master/texmf-dist/doc/cstex/opmac-d.tex b/Master/texmf-dist/doc/cstex/opmac-d.tex
index 32fef6bf372..735087fd6a8 100644
--- a/Master/texmf-dist/doc/cstex/opmac-d.tex
+++ b/Master/texmf-dist/doc/cstex/opmac-d.tex
@@ -7,7 +7,7 @@
 % This file is encoded in ISO-8859-2 because
 % UTF-8 encTeX has a conflict with DocByTeX
 
-\def\projectversion{Nov. 2013}
+\def\projectversion{May 2014}
 \def\headtitle{OPmac}
 
 \widowpenalty=10000 
@@ -253,6 +253,7 @@ uživatelské dokumentaci.
 \dgn \nb cnvhook
 \dgn \nb pghook
 \dgn \nb toclinehook
+\dgn \nb fnotehook
 \dgn \nb mnotehook
 \dgn \nb captionhook
 
@@ -1658,7 +1659,7 @@ charakterizuje obvyklou možnost chování PDF prohlížeče při odskoku na cíl.
 Podrobněji viz manuál k~pdf\TeX{}u. PDF prohlížeče většinou  
 lícují horní hranu okna přesně s~místem cíle, je tedy 
 potřeba cíl umístit poněkud výše, abychom viděli i odkazovaný text.
-K~tomu právě slouží registr \db destheight.
+K~tomu právě slouží obsah makra \db destheight.
 
 \inext{dest}{\empty}{+-}
 
@@ -1730,15 +1731,13 @@ Makro \db url "{<text>}" se používá k tisku URL. Vytiskne "<text>" fontem
 mezeru s dodatečnou mírnou roztažitelností \db urlskip. Mezera vpravo od
 těchto znaků je navíc zlomitelná s penaltou definovanou v makru \db
 urlbskip. Dvojité lomítko \db urlslashslash má zlomitelnou mezeru jen na
-konci.
+konci. Makro "\|" je lokálně definováno jako prázdné, ale při "\urlfont"
+nabývá hodnoty \db urlspecchar. Takže ve skutečném odkaze se neprojeví, ale
+při tisku ano. Uživatel si může "\urlspecchar" definovat dle svých představ
+(například jako "\hfil\break").
 
 \inext{url}{\empty}{+-}
    
-Je třeba vysvětlit, proč je v makru "\urlskip" použito "\null", neboli
-"\hbox{}". Tento box se přilepí na předchozí slovo a tím zakážeme toto slovo
-dělit podle vzorů dělení slov. Spojovník při rozděleném slovu je totiž pro  
-čtenáře matoucí: nemůže vědět, zda je nebo není součástí URL.
-
 Makro "\url{<text>}" pracuje tak, že uloží "<text>" do "\tmpb" a nechá
 vyměnit příslušné znaky uvnitř "\tmpb" pomocí "\replacestrings".
 Nakonec vytiskne "<text>" prostřednictvím "\ulink".
@@ -1748,8 +1747,9 @@ některé další znaky, ale ne všechny: procento, backlash.
 U těchto znaků bychom nejprve museli vyměnit jejich
 kategorie. Pak by ale makro "\url" nefungovalo uvnitř parametrů jiných
 maker. V zájmu jednoduchosti makra "\url" to neděláme. Takže pokud uživatel
-má v URL znak procento, nahradí ho sekvencí "\percent" manuálně a pokud tam má 
-další speciální znak, vyřeší to podobným makrem jako "\percent".
+má v URL znak procento, musí psát "\%"
+nebo si změní kategorie sám. Podobná poznámka platí pro znaky "{", "}", "\",
+"#" a "$".  
 
 Makro \db replacestrings "{<string1>}{<string2>}" vymění v makru "\tmpb"
 veškeré výskyty "<string1>" za "<string2>". Pro tento účel definuje pracovní
@@ -2238,6 +2238,27 @@ Při kladení vlevo musíme použít "fill", abychom přeprali natahovací mezeru z
 
 \inext{mnoteA}{^^B\cbrace}{++}
 
+Text uvnitř "\mnote" přebírá barvu kvůli "\vadjust" \uv{se zpožděním}, podle
+barvy, která je na konci řádku, vedle kterého je "\mnote" umístěna. Makra
+tedy při zpracování parametru "\mnote" nemohou dopředu vědět, jaká to bude
+barva, a nelze tedy použít zásobník barev řízený makry. Uživateli přitom
+musíme dát možnost barvu "\mnote" nastavit, například:
+
+\begtt
+\def\mnotehook{\noindent\Black}
+\endtt
+zajistí, že budou všechny poznámky na okraji černé bez ohledu na to, jakou
+barvu mají řádky, vedle kterých ty poznámky stojí. K tomu účelu je nastavení
+případných barev uživatelem jednak v makru "\mnoteA" obklopeno do dvojice
+"\pdfsave"--"\pdfrestore" a dále je nastartován pomocí \db mnoteC lokální
+zásobník barev, který je pomocí \db mnoteD vrácen do stavu, v jakém byl před
+zahájemním zpracování "\mnote". Uživatel může v prametru "\mnote" používat 
+"{\localcolor\Green X{\localcolor\Blue Y}Z}" s~očekávaným výsledkem.
+Barvy neoznačené "\localcolor" končí svou platnost na konci poznámky
+"\mnote".
+
+\inext{mnoteC}{^^B\cbrace}{++}
+
 Makro \db Xmnote pracuje během čtení REF souboru a využívá toho, že makro
 "\Xpage" nastavuje číslo právě procesované strany do registru "\lastpge".
 Takže stačí použít "\sxdef" následujícím způsobem:
@@ -2255,31 +2276,32 @@ pak na definovanost "\mnotesfixed" ptá a pokud je definované, nepoužije
 \subsec Bibliografické reference
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-Nejprve uvedeme deklarace deskriptoru \db auxfile a čítačů 
+Nejprve uvedeme deklarace deskriptoru \db auxfile, stringu \db bibmark a čítačů 
 \db bibnum a \db lastcitenum.
 
 \inext{auxfile}{\empty}{+-}
 
-Makro \db cite "[<lejblík1>,<lejblík2>,...]" si prostřednictvím \db citeA
-zavolá "\rcite{<lejblík>}" pro každou jednotlivou položku oddělenou čárkou ve
-svém parametru. Makro "\citeA" v sobě skrývá fintu: parametr nemá jediný,
-ale dva "#1#2". Protože první z nich je neseparovaný, ignorují se případné
-mezery za čárkou a "#1" obsahuje první písmeno "<lejblíku>". Uvnitř makra
-měníme \db citesep, což je čárka a mezera, která se má mezi údaji
-vytisknout. Makro \db nocite "[<lejblík1>,<lejblík2>,...]" je definováno
-stejně, jen připraví jiný význam makra "\docite", krz které budeme tisknout
-v "\rcite" potřebný údaj. Veškerá
-činnost maker "\cite" a "\nocite" probíhá uvnitř skupiny.
+Makro \db cite "[<lejblík1>,<lejblík2>,...]" si opakovaně zavolá 
+"\citeA<lejblík-i>", kde se připraví čísla citovaných publikací do
+lokálně tvořeného seznamu "\savedcites". Poté zavolá "\printsavedcites",
+které lokálně tvořený seznam čísel vytiskne. Kromě toho makro "\citeA" udělá
+plno dalších potřebných věcí, jak uvidíme za chvíli.
+Makro \db nocite se chová jako "\cite" až na to, že se nic netiskne.
+Makro \db rcite vytiskne čísla publikací, ale bez hranatých závorek kolem.
+Makro \db savedcites je globálně prázdné a zaplní se vždy znovu uvnitř
+skupiny vymezené makrem "\cite" nebo "\nocite" nebo "\rcite".
 
 \inext{cite}{\empty}{+-}
 
-Makro \db rcite "{<lejblík>}" řeší zhruba řečeno následující věci:
-
+Makro \db citeA "<lejblík>," řeší zhruba řečeno následující věci:
 
 \begitems
 \item * Zjistí, zda je definován "\csname bib:<lejblík>\endcsname". Pokud ano,
-  vytiskne jeho hodnotu, pokud ne, vytiskne do textu otazníky a na terminál
-  varování. Tato kontrolní sekvence začne být známá po použití
+  přidá obsah tohoto makra (což je číslo citovaného záznamu) 
+  do "\savedcites". Pokud ne, přidá do
+  "\savedcites" otazník a na terminál vypíše varování.
+  Kontrolní sekvence "\csname bib:<lejblík>\endcsname" bude obsahovat
+  "<číslo citace>" po použití
   "\bib[<lejblík>]" nebo "\bibitem{<lejblík>}". Tato makra uloží
   odpovídající informaci do REF souboru, odkud ji při opakovaném \TeX{}ování 
   vyzvedneme. Je to klasická činnost, kterou provozujeme i u ostatních
@@ -2288,41 +2310,45 @@ Makro \db rcite "{<lejblík>}" řeší zhruba řečeno následující věci:
   v makrech "\usebibtex" nebo "\usebbl".
 \enditems
 
-Makro "\rcite" je naprogramováno zhruba takto
+Makro "\citeA" je naprogramováno zhruba takto
 
 \def\begtthook{\langleactive}
 \begtt
-function rcite(<lejblík>) {
+function citeA(<lejblík>) {
   if (<lejblík> == '*') { <zapiš do> \citelist '*'; return; }
   if (\bib:<lejblík> == nedef) {
-    <zapiš do> \citelist <lejblík>;
+    <přidej do> \citelist <lejblík>;
     <na terminál:> "Warning, cite [label] unknown";
-    <do tiskového výstupu:> "??";
+    <přidej do> \savedcites "?,";
+    <lokálně vypni třídění a zkracování seznamu> \savedcites;
     \bib:<lejblík> = empty;
     return;
   if (\bib:<lejblík> == empty) {
-    <do tiskového výstupu:> "??";
+    <přidej do> \savedcites "?,";
+    <lokálně vypni třídění a zkracování seznamu> \savedcites;
     return;
   }
   if (\bib:<lejblík> končí znakem '&') {
-    <zapiš do> \citelist <lejblík>;
+    <přidej do> \citelist <lejblík>;
     <odstraň znak & z obsahu makra> \bib:<lejblík>;
   }
-  <tiskni obsah makra> \bib:<lejblík>;
+  <přidej do> \savedcites <expandovaný> "\bib:<lejblík>,";  
 } 
 \endtt
 
-\def\begtthook{\langleactive}
 Výklad kódu: Protože chceme šetřit pamětí bufferu "\citelist", zapisujeme
 tam každý "<lejblík>" jen jednou. Zda se nedeklarovaný "<lejblík>" vyskytl
-poprvé poznáme podle nedefinované hodnoty "\bib:<lejblík>". Zda se vyskytl
-později znovu poznáme podle toho, že má hodnotu "empty". Zda se deklarovaný
-"<lejblík>" vyskytl poprvé poznáme podle znaku "&" v jeho obsahu. 
+poprvé, poznáme podle nedefinované hodnoty "\bib:<lejblík>". Zda se vyskytl
+nedeklarovaný "<lejblík>" později znovu poznáme podle toho, že má makro 
+"\bib:<lejblík>" hodnotu "empty". Zda se deklarovaný
+"<lejblík>" vyskytl poprvé poznáme podle znaku "&" v~jeho obsahu. 
 
 Návrh kódu v C-like notaci nyní převedeme do maker v \TeX{}u:
 
-\inext{rcite}{^^B\cbrace}{++}
+\inext{citeA}{^^B\cbrace}{++}
 
+Makro snímá svůj parametr jako "#1#2," aby mohly být "<lejblíky>" odděleny
+před čárkou mezerou, která je neseparovaným parametrem "#1" ignorována.
 Asi nejzajímavější vychytávka v tomto makru se týká testu na znak "&".
 Implicitně při čtení REF souboru se do makra "bib:<lejblík>" uloží
 "\bibnn{<hodnota>}&". Příkaz "\if" za sebou totálně expanduje vše
@@ -2334,48 +2360,130 @@ Odstranění tohoto znaku probíhá znovu totální expanzí,
 tentokrát "\bibnn" první parametr "<hodnota>" zopakuje a druhý parametr
 se znakem "&" zahodí.
 
-Než se pustíme do výkladu makra "\docite", připravíme si makra \db printcite
-"<položka>" a \db printdashcite "<položka>". První z nich tiskne jednu 
-položku oddělenou od případné
-další čárkou, druhé tiskne položku, před kterou předchází pomlčka
-vyznačující interval položek. Pointa makra "\printcite" je v tom, že si samo
-po prvním zavolání připraví separátor "\citesep" (který je na začátku
-činnosti "\cite" prázdný), takže při opakovaném volání "\printcite" se
-vytiskne i požadovaný separátor. Pomlčka v "\printdashcite" je schována do
-"\hbox", aby nedocházelo těsně za ní ke zlomu řádku.
-
-\inext{printcite}{\empty}{+-}
-
-Makro \db docite "<položka>" vytiskne otazníky při prázdném parametru a jinak
+Makro \db printsavedcites případně setřídí seznam "\savedcites" 
+podle velikosti zavoláním "\sortcitesA" 
+a dále opakovaně na jednotlivé prvky seznamu zavolá makro
+"\citeB", které prvky seznamu vytiskne a případně je zkrátí pomocí intervalů
+(místo "3,4,5" píše "3--5"). Pomocnou proměnnou "\tmpb" využije makro
+"\citeB", jak uvidíme později při výkladu tohoto makra.
+
+\inext{printsavedcites}{^^B\cbrace}{++}
+
+Makro \db sortcitesA seřadí seznam "\savedcites" podle velikosti. Takže třeba
+"4,7,3,5," se promění na "3,4,5,7,". Implicitně je definováno jako prázdné
+makro, takže řazení se neprovede. Nicméně uživatel ho použitím makra
+\db sortcitations v~hlavičce svého dokumentu probudí k životu.
+
+Oživené "\sortcitesA" nejprve vyvrhne do čtecí fronty obsah "\savedcites"
+ukončený další čárkou (máme zde dvě čárky vedle sebe) a následně spustí \db
+sortcitesB, které postupně odebírá jednotlivé prvky ze čtecí fronty, předává
+je do nově tvořeného setříděného seznamu, kam je vkládá na správné místo.
+Výchozí hodnota nově tvořeného seznamu obsahuje číslo "300000", které bude
+vždy na konci seznamu, protože se předpokládá větší než jakýkoli tříděný
+prvek. Zajímavý trik s "\edef\savedcites{...\expandafter}" způsobí, že se
+"\savedcites" nejprve vyvrhne (po aplikaci dvou "\expandafter") do čtecí
+fronty a teprve poté dostane novou hodnotu pomocí "\edef". Na konci makra
+"\sortcitesA" ze seznamu odebereme koncové číslo "300000".
+
+\inext{sortcitesA}{\count=2 ^^B\cbrace}{++}
+
+Vložení prvku do zatříděného seznamu probíhá pomocí \db sortcitesC, což je
+makro, které nově tvořený seznam, který je nyní také vyvržen ve čtecí
+frontě, projde zleva doprava, dokud nenarazí na číslo větší než vkládané.
+Při té činnosti opakovaně sbírá hodnoty a vkládá je zpět do "\savedcites".
+Je-li zařazovaný prvek "\tmpa" menší než odebraný prvek z fronty, vloží se
+pomocí \db sortcitesD do "\savedcites" původní "\savedcites" následovaný
+"\tmpa" následovaný testovaným prvkem následovaný zbytkem vstupní
+fronty (až po "\end").
+
+\inext{sortcitesC}{\empty}{+-}
+
+Makro \db citeB "<položka>," ukončí činnost při prázdném parametru,
+jinak se po vytištění "<položky>" zavolá znova.
+Vytiskne dva otazníky, je-li parametrem otazník, a jinak
 vytiskne prostřednictvím "\printcite" jednu "<položku>". Kromě toho řeší při
 nenulovém "\lastcitenum" slučování po sobě následujících čísel položek do
 intervalů. Naposledy vytištěnou položku uchovává v registru "\lastcitenum".
 Při příštím zavolání zvětší "\lastcitenum" o jedničku a srovná ji s
-"<položkou>". Jsou-li si rovny, jde o následující položku v řadě a takovou
+"<položkou>". Jsou-li si rovny, jde o~následující položku v řadě a takovou
 položku netiskneme, nicméně si její hodnotu uchováme v "\tmpb". Pokud je
 mezi souvislou řadou položek díra, tj. "\lastcitenum" se nerovná
 "<položce>", pak dovytiskneme předchozí interval pomocí 
 "\printdashcite{\the\tmpb}" a následně vytiskneme i "<položku>".
 Makro \db shortcitations jednoduše nastavuje "\lastcitenum" na nenulovou
-hodnotu a tím probudí k životu hlavní část makra "\docite".
+hodnotu a tím probudí k životu hlavní část makra "\citeB".
 
-\inext{docite}{\empty}{+-}
+\inext{citeB}{\empty}{+-}
 
-Následuje kód makra \db bib "[<lejblík>]", které prostřednictvím
-\db wbib "{<lejblík>}{<hodnota>}" vloží do REF souboru propojené údaje o
-tom, jaké má "<lejblík>" přiřazeno číslo v seznamu literatury.
-Makro "\wbib" připojí před "\wref" příkaz "\immediate" právě tehdy, když
-"\wref" je ve stavu, kdy skutečně zapisuje do souboru REF.
-Makro \db Xbib pracuje při čtení souboru REF a dělá to, co jsme si řekli už
-dříve: nastaví hodnotu makra "\bib:<lejblík>" na "\bibnn{<hodnota>}&".
+Činnost "\cite" je konečně završena voláním maker
+\db printcite "<položka>" a \db printdashcite "<položka>". První z nich tiskne jednu 
+položku oddělenou od případné
+další čárkou, druhé tiskne položku, před kterou předchází pomlčka
+vyznačující interval položek. Pointa makra "\printcite" je v tom, že si samo
+po prvním zavolání upraví separátor \db citesep, který je globálně a tedy na začátku
+činnosti "\cite" prázdný. Při opakovaném volání "\printcite" se tedy
+vytiskne i požadovaný separátor. Pomlčka v~"\printdashcite" je schována do
+"\hbox", aby nedocházelo těsně za ní ke zlomu řádku.
+
+\inext{printcite}{\empty}{+-}
+
+Při použití \db nonumcitations potlačíme případné předchozí
+"\shortcitations" a "\sortcitations" a dále nastavíme \db citelinkA
+na jinou, než implicitní prázdnou hodnotu. Makro "\citelinkA" vytiskne 
+"\bim:<číslo citace>", tedy značku citace (je to nastaveno v "\Xbib").
+Není-li značka citace známá, vypíšeme varování a tiskneme "<číslo citace>".
+Makro \db etalchar je potřebné při použití Bib\TeX{}ového stylu "alpha".
+
+\inext{nonumcitations}{\empty}{+-}
+
+Makro \db ecite "[<lejblík>]{<text>}" nejprve provede 
+"\citeA#1,,,", tedy vlastně "\nocite[<lejblík>]" a pak si 
+\db eciteB vyzvedne ze "\savedcites"
+první údaj před čárkou, tedy "<číslo citace>", a uloží do "#1". V~"#2" je případný zbytek ze
+"\savedcites" a dále v "#3" pokračuje "<text>". Makro vytiskne jen
+"<text>", když je odkaz nedefinován, jinak vytiskne "<text>" prostřednictvím
+makra "\citelink".
+
+\inext{ecite}{\empty}{+-}
+
+Následuje kód makra \db bib "[<lejblík>]". Nejprve je ošetřeno, zda je použit
+zkrácený nebo rozšířený zápis "\bib[<lejblík>] = {<značka>}". V prvním
+případě se zavolá "\bibB" s prázdným "\bibmark", v druhém případě se
+"\bibmark" nejprve naplní prostřednictvím makra \db bibA.
+Makro \db bibB vloží prostřednictvím
+\db wbib "{<lejblík>}{<číslo citace>}{<značka>}" do REF souboru propojené údaje o
+tom, jaké má "<lejblík>" přiřazeno "<číslo citace>" v seznamu literatury.
+Makro "\tmpb" je naplněno "<lejblíkem>" pro případné použití v "\dest" (při
+draft módu) nebo pro použití v makru "\printbib".
+Makro "\wbib" připojí před "\wref" příkaz "\immediate", aby byly zapsány
+do REF souboru aktuální hodnoty parametrů.
 
 \inext{bib}{\empty}{+-}
 
+Makro \db Xbib pracuje při čtení souboru REF a dělá to, co jsme si řekli už
+dříve: nastaví hodnotu makra "\bib:<lejblík>" na "\bibnn{<číslo citace>}&".
+Dále definuje "\bim:<číslo citace>" jako třetí parametr, který je při použití 
+"\bib" prázdný, ale při čtení "*.bbl" souboru vygenerovaného pomocí 
+"alpha.bst" nebo "apalike.bst" tam bude uložena "<značka>". Dále "\Xbib"
+definuje \db lastbibnum jako "<číslo citace>", takže po přečtení REF souboru
+obsahuje největší použité "<číslo citace>". To se může hodit, pokud designér
+chce odsadit seznam literatury podle šířky největšího čísla citace. 
+
+\inext{Xbib}{\empty}{+-}
+
+Makro \db printbib se vloží na začátek každého záznamu v seznamu literatury.
+Implicitně vytiskne "\the\bibnum" v hranaté závorce a při "\nonumcitations"
+netiskne nic. V obou případech nastaví odsazení druhého a dalších řádků 
+odstavce na "\iindent". Designér si může toto makro předefinovat dle svého
+uvážení.
+
+\inext{printbib}{\empty}{+-}
+
 Makro \db addcitelist "{<lejblík>}" přidá do \db citelist údaj ve tvaru
-"\lcite[<lejblík>]". Hranaté závorky jsou použity proto, aby fungoval test
+\db citeI "[<lejblík>]". Hranaté závorky jsou použity proto, aby fungoval test
 "\isinlist\citelist{[<lejblík>]}". Jak uvidíme za chvíli, makro
 "\addcitelist" změní během činnosti makra "\usebibtex" svůj význam na
-\db writeaux, aby případné použití "\cite" až za "\usebitex" rovnou
+\db writeaux, aby případné použití "\cite" až za "\usebibtex" rovnou
 zapisovalo do AUX souboru. Podobně makro "\addcitelist" změní v makru
 "\usebbl" svůj význam \db writeXcite "{<lejblík>}", 
 aby v příštím průchodu \TeX{}em
@@ -2419,13 +2527,11 @@ V BBL souboru se vyskytují povely \db bibitem. Za každým z nich se možná
 objeví parametr v~hranaté závorce "[<značka>]" a následně je uveden
 "{<lejblík>}". Pak na dalších řádcích jsou bibliografická data jednoho
 záznamu ukončená prázdným řádkem. Objeví-li se "[<značka>]", dává tím
-Bib\TeX{} najevo, že se má tato "<značka>" použít místo běžného číslování
+Bib\TeX{} najevo, že se může tato "<značka>" použít místo běžného číslování
 záznamů. Následuje kód, který takové údaje přečte, vytiskne a vloží do REF
-souboru o tom zprávu prostřednictvím "\wref{<lejblík>}{<hodnota>}".
-Rozlišují se dva režimy tisku: není-li přítomna "[<značka>]" (makro "\tmpa"
-je prázdné), pak pomocí "\llap" vytiskneme "[<číslo>]". Jinak se posuneme o
-"-\iindent" a tiskneme "[<značku>]" následovanou mezerou. Pak se vytisknou
-další údaje bibliografického záznamu.
+souboru o tom zprávu prostřednictvím "\wref{<lejblík>}{<číslo citace>}{<značka>}".
+Makro "\tmpb" je naplněno "<lejblíkem>" pro případné použití v "\dest" (při
+draft módu) nebo pro použití v makru "\printbib".
 \dgn\nb bibitemB \dgn\nb bibitemC \dgn\nb bibitemD
 
 \inext{bibitem}{^^B\cbrace}{++}
@@ -2447,7 +2553,7 @@ prázdný řádek alias "\par") přečtena do parametru "#2" makra "\bibitemC".
 Celý údaj je pak vytištěn jen za předpokladu, že "[<lejblík>]" je přítomen 
 v seznamu "\citelist". Třetí makro "\bbl:c" pracuje jako druhé až na to, že
 údaj netiskne, ale zapamatuje si ho do makra "\bb:<lejblík>". Po takovém
-projití BBL souboru ještě projde "\citelist", kde se "\lcite[<lejblík>]"
+projití BBL souboru ještě projde "\citelist", kde se "\citeI[<lejblík>]"
 promění v "\bb:<lejblík>", takže se záznam vytiskne. Nyní ale v pořadí, v
 jakém jsou "<lejblíky>" zařazeny do "\citelist".
 
diff --git a/Master/texmf-dist/doc/cstex/opmac-u-en.pdf b/Master/texmf-dist/doc/cstex/opmac-u-en.pdf
new file mode 100644
index 00000000000..731fca0656b
--- /dev/null
+++ b/Master/texmf-dist/doc/cstex/opmac-u-en.pdf
diff --git a/Master/texmf-dist/doc/cstex/opmac-u-en.tex b/Master/texmf-dist/doc/cstex/opmac-u-en.tex
new file mode 100644
index 00000000000..95408df9a3e
--- /dev/null
+++ b/Master/texmf-dist/doc/cstex/opmac-u-en.tex
@@ -0,0 +1,1251 @@
+
+\input opmac
+
+\def\toasciidata{}\def\r{}
+
+\typosize[11/13]
+
+\def\thefnote{$^{\locfnum}$}
+
+\catcode`<=13
+\def<#1>{\hbox{$\langle$\it#1\/$\rangle$}}
+
+\activettchar"
+
+\insertoutline{CONTENTS} \outlines{0} \hyperlinks{\Blue}{\Green}
+
+
+\tit OPmac -- macros for plain\TeX\fnotemark1
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+ 
+\centerline{\it Petr Ol\v s\'ak, 2012, 2013, 2014}
+
+\bigskip
+\centerline{\url{http://petr.olsak.net/opmac-e.html}}
+
+
+\fnotetext {This text is second revised version. The first version was
+ published in TUGboat 34:1, 2013, pp.~88--96}
+
+\notoc\nonum \sec Contents\par\maketoc
+
+\nonum \sec Introduction
+%%%%%%%%%%%%
+
+The OPmac package is simple additional macros to plain\TeX{}. It enables
+users to take advantage of basic \LaTeX{} functionality: the font size
+selection, automatic creation of table of contents and index, working with
+bibliography databases, tables, references including hyperlinks option,
+margins settings, etc. 
+
+I have decided to publish my macros together with the new version of
+\csplain{}. I am using these macros long time for various purposes only in
+my own computer. Now, I have made them more clean and added the user and
+technical documentation and released them.
+
+The main reason is to give a set of macros which solves the common tasks to
+the plain\TeX{} users. The side effect is that the macros demonstrate
+that it is possible to do \TeX{} code simple and effective. Most of
+\LaTeX{} macro packages don't have this feature. All macros are in the single
+documented file "opmac.tex" with only 1700 lines. On the other hand the
+\LaTeX{} code which solves comparable tasks is placed in kernel and tens
+of \LaTeX{} packages with many tens of thousands lines in total.
+
+The main principles which I followed when creating this macro package, are:
+
+\begitems
+  * Simplicity is power.
+  * Macros are not universal, but are readable and understandable.
+  * User can easily redefine these macros as he/she wishes. 
+\enditems
+
+Each part of the macro code is written in order to maximize readability for
+human who will want to read it, understand it and change it. 
+
+OPmac package offers a markup language for authors of texts (like \LaTeX),
+i.e. the fixed set of tags to define the structure of the document. This
+markup is different from the \LaTeX{} markup. It may offer to write the
+source text of the document somewhat clearer and more attractive. The OPmac
+package, however, does not care for typographic of the document. The simple
+sober document is created if no additional macros are used. We assume that
+the author of additional macros is able to create a look of the document to
+suit specific requirement.
+
+OPmac has a small number of additional packages: "pdfuni", "opmac-xetex" and
+"opmac-bib" (see the end of \url{http://petr.olsak.net/opmac-e.html} page).
+Moreover, there exist many tens of little OPmac tricks comparable with 
+\LaTeX{} packages
+mentioned on \url{http://petr.olsak.net/opmac-tricks.html} page.
+
+\secnum=-1
+
+\sec Using OPmac
+%%%%%%%%%%%%%%%%
+
+OPmac is not compiled as a format. For using it in plain\TeX{}, you can simply
+"\input opmac" at the beginning of your document. The example of the simple
+document follows:
+
+\begtt
+\input opmac
+\typosize[11/13]   % setting the basic font size and the baselineskip
+\margins/1 a4 (1,1,1,1)in   % setting 1in margins for A4 paper
+
+Here is a text.
+\bye
+\endtt
+
+You can use \TeX, pdf\TeX, Xe\TeX{} or lua\TeX{} with eplain or \csplain{}
+preloaded. The \csplain{} is recommended but it is not explicitly requested if you
+don't need to use Czech/Slovak specific features\fnote
+{Warnings: ``falling back to ASCII sorting''
+or ``CZ/SK outline-conversion is off'' may occur without \csplain{}.}.
+
+
+\sec Font sizes
+%%%%%%%%%%%%%%%
+
+The commands for font size setting described here have local validity. It
+means that if you put them into group, the font sizes are selected locally.
+
+The command "\typosize[<fontsize>/<baselineskip>]" sets the font size of text and
+math fonts and baselineskip. If one of these two parameters is empty, the
+corresponding feature stays unchanged. The metric unit is supposed "pt" and
+this unit isn't written in parameters. You can change the unit by the
+command "\ptunit=<something-else>", for instance "\ptunit=1mm".
+Examples:
+
+\begtt
+\typosize[10/12]   % default of plainTeX
+\typosize[11/12.5] % font 11pt, baseline 12.5pt
+\typosize[8/]      % font 8pt, baseline unchanged
+\endtt
+
+The command
+"\typoscale[<font-factor>/<baselineskip-factor>]"
+sets the text and math fonts
+size and baselineskip as a multiple of the current fonts size and
+baselineskip. The factor is written in "scaled"-like way, it means that 1000
+means factor one. The empty parameter is equal to the parameter 1000,
+i.e. the value stays unchanged. Examples:
+
+\begtt
+\typoscale[800/800]    % fonts and baselineskip re-size to 80 %
+\typoscale[\magstep2/] % fonts bigger 1,44times
+\endtt
+
+The sizes declared by these macros (for example in titles) are relative to
+the basic size selected for the font (this may be arbitrary size, not only
+10pt).
+
+The size of the current font can be changed by the command
+"\thefontsize[<font-size>]" or can be rescaled by
+"\thefontscale[<factor>]". These macros don't change math fonts sizes nor
+baselineskip.
+
+The "\resizefont", "\regfont" and "\resizeall" commands (documented in
+\csplain) can be used even if
+the used format is not \csplain. The best
+design size of the font for desired size is selected. 
+For example "\typosize[18/]" selects the font "cmr17 at 18pt".
+
+The "\em" macro acts as "\it" if the current font is "\rm", acts as "\rm" if
+the current font is "\it", acts as "\bi" if the current font is "\bf" and
+acts as "\bf" if the current font is "\bi". The "\/" spaces are inserted
+automatically. Example:
+
+\begtt
+This is {\em important} text.     % = This is {\it important\/} text.
+\it This is {\em important} text. % = This is\/ {\rm important} text.
+\bf This is {\em important} text. % = This is {\bi important\/} text.
+\bi This is {\em important} text. % = This is\/ {\bf important} text.
+\endtt
+
+
+\sec Parts of the document
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+The document can be divided into chapters, sections and subsections and titled
+by "\tit" command. The parameters have to be separed by empty line (no
+braces are used):
+
+\begtt
+\tit Document title <empty line>
+\chap Chapter title <empty line>
+\sec Section title <empty line>
+\secc Subsection title <empty line>
+\endtt
+
+The chapters are numbered by one number, sections by two numbers
+(chapter.section) and subsections by three numbers. If there are no chapters
+then section have only one number and subsection two.
+
+The implicit design of the titles of chapter etc.\ are implemented in the
+macros "\printchap", "\printsec" and "\printsecc". User can simply change
+these macros if he/she needs another behavior.
+
+The first paragraph after the title of chapter, section and subsection is
+not indented but you can type "\let\firstnoindent=\relax" if you need all
+paragraphs indented.
+
+If a title is so long then it breaks to more lines. It is better to hint the
+breakpoints because \TeX{} does not interpret the meaning of the title.
+User can put the "\nl" (it means newline) macro to the breakpoints.
+
+The chapter, section or subsection isn't numbered if the "\nonum" precedes.
+And the chapter, section or subsection isn't delivered to the table of
+contents if "\notoc" precedes.
+
+
+\sec Another numbered objects
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+Apart from chapters, sections and subsections, there are another
+automatically numbered objects: equations and captions for tables and
+figures.
+
+If user write the "\eqmark" as the last element of the display mode then
+this equation is numbered. The format is one number in brackets. This number
+is reset in each section. 
+
+If the "\eqalignno" is used, then user can put "\eqmark" to the last column
+before "\cr". For example:
+
+\begtt
+\eqalignno{
+    a^2+b^2 &= c^2 \cr
+          c &= \sqrt{a^2+b^2} & \eqmark \cr}
+\endtt
+
+The next numbered object is caption which is tagged by "\caption/t" for
+tables and "\caption/f" for figures. Example:
+
+\begtt
+\hfil\table{rl}{
+    age   & value \crl\noalign{\smallskip}
+    0--1  & unmeasured \cr 
+    1--6  & observable \cr
+    6--12 & significant \cr
+   12--20 & extremal \cr
+   20--40 & normal \cr
+   40--60 & various \cr
+   60--$\infty$ & moderate}
+\par\nobreak\medskip
+\caption/t The dependency of the computer-dependency on the age.
+\endtt
+
+This example produces:
+
+\bigskip
+{\def\addto#1#2{\expandafter\def\expandafter#1\expandafter{#1#2}}
+\hfil\table{rl}{age   & value \crl\noalign{\smallskip}
+                0--1  & unmeasured \cr 
+                1--6  & observable \cr
+                6--12 & significant \cr
+               12--20 & extremal \cr
+               20--40 & normal \cr
+               40--60 & various \cr
+               60--$\infty$ & moderate}
+\par\nobreak\medskip
+{      \leftskip=\parindent plus1fil
+      \rightskip=\parindent plus-1fil
+      \parfillskip=0pt plus2fil \noindent
+{\bf Table 2.3} The dependency of the com\-puter-dependency on the age.\par}
+}
+\bigskip
+
+The word ``Table'' followed by a number is added by the macro 
+"\caption/t". The macro "\caption/f" creates the word figure.
+The caption text is centered. If it occupies more lines then the 
+last line is centered.
+
+The added word (table, figure) depends on the actual number of the
+"\language" register. OPmac implements the mapping from "\language"
+numbers to the languages and the mapping from languages to the generated
+words.
+
+If you wish to make the table or figure as floating object, you need to use
+plain\TeX{} macros "\midinsert", "\topinsert" and "\endinsert".
+
+Each automatically numbered object can be referenced, if the 
+"\label[<label>]" command precedes. The reference commands are 
+"\ref[<label>]" and "\pgref[<label>]". Example:
+
+\begtt
+\label[beatle] \sec About Beatles
+
+\label[comp-dependence]
+\hfil\table{rl}{...} % the table
+\caption/t The dependency of the computer-dependency on the age.
+
+\label[pythagoras]
+$$ a^2 + b^2 = c^2 \eqmark $$
+
+Now we can point to the section~\ref[beatle] on the page~\pgref[beatle] 
+or write about the equation~\ref[pythagoras]. Finally there 
+is an interesting Table~\ref[comp-dependence].
+\endtt
+
+If there are forward referenced objects then user have to run \TeX{} twice.
+During each pass, the working "*.ref" file (with refereces data) is created
+and this file is used (if it exists) at the begin of the document.
+
+
+\sec Lists 
+%%%%%%%%%%
+
+The list of items is surrounded by "\begitems" and "\enditems" commands.
+The asterisk ("*") is active within this environment and it starts one item.
+The item style can be chosen by "\style" parameter written after "\begitems":
+
+\begtt
+\style o % small bullet
+\style O % big bullet (default)
+\style - % hyphen char
+\style n % numbered items 1., 2., 3., ...
+\style N % numbered items 1), 2), 3), ...
+\style i % numbered items (i), (ii), (iii), ...
+\style I % numbered items I, II, III, IV, ...
+\style a % items of type a), b), c), ...
+\style A % items of type A), B), C), ...
+\style x % small rectangle
+\style X % big rectangle
+\endtt
+
+Another style can be defined by the command "\sdef{item:<style>}{<text>}".
+Default item can be redefined by "\def\normalitem{<text>}".
+The list environments can be nested. Each new level of item is indented by
+next multiple of "\iindent" which is set to "\parindent" by default.
+The vertical space at begin and end of the environment is inserted by the
+macro "\iiskip".
+
+
+\sec Table of contents
+%%%%%%%%%%%%%%%%%%%%%%
+
+The "\maketoc" command prints the table of contents of all "\chap", "\sec"
+and "\secc" used in the document. These data are read from external "*.ref" file, so
+you have to run \TeX{} more than once (typically three times if the table of
+contents is at the beginning of the document). 
+
+The name of the section with table of contents is not printed. The direct usage
+of "\chap" or "\sec" isn't recommended here because the table of contents 
+is typically not referenced to itself. You can print the unnumbered and unreferenced
+title of the section by the code:
+
+\begtt
+\nonum\notoc\sec Table of Contents
+\endtt
+
+The title of chapters etc.\ are written into the external file and they are
+read from this file in a next run of \TeX. This technique can induce some
+problems when a somewhat complicated macro is used in the title. OPmac
+solves this problem by different way than \LaTeX. User can set the
+problematic macro as ``robust'' by "\addprotect\macro" declaration. The
+"\macro" itself cannot be redefined. The common macros used in OPmac which
+can be occur in the titles are declared by this way. For example:
+
+\begtt
+\addprotect~ \addprotect\TeX \addprotect\thefontsize \addprotect\em
+\endtt
+
+
+\sec Making the index 
+%%%%%%%%%%%%%%%%%%%%%
+
+The index can be included into document by "\makeindex" macro. No external
+program is needed, the alphabetical sorting are done inside \TeX{} at macro
+level.
+
+The "\ii" command (insert to index) declares the word separated by the space
+as the index item. This declaration is represented as invisible atom on the
+page connected to the next visible word. The page number of the page where
+this atom occurs is listed in the index entry. So you can type:
+
+\begtt
+The \ii resistor resistor is a passive electrical component ...
+\endtt
+
+You cannot double the word if you use the "\iid" instead "\ii":
+
+\begtt
+The \iid resistor is a passive electrical component ...
+or:
+Now we'll deal with the \iid resistor .
+\endtt
+
+Note that the dot or comma have to be separated by space when "\iid" is
+used. This space (before dot or comma) is removed by the macro in 
+the current text.
+
+The multiple-words entries are commonly organized in the index by the format
+(for example): 
+
+\medskip
+
+linear~dependency  11, 40--50
+
+--- independency 12, 42--53
+
+--- space 57, 76
+
+--- subspace 58
+
+\medskip
+
+To do this you have to declare the parts of the words by the "/" separator.
+Example:
+
+\begtt
+{\bf Definition.}
+\ii linear/space,vector/space
+{\em Linear space} (or {\em vector space}) is a nonempty set of...
+\endtt
+
+The number of the parts of one index entry is unlimited. Note, that you can
+spare your typing by the comma in the "\ii" parameter. The previous example
+is equivalent to "\ii linear/space" "\ii vector/space".
+
+Maybe you need to propagate to the index the similar entry to the
+linear/space in the form space/linear. You can do this by the shorthand ",@"
+at the end of the "\ii" parameter. Example:
+
+\begtt
+\ii linear/space,vector/space,@
+is equivalent to:
+\ii linear/space,vector/space \ii space/linear,space/vector
+\endtt
+
+If you really need to insert the space into the index entry, write ``"~"''.
+
+The "\makeindex" creates the list of alphabetically sorted index entries
+without the title of the section and without creating more columns. OPmac
+provides another macros for more columns: 
+
+\begtt
+\begmulti <number of columns>
+<text>
+\endmulti
+\endtt
+
+The columns will be balanced. The Index can be printed by the following
+code:
+
+\begtt
+\sec Index\par
+\begmulti 3 \makeindex \endmulti
+\endtt
+
+Only ``pure words'' can be propagated to the index by the "\ii" command. It
+means that there cannot be any macro, \TeX{} primitive, math selector etc.
+But there is another possibility to create such complex index entry. Use
+``pure equivalent'' in the "\ii" parameter and map this equivalent to the
+real word which is printed in the index by "\iis" command. Example:
+
+\begtt
+The \ii chiquadrat $\chi$-quadrat method is 
+...
+If the \ii relax "\relax" command is used then \TeX\ is relaxing.
+...
+\iis chiquadrat {$\chi$-quadrat}
+\iis relax {{\tt \char`\\relax}}
+...
+\endtt
+
+The "\iis <equivalent> {<text>}" creates one entry in the ``dictionary 
+of the exceptions''. The sorting is done by the "<equivalent>" but the
+"<text>" is printed in the index entry list.
+
+The special sorting by the Czech or Slovak standard of alphabetical sorting
+is activated if \csplain{} is used and if "\language" register is set to the
+Czech or Slovak hyphenation patterns when "\makeindex" is in progress. The
+main difference from English sorting is that ``ch'' is treated as one
+character between h and i.
+
+
+\sec Colors
+%%%%%%%%%%%
+
+The colors selection macros are working only if pdf\TeX-like engine is used.
+OPmac provides a small number of color selectors: 
+{\localcolor\Blue "\Blue"}, 
+{\localcolor\Red "\Red"}, 
+{\localcolor\Brown "\Brown"},
+{\localcolor\Green "\Green"}, 
+{\localcolor\Yellow "\Yellow"}, 
+{\localcolor\Cyan "\Cyan"}, 
+{\localcolor\Magenta "\Magenta"}, 
+{"\White"}, 
+{\localcolor\Grey "\Grey"}, 
+{\localcolor\LightGrey "\LightGrey"} and
+"\Black". But user can define more
+such selectors by setting the CMYK components. For example
+
+\begtt
+\def\Orange{\setcmykcolor{0 0.5 1 0}}
+\endtt
+
+The selectors itself change the color of the text and of the lines with the
+thickness more than 1bp. If the "\linecolor" immediately precedes the color
+selector then the lines with thickness less or equal 1bp are colored. This
+is a second independent type of the color.
+
+The color selectors work globally on the one page. If the colored text is
+broken to the next page then the color is correctly set on the following
+page(s) after the second run of \TeX, because this event is implemented via
+external file. User can write "\localcolor" inside the group. This command
+saves the current color and restore it after the group is completed. It is
+supposed that the group corresponds to the boundary of a box which cannot break 
+to more pages. If this is not true case then user can use "\longlocalcolor" 
+instead "\localcolor". Example:
+
+\begtt
+\Red The text is red
+\hbox{\loacalcolor \Blue here is blue {\localcolor \Green and green}
+      restored blue \Brown and brown}
+now the text is red.
+\endtt
+
+\def\coloron#1#2#3{%
+   \setbox0=\hbox{#3}\leavevmode
+   {\localcolor\rlap{#1\strut \vrule width\wd0}#2\box0}%
+}
+The more usable example follows. It defines a macro which creates the
+\coloron\Yellow\Brown{colored text on the} 
+\coloron\Yellow\Brown{colored background}. Usage:
+"\coloron<background><foreground>{<text>}"
+
+The "\coloron" can be defined as follows:
+
+\begtt
+\def\coloron#1#2#3{%
+   \setbox0=\hbox{#3}\leavevmode
+   {\localcolor\rlap{#1\strut \vrule width\wd0}#2\box0}%
+}
+\coloron\Yellow\Brown{The brown text on the yellow backround}
+\endtt
+
+{\bf The watermark} is grey text on the backrounf of the page. OPmac offers
+an example: the macro "\draft" which creates grey scaled and rotated text
+DRAFT on the background of every page.
+
+
+\sec Hyperlinks, outlines
+%%%%%%%%%%%%%%%%%%%%%%%%%
+
+If the command "\hyperlins{<color-in>}{<color-out>}" is used at the beginning of
+the file, then the following objects are hyperlinked when PDF output is used:
+
+\begitems
+* numbers generated by "\ref" or "\pgref",
+* numbers of chapters, sections and subsections in the table of contents,
+* numbers or marks generated by "\cite" command (bibliography references),
+* texts printed by "\url" command.
+\enditems
+
+The last object is an external link and it is colored by
+"<color-out>". Others links are internal and they are colored by
+"<color-in>". Example:
+
+\begtt
+\hyperlinks \Blue \Green % internal links blue, URLs green.
+\endtt
+
+You can use another marking of active links: by frames which are visible in
+the PDF viewer but invisible when the document is printed. The way to do it
+is to define the macros "\pgborder", "\tocborder", "\citeborder",
+"\refborder" and "\urlborder" as the triple of RGB components of the used
+color. Example:
+
+\begtt
+\def\tocborder {1 0 0}  % links in table of contents: red frame
+\def\pgborder {0 1 0}   % links to pages: green frame
+\def\citeborder {0 0 1} % links to references: blue frame
+\endtt
+
+By default these macros are not defined. It means that no frames are created.
+
+There are ``low level'' commands to create the links. You can specify the
+destination of the internal link by "\dest[<type>:<label>]". The
+active text linked to the "\dest" can be created by
+"\link[<type>:<label>]{<color>}{<text>}". The "<type>" parameter is one of
+the "toc", "pg", "cite", "ref" or another special for your purpose. 
+
+The "\url" macro prints its parameter in "\tt" font and creates a potential
+breakpoints in it (after slash or dot, for example). If "\hyperlinks"
+declaration is used then the parameter of "\url" is treated as an external URL link.
+An example: "\url{http://www.olsak.net}" creates \url{http://www.olsak.net}.
+The charecters {\tt\%}, "\", "#", "$", "{" and "}" have to be protected by
+backslash in the "\url" argument, the other special charecters "~", "_",
+"^", "&" can be written as single character. You can insert the "\|" command 
+in the "\url" argument as a potential breakpoint.
+
+If the linked text have to be different than the URL, you can use
+"\ulink[<url>]{text}" macro. For example:
+
+\begtt
+\ulink[http://www.olsak.net/opmac-e.html]{OPmac page}
+\endtt
+creates
+\ulink[http://www.olsak.net/opmac-e.html]{OPmac page}.
+
+The PDF format provides ``outlines'' which are notes placed in the special frame of
+the PDF viewer. These notes can be managed as structured and hyperlinked
+table of contents of the document. The command "\outlines{<level>}" creates
+such outlines from data used for table of contents in the document. The
+"<level>" parameter gives the level of opened sub-outlines
+in the default view. The deeper levels can be open by mouse click on the
+triangle symbol after that.\looseness=-1
+
+The strings used in PDF outlines are converted if \csplain{} is used: the
+accents are stripped off because they can make problems in outlines. But
+user can use "\input pdfuni" in order to convert these strings to internal
+UNICODE representation.
+
+The command "\insertoutline{<text>}" inserts next entry into PDF outlines at
+the main level~0. This entry can be placed before table of contents (created
+by "\outlines") or after it.
+
+
+\sec Verbatim
+%%%%%%%%%%%%%
+
+The display verbatim text have to be surrounded by the "\begtt" and
+"\endtt" couple. 
+The inline verbatim have to be tagged (before and after) 
+by a character which is declared by
+"\activettchar<char>". For example "\activettchar"{\tt\char`"} 
+declares the
+{\tt\char`"} for inline verbatim markup. 
+
+If the numerical register "\ttline" is set to the non-negative value then
+display verbatim will number the lines. The first line has the number
+"\ttline+1" and when the verbatim ends then the "\ttline" value is equal to the
+number of last line printed. Next "\begtt...\endtt" environment will follow
+the line numbering. OPmac sets "\ttline=-1" by default.
+
+The indentation of each line in display verbatim is controlled by
+"\ttindent" register. This register is set to the "\parindent" when
+"opmac.tex" is read. User have to change its value if the "\parindent" is
+changed after reading of "opmac.tex".
+
+The "\begtt" starts internal group in which the catcodes are changed. Then
+the "\tthook" macro is run. This macro is empty by default and user can
+control fine behavior by it. For example the cactodes can be reset here. If
+you need to define active character in the "\tthook", use "\adef" as in the
+following example:
+
+{\def\tthook{\adef@{\string\endtt}}
+\begtt
+\def\tthook{\adef!{?}\adef?{!}}
+\begtt
+Each occurrence of the exclamation mark will be changed to 
+the question mark and vice versa. Really? You can try it! 
+@
+\endtt
+}
+
+The "\adef" command sets its parameter as active {\it after\/}
+the body of "\tthook" is read. So you can't worry about active
+categories. 
+
+There are tips for global "\tthook" definitions here:
+
+\begtt
+\def\tthook{\typosize[9/11]}     % setting font size for verbatim
+\def\tthook{\ttline=0}           % each listing will be numbered from one
+\def\tthook{\adef{ }{\char`\ }}  % visualisation of spaces
+\endtt
+
+You can print verbatim listing from external files by "\verbinput" command. 
+Examples:
+
+\begtt
+\verbinput (12-42) program.c  % listing from program.c, only lines 12-42
+\verbinput (-60) program.c    % print from begin to the line 60
+\verbinput (61-) program.c    % from line 61 to the end
+\verbinput (-) program.c      % whole file is printed
+\verbinput (70+10) program.c  % from line 70, only 10 lines printed
+\verbinput (+10) program.c    % from the last line read, print 10 lines 
+\vebrinput (-5+7) program.c   % from the last line read, skip 5, print 7
+\verbinput (+) program.c      % from the last line read to the end
+\endtt
+
+
+The "\ttline" influences the line numbering by the same way as in
+"\begtt...\endtt" environment. If "\ttline=-1" then real line numbers are
+printed (this is default). If "\ttline"{\tt\char`\<-1} then no line 
+numbers are printed. 
+
+The "\verbinput" can be controlled by "\tthook", "\ttindent" just like
+in "\begtt...\endtt".
+
+
+\sec Tables
+%%%%%%%%%%%
+
+The macro "\table{<declaration>}{<data>}" provides similar "<declaration>"
+as in \LaTeX: you can use letters "l", "r", "c", each letter declares 
+one column (aligned to left, right, center respectively). 
+These letters can be combined by the ``{\tt\char`\|}'' character 
+(vertical line). Example
+
+\begtt
+\table{||lc|r||}{                  \crl
+   Month    & commodity & price    \crli 
+                                   \tskip.2em
+   January  & notebook   & \$ 700  \cr
+   February & skateboard & \$ 100  \cr
+   July     & yacht      & k\$ 170 \crl}
+\endtt
+%
+generates the following result:
+
+\bigskip
+\table{||lc|r||}{               \crl
+   Month    & commodity & price \crli 
+                                     \tskip.2em
+   January  & notebook   &  \$ 700    \cr
+   February & skateboard &  \$ 100    \cr
+   July     & yacht      & k\$ 170   \crl}
+\bigskip
+
+The command "\cr" is generally known. Moreover OPmac defines following similar
+commands:
+
+\begitems
+* "\crl" \dots\ the end of the row with a horizontal line after it.
+* "\crli" \dots\ like "\crl" but the horizontal line doesn't intersect the
+      vertical double lines.
+* "\crlli" \dots\ like "\crli" but horizontal line is doubled.
+\enditems
+
+The "\tskip<dimen>" command works like the "\noalign{\vskip<dimen>}" 
+after "\cr*" commands but it doesn't interrupt the vertical lines.
+
+The configuration macros for "\table" are defined in the following listing
+with their default values:
+
+\begtt
+\def\tabiteml{\enspace} % left material in each column
+\def\tabitemr{\enspace} % right material in each column
+\def\tabstrut{\strut}   % strut inserted in each line
+\def\vvkern{1pt}        % space between double vertical line
+\def\hhkern{1pt}        % space between double horizontal line
+\endtt
+
+If you do "\def\tabiteml{$\enspace}\def\tabitemr{\enspace$}" then
+the "\table" acts like \LaTeX's array environment.
+
+The "\frame{<text>}" makes a frame around "<text>". You can put the whole "\table"
+into "\frame" if you need double-ruled border of the table. Example:
+
+\begtt
+\frame{\table{|c||l||r|}{\crl
+  \multispan3\vrule\hss\bf Title\hss \vrule\tabstrut \crl
+                   \noalign{\kern\hhkern}\crli
+  first & second & third  \crlli
+  seven & eight  & nine   \crli}}
+\endtt
+%
+creates the following result:
+
+\bigskip
+\frame{\table{|c||l||r|}{\crl
+  \multispan3\vrule\hss\bf Title\hss \vrule\tabstrut \crl
+  \noalign{\kern\hhkern}\crli
+  first & second & third  \crlli
+  seven & eight  & nine   \crli}}
+\bigskip
+
+The "c", "l" and "r" are default <declaration> letters but you can define
+more such letters by "\def\tabdeclare<letter>{<left>##<right>}". For
+example:
+
+\begtt
+\newdimen\Pwidth
+\def\tabdeclareP {\enskip\vtop{\hsize=\Pwidth \rightskip=0pt plus1fil
+   \baselineskip=1.2em\lineskiplimit=0pt\noindent##\tabstrutA}\hss\enskip}
+\endtt 
+%
+declares the letter P which means the tabular column with "\vtop"s. This is
+similar to \LaTeX's parbox.
+
+The rule width of tables (and implicit width of all "\vrule"s and "\hrule"s)
+can be set by the command "\rulewidth=<dimen>". The default value given 
+by \TeX{} is 0.4pt.
+
+Many tips about tables can be seen on
+\url{http://petr.olsak.net/opmac-tricks.html}.
+
+\sec Images
+%%%%%%%%%%%
+
+The "\inspic <filename>.<extension><space>" inserts the picture stored in
+the graphics file  with the name "<filename>.<extension>". 
+You can set the picture width by "\picw=<dimen>" before first "\inspic" command
+which declares the width of the picture. 
+The files can be in the PNG, JPG, JBIG2 or PDF format. The "\inspic" command
+works with pdf\TeX{}/Xe\TeX{} only.
+
+The "\picwidth" is an equivalent register to "\picw". Moreover there is an
+"\picheight" register which denotes the height of the picture. If both
+registers are set then the picture will be (probably) deformed. 
+
+The file is searched in "\picdir". This macro is empty by default, this
+means that the file is searched in current directory.
+
+\sec PDF transformations
+%%%%%%%%%%%%%%%%%%%%%%%%
+
+All typesetting elements are transformed in pdf\TeX{} by linear
+transformation given by the current transformation matrix. The
+"\pdfsetmatrix {<a> <b> <c> <d>}" command makes the internal multiplication
+with the current matrix so linear transformations can be composed. The
+stack-oriented commands "\pdfsave" and "\pdfrestore" gives a possibility of
+storing and restoring the current transformation matrix and current point.
+The possition of current point have to be the same from \TeX{}'s point of
+view as from transformation point of view when "\pdfrestore" is processed.
+Due to this fact the "\pdfsave\rlap{<transformed text>}\pdfrestore" 
+or something similar is recomeded.
+
+OPmac provides the macros 
+
+\begtt
+\pdfscale{<horizontal-factor>}{<vertical-factor>} 
+\pdfrotate{<angle-in-degrees>}
+\endtt 
+
+These macros simply calls the
+properly "\pdfsetmatrix" primitive command.
+
+It is known that the comosition of transformations is not commutative. It
+means that the order is important. You have to read the tranformation
+matrices from right to left. Example:
+
+\begtt
+First: \pdfsave \pdfrotate{30}\pdfscale{-2}{2}\rlap{text1}\pdfrestore
+      % text1 is scaled two times and it is reflected about vertical axis
+      % and next it is rotated by 30 degrees left.
+second: \pdfsave \pdfscale{-2}{2}\pdfrotate{30}\rlap{text2}\pdfrestore
+      % text2 is rotated by 30 degrees left then it is scaled two times
+      % and reflected about vertical axis.
+third: \pdfsave \pdfrotate{-15.3}\pdfsetmatrix{2 0 1.5 2}\rlap{text3}%
+       \pdfrestore % first slanted, then rotated by 15.3 degrees right
+\endtt
+
+\bigskip\smallskip
+This gives the following result. 
+First: \pdfsave \pdfrotate{30}\pdfscale{-2}{2}\rlap{text1}\pdfrestore
+second: \pdfsave \pdfscale{-2}{2}\pdfrotate{30}\rlap{text2}\pdfrestore
+third: \pdfsave \pdfrotate{-15.3}\pdfsetmatrix{2 0 1.5 2}\rlap{text3}\pdfrestore
+\bigskip\bigskip
+
+\sec Footnotes and marginal notes
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+The plain\TeX{}'s macro "\footnote" is not redefined. But a new macro 
+"\fnote{<text>}" is defined. The footnote mark is added automatically and it
+is numbered on each page from one\fnote
+{This behavior is changed if {\tt\char`\\runningfnotes} is used: 
+the footnotes are numbered from one in whole document in such case.
+Alternatives are possible, see OPmac tricks or technical documentation.}. 
+The "<text>" is scaled by
+"\typoscale[800]". The implicit visual aspect of the footnote mark is defined by
+"\def\thefnote{$^{\locfnum}$)}". User can redefine it, for example:
+
+\begtt
+\def\thefnote{\ifcase\locfnum\or
+   *\or**\or***\or$^{\dag}$\or
+   $^{\ddag}$\or$^{\dag\dag}$\fi}
+\endtt
+
+The "\fnote" macro is fully applicable only in ``normal outer'' paragraph.
+It doesn't work inside boxes (tables for example). If you are solving such
+case you can use "\fnotemark<number>" inside the box (only the footnote mark is
+generated). When the box is finished you can use "\fnotetext{<text>}". This
+macro puts the "<text>" to the footnote. The "<number>" after "\fnotemark"
+have to be "1" if only one such command is in the box. Second "\fnotemark"
+inside the same box have to have the parameter "2" etc. 
+The same number of "\fnotetext"s have to be written 
+after the box as the number of "\fnotemark"s inserted inside the box.
+
+The marginal note can be printed by the "\mnote{<text>}" macro. The <text>
+is placed to the right margin on the odd pages and it is placed to the left
+margin on the even pages. This is done after second \TeX{} run because the
+relevant information is stored in an external file. If you need to place the
+notes only to the fixed margin write "\fixmnotes\right" or
+"\fixmnotes\left".
+
+The <text> is formatted as a little paragraph with the maximal width
+"\mnotesize" ragged left on the left margins or ragged right on the right
+margins. The first line of this little paragraph is at the same height as
+the invisible mark created by "\mnote" in the current paragraph. The
+exceptions are possible by "\mnoteskip" register. You can implement such
+exceptions to each "\mnote" manually in final printing in order to margin
+notes do not overlap. The positive value of "\mnoteskip" shifts the note up
+and negative value shifts it down. For example
+"\mnoteskip=2\baselineskip \mnote{<text>}" shifts this (and only this) note 
+two lines up.
+
+
+\sec Bib\TeX ing
+%%%%%%%%%%%%%%%%
+
+The command "\cite[<label>]" or its variations of the type
+\hbox{"\cite[<label-1>,<label-2>,<label-3>]"}
+create the citations in the form [42] or [15,~19,~26]. 
+If "\shortcitations" is declared at the beginning of the document then continuous sequences of
+numbers are re-printed like this: \hbox{[3--5,~7,~9--11]}. If
+"\sortcitations" is declared then numbers generated by one "\cite" command
+are sorted upward.
+
+If "\nonumcitations" is used then the marks instead numbers are generated
+depending on the used bib\TeX{} style. For example the citations look like
+[Now08] when "alpha" style is used and like [Nowak, 2008] when "apalike"
+style is used.
+
+The "\rcite[<labels>]" creates the same list as "\cite[<labels>]" but without
+the outer brackets. Example: "[\rcite[tbn], pg.~13]" creates [4,~pg.13].
+
+The "\ecite[<label>]{<text>}" prints the "<text>" only, but the entry labeled
+"<label>" is decided as to be cited. If "\hyperlinks" is used then "<text>"
+is linked to the references list.
+
+You can define alternative formating of "\cite" command. Example:
+
+\begtt
+\def\cite[#1]{(\rcite[#1])}    % \cite[<label>] creates (27)
+\def\cite[#1]{$^{\rcite[#1]}$} % \cite[<label>] creates^{27}
+\endtt
+
+The numbers printed by "\cite" correspond to the same numbers generated in
+the list of references. There are four possibilities to generate this
+references list:
+
+\begitems
+* Manually using "\bib[<label>]" commands.
+* Using bib\TeX{} and "\usebibtex{<bib-base>}{<bib-style>}" command.
+* Using pregenerated "*.bbl" file and "\usebbl/<type> <bbl-base>" command.
+* By "\usebib/<type> (<style>) <bbl-base>" command which reads "*.bib"
+  databases directly. 
+\enditems
+
+These possibilities are documented here in detail:
+
+\medskip\noindent
+{\bf References created manually using "\bib[<label>]" command.}
+
+{\def\tthook{\catcode`/=0 \catcode`+=9 }
+\begtt
+\bib [tbn] P. Ol/v+s/'ak. {\it\TeX{}book naruby.} 468~s. Brno: Konvoj, 1997.
+\bib [tst] P. Ol/v+s/'ak. {\it Typografick/'y syst/'em \TeX.}  
+           269~s. Praha: CSTUG, 1995.
+\endtt
+}
+
+If you are using "\nonumcitations" then you need to declare the "<marks>"
+used by "\cite" command. To do it you have to use long form of the "\bib"
+command which is in the format "\bib[<label>] = {<mark>}". The spaces around
+equal sign are mandatory. Example:
+
+{\def\tthook{\catcode`/=0 \catcode`+=9 }
+\begtt
+\bib [tbn] = {OlĹĄĂĄk, 2001} 
+    P. Ol/v+s/'ak. {\it\TeX{}book naruby.} 468~s. Brno: Konvoj, 2001.
+\endtt
+}
+
+{\bf References using bib\TeX.}
+The command "\usebibtex{<bib-base>}{<bst-style>}"
+ creates the list of cited entries and entries indicated by
+"\nocite[<label>]". 
+After first \TeX{} run the "*.aux" file is created, so user have to run
+the bib\TeX{} by the command "bibtex <document>". After second \TeX{} run 
+the bib\TeX's
+output is read and after third \TeX{} run all references are properly
+created.
+
+The "<bib-base>" is one or more "*.bib" database source files (separated by
+spaces and without extension) and the "<bst-style>" is the style used by
+bib\TeX. The common styles are "plain", "alpha", "apalike", "ieeetr",
+"unsrt". 
+
+\medskip\noindent
+{\bf Using pregenerated "*.bbl" file by bib\TeX.}
+You can create the temporary file ("mybase.tex", for example) 
+which looks like:
+
+\begtt
+\input opmac  
+\genbbl{<bib-base>}{<bst-style>}  
+\end
+\endtt
+%
+After first \TeX{} run the "mybase.aux" is generated. Then you can run
+"bibtex mybase" which generates the ".bbl" file with all entries from the
+"<bib-base>" "*.bib" file(s). Second \TeX{} run on the file "mybase.tex" generates
+the printed form of the list of all bib entries with labels. This is usable
+printed matter, you can place it to your notice board when you create
+your document. Finally you can insert to your real document one of the
+following commands:
+
+\begtt
+\usebbl/a mybase  % print all entries from mybase.bbl (a=all) 
+\usebbl/b mybase  % print only \cited and \nocided entries
+                  % sorted by mybase.bbl  (b=bbl)
+\usebbl/c mybase  % print only \cited and \nocited entries
+                  % sorted by \cite-order (c=cite)
+\endtt
+
+Sometimes the pure \LaTeX{} command occurs (unfortunately) 
+in the ".bib" database or bib\TeX{}
+style. User can define such commands in the "\bibtexhook" macro which is a
+hook started inside the group before ".bbl" file is read. Example:
+
+\begtt
+\def\bibtexhook{\def\emph##1{{\em##1}}\def\frac##1##2{{##1\over##2}}}
+\endtt
+
+\noindent
+{\bf Direct reading of ".bib" files} is possible after "\input opmac-bib".
+This package uses the external package "librarian.tex" by Paul Isambert. 
+The usage is similar to previous case:
+
+\begtt
+                           % print only \cited and \nocited entries
+\usebib/c (<style>) <bib-base> % sorted by \cite-order (c=cite),
+\usebib/s (<style>) <bib-base> % sorted by style (s=style).
+\endtt
+
+The "<bib-base>" is one or more "*.bib" database source files (separated by
+spaces and without extension) and the "<style>" is the part of the filename
+"opmac-bib-<style>.tex" where the formatting of the references list is
+defined. Possible styles are "simple" or "iso690". The behavior of
+"opmac-bib.tex" and "opmac-bib-iso690.tex" is full documented in these files
+(after "\endpinput" command).
+
+\medskip\noindent
+{\bf Formatting of the references list} is controlled by the "\printb" macro.
+It is called at the begin of each entry. The default "\printb" macro prints
+the number of the entry in square brackets. If the "\nonumcitations" is set
+then no numbers are printed, only all lines (but no first one) are indented.
+The "\printb" macro can use the following values: "\the\bibnum" (the number
+of the entry) and "\the\bibmark" (the mark of the entry used when
+"\nonumcitations" is set). Examples:
+
+\begtt
+% The numbers are without square brackets:
+\def\printbib{\hangindent=\parindent \indent \llap{\the\bibnum. }}
+% Printing of <marks> when \nonumcitations is set:
+\def\printbib{\hangindent=\parindent \noindent [\the\bibmark]\quad}
+\endtt 
+
+Next examples can be found on the 
+\ulink[http://petr.olsak.net/opmac-tricks.html]{OPmac tricks WWW page}.
+
+
+\sec Typesetting math
+%%%%%%%%%%%%%%%%%%%%%
+
+There are two files for math typesetting prepared in \csplain:
+
+\begitems
+* "ams-math.tex" loads the AMS math fonts visual compatible with Computer
+  modern.
+* "tx-math.tex" loads the TX fonts visual compatible with Times.
+\enditems
+
+OPmac reads the first file "ams-math.tex" by default. If you are using font
+files from \csplain{} ("ctimes.tex", "cbookman.tex", "cs-termes.tex" etc.)
+then the second math-file "tx-math.tex" is loaded.
+
+This section describes the features of the macros from "ams-math.tex" or
+"tx-math.tex". More documentation is written in these files themselves. 
+
+Hundreds math symbols and operators like in AMS\TeX{} are accesible. 
+For example  "\alpha" $\alpha$, "\geq" $\geq$, "\sum" $\sum$, 
+"\sphericalangle" $\sphericalangle$, "\bumpeq", $\bumpeq$. See AMS\TeX{}
+manual (or TX-fonts manual) for complete list of symbols.
+
+The following math alphabets are available:
+
+{\def\tthook{\catcode`\$=3 \catcode`/=0 \medmuskip=0mu}%
+\begtt
+\mit     % mathematical variables    $abc-xyz,ABC-XYZ$
+\it      % text italics              $/it abc-xyz,ABC-XYZ$
+\rm      % text roman                $/rm abc-xyz,ABC-XYZ$
+\cal     % normal calligraphics      $/cal ABC-XYZ$
+\script  % script                    $/script ABC-XYZ$
+\frak    % fracture                  $/frak abc-xyz,ABC-XYZ$
+\bbchar  % double stroked letters    $/bbchar ABC-XYZ$
+\bf      % sans serif bold           $/bf abc-xyz,ABC-XYZ$
+\bi      % sans serif bold slanted   $/bi abc-xyz,ABC-XYZ$
+\endtt
+}
+
+The last two selectors "\bf" and "\bi" select the sans serif fonts regardless
+current text font family. The reason is that these shapes are used for
+vectors and matrices in Czech math typesetting.
+
+The math fonts are scaled by "\typosize" and "\typoscale" macros.
+Two math fonts collections are prepared: "\normalmath" for normal weight
+and "\boldmath" for bold. The first one is set by default.
+There is an example for math typesetting in titles:
+
+\begtt
+\def\title#1\par{\centerline{\typosize[17/]\bf\boldmath #1}}
+\title The title with math $\int_a^b f(x) {\rm d}x$ is here
+\endtt
+
+Variables are printed by special math italics when "ams-math.tex" is loaded
+and by text italics of the current text font when "tx-math.tex" is loaded.
+You can change this behavior by following commands:
+
+\begtt
+\itvariables  % variables typeset by text italics.
+\mitvariables % mariables typeset by math italics.
+\endtt
+
+
+\sec Setting the margins
+%%%%%%%%%%%%%%%%%%%%%%%%
+
+OPmac declares paper formats a4, a4l (landscape~a4), a5, a5l, b5, letter and
+user can declare another own format by "\sdef":
+
+\begtt
+\sdef{pgs:b5l}{(250,176)mm} 
+\sdef{pgs:letterl}{(11,8.5)in}
+\endtt
+
+The "\margins" command declares margins of the document. This command have
+the following parameters:
+
+\begtt
+\margins/<pg> <fmt> (<left>,<right>,<top>,<bot>)<unit>
+  example:
+\margins/1 a4 (2.5,2.5,2,2)cm
+\endtt
+
+Parameters are:
+
+\begitems
+* <pg> \dots\ "1" or "2" specifies one-page or two-pages design.
+* <fmt> \dots\ paper format (a4, a4l, etc.).
+* <left>, <right>, <top>, <bot> \dots\ gives the amount of left, right,
+      top and bottom margins.
+* <unit> \dots\ unit used for values <left>, <right>, <top>, <bot>.
+\enditems
+
+Each of the parameters <left>, <right>, <top>, <bot> can be empty.
+If both <left> and <right> are nonempty then "\hsize" is set. Else "\hsize"
+is unchanged. If both <left> and <right> are empty then typesetting area is
+centered in the paper format. The analogical rule works when <top> or <bot>
+parameter is empty ("\vsize" instead "\hsize" is used). Examples:
+
+\begtt
+\margins/1 a4 (,,,)mm   % \hsize, \vsize untouched, 
+                        % typesetting area centered
+\margins/1 a4 (,2,,)cm  % right margin set to 2cm
+                        % \hsize, \vsize untouched, vertically centered
+\endtt
+
+If "<pg>=1" then all pages have the same margins. If "<pg>=2" then the
+declared margins are true for odd pages. The margins at the even pages are
+mirrored in such case, it means that <left> is replaced by <right> and vice
+versa.
+
+The command "\magscale[<factor>]" scales the whole typesetting area. The
+fixed point of such scaling is the so called the ``Knuth's point'': 1in
+below and 1in right of paper sides. Typesetting (breakpoints etc.) is
+unchanged. All units are relative after such scaling. Only paper formats
+dimensions stays unscaled. Example:
+
+\begtt
+\margins/2 a5 (22,17,19,21)mm
+\magscale[1414] \margins/1 a4 (,,,)mm
+\endtt
+%
+The first line sets the "\hsize" and "\vsize" and margins for final
+printing at a5 format. The setting on the second line centers the scaled 
+typesetting area to the true a4 paper while breaking points for paragraphs
+and pages are unchanged. It may be usable for 
+review printing. After review is done, the second line can be commented out.
+
+\sec The last page
+%%%%%%%%%%%%%%%%%%
+
+The number of the last page (it may be different from number of pages) is
+stored in the "\lastpage" register after first \TeX{} run if the working "*.ref" 
+file is open. This file isn't open for every documents; only for those
+where the forward references are printed or table of contents is created.
+If the "*.ref" file isn't open for your document and you need to use the "\lastpage"
+register then you have to write the command "\openref". This command opens
+the "*.ref" file immediatelly.
+
+There is an example for footlines in the format ``current page / last
+page'': 
+
+\begtt
+\footline={\hss \rm \thefontsize[10]\the\pageno/\the\lastpage \hss}
+\endtt
+
+\sec Summary
+%%%%%%%%%%%%
+
+\def\tthook{\adef!{\string\endtt}\adef&{\kern.25em}}
+\begtt
+\tit Title (terminated by a blank line)
+\chap Chapter Title (terminated by a blank line)
+\sec Section Title (terminated by a blank line)
+\secc Subsection Title (terminanted by a blank line)
+
+\maketoc         % table of contents generation
+\ii item1,item2  % insertion the items to the index
+\makeindex       % the index is generated
+
+\label [labname]  % link target location
+\ref [labname]    % link to the chapter, section, subsection, equation
+\pgref [labname]  % link to the page of the chapter, section, ...
+
+\caption/t  % a numbered table caption
+\caption/f  % a numbered caption for the picture
+\eqmark     % a numbered equation
+
+\begitems       % start list of the items
+\enditems       % end of list of the items
+\begtt          % start verbatim text
+!          % end verbatim text
+\activettchar X % initialization character X for in-text verbatim
+\verbinput      % verbatim extract from the external file
+\begmulti num   % start multicolumn text (num columns)
+\endmulti       % end multicolumn text
+
+\cite [labnames]  % refers to the item in the lits of references
+\rcite [labnames] % similar to \cite but [] are not printed.
+\sortcitations \shortcitations \nonumcitations % cite format
+\bib [labname]  % an item in the list of references
+\usebibtex {bib-base}{bst-style}  % use BibTeX for bibliography
+\genbbl {bib-base}{bst-style}     % prepare the bbl file generation
+\usebbl/? bbl-base   % use pre-generated bbl file, ? in {a,b,c}
+\usebib/? (style) bib-base % direct using of .bib file, ? in {s,c}
+
+\typosize [font-size/baselineskip] % size setting of typesetting
+\typoscale [factor-font/factor-baselineskip] % size scaling
+\thefontsize [size] \thefontscale [factor]   % current font size
+
+\inspic file.ext    % insert a picture, extensions: jpg, png, pdf
+\table {rule}{data} % simple macro for the tables like in LaTeX
+
+\fnote    % footnote (local numbering on each page)
+\mnote    % note in the margin (left or right by page number)
+
+\hyperlinks {color-in}{color-out} % PDF links activate as clickable
+\outlines {level}   % PDF will have a table of contents in the left tab
+
+\magscale[factor]  % resize typesetting, line/page breaking unchanged
+\margins/pg format (left, right, top, bottom)unit % margins setting
+\endtt
+
+\end
diff --git a/Master/texmf-dist/doc/cstex/opmac-u.pdf b/Master/texmf-dist/doc/cstex/opmac-u.pdf
index 31c66e6975b..df1709d7c10 100644
--- a/Master/texmf-dist/doc/cstex/opmac-u.pdf
+++ b/Master/texmf-dist/doc/cstex/opmac-u.pdf
diff --git a/Master/texmf-dist/doc/cstex/opmac-u.tex b/Master/texmf-dist/doc/cstex/opmac-u.tex
index ec321439e99..d005632afdd 100644
--- a/Master/texmf-dist/doc/cstex/opmac-u.tex
+++ b/Master/texmf-dist/doc/cstex/opmac-u.tex
@@ -20,7 +20,7 @@
 \tit OPmac -- rozšiřující makra plain\TeX{}u
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-\centerline{\it Petr OlĹĄĂĄk, listopad, prosinec 2012}
+\centerline{\it Petr OlĹĄĂĄk, 2012, 2013, 2014}
 
 \bigskip
 \centerline{\url{http://petr.olsak.net/opmac.html}}
@@ -748,7 +748,11 @@ VyskytujĂ­-li se v~argumentu "\url" znaky
 "%", "\", "#", "$", "{" a "}", je třeba použít 
 "\%", "\\", "\#", "\$", "\{" a "\}".
 OstatnĂ­ speciĂĄlnĂ­ znaky "~", "_", "^", "&" lze napsat do parametru "\url"
-přímo. Libovolný text odkazovaný na webovou stránku lze vložit pomocí
+přímo. 
+Dále je možno do parametru "\url" napsat "\|" k označení místa, kde
+je dovoleno zlomit řádek.
+%
+LibovolnĂ˝ text odkazovanĂ˝ na webovou strĂĄnku lze vloĹžit pomocĂ­
 "\ulink[<URL>]{<text>}". Například odkaz na
 \ulink[http://petr.olsak.net/opmac.html]{stránky OPmac} jsou vytvořeny
 pomocĂ­ "\ulink[http://petr.olsak.net/opmac.html]{strĂĄnky OPmac}".
@@ -1193,39 +1197,77 @@ nahoru. Při záporné hodnotě se posune dolů. Například
 \sec BibliografickĂŠ Ăşdaje
 %%%%%%%%%%%%%%%%%%%%%%%%%
 
+{\bf Odkazy.}
 PomocĂ­ "\cite[<lejblĂ­k>]" nebo "\cite[<lejbĂ­k1>,<lejblĂ­k2>,<lejblĂ­k3>]"
-(atd.) vytvoříme v textu odkazy na položky v seznamu literatury. V seznamu
-literatury je třeba uvést záznamy, které mají odkazované lejblíky. Tyto
-záznamy dostanou v seznamu automaticky vygenerovaná čísla a sekvence "\cite"
-se pak promění na číselné odkazy, například [27] nebo [18,~24,~42] (atd.).
-Souvislé řady čísel [1,~2,~3,~5,~6] se promění v~intervaly [1--3,~5--6~]
-jen tehdy, kdyĹž je v ĂşvodnĂ­ deklaraci dokumentu napsĂĄno "\shortcitations".
-
-Seznam literatury je možné vložit do dokumentu třemi různými
+atd. vytvoříme v~textu odkazy na položky v seznamu literatury. V
+seznamu literatury je třeba uvést záznamy, které mají odkazované lejblíky.
+Tyto záznamy dostanou v seznamu automaticky vygenerovaná čísla a sekvence
+"\cite" se pak promění na číselné odkazy, například [27] nebo [18,~24,~42]
+atd. Souvislé řady čísel [1,~2,~3,~5,~6] se promění v~intervaly
+[1--3,~5--6] jen tehdy, kdyĹž je v ĂşvodnĂ­ deklaraci dokumentu napsĂĄno
+"\shortcitations". A seřadí se podle velikosti při "\sortcitations".
+
+Při "\nonumcitations" se odkazy nepřevádějí na čísla. K tomu je potřeba
+použít navazující Bib\TeX{}ový styl (např. "alpha", "apalike") nebo
+rozšířenou formu příkazu "\bib", viz níže. Odkazy vypadají při stylu 
+"alpha" takto [Nov08] a při stylu "apalike" 
+takto [NovĂĄk, 2008].
+
+Příkaz "\rcite[<lejblíky>]" funguje jako "\cite[<lejblíky>]", ale kolem odkazů 
+nejsou přidány závorky. Možnost využití: "[\rcite[novak08],~s.~213]" vytvoří
+například odkaz [17,~s.~213]. Závorky kolem musíte napsat sami. 
+
+Příkaz "\ecite[<lejblík>]{<text>}" vytiskne pouhý "<text>", který se chová
+jako odkaz na literaturu.
+Příklad použití: "z~výsledů Nováka [\ecite[novak08]{2008},~s.~213] plyne..."
+z~výsledků Nováka [2008, s. 213] plyne\dots\ Přitom "novak08" je registrován do
+seznamu citovaných položek a třeba při "\hyperlinks" bude číslo 2008 prolinkováno 
+s odpovĂ­dajĂ­cĂ­ poloĹžkou v~seznamu literatury. 
+
+Příklady redefinice "\cite" pro alternativní formátování odkazů:
+
+\begtt
+\def\cite[#1]{(\rcite[#1])}     % \cite[lejblík] vytvoří (27)
+\def\cite[#1]{$^{\rcite[#1]}$}  % \cite[lejblík] vytvoří^{27}
+\endtt
+
+\noindent {\bf Seznam literatury} je možné vložit do dokumentu čtyřmi různými
 zpĹŻsoby:
 
 \begitems
 * Manuálně: pomocí jednotlivých položek "\bib[<lejblík>]" přímo v dokumentu.
 * S vyuĹžitĂ­m Bib\TeX{}u makrem "\usebibtex{<bib-bĂĄze>}{<bst-styl>}".
 * VyuĹžitĂ­m jednou vygenerovanĂŠ databĂĄze makrem "\usebbl/<typ> <bbl-bĂĄze>".
+* Přímým čtením ".bib" databáze makry \TeX{}u bez využití Bib\TeX{}u.
 \enditems
 
 Jednotlivé způsoby jsou níže probrány podrobněji.
 
 \medskip\noindent
 {\bf Manuálně vložený seznam literatury} v dokumentu vypadá například takto:
+\par\nobreak
 
 \begtt
-\bib[tbn] P. OlĹĄĂĄk. {\it\TeX{}book naruby.} 468~s. Brno: Konvoj, 1997.
-\bib[tst] P. OlĹĄĂĄk. {\it TypografickĂ˝ systĂŠm \TeX.} 
-                    269~s. Praha: CSTUG, 1995.
+\bib [tbn] Petr OlĹĄĂĄk. {\it\TeX{}book naruby.} 468~s. Brno: Konvoj, 1997.
+\bib [tst] Petr OlĹĄĂĄk. {\it TypografickĂ˝ systĂŠm \TeX.} 
+                       269~s. Praha: CSTUG, 1995.
 \endtt
 %
 Výťe uvedenå ukåzka då nåsledující výstup:
 \medskip
-\bib[tbn] P. OlĹĄĂĄk. {\it\TeX{}book naruby.} 468~s. Brno: Konvoj, 1997.
-\bib[tst] P. OlĹĄĂĄk. {\it TypografickĂ˝ systĂŠm \TeX.} 
+\bib[tbn] Petr OlĹĄĂĄk. {\it\TeX{}book naruby.} 468~s. Brno: Konvoj, 1997.
+\bib[tst] Petr OlĹĄĂĄk. {\it TypografickĂ˝ systĂŠm \TeX.} 
                     269~s. Praha: CSTUG, 1995.
+\medskip
+Je možné použít rozšířený způsob zápisu 
+"\bib [<lejblík>] = {<značka>} <text záznamu>". Údaj "<značka>" se 
+použije do odkazů při zapnutém "\nonumcitations". Kolem rovnítka musejí být mezery.
+Například:
+
+\begtt
+\bib [tbn] = {OlĹĄĂĄk, 1997} 
+     OLŠÁK, P. {\it\TeX{}book naruby.} 468~s. Brno: Konvoj, 1997.
+\endtt
 
 \medskip\noindent
 {\bf Využití Bib\TeX{}u.} Předpokládá se, že uživatel disponuje souborem
@@ -1248,13 +1290,8 @@ stylového souboru bez přípony ".bst", který použije Bib\TeX{} pro konverzi
 "<bib-båze>.bib" do výstupu "<dokument>.bbl". Tento výstup pak bude makrem
 "\usebibtex" přečten a vložen do dokumentu. Typicky používané <bst-styly>
 jsou "plain", "alpha", "apalike", "ieeetr", "unsrt". 
-Styl "alpha" způsobí, že se místo čísel začnou zjevovat v dokumentu zkratky,
-a to jednak v seznamu literatury a jednak v místě výskytu příkazů "\cite".
-V takovém případě pochopitelně "\shortcitations" nefunguje a pokud byste se
-o něj pokusili, tak makro havaruje.
 ExistujĂ­ desĂ­tky, moĹžnĂĄ stovky dalĹĄĂ­ch ".bst" stylĹŻ, viz internet.
 
-
 Při prvním zpracování dokumentu \TeX{}em makro "\usebibtex" připraví vstupní
 pokyny pro Bib\TeX{} do souboru "<dokument>.aux" a zjistĂ­, Ĺže soubor
 "<dokument>.bbl" zatĂ­m neexistuje. To dĂĄ najevo na terminĂĄlu:
@@ -1338,7 +1375,6 @@ Makro OPmac navrhuje řešení, při kterém stačí použít Bib\TeX{} pro mnoh
 \removelastskip
 \enditems
 
-
 Kroky 2 až 4 budete muset opakovat pouze tehdy, když budete chtít přidat do
 "<mojebĂĄze>.bbl" dalĹĄĂ­ Ăşdaj, tj. po upgradu souboru "<bib-bĂĄze>.bib". 
 Prudí-li různí odběratelé vaší vědecké činnosti požadavky na různé 
@@ -1346,6 +1382,45 @@ Prudí-li různí odběratelé vaší vědecké činnosti požadavky na různé
 podle různých stylů různÊ soubory typu "mybbl-plain.bbl",
 "mybbl-ieeetr.bbl".
 
+\medskip
+\noindent
+{\bf Přímé čtení ".bib" databáze} je možné po "\input opmac-bib.tex".
+Tato přídavná makra navíc používají externí balíček na čtení ".bib" souborů 
+"librarian.tex" od Paula Isamberta. Užití je podobné, jako při "\usebbl":
+
+\begtt
+\usebib/c (<style>) <bib-báze> % řadit podle pořadí citace (c=cite),
+\usebib/s (<style>) <bib-báze> % řadit podle klíče ve stylu (s=style).
+\endtt
+
+Zde "<bib-báze>" je jeden nebo více ".bib" souborů oddělených čárkou bez
+mezery a bez přípony. Prametr "<style>" udává část jména souboru
+"opmac-bib-<style>.tex", ve kterĂŠm je specifikace formĂĄtovĂĄnĂ­ poloĹžek.
+Součástí balíčku je styl "simple", tedy soubor "opmac-bib-simple.tex",
+který si můŞe uŞivatel zkopírovat na jiný nåzev a modifikovat dle svých
+představ. Více informací je na konci souboru "opmac-bib.tex".
+
+\medskip
+\noindent 
+{\bf Formátování seznamu literatury} je řízeno makrem "\printbib",
+které je vloženo na začátek každé položky v seznamu. 
+Implicitní hodnota makra tiskne čísla položek do
+hranatých závorek a při použití "\nonumcitations" předsadí první řádek
+položky a nepřidává nic. Makro může využít "\the\bibnum" pro tisk 
+čísla nebo "\the\bibmark" pro tisk značky (při "\nonumcitations").
+Příklady:
+
+\begtt
+% Číslování položek bez hranatých závorek:
+\def\printbib{\hangindent=\parindent \indent \llap{\the\bibnum. }}
+
+% Tisk zkratek při použití bibTeXového stylu alpha a \nonumcitations:
+\def\printbib{\hangindent=\parindent \noindent [\the\bibmark]\quad}
+\endtt
+
+Další příklady (třeba jak \TeX{} změří šířku největšího čísla a podle toho
+vypočítá odsazení celého seznamu) jsou uvedeny na
+\url{http://petr.olsak.net/opmac-tricks.html}.
 
 \sec MatematickĂĄ sazba
 %%%%%%%%%%%%%%%%%%%%%%
@@ -1477,12 +1552,11 @@ Není-li soubor REF otevřen, je hodnota registru "\lastpage" rovna nule.
 \footline={\hss \rm \thefontsize[10]\the\pageno/\the\lastpage \hss}
 \endtt
 
-\vfill\break
 
 \sec ShrnutĂ­
 %%%%%%%%%%%%
 
-Klíčová makra balíku OPmac jsou stručně shrnuta v následujícím výpisu.
+%Klíčová makra balíku OPmac jsou stručně shrnuta v následujícím výpisu.
 
 \def\tthook{\adef!{\string\endtt}\adef&{\kern.25em}}
 \begtt
@@ -1497,7 +1571,6 @@ Klíčová makra balíku OPmac jsou stručně shrnuta v následujícím výpisu.
 
 \label[<lejblík>] % deklarace před cílem odkazu
 \ref[<lejblĂ­k>]   % odkaz na kapitolu, sekci nebo podsekci
-\cite[<lejblĂ­k>]  % odkaz do seznamu literatury
 \pgref[<lejblĂ­k>] % odkaz na strĂĄnku
 
 \caption/t      % číslovaný popisek tabulky
@@ -1513,11 +1586,14 @@ Klíčová makra balíku OPmac jsou stručně shrnuta v následujícím výpisu.
 \begmulti           % začátek vícesloupcové sazby
 \endmulti           % konec vĂ­cesloupcovĂŠ sazby
 
-\bib[<lejblĂ­k>]   % poloĹžka v seznamu literatury
-\cite[<lejblĂ­k>]  % mĂ­sto, odkud se odkazuje do seznamu literatury
+\cite[<lejblĂ­ky>]  % mĂ­sto, odkud se odkazuje do seznamu literatury
+\rcite[<lejblĂ­ky>] % jako \cite, ale bez zĂĄvorek kolem
+\sortcitations \shortcitations \nonumcitations % deklarace typu odkazĹŻ
+\bib[<lejblĂ­k>]    % poloĹžka v seznamu literatury
 \usebibtex{<bib-bĂĄze>}{<bst-styl>}  % pouĹžitĂ­ bibTeXu pro seznam literatury
 \genbbl{<bib-báze>}{<bst-styl>}     % předgenerování seznamu literatury
 \usebbl/? <bbl-báze>  % použití předgenerované databáze, ? je z {a,b,c}
+\usebib/? (<style>) <bib-báze> % přímé čtení .bib bez BibTeXu, ? je z {c,s}
 
 \typosize[<font-velikost>/<řádkování>]            % nastavení velikosti sazby
 \typoscale[<faktor-font>/<faktor-řádkování>]       % škálování velikosti sazby
@@ -1526,7 +1602,6 @@ Klíčová makra balíku OPmac jsou stručně shrnuta v následujícím výpisu.
 \inspic <soubor>.<přípona> % vložení obrázku, přípony: jpg, png, pdf
 \table{<pravidlo>}{<data>} &% makro pro tabulku
 \frame{<text>}            % orĂĄmovanĂ˝ text
-
 \fnote{<text>}  % poznámka pod čarou (lokální číslování na každé stránce)
 \mnote{<text>}  % poznĂĄmka na okraji (pravĂŠm nebo levĂŠm podle strĂĄnky)