diff options
author | Karl Berry <karl@freefriends.org> | 2013-06-28 22:26:18 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2013-06-28 22:26:18 +0000 |
commit | 98d97883f83dd86032b6b058692d87b9fa83926b (patch) | |
tree | 8de3c144ec825fc9cc4b1fe255b60875a8b9e1bb /Master/texmf-dist/doc/generic/FAQ-en/faq-how-do-i.tex | |
parent | aa0b340189383ff3014db4eaec3aeb58687d6207 (diff) |
FAQ-en (7jun13)
git-svn-id: svn://tug.org/texlive/trunk@31019 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 | 46 |
1 files changed, 27 insertions, 19 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 f767d3959d5..f2fbfb63e86 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 @@ -2259,9 +2259,9 @@ and the sequence of float numbers is all correct. \Question[Q-footintab]{Footnotes in tables} The standard \LaTeX{} \csx{footnote} command doesn't work in tables; -the table traps the footnotes and they can't escape to the bottom of -the page. As a result, you get footnote marks in the table, and -nothing else. +the tabular environment (and its ``relations'') traps footnotes, and +they can't escape to the bottom of the page. As a result, you get +footnote marks in the table, and nothing else. This accords with common typographic advice: footnotes and tables are reckoned not to mix. @@ -2288,7 +2288,8 @@ advice, you can: the text once you've closed the \environment{tabular} environment. This is described in Lamport's book, but it gets messy if there's more than one footnote. -\item Stick the table in a \environment{minipage}. Footnotes in the +\item Stick the \environment{tabular} environment in a + \environment{minipage}. Footnotes in the table then ``work'', in the \environment{minipage}'s style, with no extra effort. (This is, in effect, somewhat like table notes, but the typeset appearance isn't designed for the job.) @@ -2301,9 +2302,9 @@ advice, you can: \item Use \Package{footnote}, which provides an \environment{savenotes} which collects all footnotes and emits them at the end of the environment; thus if you put your - \environment{tabular} environment inside the environment, the - footnotes will appear as needed. Alternatively, you may use - \cmdinvoke{makesavenoteenv}{tabular} in the preamble of your + \environment{tabular} environment inside a \environment{savenotes} + environment, the footnotes will appear as needed. Alternatively, + you may use \cmdinvoke{makesavenoteenv}{tabular} in the preamble of your document, and tables will all behave as if they were inside a \environment{savenotes} environment. \item Use \Package{mdwtab} from the same bundle; it will handle @@ -2325,7 +2326,7 @@ recommend any of them, believing that table notes are the way to go\dots{} \item[threeparttablex.sty]\CTANref{threeparttablex} \item[tabularx.sty]Distributed as part of \CTANref{2etools}[tabularx] \end{ctanrefs} -\LastEdit{2012-02-07} +\LastEdit{2013-03-11} \Question[Q-ftnsect]{Footnotes in \LaTeX{} section headings} @@ -3267,7 +3268,8 @@ Finally, for now, the \Package{gitinfo} package supports \Question[Q-make]{Makefiles for \LaTeX{} documents} -\LaTeX{} is a tricky beast for running \ProgName{make} on: the need to +\LaTeX{} documents are tricky beasts for building using +(\ProgName{Uni*x}) \ProgName{make} on: the need to instruct \LaTeX{} to run several times for essentially different reasons (for example, ``get the table of contents stable'', ``get the labels stable'', ``add the bibliography'', ``add the index'') is @@ -3275,7 +3277,7 @@ actually rather difficult to express in the `ordinary' sort of dependency graph that one constructs for \ProgName{make}. The \ProgName{latex-make} package offers help with this task (far more -sophisticated techniques than in the \acro{FAQ} building script); it +sophisticated techniques than in the script that builds these \acro{FAQ}s); it looks good, but reports of its use (other than by its author) are scarce. For a long time, the only \ProgName{make}-like package on \acro{CTAN} @@ -3286,25 +3288,29 @@ programs' input (parts of the \extension{aux} file, or the \extension{idx} file, respectively) has changed, and so on. \ProgName{Latexmk} is a fine solution (and was used in generating printable versions of these -\acro{FAQ}s for a long time); it has recently been upgraded and has +\acro{FAQ}s for some time); it has recently been upgraded and has many bells and whistles that allow it to operate as if it were a poor man's \WYSIWYG{} system. A recent strong contender is \ProgName{arara}, written in \ProgName{Java}. It is (the documentation says) based on ``rules'' and ``directives''; its aim is to determine what to do from explicit -instructions in its source code, rather than secondary sources such as -log file analysis. \ProgName{Arara} is relatively new on CTAN, and -comes with recommendations from many of the great and good of the -\latex{} world. +instructions in the document's source code, rather than secondary +sources such as log file analysis. \ProgName{Arara} is relatively new +on CTAN, and comes with recommendations from many of the great and +good of the \latex{} world. + +Newer still is the Python script \ProgName{try}, which has a similar +structure to \ProgName{arara}~--- it, too, reads instructions in the +document source. Apparently along the same lines, is Auto\LaTeX{}. The \File{README} of the distribution is actual a Unix-type man-page output, and shows great attention to the details of the document production process. -The \ProgName{mk} (also, apparently, known as \ProgName{latex_maker}) -is a Ruby script for the task in hand; it works well with another of -the author's scripts script called \ProgName{vpp} (View and Print +The (Ruby) script \ProgName{mk} (also, apparently, known as +\ProgName{latex_maker}) works well with another of the author's +scripts script called \ProgName{vpp} (View and Print \PS{}/\acro{PDF}). Windows users of the \miktex{} system may use that system's @@ -3335,8 +3341,10 @@ solution, but some of the tricks employed are surely re-usable. \item[latex\_make]\CTANref{latex_maker} \item[latexmk]\CTANref{latexmk} \item[texi2dvi]Distributed as part of \CTANref{texinfo} +\item[try]\CTANref{try} +\item[vpp]\CTANref{vpp} \end{ctanrefs} -\LastEdit{2013-02-08} +\LastEdit{2013-05-13} \Question[Q-howmanypp]{How many pages are there in my document?} |