docsurvey (24jan18)

git-svn-id: svn://tug.org/texlive/trunk@46430 c570f23f-e606-0410-a88d-b1316a301751

3 files changed, 100 insertions, 53 deletions

diff --git a/Master/texmf-dist/doc/latex/docsurvey/README.txt b/Master/texmf-dist/doc/latex/docsurvey/README.txt
index ffe7a95d535..f2baa1aad18 100644
--- a/Master/texmf-dist/doc/latex/docsurvey/README.txt
+++ b/Master/texmf-dist/doc/latex/docsurvey/README.txt
@@ -4,7 +4,7 @@ The LaTeX docsurvey package
 Provides the document
 "Programming LaTeX — A survey of documentation and packages"
 
-January 18, 2018
+January 21, 2018
 Copyright 2017-2018 Brian Dunn — www.BDTechConcepts.com
 
 LaTeX Project Public License, version 1.3
diff --git a/Master/texmf-dist/doc/latex/docsurvey/docsurvey.pdf b/Master/texmf-dist/doc/latex/docsurvey/docsurvey.pdf
index 37bbaffec5d..2bc5ec91868 100644
--- a/Master/texmf-dist/doc/latex/docsurvey/docsurvey.pdf
+++ b/Master/texmf-dist/doc/latex/docsurvey/docsurvey.pdf
diff --git a/Master/texmf-dist/doc/latex/docsurvey/docsurvey.tex b/Master/texmf-dist/doc/latex/docsurvey/docsurvey.tex
index a54d5ba994b..5f40aa35595 100644
--- a/Master/texmf-dist/doc/latex/docsurvey/docsurvey.tex
+++ b/Master/texmf-dist/doc/latex/docsurvey/docsurvey.tex
@@ -268,6 +268,7 @@
 % \def\XSLFO{\acro{XSL}\raise.08ex\hbox{-}\acro{FO}}
 % \def\XSLT{\acro{XSLT}}
 
+\newcommand{\pub}[1]{\textit{#1}}
 
 \newcommand{\acro}[1]{\textsc{\MakeLowercase{#1}}}
 
@@ -367,7 +368,7 @@ Reinventing the wheel may be useful if you think that you can do it better.
 Worse, though, is not even being aware that the wheel has already been
 invented in the first place, which can be an embarrassing waste of time.
 Such can be the case both for a new \LaTeX\ programmer who isn't aware of
-the many ways things may be done, but also for someone, the author included,
+the many ways things may be done, but also for someone, this author included,
 who learned \LaTeX\ many years ago but may have missed some of the recent
 advancements in package code and documentation.
 
@@ -431,6 +432,22 @@ program.
 \subsection{\LaTeX}
 
 \begin{description}
+\item[Getting something out of \LaTeX:]
+    Create your first document in \LaTeX.~\cite{hefferon:first}
+    \hfill \url{https://ctan.org/pkg/first-latex-doc}
+
+\item[The very short guide to typesetting with \LaTeX:]
+    A four-page introduction.~\cite{flynn:veryshort}
+    \hfill \url{https://ctan.org/pkg/latex-veryshortguide}
+
+\item[Formatting Information:]
+    A beginner’s introduction to typesetting with \LaTeX.~\cite{flynn:formatting}
+    \hfill \url{https://ctan.org/pkg/beginlatex}
+
+\item[Writing Scientific Documents Using \LaTeX:]
+    An introduction to typesetting scientific documents.~\cite{Bennieston:scientific} \\
+    \hspace*{\fill} \url{https://ctan.org/pkg/intro-scientific}
+
 \item[The Not So Short Introduction to \LaTeXe:]
 	Covers introductory material, customizations,
 	and a simple package.~\cite{oetiker:introduction}
@@ -444,6 +461,11 @@ program.
 \item[LaTeX WikiBook:] An online book, includes information about
 	creating \LaTeX\ packages and classes. \\
 	\hspace*{\fill} \url{https://en.wikibooks.org/wiki/LaTeX}
+
+\item[Initiation à LATEX:] A French guide on \LaTeX — for beginners
+    or advanced users.~\cite{bouzigues:guide} \\
+    \hspace*{\fill} \url{https://ctan.org/pkg/guide-latex-fr}
+
 \end{description}
 
 \subsection{Lua\LaTeX}
@@ -472,8 +494,7 @@ These are lists of the \LaTeX\ commands which produce symbols.
 More than 14,000 symbols and \LaTeX\ commands.~\cite{pakin:list} \\
 \texdoc{symbols-letter} \\ \texdoc{symbols-a4}
 
-\item[Every symbol (most symbols) defined\\\hspace*{-\leftmargin}by
-unicode-math:]
+\item[Every symbol (most symbols) defined by unicode-math:]
 Unicode math symbols.~\cite{robertson:mathsymbols}
 \texdoc{unimath-symbols}
 \end{description}
@@ -672,10 +693,10 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
 \begin{description}[style=unboxed]
 \raggedright
 \item[TeX\Dash \LaTeX\ Stack Exchange:] 
-    \url{http://tex.stackexchange.com/} \\
+    \url{http://tex.stackexchange.com} \\
     Almost any question has already
 	been asked, and a quick web search will find answers, ranked by vote.
-\item[\LaTeX\ Community:]   \url{http://www.latex-community.org/} \\
+\item[\LaTeX\ Community:]   \url{http://www.latex-community.org} \\
     A traditional forum with quick replies
 	to your questions
 \end{description}
@@ -683,7 +704,7 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
 \item[German forums:] \
 \begin{description}[style=unboxed]
 \item[TeXwelt:] \url{http://texwelt.de/wissen/}
-\item[goLaTeX:] \url{http://golatex.de/}
+\item[goLaTeX:] \url{http://golatex.de}
 \end{description}
 
 \item[Mailing lists:] \url{http://tug.org/mailman/listinfo} \\
@@ -694,8 +715,8 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
 
 \section{Distributions \Dash \LaTeX\ for various operating systems}
 \begin{description}[style=unboxed]
-\item[TeXLive:] \url{http://tug.org/texlive/} \hfill Unix and Windows
-\item[MiKTex:] \url{https://miktex.org/}  \hfill Windows and Mac
+\item[TeXLive:] \url{http://tug.org/texlive} \hfill Unix and Windows
+\item[MiKTex:] \url{https://miktex.org}  \hfill Windows and Mac
 \item[proTeXt:] \url{http://tug.org/protext/}  \hfill Windows
 \item[MacTex:] \url{http://tug.org/mactex/} \hfill Mac
 \end{description}
@@ -710,140 +731,166 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
     Organization and formatting improvements.
 \item[2017/10/14:] More information about accessing embedded documentation.
 \item[2018/01/18:] Added \url{texdoc.net}.
+\item[2018/01/21:] Added \pkg{la­tex-veryshort­guide}, \pkg{first-latex-doc},
+                    \pkg{beginlatex},
+                    \pkg{intro-scientific}, \pkg{guide-latex-fr}.
 \end{description}
 
 
 \begin{thebibliography}{99}
 
 \bibitem{lamport:latex}
-\LaTeX: A Document Preparation System,
+\pub{\LaTeX: A Document Preparation System},
 Leslie Lamport,
 second edition, Addison Wesley, 1994, ISBN 0201529831.
 
 \bibitem{hokpkadaly:guide}
-Guide to \LaTeX,
+\pub{Guide to \LaTeX},
 Helmut Kopka and Patrick W. Daly,
 fourth edition, Addison-Wesley, 2004, ISBN 0321173856.
 
 \bibitem{gratzer:moremath}
-More Math Into \LaTeX,
+\pub{More Math Into \LaTeX},
 George Gr\"{a}tzer,
 5th ed., Springer, 2016,
 ISBN 3319237950.
 %ISBN-13: 978-3319237954.
 
 \bibitem{kottwitz:beginner}
-\LaTeX\ Beginner's Guide,
+\pub{\LaTeX\ Beginner's Guide},
 Stefan Kottwitz,
 Packt Publishing, 2011, ISBN 1847199860.
 %ISBN-13 1847199860.
 
 \bibitem{kottwitz:cookbook}
-\LaTeX\ Cookbook, Stefan Kottwitz, Packt Publishing, 2015,
+\pub{\LaTeX\ Cookbook}, Stefan Kottwitz, Packt Publishing, 2015,
 ISBN-13 9781784395148, \\
-\url{http://latex-cookbook.net/}
+\url{http://latex-cookbook.net}
 
 \bibitem{mittelbachgossens:companion}
-The \LaTeX\ Companion,
+\pub{The \LaTeX\ Companion},
 Frank Mittelbach, Michel Goossens, Johannes Braams,
 David Carlisle and Chris Rowley,
 second edition, Addison-Wesley, 2004,
 ISBN 0201362996.
 %ISBN-13 0-201-36299-6.
 
+\bibitem{eijkhout:topic}
+\pub{\TeX\ by Topic}, A \TeX{}nician's Reference,
+Victor Eijkhout,
+Addison-Wesley UK, 1991, ISBN 0201568829,
+\url{http://eijkhout.net/texbytopic/texbytopic.html}
+
+\bibitem{hefferon:first}
+\pub{Getting something out of \LaTeX},
+Jim Hefferon, 2009.  \url{https://ctan.org/pkg/first-latex-doc}
+
+\bibitem{flynn:veryshort}
+\pub{The very short guide to typesetting with \LaTeX},
+Peter Flynn, 2016. \\
+\url{https://ctan.org/pkg/latex-veryshortguide}
+
+\bibitem{flynn:formatting}
+\pub{Formatting Information}, A beginner’s introduction to
+typesetting with \LaTeX, Peter Flynn, 2005. \\
+\url{https://ctan.org/pkg/beginlatex}
+
+\bibitem{Bennieston:scientific}
+\pub{Writing Scientific Documents Using \LaTeX},
+Andrew J. Bennieston, 2009. \\
+\url{https://ctan.org/pkg/intro-scientific}
+
 \bibitem{oetiker:introduction}
-The Not So Short Introduction to \LaTeXe,
-Tobias Oetiker,
-\url{https://ctan.org/pkg/lshort}
+\pub{The Not So Short Introduction to \LaTeXe},
+Tobias Oetiker, 2015. \url{https://ctan.org/pkg/lshort}
 
 \bibitem{greenwade:reference}
-\LaTeXe: An unofficial reference manual,
+\pub{\LaTeXe: An unofficial reference manual},
 George~D. Greenwade, Stephen Gilmore,
-Torsten~Martinsen, and Karl Berry,
+Torsten~Martinsen, and Karl Berry.
 \url{http://home.gna.org/latexrefman}
 
-\bibitem{eijkhout:topic}
-\TeX\ by Topic, A \TeX{}nician's Reference,
-Victor Eijkhout,
-Addison-Wesley UK, 1991, ISBN 0201568829,
-\url{http://eijkhout.net/texbytopic/texbytopic.html}
+\bibitem{bouzigues:guide}
+\pub{Initiation à \LaTeX}, Pour débutants ou jeunes utilisateurs,
+Adrien Bouzigues, 2017. \\
+\url{https://ctan.org/pkg/guide-latex-fr}.
 
 \bibitem{pakin:list}
-The Comprehensive \LaTeX\ Symbol List,
-Scott Pakin,
+\pub{The Comprehensive \LaTeX\ Symbol List},
+Scott Pakin, 2017.
 \url{https://ctan.org/pkg/comprehensive}
 
 \bibitem{robertson:mathsymbols}
-Every symbol (most symbols) defined by unicode-math,
-Will Robertson, \\
+\pub{Every symbol (most symbols) defined by unicode-math},
+Will Robertson, 2018. \\
 \url{https://ctan.org/pkg/unicode-math}
 
+\bibitem{latexteam:sources}
+\pub{The \LaTeXe\ Sources},
+Johannes Braams, David Carlisle, Alan Jeffrey, Leslie Lamport,
+Frank Mittelbach, Chris Rowley, and Rainer Sch\"opf,
+\url{https://ctan.org/pkg/source2e}
+
+\bibitem{scharrer:listinternal}
+\pub{List of internal \LaTeXe\ Macros useful to Package Authors},
+Martin Scharrer, \\
+\url{https://ctan.org/pkg/macros2e}
+
 \bibitem{UK:FAQ}
 UK TUG FAQ,
 UK \TeX\ Users Group, 
-\url{http://www.tex.ac.uk/}
+\url{http://www.tex.ac.uk}
 
 \bibitem{pakin:visual}
-The Visual \LaTeX\ FAQ,
+\pub{The Visual \LaTeX\ FAQ},
 Scott Pakin, 
 \url{https://ctan.org/pkg/visualfaq}
 
 \bibitem{texdocnet}
 TeXdoc Online, 
-\url{http://texdoc.net/}
-
-\bibitem{latexteam:sources}
-The \LaTeXe\ Sources,
-Johannes Braams, David Carlisle, Alan Jeffrey, Leslie Lamport,
-Frank Mittelbach, Chris Rowley, and Rainer Sch\"opf,
-\url{https://ctan.org/pkg/source2e}
-
-\bibitem{scharrer:listinternal}
-List of internal \LaTeXe\ Macros useful to Package Authors,
-Martin Scharrer, \\
-\url{https://ctan.org/pkg/macros2e}
+\url{http://texdoc.net}
 
 \bibitem{ctan}
 Comprehensive \TeX\ Archive Network (CTAN),
 \url{https://ctan.org}
 
 \bibitem{pakin:dtxtut}
-How to Package Your \LaTeX\ Package,
+\pub{How to Package Your \LaTeX\ Package},
 Scott~Pakin,
 \url{https://ctan.org/pkg/dtxtut}
 
 \bibitem{latexteam:class}
-\LaTeXe\ for class and package writers,
+\pub{\LaTeXe\ for class and package writers},
 \LaTeX3 Project,
 \url{https://ctan.org/pkg/clsguide}
 
 \bibitem{mittelbach:doc}
-The doc and shortvrb packages,
+\pub{The doc and shortvrb packages},
 Frank Mittelbach,
 \url{https://ctan.org/pkg/doc}
 
 \bibitem{mittelbach:docstrip}
-The DocStrip program,
+\pub{The DocStrip program},
 Frank Mittelbach, Denys Duchier, Johannes Braams,
 Marcin Woli\'nski, and Mark Wooding,
 \url{https://ctan.org/pkg/docstrip}
 
 \bibitem{flynn:article}
-Rolling your own Document Class:
-Using \LaTeX\ to keep away from the Dark Side,
+\pub{Rolling your own Document Class:
+Using \LaTeX\ to keep away from the Dark Side},
 Peter~Flynn,
 \TUB\ 28:1 (2007), pp.\,110--123,
 \url{http://tug.org/TUGboat/tb28-1/tb88flynn.pdf}
 
 \bibitem{pakin:goodthings}
-Good things come in little packages:
-An introduction to writing \texttt{.ins} and \texttt{.dtx} files,
+\pub{Good things come in little packages:
+An introduction to writing \texttt{.ins} and \texttt{.dtx} files},
 Scott~Pakin,
 \TUB\ 29:2 (2008), pp.\,305--314,
 \url{http://tug.org/TUGboat/tb29-2/tb92pakin.pdf}
 
 \bibitem{mansfield:class}
-How to develop your own document class\Dash our experience,
+\pub{How to develop your own document class\Dash our experience},
 Niall Mansfield,
 \TUB\ 29:3 (2008), pp.\,356--361.
 \url{http://tug.org/TUGboat/tb29-3/tb93mansfield.pdf}