summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/faq-how-do-i.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-06-28 22:26:18 +0000
committerKarl Berry <karl@freefriends.org>2013-06-28 22:26:18 +0000
commit98d97883f83dd86032b6b058692d87b9fa83926b (patch)
tree8de3c144ec825fc9cc4b1fe255b60875a8b9e1bb /Master/texmf-dist/doc/generic/FAQ-en/faq-how-do-i.tex
parentaa0b340189383ff3014db4eaec3aeb58687d6207 (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.tex46
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?}