summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/ulem
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-01-10 21:42:03 +0000
committerKarl Berry <karl@freefriends.org>2020-01-10 21:42:03 +0000
commit2e6956a9eea8269ca8f5660ae80a8ce408c7b47d (patch)
treed1ed8410a3069bbba9347ff397c5705af2f02c20 /Master/texmf-dist/doc/generic/ulem
parenta93ee1456c70aac1fa5d0f2955af4c80a346c4a3 (diff)
ulem (10jan20)
git-svn-id: svn://tug.org/texlive/trunk@53365 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/ulem')
-rw-r--r--Master/texmf-dist/doc/generic/ulem/README2
-rw-r--r--Master/texmf-dist/doc/generic/ulem/ulem.ltx34
-rw-r--r--Master/texmf-dist/doc/generic/ulem/ulem.pdfbin105944 -> 160373 bytes
3 files changed, 18 insertions, 18 deletions
diff --git a/Master/texmf-dist/doc/generic/ulem/README b/Master/texmf-dist/doc/generic/ulem/README
index 22dd59adcaf..a2fbf260287 100644
--- a/Master/texmf-dist/doc/generic/ulem/README
+++ b/Master/texmf-dist/doc/generic/ulem/README
@@ -5,7 +5,7 @@
A declaration of \normalem (or the \usepackage option "normalem") restores
the normal \em and \emph behavior.
- Copyright 1989-2011 by Donald Arseneau (Vancouver, Canada; asnd@triumf.ca)
+ Copyright 1989-2019 by Donald Arseneau (Vancouver, Canada; asnd@triumf.ca)
This software may be freely transmitted, reproduced, or modified for any
purpose provided that this copyright notice is left intact.
diff --git a/Master/texmf-dist/doc/generic/ulem/ulem.ltx b/Master/texmf-dist/doc/generic/ulem/ulem.ltx
index 2979659c300..4d46a2f9e99 100644
--- a/Master/texmf-dist/doc/generic/ulem/ulem.ltx
+++ b/Master/texmf-dist/doc/generic/ulem/ulem.ltx
@@ -2,9 +2,9 @@
% ulem.ltx Manual for ulem.sty
%
%
-% Copyright (c) 1989-2011 by Donald Arseneau
+% Copyright (c) 1989-2019 by Donald Arseneau
%
-% Version date 2011/03/18
+% Version date 2019/11/18
%
\documentclass[12pt]{ltxdoc}
\addtolength{\textwidth}{1cm}
@@ -15,7 +15,7 @@
\hyphenation{normalem uwforbf ulforem}
\title{The ulem package:\\ underlining for emphasis}
\author{Donald Arseneau\\ asnd@triumf.ca}
-\date{2011/03/18}
+\date{2019/11/18}
\begin{document}
\maketitle
@@ -46,7 +46,7 @@
\begin{footnotesize}
-\noindent The ulem package is Copyright \copyright\ 1989--2011 by
+\noindent The ulem package is Copyright \copyright\ 1989--2019 by
Donald Arseneau (Vancouver, Canada).\\
The package (ulem.sty) and this documentation (ulem.ltx, ulem.pdf) may be
freely transmitted, reproduced, or modified for any purpose provided that the
@@ -104,9 +104,8 @@ Alternative package: soul.
You can define your own styles of overprinting or underlining by using
the \cs{markoverwith} command in the definition of your new command.
-The definition should be something like:\\[3pt]
-\indent
- \cs{newcommand}\cs{cmd}|{|\cs{bgroup} \cs{markoverwith}|{|\meta{something}|}|\cs{ULon}|}|\\[3pt]
+The definition should be something like:\\[6pt]
+ \cs{newcommand}\cs{cmd}|{|\cs{bgroup} \meta{settings}\cs{markoverwith}|{|\meta{something}|}|\cs{ULon}|}|\\[8pt]
The `\meta{something}' can be as simple as a single character, or as complex as
you can keep track of; it will likely contain some repositioning commands, perhaps
\cs{raisebox}.
@@ -127,26 +126,27 @@ Any type of underlining can be substituted for any font-selection command
by issuing a proper \cs{useunder} declaration:\\[3pt]
\cs{useunder}|{|\meta{underlinecommand}|}{|\meta{fontdeclaration}|}{|\meta{fontcommand}|}|\\[3pt]
e.g., |\useunder{\uuline}{\bfseries}{\textbf}| gives a double underline
-instead of bold face in \LaTeX.
+instead of bold face in \LaTeX\ (but note the problem explained next).
The commands \cs{normalem} and \cs{ULforem} respectively disable and enable
underlining for \cs{em}/\cs{emph}, and so do the \cs{usepackage}
options [normalem] and [ULforem]. There is also the \cs{usepackage}
-option [UWforbf] to replace boldface with a wavey underline. These features
-use the \cs{useunder} command internally. UWforbf does handle bold in
-math mode, in a limited way, but it doesn't work in section titles,
-unfortunately, because the titles are not delimited by explicit braces when
-printed by the \cs{section} command. Currently under UWforbf the \cs{bfseries}
+option [UWforbf] to replace boldface from \cs{textbf} with a wavey underline.
+These features use the \cs{useunder} command internally.
+UWforbf specifically employs
+\cs{useunder}|{|\cs{uwave}|}|\allowbreak|{|\cs{bf}|}|\allowbreak|{|\cs{textbf}|}|,
+so the \cs{bfseries}
command still produces bold face, but \cs{bf} makes an
-under-wave\footnote{%% no verbatim in footnotes
+under-wave (if \cs{bf} is defined at all). That is
+because section title formatting typically uses \cs{bfseries} not delimited by
+braces, which would give errors for \cs{uwave}.\footnote{%% no verbatim in footnotes
To get under-waved section titles (in ordinary \LaTeX\ classes) you could define:\\
\texttt{\string\renewcommand\string\@seccntformat[1]\string{\string\uwave
\string{\string\csname\ the\#1\string\endcsname\string}\string\hskip 1em\string}}\\
and later specify
\texttt{\string\section[...]\string{\string\uwave\string{...\string}\string}}.
But you don't want to enter that swamp.}
-(if |\bf| is defined at all).
-In plain \TeX\ there is |\bf| but no \cs{textbf} so you could say |\useunder{\UWave}{\bf}{}|.
+In plain \TeX\ there is \cs{bf} but no \cs{textbf} so you could say |\useunder{\uwave}{\bf}{}|.
Some commands, such as |\\| and \cs{hskip} are given special treatment to
work within uline, but others are not. Support for others can sometimes
@@ -157,7 +157,7 @@ versions of commands should be modelled on |\UL@hskip| or |\UL@cr|, and
should include the test `|\ifx\ \LA@space|'. For example, support for
\cs{marginpar} is added through the hook mechanism.
-All the underlining commands are robust (self-protecting) in \LaTeX.
+All the underlining commands are robust in \LaTeX.
\section{Complications}
diff --git a/Master/texmf-dist/doc/generic/ulem/ulem.pdf b/Master/texmf-dist/doc/generic/ulem/ulem.pdf
index e478d6ed5a7..f0943c75769 100644
--- a/Master/texmf-dist/doc/generic/ulem/ulem.pdf
+++ b/Master/texmf-dist/doc/generic/ulem/ulem.pdf
Binary files differ