texlive[48627] Master/texmf-dist: covington (8sep18)

commits+karl at tug.org commits+karl at tug.org
Sat Sep 8 23:42:09 CEST 2018


Revision: 48627
          http://tug.org/svn/texlive?view=revision&revision=48627
Author:   karl
Date:     2018-09-08 23:42:09 +0200 (Sat, 08 Sep 2018)
Log Message:
-----------
covington (8sep18)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/covington/README
    trunk/Master/texmf-dist/doc/latex/covington/covington.pdf
    trunk/Master/texmf-dist/doc/latex/covington/covington.tex
    trunk/Master/texmf-dist/tex/latex/covington/covington.sty

Modified: trunk/Master/texmf-dist/doc/latex/covington/README
===================================================================
--- trunk/Master/texmf-dist/doc/latex/covington/README	2018-09-08 21:41:57 UTC (rev 48626)
+++ trunk/Master/texmf-dist/doc/latex/covington/README	2018-09-08 21:42:09 UTC (rev 48627)
@@ -31,6 +31,11 @@
 
 == CHANGES ==
 
+* Version 1.7 (2018-09-08):
+
+	- Fix alignment in subexamples.
+	- Improve manual.
+
 * Version 1.6 (2018-09-07):
 
 	- Introduce new environment subexamples for sub-examples such as 1a.

Modified: trunk/Master/texmf-dist/doc/latex/covington/covington.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/covington/covington.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/covington/covington.tex	2018-09-08 21:41:57 UTC (rev 48626)
+++ trunk/Master/texmf-dist/doc/latex/covington/covington.tex	2018-09-08 21:42:09 UTC (rev 48627)
@@ -66,6 +66,8 @@
 \renewcommand{\cfttoctitlefont}{\normalsize\bfseries}
 \renewcommand{\cftsecfont}{\footnotesize}
 \renewcommand{\cftsecpagefont}{\footnotesize}
+\renewcommand{\cftsubsecfont}{\footnotesize}
+\renewcommand{\cftsubsecpagefont}{\footnotesize}
 
 \usepackage{babel}
 
@@ -90,8 +92,8 @@
 %
 % Titling
 %
-\def\pversion{Version 1.6}
-\def\pdate{September 7, 2018}
+\def\pversion{Version 1.7}
+\def\pdate{September 8, 2018}
 
 \title{\textbf{The \cvt\ Package\\Macros for Linguistics}}
 \author{Michael A. Covington \and J\"urgen Spitzm\"uller\thanks{Current maintainer.
@@ -162,16 +164,6 @@
 \begin{lstlisting}
 \`{x} \'{x} \^{x} \"{x} \~{x} \={x} \H{x} \t{xx} \c{x} \d{x} \b{x}
 \end{lstlisting}
-\LaTeX\ also provides support for many non-\textsc{ascii} characters, such as%
-\footnote{Please refer to \cite{pakin} for a comprehensive list of special characters and symbols.}:
-\begin{flushleft}\obeyspaces
-\i \j \ae \AE \oe \OE \aa \AA \o \O \l \L \ss ?` !`
-\end{flushleft}
-via the macros:
-\begin{lstlisting}
-\i \j \ae \AE \oe \OE \aa \AA \o \O \l \L \ss ?` !`
-\end{lstlisting}
-%
 Out of the box, however, \LaTeX\ doesn't give you a convenient way to put \emph{two}
 diacritical marks on the same letter.  To fill this gap, \cvt\ provides
 the following macros:
@@ -206,10 +198,19 @@
 Note that not all accent macros work in the \jfenv{tabbing} environment.
 Use the \jfenv{Tabbing} package or refer to \cite{pakin} for alternative solutions.
 
-\section{Example numbers}
 
-Linguistics papers often include numbered examples.
-The macro \jcsmacro{exampleno} generates a new example number and can be 
+\section{Numbered examples}
+
+Linguistic papers often include numbered examples. With \cvt, generating those is straightforward.
+In this section, we describe how you can typeset a self-stepping example number (see section~\ref{sec:exno}),
+a single numbered example (sec.~\ref{sec:ex}), a consecutive range of numbered examples (sec.~\ref{sec:exs}),
+and alpha-numerically labeled sub-examples (sec.~\ref{sec:subexs}).
+All numbered examples can be referred to in the text via \jfcsmacro{label} and \jfcsmacro{ref} as usual
+(see sec.~\ref{sec:ref} for details).
+
+\subsection{Example numbers}\label{sec:exno}
+
+The macro \jcsmacro{exampleno} generates a new example number, stepped by 1. It can be 
 used anywhere you want the number to appear.  For example, to display a 
 sentence with a number at the extreme right, do this:
 \begin{lstlisting}[moretexcs={exampleno}]
@@ -224,14 +225,13 @@
 The example counter is actually the same as \LaTeX's equation counter, 
 so that if you use equations and numbered examples in the same
 paper, you get a single continuous series of numbers. If you want to 
-access the number without changing it, use \jfcsmacro{theequation}.
+output the number without stepping it, use \jfcsmacro{theequation}.
 
-Also, you can use \jfcsmacro{label} and \jfcsmacro{ref} with example numbers in 
-exactly the same way as with equation numbers (see sec.~\ref{sec:ref} for
-details). This applies to the \jenv{example}, \jenv{examples} and \jenv{subexamples}
-environments, described next, as well as to \jcsmacro{exampleno} itself.
+Normally, however, you do not need to manually place \jcsmacro{exampleno} yourselves,
+as in the example above. For the common case where example numbers in parentheses are
+placed left to the example, \cvt\ provides more convenient solutions. These are described in turn.
 
-\section{The \jenv{example} environment}\label{sec:ex}
+\subsection[The \texttt{example} environment]{The \jenv{example} environment}\label{sec:ex}
 
 The \jenv{example} environment (alias \jenv{covexample}) displays a single example
 with a generated example number to the left of it.
@@ -255,7 +255,7 @@
 
 If you need more space between the example number and the text, you can increase it by means of
 the length \jcsmacro{examplenumbersep} (which is preset to \texttt{0pt}). Doing \lstinline|\setlength\examplenumbersep{1em}|,
-for instance, will increase the space by 1\,em.
+for instance, will increase the space by 1\,em (negative values will decrease the space accordingly).
 
 Note that, as of version 1.1, \cvt\ checks if there is already an \jenv{example} environment defined
 (e.\,g., by the class). If so, \cvt\ does not
@@ -282,9 +282,9 @@
 \end{itemize}
 \end{example}
 However, the \jenv{examples} and \jenv{subexamples} environments, described in turn, are usually more 
-convenient.
+convenient for this task.
 
-\section{The \jenv{examples} environment}\label{sec:exs}
+\subsection[The \texttt{examples} environment]{The \jenv{examples} environment}\label{sec:exs}
 
 To display a series of examples together, each with its own example 
 number, use \jenv{examples} (or \jenv{covexamples}) instead of \jenv{example} or \jenv{covexample}.  The only 
@@ -316,7 +316,7 @@
 how it has dealt with the situation.
 
 
-\section{The \jenv{subexamples} environment}\label{sec:subexs}
+\subsection[The \texttt{subexamples} environment]{The \jenv{subexamples} environment}\label{sec:subexs}
 
 Sometimes a set of (paradigmatic) sub-examples gets only one main example number with alphabetic sub-numbering,
 as in \pxref{sbex}. To achieve this most conveniently, \cvt\ provides the \jenv{subexamples} (or \jenv{covsubexamples})
@@ -352,16 +352,17 @@
 
 The distance between example number and subnumber (letter) can be changed via the length \jcsmacro{examplenumbersep}
 (which is preset to \texttt{0pt}). The distance between example subnumber and text can be changed  via the length
-\jcsmacro{subexamplenumbersep} (preset to \texttt{0pt} as well).
+\jcsmacro{subexamplenumbersep} (preset to \texttt{0pt} as well). In both cases, a positive value will increase, a negative
+value will decrease the respective distance.
 Doing 
 \begin{lstlisting}
-\setlength{\examplenumbersep}{-0.2em}
+\setlength{\examplenumbersep}{-0.5em}
 \setlength{\subexamplenumbersep}{0.5em}
 \end{lstlisting}
-for instance, will come out like this:\footnote{Note, though, that negative shrinking is only possible to a certain degree in the first subitem.}
+for instance, will come out like this:
 
 \bgroup
-\setlength{\examplenumbersep}{-0.2em}
+\setlength{\examplenumbersep}{-0.5em}
 \setlength{\subexamplenumbersep}{0.5em}
 
 \begin{subexamples}
@@ -371,13 +372,14 @@
 \egroup
 
 
-\section{Referring to examples}\label{sec:ref}
+\subsection{Referring to examples}\label{sec:ref}
 
-References to examples and sub-examples can be made the usual way via the \jcsmacro{ref} command.
+References to examples and sub-examples can be made the usual way via the \jcsmacro{ref} command
+(which refers to a \jcsmacro{label} that is placed in the respective example paragraph).
 The references do not have parentheses by default, i.\,e., a reference to the example
 in section~\ref{sec:ex} would be printed as \ref{expl}, a reference to the sub-example
 in section~\ref{sec:subexs} as \ref{sbex}.
-For convenience, \cvt\ provides a command \jcsmacro{pxref} that also prints the parentheses,
+For convenience, though, \cvt\ provides a command \jcsmacro{pxref} that also prints the parentheses,
 as in \pxref{expl} and \pxref{sbex}.
 
 
@@ -423,14 +425,15 @@
 \glend
 \end{lstlisting}
 %
-All together, \cvt\ provides eight macros for dealing with
-glosses:
+Sometimes, an additional fourth line is needed (for instance to gloss cited forms, morphology, or an additional translation). To support this as well,
+\cvt\ provides \jcsmacro{glll} and \jcsmacro{xglll}, each allowing for, and actually requiring, an additional line (see below for an example).
+
+All together, \cvt\ provides eight macros for dealing with glosses:
 \begin{itemize}
 \item \jcsmacro{gll} introduces two lines of words vertically aligned, and 
 activates an environment very similar to \jfenv{flushleft}. The two lines are separated by a normal line break (carriage return).
 \item \jcsmacro{glll} is like \jcsmacro{gll} except that it introduces
-\emph{three} lines of lined-up words (useful for cited forms, morphology,
-and translation).
+\emph{three} lines of lined-up words.
 \item \jcsmacro{xgll} is similar to \jcsmacro{gll} except that it does not make the line ending active. It thus works inside macros such as footnotes but requires explicit gloss line termination via \jcsmacro{xgle}.
 \item \jcsmacro{xglll} is similar to \jcsmacro{glll} except that it does not make the line ending active. It thus works inside macros such as footnotes but requires explicit gloss line termination via \jcsmacro{xgle}.
 \item \jcsmacro{xgle} is a gloss line ending marker to be used with \jcsmacro{xgll} and \jcsmacro{xglll}.
@@ -444,7 +447,7 @@
 Here are several examples.  First, a sentence with three lines aligned, 
 instead of just two:
 \glll  Hoc est aliud exemplum.
-       n.sg.nom 3.sg n.sg.nom n.sg.nom
+       \textsc{n.sg.nom} \textsc{3sg} \textsc{n.sg.nom} \textsc{n.sg.nom}
        This is another example.
 \glt   `This is another example.'
 \glend
@@ -451,7 +454,7 @@
 This is typed as:
 \begin{lstlisting}[moretexcs={glll,glt,glend}]
 \glll  Hoc est aliud exemplum.
-       n.sg.nom 3.sg n.sg.nom n.sg.nom
+       \textsc{n.sg.nom} \textsc{3sg} \textsc{n.sg.nom} \textsc{n.sg.nom}
        This is another example.
 \glt   `This is another example.'
 \glend
@@ -486,8 +489,8 @@
 \glend
 \end{example}
 \end{lstlisting}
-Notice that every glossed sentence begins with either \jcsmacro{gll} or 
-\jcsmacro{glll}, then contains either \jcsmacro{glt} or \jcsmacro{gln}, and ends 
+Notice that every glossed sentence begins with either \jcsmacro{gll}, \jcsmacro{xgll},
+\jcsmacro{glll} or \jcsmacro{xglll}, then contains either \jcsmacro{glt} or \jcsmacro{gln}, and ends 
 with \jcsmacro{glend}.  Layout is critical in the part preceding 
 \jcsmacro{glt} or \jcsmacro{gln}, and fairly free afterward.
 
@@ -655,7 +658,7 @@
 (\emph{Committee of Editors of Linguistics Journals}), which slightly differs from the \textsc{lsa} style,
 is followed by the style file \texttt{unified.bst} (available at \url{http://celxj.org/downloads/unified.bst}).
 A \texttt{biblatex} style file for the unified style is available at
-\url{https://github.com/semprag/biblatex-sp-unified}.})  For example,
+\url{https://github.com/semprag/biblatex-sp-unified} or on \textsc{ctan} as part of the \textsf{univie-ling} bundle.})  For example,
 \begin{lstlisting}
 \begin{reflist}
 Barton, G. Edward; Berwick, Robert C.; and Ristad, Eric Sven.  1987.
@@ -725,6 +728,13 @@
 
 \section{Release history}
 
+\subsection*{1.7 (2018 September 8)}
+
+\begin{itemize}
+	\item Fix alignment in \jenv{subexamples}.
+	\item Improve manual.
+\end{itemize}
+
 \subsection*{1.6 (2018 September 7)}
 
 \begin{itemize}

Modified: trunk/Master/texmf-dist/tex/latex/covington/covington.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/covington/covington.sty	2018-09-08 21:41:57 UTC (rev 48626)
+++ trunk/Master/texmf-dist/tex/latex/covington/covington.sty	2018-09-08 21:42:09 UTC (rev 48627)
@@ -42,8 +42,8 @@
 %%% Metadata
 %%%
 
-\def\filedate{2018/09/07}
-\def\fileversion{1.6}
+\def\filedate{2018/09/08}
+\def\fileversion{1.7}
 \def\filename{covington.sty}
 
 % Force redefinition of environments?
@@ -261,7 +261,6 @@
 
 \newenvironment{covsubexamples}%         % define "subexamples" environment
 {%
-    \addtolength{\examplenumbersep}{-0.75em}%
     \begin{covexample}
     \begin{enumerate}
     \addtolength{\labelsep}{\subexamplenumbersep}%
@@ -268,6 +267,8 @@
     \renewcommand\theenumi{\alph{enumi}}
     \renewcommand\labelenumi{\covsubexnumber{\theenumi}}
     \renewcommand\p at enumi{\theequation\,}%
+    \setlength{\listparindent}{0pt}%
+    \def\makelabel##1{##1\hfil}%       % put labels flushleft in space available
 }%
 {%
     \end{enumerate}



More information about the tex-live-commits mailing list