summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/titlecaps/titlecaps.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-01-30 22:02:57 +0000
committerKarl Berry <karl@freefriends.org>2015-01-30 22:02:57 +0000
commit37a530cfe394c0bfeef73bd34cf86b9c5ecedabb (patch)
tree9041b11a20548dfa9eed5229100a5bee35c30f5c /Master/texmf-dist/doc/latex/titlecaps/titlecaps.tex
parente5e0aeb7fe58d7adb35199774ede1ac6da9ad454 (diff)
titlecaps (30jan15)
git-svn-id: svn://tug.org/texlive/trunk@36170 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/titlecaps/titlecaps.tex')
-rw-r--r--Master/texmf-dist/doc/latex/titlecaps/titlecaps.tex35
1 files changed, 21 insertions, 14 deletions
diff --git a/Master/texmf-dist/doc/latex/titlecaps/titlecaps.tex b/Master/texmf-dist/doc/latex/titlecaps/titlecaps.tex
index e2e0b35bc8c..01124a08308 100644
--- a/Master/texmf-dist/doc/latex/titlecaps/titlecaps.tex
+++ b/Master/texmf-dist/doc/latex/titlecaps/titlecaps.tex
@@ -1,5 +1,5 @@
\documentclass{article}
-\def\version{1.1}
+\def\version{1.2}
%% Copyright 2013 Steven B. Segletes
%
% This work may be distributed and/or modified under the
@@ -16,6 +16,10 @@
%
% V1.1 -Typographical corrections to docs.
% -Missing % added on line 356
+% V1.2 -Now works with \l and \aa national symbols.
+% -Replaced all occurrences of \roman with \romannumeral\value
+% -Found two lines needing a trailing %
+% -Added a trailing space following invocations of \catcode
%
\usepackage{titlecaps}
\usepackage{needspace}
@@ -152,7 +156,7 @@ the lower-cased word flag that has previously been set. The {\tcp}
package can notably handle the titling of strings containing both
diacritical marks found in various languages (such as \`o, \'o, \^o,
\"o, \~o, \=o, \.o, \u o, \v o, \H o, \t{oo}, \c o, \d o, and \b o), as
-well as national symbols (such as \oe, \ae, and \o~[see {\QL}]).
+well as national symbols (such as \oe, \ae, \aa, \l, and \o).
While punctuation had been earlier screened out in order to search for
predefined lower-cased words, that is a slightly different problem from
@@ -173,12 +177,6 @@ While {\tcp} has been set up to run with certain embedded size and
font-changing commands, it will not, in general, work with macros in the
argument, unless the macros expand directly to a text string.
-The {\tcp} package is designed to work with diacritical marks (for
-example, umlauts) as well as national symbols (symbols like \ae, \oe,
-\textit{etc.}). There remain, however, two national symbols which are
-not handled properly by this package. They are {\aa} and {\l}. They
-will not be capitalized, even if found at the beginning of a word.
-
The {\tcp} package is designed to screen out punctuation when searching
for words that are pre-designated as lower-cased. So, for example, the
word (\textit{if}) or \textit{``if''} or [\textit{if} or \textit{if,}
@@ -195,10 +193,13 @@ can be used to for one-time exceptions to titling, or to overcome the
curly-brace problem described above, as in \verb|\{\relax if\}|.
The package introduces a command, \verb|\textnc|\margcmd{textnc}
-(standing for ``text no-change''), which forces its argument to be
+(standing for ``text no-change''). If used outside of the
+\verb|\titlecap| argument, it is defined as \verb|\def\textnc#1{#1}|
+and so is leaves the argument intact. Inside of the \verb|\titlecap|
+argument, however, it forces its argument to be
independently considered as text, regardless of any surrounding
punctuation or other characters. Thus, this approach may also be used
-to address the curly-brace issue as \verb|\{\textnc{it}\}|. In this
+to address the curly-brace issue as \verb|\{\textnc{if}\}|. In this
case, ``if'' would be titled if it is not on the lower-cased word list,
but left in lower case if it were on the lower-cased word list. The
\verb|\textnc| command is useful in a number of ways inside the argument
@@ -339,6 +340,12 @@ string parsing and punctuation screening techniques of this package:
\verb|http://tex.stackexchange.com/questions/105735/ignoring|\\
\verb|-punctuation-during-comparison|
+I would also like to thank Prof. Enrico Gregorio for his discovery of several
+bugs in the package and suggestions for fixes:
+
+\verb|http://tex.stackexchange.com/questions/225434/|\\
+\verb|how-to-workaround-conflict-between-greek-and-titlecaps|
+
\clearpage
\section{\titlecap{a \ttfamily\bs titlecap \rmfamily demonstration
for beginners,\\ expressed in \texttt{\bs titlecap}}}
@@ -367,18 +374,18 @@ but if you want the argument of that command to not be titled, you
either need, in this example, to add \textit{xx} to the lowercase word
list, which you can see i did not. instead, i put ``\bs relax~xx'' as
the argument, so that, in essence, the \bs relax was capitalized, not
-the x. Or you could use \texttt{\bs textnc} . here i demonstrate that
+the x. Or you could use \texttt{\bs textnc}. here i demonstrate that
text boldface, \textbf{as in the \bs textbf command}, also works fine,
as do \texttt{texttt}, \textsl{textsl}, \textsc{textsc},
\textsf{textsf}, \textit{etc}. titlecap will work on diacritical marks,
such as \"apfel, \c cacao \textit{etc.}, \scriptsize fontsize \LARGE
changing commands\normalsize\unskip, as well as national symbols such as
-\o laf, \ae gis, and \oe dipus. unfortunately, i could not get it to
-work on the \aa~nor the \l~symbols. the method will work with some
+\o laf, \ae gis, \oe dipus, \aa ngstrom, and \l ucky.
+the method will work with some
things in math mode, capitalizing symbols if there is a leading space,
$x^2$ can become $ x^2$, and it can process but it will not capitalize
the greek symbols, such as $\alpha$, and will choke on most macros, if
-they are not direct character expansions. Additionally,
+they are not direct character expansions. additionally,
\textsf{titlecaps} also works with font changing declarations, for
example, \bs itshape\bs sffamily. \itshape\sffamily you can see that it
works fine. likewise, any subsequent \bs textxx command will, upon