summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/faq-docs.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/faq-docs.tex')
-rw-r--r--Master/texmf-dist/doc/generic/FAQ-en/faq-docs.tex91
1 files changed, 57 insertions, 34 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/faq-docs.tex b/Master/texmf-dist/doc/generic/FAQ-en/faq-docs.tex
index c569b151804..dbbdeb37c53 100644
--- a/Master/texmf-dist/doc/generic/FAQ-en/faq-docs.tex
+++ b/Master/texmf-dist/doc/generic/FAQ-en/faq-docs.tex
@@ -1,4 +1,4 @@
-% $Id: faq-docs.tex,v 1.44 2012/12/07 19:34:33 rf10 Exp rf10 $
+% $Id: faq-docs.tex,v 1.46 2014/03/04 15:42:45 rf10 Exp rf10 $
\section{Documentation and Help}
@@ -98,7 +98,10 @@ A collection of Knuth's publications about typography is also available:
2011, \ISBN*{1847199860}{978-1847199867})
\item[The \LaTeX{} Companion]by Frank Mittelbach, Michel Goossens,
Johannes Braams, David Carlisle and Chris Rowley (second edition,
- Addison-Wesley, 2004, \ISBN*{0-201-36299-6}{978-0-201-36299-2})
+ Addison-Wesley, 2004, \ISBN*{0-201-36299-6}{978-0-201-36299-2}); the
+ book as also available as a digital download (in \acro{EPUB},
+ \acro{MOBI} and \acro{PDF} formats) from
+ \url{http://www.informit.com/store/latex-companion-9780133387667}
\item[The \LaTeX{} Graphics Companion:]%
\emph{Illustrating documents with \TeX{} and \PS{}} by Michel
Goossens, Sebastian Rahtz, Frank Mittelbach, Denis Roegel and
@@ -115,10 +118,9 @@ A collection of Knuth's publications about typography is also available:
% by George Gr\"atzer (third edition Birkh\"auser and Springer Verlag,
% 2000, \ISBN{0-8176-4431-9}, \ISBN{3-7643-4131-9})
% \checked{RF}{2001/01/16}
-\item[More Math into \latex{}:]\emph{An Introduction to \LaTeX{} and
- \AMSLaTeX{}}by George Gr\"atzer (fourth edition Springer Verlag,
+\item[More Math into \latex{}:]\emph{An Introduction to} \LaTeX{}
+ \emph{and} \AMSLaTeX{} by George Gr\"atzer (fourth edition Springer Verlag,
2007, \ISBN{978-0-387-32289-6}
-\checked{RF}{2011-07-06}
%% gr\"atzer's home page
%% http://www.maths.umanitoba.ca/homepages/gratzer.html/LaTeXBooks.html
\item[Digital Typography Using \LaTeX{}]Incorporating some
@@ -160,7 +162,7 @@ Gr\"atzer's ``First Steps in \LaTeX{}'', are all available on
%\item[\nothtml{\rmfamily}Examples for \nothtml{\upshape}\TeX{} in Practice]\CTANref{tip}
\item[\nothtml{\rmfamily}Sample of \nothtml{\upshape}Math into \LaTeX{}]\CTANref{mil}
\end{ctanrefs}
-\LastEdit*{2011-09-09}
+\LastEdit{2014-03-14}
\Question[Q-other-books]{Books on other \tex{}-related matters}
@@ -277,11 +279,11 @@ Both the Francophone \TeX{} user group Gutenberg and the Czech/Slovak
user group CS-TUG have published translations of this \acro{FAQ}, with
extensions appropriate to their languages.
-Herbert Vo\ss {}'s excellent % beware line break
-\href{http://texnik.de/}{\LaTeX{} tips and tricks}
-provides excellent advice on most topics one might imagine (though
-it's not strictly a \acro{FAQ})~--- highly recommended for most
-ordinary mortals' use.
+% Herbert Vo\ss {}'s excellent % beware line break
+% \href{http://texnik.de/}{\LaTeX{} tips and tricks}
+% provides excellent advice on most topics one might imagine (though
+% it's not strictly a \acro{FAQ})~--- highly recommended for most
+% ordinary mortals' use.
The Open Directory Project (\acro{ODP}) maintains a list of sources of
\AllTeX{} help, including \acro{FAQ}s. View the \TeX{} area at
@@ -312,6 +314,7 @@ Resources available on \acro{CTAN} are:
\CTANref{TeX-FAQ}
\item[\nothtml{\rmfamily}The visual \acro{FAQ}]\CTANref{visualFAQ}
\end{ctanrefs}
+\LastEdit{2013-07-02}
\Question[Q-gethelp]{Getting help online}
@@ -383,11 +386,21 @@ mechanisms are:
which offers a variety of `categories' to place your query, and the
% the next line will tend to break if you add _anything_ to it!
\href{http://tex.stackexchange.com/}{\TeX{}, \LaTeX{} and friends Q\&A site}
- (``Stack exchange'').
+ (``StackExchange'').
- Stack exchange has a scheme for voting on the quality of answers (and
+ StackExchange has a scheme for voting on the quality of answers (and
hence of those who offer support). This arrangement is supposed to
enable you to rank any answers that are posted.
+
+ StackExchange offers
+ \href{http://meta.tex.stackexchange.com/questions/1436/welcome-to-tex-sx}{hints about ``good behaviour''},
+ which any user should at least scan before asking for help there.
+ (The hints' principal aim is to maximise the chance that you get useful
+ advice from the first answer; for example, it suggests that you supply a
+ \Qref*{minimal example of your problem}{Q-askquestion}, just as
+ these \acro{FAQ}s do. There are people on the site who can be abrasive
+ to those asking questions, who seem not to be following the
+ guidelines for good behaviour)
\end{enumerate}
Do \textbf{not} try mailing the \LaTeX{} project team, the maintainers
of the \texlive{} or \miktex{} distributions or the maintainers of
@@ -398,7 +411,7 @@ are a far better bet.
\begin{ctanrefs}
\item[texhax \nothtml{\rmfamily}`back copies']\CTANref{texhax}
\end{ctanrefs}
-\LastEdit{2011-05-27}
+\LastEdit{2014-01-28}
\Question[Q-maillists*]{Specialist mailing lists}
@@ -1142,12 +1155,12 @@ Geoffrey Tobin's \textit{\MF{} for Beginners} % !! line break
(see \Qref[question]{using \MF{}}{Q-useMF}) describes how the \MF{}
system works and how to avoid some of the potential pitfalls.
-There is also an article on how to run both \MF{} and \MP{} (the
-programs). Peter Wilson's % !! line break
-\textit{Some Experiences in Running \MF{} and \MP{}}
-offers the benefit of Peter's experience (he has designed a number of
-`historical' fonts using \MF{}). For \MF{} the article is geared
-towards testing and installing new \MF{} fonts, while its \MP{}
+Peter Wilson's experience of running both \MF{} and \MP{} (the
+programs), \textit{Some Experiences in Running \MF{} and \MP{}}
+(available on \ctan{}) offers the benefit of Peter's experience (he
+has designed a
+number of `historical' fonts using \MF{}). For \MF{} the article is
+geared towards testing and installing new \MF{} fonts, while its \MP{}
section describes how to use \MP{} illustrations in \LaTeX{} and
\PDFLaTeX{} documents, with an emphasis on how to use appropriate
fonts for any text or mathematics.
@@ -1157,17 +1170,23 @@ MetaFun (which admittedly concentrates on the use of \MP{} within
\CONTeXT{}). It may be found on his company's % ! line break
\href{http://www.pragma-ade.com/general/manuals/metafun-p.pdf}{`manuals' page}.
-Other \MP{} tutorials that have appeared are two in English by % ! line breaks
-\href{http://remote.science.uva.nl/~heck/Courses/mptut.pdf}{Andr\'e Heck}
-and \href{http://www.tlhiv.org/MetaPost/tutorial/}{Urs Oswald},
-and one in French (listed here because it's clearly enough written
-that even this author understands it), by
-\href{http://pauillac.inria.fr/~cheno/metapost/metapost.pdf}{Laurent Ch\'eno};
-both have been recommended for inclusion in the \acro{FAQ}
+Another \MP{} tutorial in English is: % ! line breaks
+\url{http://www.tlhiv.org/MetaPost/tutorial/} by Urs Oswald.
+One in French (listed here because it's clearly enough written
+that even this author understands it),
+\url{http://pauillac.inria.fr/~cheno/metapost/metapost.pdf}
+by Laurent Ch\'eno.
+
+Urs Oswald's tutorial uses Troy Henderson's tool
+(\URL{http://www.tlhiv.org/mppreview}) for testing little bits of
+\MP{}; it is an invaluable aid to the learner:
+\URL{http://www.tlhiv.org/mppreview}
-Urs Oswald's tutorial is accompanied by a super tool (by Troy
-Henderson) for testing little bits of \MP{}, which is an invaluable
-aid to the learner: \URL{http://www.tlhiv.org/mppreview}
+A three-part introduction, by Mari Voipio, was published in
+\href{http://tug.org/TUGboat/intromp/tb106voipio-grid.pdf}{\TUGboat34(1) (Entry-level \MP{}: On the grid)},
+\TUGboat34(2)
+\href{http://tug.org/TUGboat/intromp/tb107voipio-moveit.pdf}{(Entry-level \MP{}: Move it!\@)}, and
+\href{http://tug.org/TUGboat/intromp/tb108voipio-color.pdf}{\TUGboat34(2) (Entry-level \MP{}: Color)}.
Vincent Zoonekynd's massive set of example \MP{} files is available on
\acro{CTAN}; the set includes a \ProgName{Perl} script to convert the
@@ -1182,7 +1201,7 @@ written more as a document, and presented in \acro{PDF}.
\item[\nothtml{\rmfamily}Peter Wilson's ``experiences'']\CTANref{metafp-pdf}
\item[\nothtml{\rmfamily}Vincent Zoonekynd's examples]\CTANref{zoon-mp-eg}
\end{ctanrefs}
-\LastEdit{2011-11-21}
+\LastEdit{2014-02-18}
\Question[Q-BibTeXing]{\bibtex{} Documentation}
@@ -1196,6 +1215,9 @@ also has information on \bibtex{} and writing \bibtex{} style files.
(See \Qref[question]{\latex{} books}{Q-latex-books} for details of both
books.)
+The web site ``\href{http://www.bibtex.org}{Your \bibtex{} resource}''
+offers a solid introduction, but doesn't go into very great detail.
+
The document ``Designing \bibtex{} Styles'', also in the \bibtex{}
distribution (look for
\File{btxhak}), explains the postfix stack-based language used to
@@ -1205,15 +1227,16 @@ is the template for the four standard styles (\Package{plain},
\Package{abbrv}, \Package{alpha}, and \Package{unsrt}); it also
contains their documentation.
-A useful tutorial of the whole process of using \BibTeX{} is Nicolas
-Markey's ``\emph{Tame the BeaST (The B to X of \BibTeX{})}'', which
+A useful tutorial of the whole process of using \bibtex{} is Nicolas
+Markey's ``\emph{Tame the BeaST (The B to X of \bibtex{})}'', which
may also be found on \acro{CTAN}. A summary and \acro{FAQ} by Michael
Shell and David Hoadley, is also to be recommended.
\begin{ctanrefs}
-\item[\nothtml{\rmfamily}\BibTeX{} distribution]\CTANref{bibtex}
+\item[\nothtml{\rmfamily}\bibtex{} distribution]\CTANref{bibtex}
\item[\nothtml{\rmfamily}Shell and Hoadley's FAQ]\CTANref{bibtex-faq}
\item[\nothtml{\rmfamily}Tame the BeaST]\CTANref{ttb-pdf}
\end{ctanrefs}
+\LastEdit{2013-10-15}
\Question[Q-symbols]{Where can I find the symbol for\,\dots{}}
\keywords{assignment circular integral degrees diagonal dots Fourier transform}