summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/csquotes/csquotes.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-01-02 23:50:05 +0000
committerKarl Berry <karl@freefriends.org>2017-01-02 23:50:05 +0000
commitb11fa28addcddb2dbe955e36abe1c4a9ffedabae (patch)
treea4756f9d107741fc00e832cad57fa9f1771db65b /Master/texmf-dist/doc/latex/csquotes/csquotes.tex
parentaccc73bc080e1e460e175e63e1e849cae60d5740 (diff)
csquotes (28dec16)
git-svn-id: svn://tug.org/texlive/trunk@42841 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/csquotes/csquotes.tex')
-rw-r--r--Master/texmf-dist/doc/latex/csquotes/csquotes.tex30
1 files changed, 25 insertions, 5 deletions
diff --git a/Master/texmf-dist/doc/latex/csquotes/csquotes.tex b/Master/texmf-dist/doc/latex/csquotes/csquotes.tex
index 22d06249ec6..2700b9fec9e 100644
--- a/Master/texmf-dist/doc/latex/csquotes/csquotes.tex
+++ b/Master/texmf-dist/doc/latex/csquotes/csquotes.tex
@@ -18,8 +18,8 @@
url={http://www.ctan.org/pkg/csquotes/},
author={Philipp Lehman, Joseph Wright},
email={joseph.wright@morningstar2.co.uk},
- revision={v5.1h},
- date={2016/07/14}}
+ revision={v5.2},
+ date={2016/12/28}}
\hypersetup{%
pdftitle={The csquotes Package},
@@ -578,7 +578,7 @@ This environment combines \env{displaycquote} with \env{hyphenrules}. Apart from
\section{Auxiliary Commands}
\label{aux}
-When quoting text in a formal way, any changes applied to the quoted material, such as omissions, insertions, or alterations, are typically marked as such by using the ellipsis mark and square brackets or parentheses. Use the following commands to indicate such changes in formal quotations:
+When quoting text in a formal way, any changes applied to the quoted material, such as omissions, insertions, or alterations, are typically marked as such by using square brackets or parentheses and, where appropriate, ellipses. Use the following commands to indicate such changes in formal quotations:
\begin{ltxsyntax}
@@ -606,6 +606,16 @@ By default, \cmd{textins} will enclose the \prm{text} added to the quoted materi
\textins*{T}ext %= \textins*{T}ext %
\end{ltxcode}
%
+The deletion of individual letters may be indicated with the following command:
+
+\cmditem{textdel}{text}
+
+By default, \cmd{textdel} will output two square brackets. The omitted \prm{text} is not output.
+
+\begin{ltxcode}[escapechar={\%},escapebegin={\rmfamily}]
+ text\textdel{s} %= text\textdel{s} %
+\end{ltxcode}
+%
See \secref{cfg:elp} on how to configure the appearance of ellipses and insertions.
\end{ltxsyntax}
@@ -1010,10 +1020,10 @@ This definition is restored automatically whenever the \opt{autopunct} package o
\end{ltxsyntax}
-\subsection{Configuring Ellipses}
+\subsection{Configuring Auxiliary Commands}
\label{cfg:elp}
-The appearance of ellipses and insertions formatted with the auxiliary commands from \secref{aux} is controlled by five hooks. When \cmd{textelp} is used with an empty argument (ellipsis only), it will execute \cmd{mktextelp}. When used with a non-empty \prm{text} argument (ellipsis and insertion), the \prm{text} will be passed as an argument to \cmd{mktextelpins}. The starred form will pass the \prm{text} to \cmd{mktextinselp} instead. These are the default definitions:
+The appearance of ellipses and insertions formatted with the auxiliary commands from \secref{aux} is controlled by six hooks. When \cmd{textelp} is used with an empty argument (ellipsis only), it will execute \cmd{mktextelp}. When used with a non-empty \prm{text} argument (ellipsis and insertion), the \prm{text} will be passed as an argument to \cmd{mktextelpins}. The starred form will pass the \prm{text} to \cmd{mktextinselp} instead. These are the default definitions:
\begin{ltxcode}[showspaces=true]
\newcommand{<<\mktextelp>>}{[\textellipsis\unkern]}
@@ -1028,6 +1038,12 @@ The \cmd{textins} command passes its \prm{text} argument to \cmd{mktextins} for
\newcommand{<<\mktextmod>>}[1]{[#1]}
\end{ltxcode}
%
+The \cmd{textdel} command passes its \prm{text} argument to \cmd{mktextdel} for further processing. This is the default definition (note that the argument is not output):
+
+\begin{ltxcode}[showspaces=true]
+\newcommand{<<\mktextdel>>}[1]{[]}
+\end{ltxcode}
+%
You may redefine the above hooks to change the format of the printed output. For example, if you prefer replacements to be indicated by «[\textellipsis text]» rather than «[\textellipsis\unkern] [text]», redefine \cmd{mktextelpins} accordingly:
\begin{ltxcode}
@@ -1533,6 +1549,10 @@ This revision history is a list of changes relevant to users of this package. Ch
\begin{changelog}
+\begin{release}{5.2}{2016-12-28}
+ \item Add \cmd{textdel} auxiliary command.\see{aux}
+\end{release}
+
\begin{release}{5.1h}{2016-07-14}
\item Adapt \cmd{fixligatures} to work correctly with \luatex
\end{release}