diff options
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.tex | 91 |
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} |