tablists new version

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

4 files changed, 122 insertions, 53 deletions

diff --git a/Master/texmf-dist/doc/latex/tablists/README b/Master/texmf-dist/doc/latex/tablists/README
index be911a0b46a..13c87e78107 100644
--- a/Master/texmf-dist/doc/latex/tablists/README
+++ b/Master/texmf-dist/doc/latex/tablists/README
@@ -1,12 +1,28 @@
-tablists 0.0d (beta)
+tablists 0.0e (beta)
 Tabulated list of short items (exersizes in textbooks).
 
-      Package  offers  environments  and commands  for one-level  and  two-level
-      lists of short items  (exersizes in textbooks).    The two-level lists can
-      be created in one of two variants:  1) with usage of sublevel environment;
-      and   2) with usage of the \subitem command and second optional argument).
-      The environments  follow   support of optional arguments of item numbering
-      as enumerate or paralist packages.   This package also offers  the command
-      for the QED sign at the end of the proof environment (amsmath package).
+      Package  offers environments  and commands  for one-level  and two-level
+      lists of short items (exersizes in textbooks).   The environments follow
+      support of optional arguments of item numbering as enumerate or paralist
+      packages.
+
+Documentation: tablists.pdf, tablist-rus.pdf.
+
+Installation hints:
+The tablists.dtx is self-installation file.
+Run LaTeX (pdfLaTeX) with this file, you get: 
+  tablists.dvi (or .pdf) file -- documentation,
+  tablists.sty file -- the package file,   
+  and other LaTeX files.
+
+Copy tablists.sty file in the folder (directory) with other packages:
+(the way to LaTeX package looks like
+ %texmf folder%/tex/latex/tablists/tablists.sty)
+Then you need to refresh your databases -- see documentation
+of your local TeX distribution (MikTeX, TeXlive etc.)
+
+Also to get help for installation please visit:
+http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages
+http://www.tex.ac.uk/cgi-bin/texfaq2html?label=miktexinst
+http://www.tex.ac.uk/cgi-bin/texfaq2html?label=privinst
 
-Documentation: tablists.pdf.
diff --git a/Master/texmf-dist/doc/latex/tablists/tablists-rus.pdf b/Master/texmf-dist/doc/latex/tablists/tablists-rus.pdf
index a03336bc2c5..65fff179004 100644
--- a/Master/texmf-dist/doc/latex/tablists/tablists-rus.pdf
+++ b/Master/texmf-dist/doc/latex/tablists/tablists-rus.pdf
diff --git a/Master/texmf-dist/doc/latex/tablists/tablists-rus.tex b/Master/texmf-dist/doc/latex/tablists/tablists-rus.tex
index 4587e136318..a2b5a70abe7 100644
--- a/Master/texmf-dist/doc/latex/tablists/tablists-rus.tex
+++ b/Master/texmf-dist/doc/latex/tablists/tablists-rus.tex
@@ -45,7 +45,7 @@
 \clubpenalty10000
 \makeatother
 \providecommand*{\file}[1]{\texttt{#1}}
-\providecommand*{\pkg}[1]{\textsf{#1}}
+\providecommand*{\package}[1]{\textsf{#1}}
 \providecommand*{\cls}[1]{\textsf{#1}}
 \providecommand*{\env}[1]{\texttt{#1}}
 
@@ -95,11 +95,11 @@
 %
 %^^A% Each item starts with |\tabenumitem| command.
 %^^A% First example of \env{tabenum} list---please note that you may set optional
-%^^A% argument in the same way as in \pkg{paralist}
+%^^A% argument in the same way as in \package{paralist}
 %^^A% environments:
 % Каждый пункт начинается с~команды |\tabenumitem|.
 % Первый вариант окружения \env{tabenum}---обратите внимание что можно задать
-% опцию так же как и~в~окружениях пакетов \pkg{enumerate} или \pkg{paralist}:
+% опцию так же как и~в~окружениях пакетов \package{enumerate} или \package{paralist}:
 %\par\begin{small}
 %\begin{verbatim}
 %\begin{tabenum}[\bfseries1)]%
@@ -290,31 +290,26 @@
 % Вертикальные отбивки вокруг перечня равны отбивкам вокруг обычного перечня:
 % |\topsep+\partopsep|.
 %
-%^^A% Space between rows depends on the |\jot| value, like in \pkg{amsmath} environments
-%^^A% like \env{align}, \pkg{gather} etc.
+%^^A% Space between rows depends on the |\jot| value, like in \package{amsmath} environments
+%^^A% like \env{align}, \package{gather} etc.
 % Отбивки между рядами зависят от величины  |\jot|, как и~в~окружениях многострочных
-% формул в~окружениях пакета \pkg{amsmath}:
-% \env{align}, \pkg{gather} и~т.\,д.
+% формул в~окружениях пакета \package{amsmath}:
+% \env{align}, \package{gather} и~т.\,д.
 %
 % \DescribeMacro{\tabenumsep}
 %^^A% The horizontal spacing between items of list. It defined like:
 % Определяет горизонтальные отбивки между пунктами. Задаётся следующим образом:
 % \begin{quote}
-% |\newcommand\tabenumsep{\hskip1em}|
+% |\renewcommand\tabenumsep{\hskip1em}|
 % \end{quote}
 %^^A% The |\labelsep| parameter is used after item number.
 % Отбивка |\labelsep| задаётся после номера.
 %
-%^^A% \subsection{The \env{tabenum} environment inside a proper list}
-% \subsection{Окружение \env{tabenum} внутри настоящего перечня}
-%
 % \DescribeMacro{\tabenumindent}
-%^^A% The |\tabenumindent| macro sets left margin of \env{tabenum}. That could be useful
-%^^A% inside, e.g., a proper list environments like \env{enumerate} or \env{itemise}.
-%^^A% It can be defined like horizontal space/skip or text.
-%^^A% For example:
-% Команда |\tabenumindent| определяет левое поле \env{tabenum}. Это может быть полезно
-% внутри настоящего перечня, типа \env{enumerate} или \env{itemise}.
+%^^A% The |\tabenumindent| command sets left margin of \env{tabenum} environment.
+%^^A% It can be defined like horizontal space/skip or text,
+%^^A% for example:
+% Команда |\tabenumindent| определяет левое поле \env{tabenum}.
 % Она может быть определена как отбивка или текст (или всё вместе).
 % Например:
 % \begin{quote}
@@ -324,35 +319,57 @@
 % \begin{quote}
 % |\renewcommand\tabenumindent{Word }|
 % \end{quote}
+%^^A% That could be useful also
+%^^A% inside, e.g., a proper list environments like \env{enumerate} or \env{itemise}
+%^^A% for corrections of left margins.
+% Это может быть также полезно внутри настоящего перечня, типа
+% \env{enumerate} или \env{itemise} для выравнивании левого поля.
 %
-% \DescribeMacro{\liststrut}
-%^^A% This command can be useful after alone list number (and not only with
-%^^A% \env{tabenum} environment). The command raises first line of next
-%^^A% text block at the baseline of previous. Without any option it puts negative
-%^^A% baselineskip. If there is a high element (any math sentence) in the first
-%^^A% line of next text, you may repeat this element in option argument without |$|'s.
-% Эта команда пригодится если окружение \env{tabenum} идёт сразу после номера перечня.
-% Команда поднимает первую строку следующего за пунктом блока текста
-% на базовую линию предыдущего. Команда без опции даёт отбивку равную отрицательному
-% интерлиньяжу. Если в~первой строке следующего блока текста встретился высокий элемент
-% (обычно это математическое выражение)
-% его повторяют в~опции команды |\liststrut| и~по его высоте рассчитываются
-% компенсирующие отбивки. Элемент записывается без знаков |$|.
-%
-%^^A% Here the combination of these two commands:
-% В~примере комбинация этих двух команд:
+%^^A% \subsection{The \env{tabenum} environment inside a proper list}
+% \subsection{Окружение \env{tabenum} внутри настоящего перечня}
+%
+%
+%^^A% The version 0.0e of \package{tablists} package enlarges left margin
+%^^A% of \env{tabenum}, when environment appears inside proper list,
+%^^A% by the value of left margin of this list. Sometimes left edges
+%^^A% of \env{tabenum} labels and list labels of the same level are not aligned
+%^^A% correctly (it happens when |\labelwidth| value is not equal to the natural
+%^^A% width of labels). In these cases you may define the correction skip
+%^^A% with the |\tabenumindent| command.
+% Версия 0.0e  пакета \package{tablists} увеличивает левое поле окружения
+% \env{tabenum}, если последнее оказывается внутри окружения обычного перечня,
+% на величину левого поля этого перечня. Иногда левый край меток в~окружении
+% \env{tabenum} и~меток в~перечне того же уровня не выравниваются корректно
+% (из-за того, что значение ширины поля для меток |\labelwidth| не равно натуральной
+% ширине меток). В~этих случаях вы можете корректирующую отбивку с~помощью
+% команды |\tabenumindent|.
+%
+%^^A% Also the version 0.0e loads labels of empty items of upper/outer list
+%^^A% at the left side of the first item of \env{tabenum} automatically.  It follows
+%^^A% mechanism similar to building of empty items in list environment.
+%^^A% (Empty items of \LaTeX\ list are consecutively stored to special box register
+%^^A% and printed out at the beginning when the list text appears;
+%^^A% the same happens at the beginning of \env{tabenum} environment:
+%^^A% this box, if not empty, is printed at the left of first \env{tabenum} item.)
+% Кроме этого, версия 0.0e помещает номера пустых пунктов старшего перечня
+% слева, перед номером первого пункта окружения \env{tabenum} автоматически. 
+% Здесь используется результат работы механизма для построения/""накопления
+% пустых меток в~окружении перечней.
+% (Пустые номера"=метки, которые не сопровождаются текстом, в~\LaTeX'овском окружении 
+% перечней последовательно записываются в~специальный регистр бокса,
+% который выводится вначале при появлении текста перечня; также происходит
+% и~в~начале окружения \env{tabenum}: этот бокс, если не пустой, печатается
+% слева от номера первого пункта.)
 %\par\begin{small}
 %\begin{verbatim}
 %\begin{enumerate}[\bfseries1)]%
-%\item\renewcommand\tabenumindent{1)\hskip\labelsep}%
-%   \liststrut[\displaystyle\frac /y]
+%\item
 %\begin{rtabenum}[a)]%
 %...
 %\end{verbatim}%
 %\end{small}
 % \begin{enumerate}[\bfseries1)]%
-% \item\renewcommand\tabenumindent{1)\hskip\labelsep}%
-%   \liststrut[\displaystyle\frac /y]
+% \item
 % \begin{rtabenum}[a)]%
 % \item
 % {$z=\displaystyle\frac xy$};
@@ -378,13 +395,49 @@
 % \item
 % $2+5+8+ \ldots +(3n+2)=155$, $n\in \mathrm{N};$\hidewidth\skipitem
 % \item
-% $t=5u^2+8v^2$;
+% $t=5u^2+8v^2$.
 % \end{rtabenum}
 % \end{enumerate}%
+%\par\kern-\baselineskip
 % Обратите внимание на использование окружения \env{rtabenum} и~нумерацию русскими буквами.
 %
-%^^A% \emph{Note}: The |\liststrut| not always works correctly.
-% \emph{Замечание}: Команда |\liststrut| не всегда работает корректно.
+%^^A% \emph{Please note} that for the case of \env{tabenum} environment inside list,
+%^^A% there is not compatibility between version 0.0e and earlier
+%^^A% versions---left margin of \env{tabenum} is changed (mechanism
+%^^A% of placing empty list items on one baseline using compensating vertical
+%^^A% spaces could work but its calculation was changed).
+% \emph{Обратите также внимание}, что в~случае появления окружения
+% \env{tabenum} внутри окружения перечня, нет совместимости между версией 0.0e
+% и~более ранними \cdash--- левое поле окружения \env{tabenum} изменено (макрокоманда
+% помещения пустых меток старшего перечня путём компенсирующих вертикальных отбивок
+% может работать, но механизм подсчёта также отличается в~версии 0.0e от предыдущих,
+% см.~также следующий абзац).\smallskip
+%
+% \begin{small}%
+% \DescribeMacro{\liststrut}
+%^^A% \emph{Note}: In versions until 0.0d there was offered the |\liststrut| command in the
+%^^A% cases when needed to put empty list item on the same line with first item of
+%^^A% \env{tabenum}. The command raises first line of next text block at the baseline of
+%^^A% previous. (Without any option it puts negative
+%^^A% baselineskip. If there is a high element (any math sentence) in the first
+%^^A% line of next text, it must be written in option without |$|'s,
+%^^A% the height of this argument is used for compensating skips argument.)
+%^^A% Since this command must take into account various vertical skips, which
+%^^A% appear at the start of new item and also height of printing text,
+%^^A% the adjusting of baselines does not always work correctly.\par
+% В~версиях вплоть до 0.0d,
+% в~случаях если окружение \env{tabenum} шло сразу после пустого номера старшего перечня,
+% предлагалась команда |\liststrut|.
+% Команда поднимает первую строку следующего за пунктом блока текста
+% на базовую линию предыдущего. (Команда без опции даёт отбивку равную отрицательному
+% интерлиньяжу (|\baselineskip|). Если в~первой строке следующего блока текста встретился
+% высокий элемент (предполагается, что это математическое выражение)
+% его повторяют в~опции команды |\liststrut| без знаков |$| и~по его высоте
+% рассчитываются компенсирующие отбивки.)
+% Поскольку при подсчёте компенсирующей отбивки должно быть принято значение нескольких
+% вертикальных отбивок, а~также высота элементов в~тексте, выравнивание базовых линий
+% не всегда получается корректным.\par
+% \end{small}%
 %
 %\RestoreSpaces
 %^^A% \subsection{The \env{subtabenum} environment: second level, variant I}
@@ -485,7 +538,7 @@
 %^^A% cancels this skip.
 % Если задать команду |\subitem| сразу после |\item|, то получится лишний
 % пробел между нумерацией, созданный отбивкой |\tabenumsep|. Команда |\negtabenumsep|
-% отменяет эту отбивку: в~версии 0.1с она задана уже внутри команды |\tabenumitem|.
+% отменяет эту отбивку: в~версии 0.0с она задана уже внутри команды |\tabenumitem|.
 %\par\begin{small}\openup-1pt\enlargethispage{2\baselineskip}
 %\begin{verbatim}
 %\def\tabenumsep{\qquad}
@@ -506,14 +559,14 @@
 %\subitem
 %$v=gt+\displaystyle\frac{g}{4}t$,
 %\subitem
-%$u=2^{5x-3y+z}$.\\ 
+%$u=2^{5x-3y+z}$.\\
 %\startsubnumber{7}\subtabrow
 %\subitem
 %$w=(v+7)^2+(u-3)^2$;
 %\subitem
 %$5^x=\displaystyle\frac{4}{3} ;$
 %\subitem
-%$z=(x+1)^2+y^2$;\\ 
+%$z=(x+1)^2+y^2$;\\
 %\subtabrow
 %\subitem
 %$2+5+8+ \ldots +(3n+2)=155$, $n\in \mathrm{N};$\hidewidth\skipitem
@@ -592,7 +645,7 @@
 % \end{theorem}%
 % \begin{proof}%
 % Поместим знакомое нам окружение \env{tabenum} внутри окружения  \env{proof},
-% и~в~конце первого поместим команду |\tabqedhere|:
+% и~в~конце первого поместим команду |\tabqedhere| (|\qedhere|):
 %\begin{verbatim}
 %\begin{theorem}
 % ...
diff --git a/Master/texmf-dist/doc/latex/tablists/tablists.pdf b/Master/texmf-dist/doc/latex/tablists/tablists.pdf
index 68580b22570..e64f4b909a3 100644
--- a/Master/texmf-dist/doc/latex/tablists/tablists.pdf
+++ b/Master/texmf-dist/doc/latex/tablists/tablists.pdf