From fd8b5081012294fd4fa8b3c9371f0b26b39d0ef1 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 14 Oct 2010 23:41:12 +0000 Subject: reinstate bezos, it contains babeltools git-svn-id: svn://tug.org/texlive/trunk@20106 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/bezos/babeltools.pdf | Bin 0 -> 112815 bytes Master/texmf-dist/doc/latex/bezos/babeltools.tex | 111 +++++++++++++++++++++++ 2 files changed, 111 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/bezos/babeltools.pdf create mode 100644 Master/texmf-dist/doc/latex/bezos/babeltools.tex (limited to 'Master/texmf-dist/doc/latex/bezos') diff --git a/Master/texmf-dist/doc/latex/bezos/babeltools.pdf b/Master/texmf-dist/doc/latex/bezos/babeltools.pdf new file mode 100644 index 00000000000..092a6558725 Binary files /dev/null and b/Master/texmf-dist/doc/latex/bezos/babeltools.pdf differ diff --git a/Master/texmf-dist/doc/latex/bezos/babeltools.tex b/Master/texmf-dist/doc/latex/bezos/babeltools.tex new file mode 100644 index 00000000000..f54db645662 --- /dev/null +++ b/Master/texmf-dist/doc/latex/bezos/babeltools.tex @@ -0,0 +1,111 @@ +%$PDFLaTeX (encoding:utf-8) + +\documentclass{article} + +\author{Javier Bezos} +\title{\textsf{babeltools}\\% +\Large Fixing (some) \textsf{babel} annoyances} + +\begin{document} + +\maketitle + +(Beta.) + +The \textsf{babel} package introduces some changes in the \LaTeX{} +kernel which are not strictly necessary (perhaps just convenient), but +have some unwanted side-effects. Oddly enough, most of these changes +cannot be disabled, with a few exceptions (eg, \texttt{activeacute} +and \texttt{activegrave}, but note there are not \texttt{activecaret} +or \texttt{activetilde}). + +With \textsf{babeltools} you can modify the \textsf{babel} behaviour +by means of a set of package options, with a few macros serving as +tools for specific purposes. This package must be loaded +\textbf{before} \textsf{babel}. + +\section{Package options} + +\begin{description} +\item[shorthands=off] The shorthands mechanism is turned off. +As some languages use this mechanism for tools not availible +otherwise, a macro \verb|\babelshorthand| is defined, which allows +using them; see below. + +\item[shortands=...] The shorthands mechanism is on, but the only +shorthands activated are those given, like, eg: +\begin{verbatim} +\usepackage[shorthands=:;!?]{babeltools} +\end{verbatim} + +If \verb|'| is included, \texttt{activeacute} is passed to +\textsf{babel}; if \verb|`| is included, \texttt{activegrave} is +passed. Active characters (like \verb|~|) should be preceded by +\verb|\string| (otherwise they will be expanded by \LaTeX{} before +they are passed to the package and therefore they will not be +recognized). + +\item[adaptive] By default, all \textsf{babel} shorthands are active +and live from start to end of documents. You can deactivate them by +hand with \verb|\shorthandoff|, but this is cumbersome and you cannot +use it ``just in case'' (if the character is not a shorthands an error +is raised, instead of ignoring silently the redundant setting). That +means you have to accept a character like : is active in an English +document even if you need it for just a few quotations in French. The +default engine may be replaced by a new one which adapts the +shorthands behaviour to the context in the following way: +\begin{enumerate} +\item In math mode, while still shorthands, they behave always like the +corresponding normal char. Things like \verb|$a \mathrel{x'} b$| +work as expected. + +\item When the language is switched, shorthands chars are made normal or +active, as appropiate. Thus, \texttt{:} or \texttt{?} are active only in +\texttt{french}. +\end{enumerate} + +% This option is useful when there are, say, short quotations in French +% inside a German text or when there are whole chapter in either French +% or German. + +\item[nocrossrefs] newlabel, ref and pageref are not redefined. You +cannot use shorthands in labels. + +\item[nocitations] nocite, bibcite and bibitem are not redefined. You +cannot use shorthands in labels. + +\item[langcaptions] Captions are redefined if possible so that an +intermediate macro \verb|\lang...name| is used, eg, +\verb|\germanchaptername|. Somewhat experimental. + +\item[noconfig] Config files are not loaded, so you can make sure your +document is not spoilt by an unexpected \texttt{.cfg} file. +\end{description} + +Babel tweaks several packages for shorthands to be accepted. At the +time of this writing they are \textsf{cite}, \textsf{natbib}, +\textsf{varioref} and \textsf{hhline} (the latter for the colon). If +you don't use shorthands, these redefinitions are unnecesary and +inconvenient. If you give a list of shorthands and it doesn't include +\verb|:|, then \verb|hhline| is left untouched. The other packages +are handled by \texttt{nocrossrefs} and \texttt{nocitations}, as +appropiate. + +\section{Macros} + +\begin{description} +\item[\ttfamily\string\babelshorthand] Use a shorthand, even with +\texttt{shorthands=off} or not listed in it, eg, +\verb|\babelshorthand{"u}| or \verb|\babelshorthand{:}|. You can +conveniently define your own macros. +\end{description} + +\section{Known limitations} + +If a class loads \textsf{babel} with a language, you cannot use +\textsf{babeltools}. However, if a class loads babel without loading +any language, you can use it. Languages given in +\verb|\documentclass| work as expected (provided the class doesn't +load it, of course). + +\end{document} \ No newline at end of file -- cgit v1.2.3