cstex (13mar19)

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

5 files changed, 147 insertions, 5 deletions

diff --git a/Master/texmf-dist/doc/cstex/opmac-d.tex b/Master/texmf-dist/doc/cstex/opmac-d.tex
index 0c19a207b5a..fcabe66ad6f 100644
--- a/Master/texmf-dist/doc/cstex/opmac-d.tex
+++ b/Master/texmf-dist/doc/cstex/opmac-d.tex
@@ -8,7 +8,7 @@
 % UTF-8 encTeX has a conflict with DocByTeX
 
 \chyph
-\def\projectversion{Aug. 2018}
+\def\projectversion{Mar. 2019}
 \def\headtitle{OPmac}
 
 \widowpenalty=10000 
@@ -344,6 +344,7 @@ u�ivatelsk� dokumentaci.
 \dgn \nb colsep
 \dgn \nb mnoteindent
 \dgn \nb mnotesize
+\dgn \nb titskip
 \dgn \nb picdir
 \dgn \nb bibtexhook
 \dgn \nb chaphook
@@ -2797,6 +2798,40 @@ jednotky pomoc� makra \db truedimen.
 
 \inext{trueunit}{\empty}{+-}
 
+\subsec [styly] P�eddefinovan� styly
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+Makro \db boxlines pracuje obdobn� jako makro plainTeX{}u "\obeylines", ale
+jednotliv� ��dky jsou samostatn� "\hbox"y r�zn� �irok�. 
+Proto nap��klad "\vbox{\boxlines <��dky textu>}" vytvo�� "\vbox", kter� je stejn�
+�irok� jako nej�ir�� ��dek v n�m. Toto makro bude pou�ito v makru
+"\address", kter� je definov�no ve stylu "\letter".
+
+\inext{boxlines}{\empty}{+-}
+
+Toto makro p�i p�echodu do horizont�ln�ho m�du pomoc� "\everypar" tento m�d
+okam�it� uzav�e a otev�e b�n� "\hbox\bgroup". V n�m je konc ��dku aktivn� a
+jakmile k n�mu dojde, provede se \db boxlinesE, co� ukon�� skupinu "\hbox"u
+pmoc� "\egroup". Nejv�ce komplikac� p�in�� syntaktick� alternativa, kdy
+u�ivatel m��e ukon�it skupinu, kterou s�m otev�el, explicitn�m "}", a to
+nejen ve vertik�ln�m m�du (to pak funguje spr�vn�), ale tak� t�eba
+v r�mci vnit�n�ho horizont�ln�ho m�du. T�m se tento m�d ukon��, ale
+neukon�� se u�ivatelova skupina. Proto pomoc� "\aftergroup" iniciaozav�n ve
+vnit�n�m horizont�ln�m m�du je za kompletovan�m "\hbox"em
+spu�t�na dvojice maker \db boxlinesC a \db boxlinesD, kter� zkontroluje,
+zda t�sn� n�sleduje "\empty". To je p��znak toho, �e jsme ukon�ili intern�
+horizonr�ln� m�d pomoc� "\boxlinesE". V takov�m p��pad� ned�l�me nic. Jinak
+ukon��me i u�ivatelovu skupinu pomoc� "\egroup". Je tam pou�it
+"\expandafter", proto�e u�ivatel m��e m�t taky sv� "\aftergroup".
+
+N�sleduj� definice maker \db report a \db letter nastavuj�c� p�eddefinovan�
+styl dokumentu v souladu s t�m, co je o tom ps�no v u�ivatelsk� dokumentaci.
+\dgn \nb address
+\dgn \nb subject
+\dgn \nb author
+
+\inext{report}{\empty}{+-}
+
 
 \subsec [zaver] Z�v�r
 %%%%%%%%%%%%%%%%%%%%%
diff --git a/Master/texmf-dist/doc/cstex/opmac-u-en.pdf b/Master/texmf-dist/doc/cstex/opmac-u-en.pdf
index 21724b8ebbc..b37232b0db3 100644
--- a/Master/texmf-dist/doc/cstex/opmac-u-en.pdf
+++ 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
index 03809c3a482..d448150ab35 100644
--- a/Master/texmf-dist/doc/cstex/opmac-u-en.tex
+++ b/Master/texmf-dist/doc/cstex/opmac-u-en.tex
@@ -20,7 +20,7 @@
 \tit OPmac -- macros for plain\TeX\fnotemark1
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  
-\centerline{\it Petr Ol\v s\'ak, 2012 -- 2016}
+\centerline{\it Petr Ol\v s\'ak, 2012 -- 2019}
 
 \bigskip
 \centerline{\url{http://petr.olsak.net/opmac-e.html}}
@@ -1414,11 +1414,58 @@ as dot and dot is ignored by sorting algorithm. You can redefine this macro,
 but you must keep the format, keep "\setlccodes" in the front and "{}{}" in
 the end.
 
+\sec Pre-defined styles
+
+OPmac defines two style-declaration macros "\report" and "\letter" since
+Mar.~2019. You can use them at the beginning of your document if you are
+preparing these types of document and you don't need to create your own
+macros.
+
+The "\report" declaration is intended to create reports. It 
+sets default font size to 11\,pt and "\parindent" to 1.2\,em.
+The "\tit" macro uses smaller font because we assume that ``chapter'' level
+will be not used in reports. The first page has no page number, but next pages
+are numbered (from number 2). The footnotes are numbered from one in whole
+document. The macro "\author <authors><end-line>" can be used when 
+"\report" is declared. It prints "<authors>" in italics at center of the
+line. You can separate authors by "\nl" to more lines.
+
+The "\letter" declaration is intended to create letters. It sets default
+font size to 11\,pt and "\parindent" to 0\,pt. It sets half-line space
+between paragraphs. The page numbers are not printed. The "\subject" macro
+can be used, it prints the word ``Subject:'' or ``V\v{e}c'' in bold
+depending on used language. Moreover, the "\address" macro
+can be used when "\letter" is declared. The usage of the "\address" macro
+looks like:
+
+\begtt
+\address
+  <first line of address>
+  <second line of address>
+  <etc.>
+  <empty line>
+\endtt
+
+It means that you need not to use any special mark at the end of lines: end
+of lines in the source file are the same as in printed output. The
+"\address" macro creates "\vtop" with address lines. The width of such
+"\vtop" is equal to the most wide line used in it. So, you can use
+"\hfill\address..." in order to put the address box to the right side of the
+document. Or you can use "<prefixed text>\address..." to put 
+"<prefixed text>" before first line of the address.
+
+Analogical declaration macros "\book" or "\slides" are not prepared. Each
+book needs an individual typographical care so you need to cerate specific
+macros for design. And you can find an inspiration of slides in OPmac tricks
+\ulink[http://petr.olsak.net/opmac-tricks-e.html\#slidy]{0017 and 0022}.
+
+
+\vfil\break
 
 \sec Summary
 %%%%%%%%%%%%
 
-\def\tthook{\adef!{\string\endtt}\adef&{\kern.25em}}
+\def\tthook{\typosize[10/12]\adef!{\string\endtt}\adef&{\kern.25em}}
 \begtt
 \tit Title (terminated by end of line)
 \chap Chapter Title (terminated by end of line)
@@ -1471,6 +1518,8 @@ the end.
 
 \magscale[factor]  % resize typesetting, line/page breaking unchanged
 \margins/pg format (left, right, top, bottom)unit % margins setting
+
+\report \letter    % style declaration macros
 \endtt
 
 \end
diff --git a/Master/texmf-dist/doc/cstex/opmac-u.pdf b/Master/texmf-dist/doc/cstex/opmac-u.pdf
index a65f94ff528..c0b62016227 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 a4450421637..60bdf7f1b1f 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, 2012 -- 2016}
+\centerline{\it Petr Olšák, 2012 -- 2019}
 
 \bigskip
 \centerline{\url{http://petr.olsak.net/opmac.html}}
@@ -1637,7 +1637,7 @@ makra: "\magscale[1414] \margins/1 a4 (,,,)mm" umístí sazbu, která je určena
 pro tisk na a5, doprostřed stránky a4 a odpovídajícím způsobem ji zvětší,
 aby se to korektorům lépe četlo. 
 
-
+\label[lastpage]
 \sec Poslední strana
 %%%%%%%%%%%%%%%%%%%%
 
@@ -1770,6 +1770,62 @@ znakem.
 
 \maybebreak 4cm
 
+\sec Předdefinované styly dokumentů
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+Implicitní styl dokumentu při použití OPmac zahrnuje výchozí parametry a
+vzhled sazby
+jako v plain\TeX u. Pochopitelně
+uživatel si styl dokumentu obvykle upraví pomocí svých maker a třeba s
+využitím maker OPmac.
+
+Od března 2019 nabízí OPmac kromě toho zkratky s výchozím nastavením jiných
+stylů, což je možné použít, pokud chce uživatel vytvořit
+běžný typ dokumentu a nechce se zdržovat nastavováním parametrů a
+definicí vlastních maker. Jsou připraveny deklarační makra "\report" a 
+"\letter", která je možné použít v záhlaví dokumentu.
+
+Deklarace "\report" je určena pro psaní zpráv. Písmo je nastaveno
+na 11 bodů, odsazení odstavců je 1,2\,em. Makro "\tit" použije menší font
+než obvykle, protože se nepředpokládá, že bude použita úroveň \uv{kapitola}.
+První stránka je nečíslovaná, ostatní jsou číslovány (od strany~2). 
+Poznámky pod čarou jsou číslovány vzestupně v celém dokumentu.
+Při použití tohoto makra v záhlaví dokumentu je připraveno též makro
+"\author<text><konec řádku>", které umístí <text> v kurzívě doprostřed
+řádku. Při použití "\nl" je text rozdělen do více řádků, každý je centrován.
+
+Deklarace "\letter" je určena pro psaní dopisů. Písmo je nastaveno na 11
+bodů, odsazení není žádné a mezi odstavci je půlřádková mezera. Stránky
+nejsou číslovány. Chcete-li je číslovat, můžete použít například kód uvedený
+v sekci \ref[lastpage].
+Při použití tohoto makra je dále připraveno makro
+"\address" pro psaní víceřádkových adres a makro "\subject" které vypíše
+tučně slovo \uv{Věc:} nebo \uv{Vec:} nebo \uv{Subject:} v závislosti na
+použitém jazyce. Užití makra "\address" vypadá takto:
+
+\begtt
+\address
+  <první řádek adresy>
+  <druhý řádek adresy>
+  <atd.>
+  <prázdný řádek>
+\endtt
+%
+tedy řádky se neukončují žádným speciálním znakem, ale konec řádku na 
+vstupu je koncem řádku i v sazbě. 
+Makro vytvoří "\vtop" se sazbou řádků tak, že jeho šířka
+odpovídá nejširšímu řádku. Chcete-li mít víceřádkovou adresu u pravého
+okraje stránky stačí tedy psát "\hfill\address..." 
+A před adresu lze také do prvního
+řádku předsadit text jednoduše pomocí "<text>\address..."
+
+Analogický deklarátor "\book" není zahrnut, protože kniha vyžaduje individuální
+péči typografa a každá kniha může být jiná. Na takový projekt je účelné si
+připravit vlastní makra. Deklarátor "\slides" také není zahrnut, ale je
+možné použít OPmac triky 
+\ulink[http://petr.olsak.net/opmac-tricks.html\#slidy]{0017 a 0022}.
+
+
 \sec Shrnutí
 %%%%%%%%%%%%
 
@@ -1827,6 +1883,8 @@ znakem.
 
 \magscale[<faktor>]  % zvětšení/zmenšení sazby beze změny zlomu
 \margins/<pg> <formát> (<levý>,<pravý>,<horní>,<dolní>)<jednotka>  % okraje
+
+\report \letter % inicializace předdefinovaného stylu dokumentu
 \endtt
 
 \bye