diff options
author | Karl Berry <karl@freefriends.org> | 2010-04-07 22:47:28 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-04-07 22:47:28 +0000 |
commit | 3f1971c9b7717818766692c9aa497e20e7472f2c (patch) | |
tree | 678de0190b6643b1b21fd9441fa1387bce180726 /Master/texmf-dist/doc/generic/FAQ-en/faq-how-do-i.tex | |
parent | c7c3b090320a234149dbe23315e2a15a2773ac79 (diff) |
FAQ-en 3.19d (7apr10)
git-svn-id: svn://tug.org/texlive/trunk@17742 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/faq-how-do-i.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/FAQ-en/faq-how-do-i.tex | 155 |
1 files changed, 70 insertions, 85 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/faq-how-do-i.tex b/Master/texmf-dist/doc/generic/FAQ-en/faq-how-do-i.tex index 40d334a538d..af25715e63a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/faq-how-do-i.tex +++ b/Master/texmf-dist/doc/generic/FAQ-en/faq-how-do-i.tex @@ -1,4 +1,4 @@ -% $Id: faq-how-do-i.tex,v 1.7 2010/01/19 22:44:39 rf10 Exp rf10 $ +% $Id: faq-how-do-i.tex,v 1.13 2010/04/02 18:20:00 rf10 Exp rf10 $ \section{How do I do\dots{}?} @@ -37,7 +37,7 @@ The \cmdinvoke{tag*}{\csx{qedhere}} construction may be used in any of \AMSLaTeX{}'s numbering environments. \begin{ctanrefs} \item[amsthm.sty]Distributed as part of the \AMSLaTeX{} bundle - \CTANref{amslatex} + \CTANref{amslatex}[amsthm] \item[ntheorem.sty]\CTANref{ntheorem} \end{ctanrefs} @@ -71,9 +71,9 @@ Alternatively, the following sets up an environment The \Package{ntheorem} package provides control of the fonts used by theorems, directly. \begin{ctanrefs} -\item[amsthm.sty]Distributed as part of \CTANref{amslatex} +\item[amsthm.sty]Distributed as part of \CTANref{amslatex}[amsthm] \item[ntheorem.sty]\CTANref{ntheorem} -\item[theorem.sty]Distributed as part of \CTANref{2etools} +\item[theorem.sty]Distributed as part of \CTANref{2etools}[theorem] \end{ctanrefs} \Question[Q-newfunction]{Defining a new log-like function in \LaTeX{}} @@ -136,7 +136,8 @@ As with \csx{DeclareMathOperator} there's a starred version (It should be noted that ``log-like'' was reportedly a \emph{joke} on Lamport's part; it is of course clear what was meant.) \begin{ctanrefs} -\item[amsopn.sty]In the \AMSLaTeX{} distribution \CTANref{amslatex} +\item[amsopn.sty]Distributed as part of the \AMSLaTeX{} distribution + \CTANref{amslatex}[amsopn] \end{ctanrefs} \Question[Q-braket]{Set specifications and Dirac brackets} @@ -484,19 +485,13 @@ signs): \end{flalign} \end{verbatim} \end{quote} - -Comprehensive documentation of \AMSLaTeX{} is to be found in -\File{amsldoc}, in the distribution; it is also available on the web -at \URL{ftp://ftp.ams.org/pub/tex/doc/amsmath/amsldoc.pdf} \begin{ctanrefs} -\item[amsldoc.tex]Distributed as part of \AMSLaTeX{} - \CTANref{amslatex} \item[amsmath.sty]Distributed as part of \AMSLaTeX{} - \CTANref{amslatex} + \CTANref{amslatex}[amsmath] \item[amstext.sty]Distributed as part of \AMSLaTeX{} - \CTANref{amslatex} + \CTANref{amslatex}[amstext] \item[mathtools.sty]Distributed as part of the \Package{mh} bundle - \CTANref{mh} + \CTANref{mh}[mathtools] \end{ctanrefs} \Question[Q-reuseq]{Re-using an equation} @@ -523,15 +518,9 @@ Remember that Here, the second instance of \ensuremath{a=b} will be typeset with a copy, made by the \csx{tag} command, of the label of the first instance. - -Comprehensive documentation of \AMSLaTeX{} is to be found in -\File{amsldoc}, in the distribution; it is also available on the web -at \URL{ftp://ftp.ams.org/pub/tex/doc/amsmath/amsldoc.pdf} \begin{ctanrefs} -\item[amsldoc.tex]Distributed as part of \AMSLaTeX{} - \CTANref{amslatex} \item[amsmath.sty]Distributed as part of \AMSLaTeX{} - \CTANref{amslatex} + \CTANref{amslatex}[amsmath] \end{ctanrefs} \Question[Q-brkinline]{Line-breaking in in-line maths} @@ -608,7 +597,7 @@ operation, only those equations to which you make reference will be numbered in the final output. See the package's documentation for details of how to make references when the switch is in effect. \begin{ctanrefs} -\item[mathtools.sty]Distributed as part of \CTANref{mh} +\item[mathtools.sty]Distributed as part of \CTANref{mh}[mathtools] \end{ctanrefs} \subsection{Lists} @@ -707,7 +696,7 @@ The \Class{memoir} class includes functions that match those in the %% larger than the default, you should also change \csx{leftmargini}, %% \csx{leftmarginii}, \emph{etc}. \begin{ctanrefs} -\item[enumerate.sty]Distributed as part of \CTANref{2etools} +\item[enumerate.sty]Distributed as part of \CTANref{2etools}[enumerate] \item[enumitem.sty]\CTANref{enumitem} \item[memoir.cls]\CTANref{memoir} \item[paralist.sty]\CTANref{paralist} @@ -817,11 +806,11 @@ to set spacing between items and between paragraphs within items. more ``basic'' (and therefore more flexible) manner than the % ! line break \Qref*{\Package{enumerate} package}{Q-enumerate} does. \begin{ctanrefs} -\item[enumerate.sty]Distributed as part of \CTANref{2etools} +\item[enumerate.sty]Distributed as part of \CTANref{2etools}[enumitem] \item[enumitem.sty]\CTANref{enumitem} \item[expdlist.sty]\CTANref{expdlist} \item[memoir.cls]\CTANref{memoir} -\item[mdwlist.sty]Distributed as part of \CTANref{mdwtools} +\item[mdwlist.sty]Distributed as part of \CTANref{mdwtools}[mdwlist] \item[multenum.sty]\CTANref{multenum} \item[paralist.sty]\CTANref{paralist} \item[savetrees.sty]\CTANref{savetrees} @@ -966,10 +955,10 @@ However, the `nested comment' interpolated in the nested enumeration appears as if it were a second paragraph to ``outer item 2'', which is hardly satisfactory. \begin{ctanrefs} -\item[enumerate.sty]Distributed as part of \CTANref{2etools} +\item[enumerate.sty]Distributed as part of \CTANref{2etools}[enumerate] \item[enumitem.sty]\CTANref{enumitem} \item[expdlist.sty]\CTANref{expdlist} -\item[mdwlist.sty]Distributed as part of \CTANref{mdwtools} +\item[mdwlist.sty]Distributed as part of \CTANref{mdwtools}[mdwlist] \end{ctanrefs} \subsection{Tables, figures and diagrams} @@ -1115,8 +1104,8 @@ should process using \LaTeX{}. Processing will give you a \File{.sty} file as well as the \File{.dvi} or \File{.pdf} output containing the documentation. \begin{ctanrefs} -\item[ltxtable.sty]Distributed as part of \CTANref{carlisle} -\item[tabularx.sty]Distributed as part of \CTANref{2etools} +\item[ltxtable.sty]Distributed as part of \CTANref{carlisle}[ltxtable] +\item[tabularx.sty]Distributed as part of \CTANref{2etools}[tabularx] \item[tabulary.sty]\CTANref{tabulary} \end{ctanrefs} @@ -1177,7 +1166,7 @@ or you can use it as follows: where the second column will end up noticeably wider, and will wrap to a second line in the third row. \begin{ctanrefs} -\item[array.sty]Distributed as part of \CTANref{2etools} +\item[array.sty]Distributed as part of \CTANref{2etools}[array] \item[varwidth.sty]\CTANref{varwidth} \end{ctanrefs} @@ -1254,12 +1243,9 @@ interesting. The package provides rule commands to support the author's scheme, but deals with inter-row spacing too. The most recent release of \Package{booktabs} sports compatibility with packages such as \Package{longtable}. - -Documentation of both \Package{bigstrut} and \Package{tabls} may be -found as comments in the package files themselves. \begin{ctanrefs} -\item[array.sty]Distributed as part of \CTANref{2etools} -\item[bigstrut.sty]Distributed as part of \CTANref{multirow} +\item[array.sty]Distributed as part of \CTANref{2etools}[array] +\item[bigstrut.sty]\CTANref{bigstrut} \item[booktabs.sty]\CTANref{booktabs} \item[cellspace.sty]\CTANref{cellspace} \item[tabls.sty]\CTANref{tabls} @@ -1329,10 +1315,10 @@ the head- and footline capabilities of the major packages. Documentation of \Package{ltablex} is to be found in the package file. \begin{ctanrefs} -\item[longtable.sty]Distributed as part of \CTANref{2etools} +\item[longtable.sty]Distributed as part of \CTANref{2etools}[longtable] \item[ltablex.sty]\CTANref{ltablex} \item[ltxtable.sty]Generate by running \CTANref{ltxtable} -\item[stabular.sty]Distributed as part of \CTANref{sttools} +\item[stabular.sty]Distributed as part of \CTANref{sttools}[stabular] \item[supertabular.sty]\CTANref{supertabular} \item[xtab.sty]\CTANref{xtab} \end{ctanrefs} @@ -1358,17 +1344,16 @@ arises in the last cell of a row: since each cell is set into a box, its settings are lost at the \texttt{\&} (or \texttt{\bsbs }) that terminates it. - -The technique using \csx{PBS} was developed in the days of \LaTeXo{} -because the actual value of \texttt{\bsbs } that the \environment{tabular} -environment uses was only available as an internal command. Nowadays, -the value is a public command, and you can in principle use it -explicitly: +In the old days, the actual value of \texttt{\bsbs } that the +\environment{tabular} environment uses was only available as an +internal command. Nowadays, the value is a public command, and you +can in principle use it explicitly: \begin{quote} \begin{verbatim} ... & \centering blah ... \tabularnewline \end{verbatim} \end{quote} +(but that's a rather verbose way of doing things). The \Package{array} package provides a command \csx{arraybackslash} which restores \texttt{\bsbs } to its correct (within table) meaning; @@ -1393,8 +1378,9 @@ specifications: The \csx{tabularnewline} and \csx{arraybackslash} commands are (somewhat) modern additions to \LaTeX{} and the \Package{array} -package, respectively. If neither is available, the user may try the -(old) solution which preserves the meaning of \texttt{\bsbs }: +package, respectively. In the unlikely event that neither is +available, the user may try the (old) solution which preserves the +meaning of \texttt{\bsbs }: \begin{quote} \begin{verbatim} \newcommand\PBS[1]{\let\temp=\\% @@ -1416,7 +1402,7 @@ or in the preamble as: \end{verbatim} \end{quote} \begin{ctanrefs} -\item[array.sty]Distributed as part of \CTANref{2etools} +\item[array.sty]Distributed as part of \CTANref{2etools}[array] \end{ctanrefs} \nothtml{\vskip 0pt plus 4ex} @@ -1700,7 +1686,7 @@ The \Package{array} package works with several other example \environment{longtable}), but unfortunately this trick won't always work. \begin{ctanrefs} -\item[array.sty]Distributed as part of \CTANref{2etools} +\item[array.sty]Distributed as part of \CTANref{2etools}[array] \end{ctanrefs} \Question[Q-multirow]{Merging cells in a column of a table} @@ -1814,7 +1800,7 @@ rows in the multi-row have been opened up with \csx{bigstrut}. The documentation of both \Package{multirow} and \Package{bigstrut} is to be found, as comments, in the package files themselves. \begin{ctanrefs} -\item[bigstrut.sty]Distributed as part of \CTANref{multirow} +\item[bigstrut.sty]\CTANref{bigstrut} \item[multirow.sty]\CTANref{multirow} \end{ctanrefs} @@ -1984,8 +1970,8 @@ float is set \emph{before} any single column floats). something approximating the effect it would have.) \begin{ctanrefs} \item[dblfloatfix.sty]\CTANref{dblfloatfix} -\item[stfloats.sty, midfloat.sty]Distributed as part of - \CTANref{sttools} +\item[midfloat.sty]Distributed as part of \CTANref{sttools}[midfloat] +\item[stfloats.sty]Distributed as part of \CTANref{sttools}[stfloats] \end{ctanrefs} \Question[Q-mcfloat]{Floats in multicolumn setting} @@ -2018,7 +2004,7 @@ running off the end of the column at the end of the \environment{multicols} environment). \begin{ctanrefs} \item[float.sty]\CTANref{float} -\item[multicol.sty]Distributed as part of \CTANref{2etools} +\item[multicol.sty]Distributed as part of \CTANref{2etools}[multicol] \end{ctanrefs} \Question[Q-dpfloat]{Facing floats on 2-page spread} @@ -2043,9 +2029,6 @@ this: the construction to use is: \end{quote} The construction has no effect unless the standard class option \pkgoption{twoside} is in effect. - -Full documentation of the package (such as it is) is to be found in -\File{README.dpfloat} \begin{ctanrefs} \item[dpfloat.sty]\CTANref{dpfloat} \end{ctanrefs} @@ -2173,7 +2156,7 @@ and the sequence of float numbers is all correct. \item[caption.sty]\CTANref{caption} \item[float.sty]\CTANref{float} \item[here.sty]\CTANref{here} -\item[perpage.sty]Distributed as part \CTANref{bigfoot} +\item[perpage.sty]Distributed as part \CTANref{bigfoot}[perpage] \end{ctanrefs} \subsection{Footnotes} @@ -2237,12 +2220,12 @@ in ordinary text. The author of this \acro{FAQ} answer doesn't actually recommend any of them, believing that table notes are the way to go\dots{} \begin{ctanrefs} \item[ctable.sty]\CTANref{ctable} -\item[footnote.sty]Distributed as part of \CTANref{mdwtools} -\item[longtable.sty]Distributed as part of \CTANref{2etools} -\item[mdwtab.sty]Distributed as part of \CTANref{mdwtools} +\item[footnote.sty]Distributed as part of \CTANref{mdwtools}[footnote] +\item[longtable.sty]Distributed as part of \CTANref{2etools}[longtable] +\item[mdwtab.sty]Distributed as part of \CTANref{mdwtools}[mdwtab] \item[threeparttable.sty]\CTANref{threeparttable} \item[threeparttablex.sty]\CTANref{threeparttablex} -\item[tabularx.sty]Distributed as part of \CTANref{2etools} +\item[tabularx.sty]Distributed as part of \CTANref{2etools}[tabularx] \end{ctanrefs} \Question[Q-ftnsect]{Footnotes in \LaTeX{} section headings} @@ -2449,8 +2432,7 @@ also designed to support typesetting critical editions. \item[edmac]\CTANref{edmac} \item[ednotes]\CTANref{ednotes} \item[ledmac]\CTANref{ledmac} -\item[manyfoot.sty]Distributed as part of the \CTANref{ncctools} - bundle +\item[manyfoot.sty]Distributed as part of \CTANref{ncctools}[manyfoot] \end{ctanrefs} \Question[Q-footnpp]{Footnotes numbered ``per page''} @@ -2491,15 +2473,14 @@ the one package to achieve your ends. The \Package{footnpag} package also does per-page footnotes (and nothing else). With the competition from \Package{perpage}, it's -probably not particularly useful any more. (Documentation is -\File{footnpag-user.pdf} in the distribution.) +probably not particularly useful any more. \begin{ctanrefs} \item[footmisc.sty]\CTANref{footmisc} \item[footnpag.sty]\CTANref{footnpag} -\item[perpage.sty]Distributed as part \CTANref{bigfoot} -\item[zref.sty]Distributed as a collection member in \CTANref{oberdiek} -\item[zref-perpage.sty]Distributed as a collection member in - \CTANref{oberdiek} +\item[perpage.sty]Distributed as part \CTANref{bigfoot}[perpage] +\item[zref.sty]Distributed as part of \CTANref{oberdiek}[zref] +\item[zref-perpage.sty]Distributed as part of \Package{zref} in + \CTANref{oberdiek}[zref] \end{ctanrefs} \Question[Q-run-fn-nos]{Not resetting footnote numbers per chapter} @@ -2643,13 +2624,19 @@ be used as a check-list in case that problems arise. Note that \csx{listfiles} only registers things that are input by the ``standard'' \LaTeX{} mechanisms (\csx{documentclass}, \csx{usepackage}, -\csx{input}, \csx{include}, \csx{includegraphics} and so on). But if you -use \TeX{} primitive syntax, as in +\csx{include}, \csx{includegraphics} and so on). +The \csx{input} command, as modified by \LaTeX{} and used, with +\LaTeX{} syntax, as: +\begin{verbatim} + \input{mymacros} +\end{verbatim} +records file details for \File{mymacros.tex}, but if you use \TeX{} +primitive syntax for \csx{input}, as: \begin{verbatim} \input mymacros \end{verbatim} -\File{mymacros.tex} \emph{won't} be listed by \csx{listfiles}, since -you've bypassed the mechanism that records its use. +\File{mymacros.tex} \emph{won't} be recorded, and so won't listed by +\csx{listfiles}~--- you've bypassed the mechanism that records its use. The \Package{snapshot} package helps the owner of a \LaTeX{} document obtain a list of the external dependencies of the document, in a form @@ -2923,21 +2910,19 @@ including (numeric or labelled) ranges of environments to extract, and an \environment{extract} environment which you can use to create complete ready-to-run \LaTeX{} documents with stuff you've extracted. \begin{ctanrefs} -\item[askinclude.sty]Distributed with Heiko Oberdiek's packages~--- - \CTANref{oberdiek} +\item[askinclude.sty]Distributed as part of \CTANref{oberdiek}[askinclude] \item[comment.sty]\CTANref{comment} \item[excludeonly.sty]\CTANref{excludeonly} \item[extract.sty]\CTANref{extract} \item[memoir.cls]\CTANref{memoir} \item[optional.sty]\CTANref{optional} -\item[pagesel.sty]Distributed with Heiko Oberdiek's packages~--- - \CTANref{oberdiek} +\item[pagesel.sty]Distributed as part of \CTANref{oberdiek}[pagesel] \item[pdfpages.sty]\CTANref{pdfpages} \item[selectp.sty]\CTANref{selectp} -\item[verbatim.sty]Distributed as part of \CTANref{2etools} +\item[verbatim.sty]Distributed as part of \CTANref{2etools}[verbatim] \item[version.sty]\CTANref{version} \item[versions.sty]\CTANref{versions} -\item[xcomment.sty]Distributed as part of \CTANref{seminar} +\item[xcomment.sty]Distributed as part of \CTANref{seminar}[xcomment] \end{ctanrefs} \Question[Q-docotherdir]{Bits of document from other directories} @@ -3031,8 +3016,8 @@ following minimal solution: \begin{wideversion} \begin{verbatim} \def\RCS$#1: #2 ${\expandafter\def\csname RCS#1\endcsname{#2}} -\RCS$Revision: 1.7 $ % or any RCS keyword -\RCS$Date: 2010/01/19 22:44:39 $ +\RCS$Revision: 1.13 $ % or any RCS keyword +\RCS$Date: 2010/04/02 18:20:00 $ ... \date{Revision \RCSRevision, \RCSDate} \end{verbatim} @@ -3042,8 +3027,8 @@ following minimal solution: \def\RCS$#1: #2 ${\expandafter \def\csname RCS#1\endcsname{#2}% } -\RCS$Revision: 1.7 $ % or any RCS keyword -\RCS$Date: 2010/01/19 22:44:39 $ +\RCS$Revision: 1.13 $ % or any RCS keyword +\RCS$Date: 2010/04/02 18:20:00 $ ... \date{Revision \RCSRevision, \RCSDate} \end{verbatim} @@ -3188,8 +3173,8 @@ to the equivalent of the \texttt{LastPage} label and the Both \Package{count1to} and \Package{totpages} need the support of the \Package{everyshi} package. \begin{ctanrefs} -\item[count1to.sty \nothtml{\bgroup\rmfamily}and\nothtml{\egroup} everyshi.sty]% line break!! - Distributed in \CTANref{ms} +\item[count1to.sty]Distributed as part of \CTANref{ms}[count1to] +\item[everyshi.sty]Distributed as part of \CTANref{ms}[everyshi] \item[lastpage.sty]\CTANref{lastpage} \item[memoir.cls]\CTANref{memoir} \item[totpages.sty]\CTANref{totpages} @@ -3221,7 +3206,7 @@ The package is known to fail, for example, with documents that use All these things can be overcome (although it's not often easy), but the environment saves a lot of work on many occasions. \begin{ctanrefs} -\item[plain.sty]Distributed as part of \CTANref{carlisle} +\item[plain.sty]Distributed as part of \CTANref{carlisle}[plain-ltx] \end{ctanrefs} \subsection{Hyphenation} @@ -3519,7 +3504,7 @@ and the \Package{hyphenat} package uses this technique for its \csx{nohyphens} command which sets its argument without any hyphenation. You can load \Package{hyphenat} with the command \begin{quote} - \cmdinvoke{usepckage}[none]{hyphenat} + \cmdinvoke{usepackage}[none]{hyphenat} \end{quote} to prevent any hyphenation in a single-language document. The technique cannot work in a document in which \Package{babel} controls |