docsurvey (14dec20)

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

3 files changed, 671 insertions, 277 deletions

diff --git a/Master/texmf-dist/doc/latex/docsurvey/README.txt b/Master/texmf-dist/doc/latex/docsurvey/README.txt
index 085730577fe..035ee112e7e 100644
--- a/Master/texmf-dist/doc/latex/docsurvey/README.txt
+++ b/Master/texmf-dist/doc/latex/docsurvey/README.txt
@@ -4,14 +4,15 @@ The LaTeX docsurvey package
 Provides the document
 "Programming LaTeX — A survey of documentation and packages"
 
-2018/10/18
-Copyright 2017-2018 Brian Dunn — www.BDTechConcepts.com
+2020/12/14
+Copyright 2017-2020 Brian Dunn — www.BDTechConcepts.com
 
 LaTeX Project Public License, version 1.3
 
 ---
 
-A survey of programming-related documentation for LaTeX.
+A survey of documentation for LaTeX.
+
 Included are references to printed and electronic books and manuals,
 symbol lists, FAQs, the LaTeX source code, CTAN and distributions,
 programming-related packages, users groups and online communities,
@@ -21,3 +22,15 @@ and information on creating packages and documentation.
 
 Files:
 README.txt, docsurvey.pdf, docsurvey.tex
+
+docsurvey.bib is generated when docsurvey.tex is compiled.
+
+---
+
+To compile the document:
+
+lualatex docsurvey.tex
+lualatex docsurvey.tex
+biber docsurvey
+lualatex docsurvey.tex
+lualatex docsurvey.tex
diff --git a/Master/texmf-dist/doc/latex/docsurvey/docsurvey.pdf b/Master/texmf-dist/doc/latex/docsurvey/docsurvey.pdf
index 97b146e8c19..7244da15c98 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 4b37f380b52..fb5a1e19951 100644
--- a/Master/texmf-dist/doc/latex/docsurvey/docsurvey.tex
+++ b/Master/texmf-dist/doc/latex/docsurvey/docsurvey.tex
@@ -1,8 +1,476 @@
 
+% To compile:
+% lualatex docsurvey.tex
+% lualatex docsurvey.tex
+% biber docsurvey
+% lualatex docsurvey.tex
+% lualatex docsurvey.tex
+
+\begin{filecontents}[overwrite]{docsurvey.bib}
+@book{lamport:latex,
+    title={\LaTeX: A Document Preparation System},
+    author={Leslie Lamport},
+    edition=2,
+    publisher={Addison Wesley},
+    year=1994,
+    isbn=0201529831,
+}
+
+@book{hokpkadaly:guide,
+    title={Guide to \LaTeX},
+    author={Helmut Kopka and Patrick W. Daly},
+    edition=4,
+    publisher={Addison-Wesley},
+    year=2004,
+    isbn=0321173856,
+}
+
+@book{gratzer:moremath,
+    title={More Math Into \LaTeX},
+    author={George Gr\"{a}tzer},
+    edition=5,
+    publisher={Springer},
+    year=2016,
+    isbn=9783319237954,
+}
+
+@book{kottwitz:beginner,
+    title={\LaTeX\ Beginner's Guide},
+    author={Stefan Kottwitz},
+    publisher={Packt Publishing},
+    year=2011,
+    isbn=1847199860,
+}
+
+@book{kottwitz:cookbook,
+    title={\LaTeX\ Cookbook},
+    author={Stefan Kottwitz},
+    publisher={Packt Publishing},
+    year=2015,
+    isbn=9781784395148,
+    url={http://latex-cookbook.net}
+}
+
+@book{mittelbachgossens:companion,
+    title={The \LaTeX\ Companion},
+    author={Frank Mittelbach and Michel Goossens and Johannes Braams
+        and David Carlisle and Chris Rowley},
+    edition=2,
+    publisher={Addison-Wesley},
+    year=2004,
+    isbn=0201362996,
+}
+
+@book{eijkhout:topic,
+    title={\TeX\ by Topic},
+    subtitle={A \TeX{}nician's Reference},
+    author={Victor Eijkhout},
+    publisher={Addison-Wesley UK},
+    year=1991,
+    isbn=0201568829,
+    url={http://eijkhout.net/texbytopic/texbytopic.html}
+}
+
+@manual{hefferon:first,
+    title={Getting something out of \LaTeX},
+    author={Jim Hefferon},
+    year=2009,
+    url={https://ctan.org/pkg/first-latex-doc}
+}
+
+@manual{flynn:veryshort,
+    title={The very short guide to typesetting with \LaTeX},
+    author={Peter Flynn},
+    year=2016,
+    url={https://ctan.org/pkg/latex-veryshortguide}
+}
+
+@manual{flynn:formatting,
+    title={Formatting Information, A beginner’s introduction to
+        typesetting with \LaTeX},
+    author={Peter Flynn},
+    year=2005,
+    url={https://ctan.org/pkg/beginlatex}
+}
+
+@manual{talbot:novices,
+    title={\LaTeX\ for Complete Novices},
+    author={Nicola L. C. Talbot},
+    year=2012,
+    publisher={Dickimaw Books},
+    url={http://www.dickimaw-books.com}
+}
+
+@manual{talbot:phd,
+    title={Using \LaTeX\ to Write a PhD Thesis},
+    author={Nicola L. C. Talbot},
+    year=2013,
+    publisher={Dickimaw Books},
+    url={http://www.dickimaw-books.com}
+}
+
+@manual{morris:gettingstarted,
+    title={Getting Started with \LaTeXe},
+    author={Michael P. Morris},
+    year=2020,
+    url={https://ctan.org/pkg/startlatex2e}
+}
+
+@manual{Bennieston:scientific,
+    title={Writing Scientific Documents Using \LaTeX},
+    author={Andrew J. Bennieston},
+    year=2009,
+    url={https://ctan.org/pkg/intro-scientific}
+}
+
+@manual{oetiker:introduction,
+    title={The Not So Short Introduction to \LaTeXe},
+    author={Tobias Oetiker},
+    year=2015,
+    url={https://ctan.org/pkg/lshort}
+}
+
+@manual{greenwade:reference,
+    title={\LaTeXe: An unofficial reference manual},
+    author={George~D. Greenwade and Stephen Gilmore and Torsten~Martinsen and Karl Berry},
+    url={https://latexref.xyz}
+}
+
+@manual{latex:authors,
+    title={\LaTeXe\ for authors},
+    author={\LaTeX3 Project Team},
+    year=2020,
+    url={https://ctan.org/pkg/usrguide}
+}
+
+@manual{downes:shortmath,
+    title={Short Math Guide for \LaTeX},
+    author={Michael Downes and Barbara Beeton},
+    year=2017,
+    url={https://ctan.org/pkg/short-math-guide}
+}
+
+@article{voss:farbige,
+    title={Farbige Mathematik},
+    journaltitle={TeXnische Komödie},
+    author={Herbert Voß},
+    year=2004,
+    url={https://ctan.org/pkg/voss-mathcol}
+}
+
+@manual{Gonzato:musicians,
+    title={\LaTeX\ for Musicians},
+    author={Guido Gonzato},
+    year=2019,
+    url={https://ctan.org/pkg/latex4musicians}
+}
+
+@manual{pakin:list,
+    title={The Comprehensive \LaTeX\ Symbol List},
+    author={Scott Pakin},
+    year=2017,
+    url={https://ctan.org/pkg/comprehensive}
+}
+
+@manual{robertson:mathsymbols,
+    title={Every symbol (most symbols) defined by unicode-math},
+    author={Will Robertson},
+    year=2018,
+    url={https://ctan.org/pkg/unicode-math}
+}
+
+@manual{latexteam:sources,
+    title={The \LaTeXe\ Sources},
+    author={Johannes Braams and David Carlisle and Alan Jeffrey and Leslie Lamport and
+        Frank Mittelbach and Chris Rowley and Rainer Sch\"opf},
+    url={https://ctan.org/pkg/source2e}
+}
+
+@manual{scharrer:listinternal,
+    title={List of internal \LaTeXe\ Macros useful to Package Authors},
+    author={Martin Scharrer},
+    url={https://ctan.org/pkg/macros2e}
+}
+
+@online{TeX:FAQ,
+    title={\TeX\ FAQ},
+    url={https://texfaq.org/}
+}
+
+@manual{pakin:visual,
+    title={The Visual \LaTeX\ FAQ},
+    author={Scott Pakin},
+    url={https://ctan.org/pkg/visualfaq}
+}
+
+@manual{bouzigues:guide,
+    title={Initiation à \LaTeX},
+    subtitle={Pour débutants ou jeunes utilisateurs},
+    author={Adrien Bouzigues},
+    year=2017,
+    url={https://ctan.org/pkg/guide-latex-fr}
+}
+
+@manual{Goulet:Redaction,
+    title={Rédaction avec \LaTeX},
+    author={Vincent Goulet},
+    year=2020,
+    url={https://ctan.org/pkg/formation-latex-ul}
+}
+
+@manual{Holkar:polyglossia,
+    title={A practical guide to \LaTeX\ and polyglossia for Indian Languages},
+    author={Rohit Dilip Holkar},
+    year=2017,
+    url={https://ctan.org/pkg/latex-mr}
+}
+
+@manual{massago:exemplos,
+    title={\LaTeXe\ Via Exemplos},
+    author={Sadao Massago},
+    year=2018,
+    url={https://ctan.org/pkg/latex-via-exemplos}
+}
+
+@online{latexwikibook,
+    title={Wikibooks},
+    subtitle={LaTeX},
+    url={https://en.wikibooks.org/wiki/LaTeX}
+}
+
+@online{ebookfoundation:free,
+    title={Free Programming Books},
+    author={Ebook Foundation},
+    url={https://github.com/EbookFoundation/free-programming-books}
+}
+
+@book{wilson:design,
+    title={A Few Notes on Book Design},
+    author={Peter Wilson},
+    year=2009,
+    month=8,
+    publisher={The Herries Press},
+    edition=1,
+    url={https://ctan.org/pkg/memdesign}
+}
+
+@manual{kohm:typearea,
+    title={KOMA-Script — The Guide},
+    author={Markus Kohm},
+    year=2018,
+    url={https://ctan.org/pkg/koma-script}
+}
+
+@manual{tufte:book,
+    title={A TUFTE-STYLE BOOK},
+    author={The Tufte-LaTeX Developers},
+    year=2015,
+    url={https://ctan.org/pkg/tufte-latex}
+}
+
+@article{revets:octavo,
+    title={The Octavo Package},
+    author={Stefan A. Revets},
+    journaltitle={TUGboat},
+    number={23 3/4},
+    year=2002,
+    pages={269},
+    url={https://ctan.org/pkg/octavo}
+}
+
+@manual{beccari:canoniclayout,
+    title={Package canoniclayout},
+    author={Claudio Beccari},
+    year=2011,
+    url={https://ctan.org/pkg/canoniclayout}
+}
+
+@manual{fear:booktabs,
+    title={Publication-quality tables in \LaTeX},
+    author={Simon Fear},
+    year=2016,
+    url={https://ctan.org/pkg/booktabs}
+}
+
+@manual{tantu:pgf,
+    title={The TikZ and PGF Packages},
+    author={Till Tantau},
+    year=2020,
+    url={https://ctan.org/pkg/pgf}
+}
+
+@online{texdocnet,
+    title={TeXdoc Online},
+    url={http://texdoc.net}
+}
+
+@online{ctan,
+    title={Comprehensive \TeX\ Archive Network},
+    shorttitle={CTAN},
+    url={https://ctan.org}
+}
+
+@manual{hefferon:firstset,
+    title={A First Set of \LaTeX\ Packages},
+    author={Jim Hefferon},
+    year=2020,
+    url={https://ctan.org/pkg/first-packages}
+}
+
+@manual{pakin:dtxtut,
+    title={How to Package Your \LaTeX\ Package},
+    author={Scott Pakin},
+    url={https://ctan.org/pkg/dtxtut}
+}
+
+@manual{latexteam:class,
+    title={\LaTeXe\ for class and package writers},
+    author={\LaTeX3 Project},
+    url={https://ctan.org/pkg/clsguide}
+}
+
+@manual{mittelbach:doc,
+    title={The doc and shortvrb packages},
+    author={Frank Mittelbach},
+    url={https://ctan.org/pkg/doc}
+}
+
+@manual{mittelbach:docstrip,
+    title={The DocStrip program},
+    author={Frank Mittelbach and Denys Duchier and Johannes Braams and
+        Marcin Woli\'nski and Mark Wooding},
+    url={https://ctan.org/pkg/docstrip}
+}
+
+@article{flynn:article,
+    title={Rolling your own Document Class:
+        Using \LaTeX\ to keep away from the Dark Side},
+    author={Peter Flynn},
+    journaltitle={TUGboat},
+    number={28:1},
+    year=2007,
+    pages={110--123},
+    url={http://tug.org/TUGboat/tb28-1/tb88flynn.pdf}
+}
+
+@article{pakin:goodthings,
+    title={Good things come in little packages:
+        An introduction to writing \texttt{.ins} and \texttt{.dtx} files},
+    author={Scott~Pakin},
+    journaltitle={TUGboat},
+    number={29:2},
+    year=2008,
+    pages={305--314},
+    url={http://tug.org/TUGboat/tb29-2/tb92pakin.pdf}
+}
+
+@article{mansfield:class,
+    title={How to develop your own document class\Dash our experience},
+    author={Niall Mansfield},
+    journaltitle={TUGboat},
+    number={29:3},
+    year=2008,
+    pages={356--361},
+    url={http://tug.org/TUGboat/tb29-3/tb93mansfield.pdf}
+}
+
+@online{gutenberg:TeXniques,
+    title={TeXniques},
+    subtitle={Groupe francophone des Utilisateurs de TEX, \LaTeX\ et logiciels compagnons},
+    url={https://www.gutenberg.eu.org/TeXniques}
+}
+
+@book{lozano:everythingLaTeX,
+    title={Tout Ce Que Vous Avez Toujours Voulu Savoir Sur \LaTeX\ Sans Jamais Oser Le Demander},
+    author={Vincent Lozano},
+    year=2011,
+    url={http://lozzone.free.fr/index.php?vlunch=latex}
+}
+
+@book{baudoin:learnLaTeX,
+    title={Apprends \LaTeX!},
+    author={Marc Baudoin},
+    year=2012,
+    url={http://www.babafou.eu.org/Apprends_LaTeX}
+}
+
+@manual{amsmath,
+    title={User’s Guide for the amsmath Package},
+    author={{American Mathematical Society} and {\LaTeX3 project}},
+    year=2020,
+    url={https://ctan.org/pkg/amsmath}
+}
+
+@manual{amsmath-it,
+    title={Manuale utente per il pacchetto amsmath},
+    author={{American Mathematical Society} and {\LaTeX3 project}},
+    translator={
+        Giulio Agostini and Giuseppe Bilotta and Flavio Casadei Della Chiesa and Onofrio
+        de Bari and Giacomo Delre and Luca Ferrante and Tommaso Pecorella and
+        Mileto Rigido and Roberto Zanasi
+    },
+    year=1999,
+    url={http://tug.ctan.org/tex-archive/info/italian/amsldoc/itamsldoc.pdf}
+}
+
+@manual{campani:tutorial,
+    title={Introdução ao Uso do Preparador de Documentos \LaTeX},
+    author={Carlos A. P. Campani},
+    year=2011,
+    url={https://ctan.org/pkg/cursolatex}
+}
+
+@manual{amsmath-vn,
+    title={{\setmainfont{Latin Modern Roman} \textit{Hướng dẫn sử dụng gói amsmath}}},
+    author={{American Mathematical Society} and {\LaTeX3 project}},
+    translator={Ky Anh},
+    year=1999,
+    url={https://ctan.org/pkg/amslatexdoc-vietnamese}
+}
+
+@manual{latex2e-japanese,
+    title={\LaTeX2e for authors},
+    author={\LaTeX3 Project Team},
+    translator={Yukitoshi FUJIMURA},
+    year=2015,
+    url={https://www.latex-project.org/help/documentation/usrguide_jpn.pdf}
+}
+
+@manual{amsmath-jp,
+    title={User’s Guide for the amsmath Package},
+    author={{American Mathematical Society} and {\LaTeX3 project}},
+    translator={Yukitoshi FUJIMURA},
+    year=2018,
+    url={https://www.latex-project.org/help/documentation/amsldoc_jpn.pdf}
+}
+
+@manual{shortmath-jp,
+    title={Short Math Guide for LaTeX},
+    author={Michael Downes and Barbara Beeton},
+    translator={Yukitoshi FUJIMURA},
+    year=2017,
+    url={https://www.latex-project.org/help/documentation/short-math-guide_jpn.pdf}
+}
+
+\end{filecontents}
+
+
+
+
 \documentclass{article}
 
 
 % \documentclass[twocolumn]{article}
+
+
+% \usepackage[T1]{fontenc} 
+% \usepackage[utf8]{inputenc}
+\usepackage{fontspec}
+% \setmonofont{Inconsolata}
+% \setmainfont{Erewhon}
+% \setsansfont{SourceSansPro}
+
+
 \usepackage{lmodern}
 \usepackage{erewhon}
 % \usepackage[type1,scaled=.95]{cabin} % sans serif like Gill Sans, full styles
@@ -10,15 +478,18 @@
 \usepackage[varqu,varl]{inconsolata} % typewriter
 % \renewcommand{\familydefault}{\sfdefault}
 
-\usepackage[T1]{fontenc} 
-\usepackage[utf8]{inputenc}
 
 \usepackage[bottom=1in]{geometry}
 
 \usepackage{graphicx}
 
+\usepackage{metalogox}
+
 \usepackage{needspace}
 
+\usepackage{biblatex}
+\addbibresource{docsurvey.bib}
+
 \usepackage[nottoc,numbib]{tocbibind}
 
 \setcounter{secnumdepth}{0}
@@ -302,6 +773,7 @@ Keywords={LaTeX, programming, documentation, BD Tech Concepts LLC}%
 
 \usepackage{enumitem}
 \setlist[description]{style=nextline,font=\small}
+\setlist[description]{style=nextline,font=\small,before={\raggedright}}
 
 \usepackage{multicol}
 
@@ -313,13 +785,12 @@ Keywords={LaTeX, programming, documentation, BD Tech Concepts LLC}%
 
 \newrobustcmd*{\pkg}[1]{\textsf{#1}}
 \newrobustcmd*{\prog}[1]{\texttt{#1}}
-\newrobustcmd*{\LuaLaTeX}{Lua\-\LaTeX}
-\newrobustcmd*{\LuaTeX}{Lua\-\TeX}
 \newrobustcmd*{\tag}[1]{\texttt{<#1>}}
 \newrobustcmd*{\prop}[1]{\textsl{\texttt{#1}}}
 \newrobustcmd*{\epub}{\acro{EPUB}}
 \newrobustcmd*{\texdoc}[1]{\hspace*{\fill}\mbox{(\texttt{texdoc #1})}}
 \newrobustcmd*{\hfurl}[1]{\hspace*{\fill}\mbox{(\url{#1})}}
+\newrobustcmd*{\hfciteurl}[1]{\hspace*{\fill}\mbox{(\citeurl{#1})}}
 \newrobustcmd*{\userentry}[1]{%
 \leavevmode\par\hspace*{2em}\texttt{#1}\smallskip\\}
 
@@ -339,7 +810,7 @@ Keywords={LaTeX, programming, documentation, BD Tech Concepts LLC}%
 
 \author{Brian Dunn \\
 	\small \href{mailto:bd@BDTechConcepts.com}{bd@BDTechConcepts.com} \\
-	\small Copyright 2017--2018 Brian Dunn\thanks{
+	\small Copyright 2017--2020 Brian Dunn\thanks{
 		This work may be distributed and/or modified under the
 		conditions of the \LaTeX\ Project Public License, either version 1.3
 		of this license or (at your option) any later version.
@@ -360,7 +831,7 @@ Keywords={LaTeX, programming, documentation, BD Tech Concepts LLC}%
 
 \begin{abstract}
 \noindent
-A survey of programming-related documentation for \LaTeX.
+A survey of documentation for \LaTeX.
 Included are references to printed and electronic books and manuals,
 symbol lists, \acro{FAQ}s, the \LaTeX\ source code, CTAN and distributions,
 programming-related packages, users groups and online communities,
@@ -395,6 +866,7 @@ on the screen.  Printed books also provide extended discussion of
 useful topics, have extensive human-edited indexes which are more useful
 than a simple document-wide search function, and some are also available in
 electronic format.
+
 \begin{description}
 \item[\LaTeX:\ A Document Preparation System:]
 	The classic introduction to \LaTeX, in continuous reprint for
@@ -414,7 +886,7 @@ electronic format.
 	of \LaTeX\ and numerous useful packages.
 	Second edition: 2004.~\cite{mittelbachgossens:companion}
 \item[Additional books:] Listed at the \TeX\ \acro{FAQ}.~\cite{TeX:FAQ}
-    \hfurl{https://texfaq.org/}
+    \hfciteurl{TeX:FAQ}
 \end{description}
 
 
@@ -428,7 +900,7 @@ program.
 \subsection{\TeX}
 
 \begin{description}
-\item[\TeX\ by Topic, A \TeX{}nician's Reference:]
+\item[\TeX\ by Topic, A \TeX nician's Reference:]
     A reference for \TeX.
     This may be useful for understanding the source code of \LaTeX\ packages,
     many of which are quite old and written in
@@ -441,15 +913,15 @@ program.
 \begin{description}
 \item[Getting something out of \LaTeX:]
     Create your first document in \LaTeX.~\cite{hefferon:first}
-    \hfurl{https://ctan.org/pkg/first-latex-doc}
+    \hfciteurl{hefferon:first}
 
 \item[The very short guide to typesetting with \LaTeX:]
     A four-page introduction.~\cite{flynn:veryshort}
-    \hfurl{https://ctan.org/pkg/latex-veryshortguide}
+    \hfciteurl{flynn:veryshort}
 
 \item[Formatting Information:]
     A beginner’s introduction to typesetting with \LaTeX.~\cite{flynn:formatting}
-    \hfurl{https://ctan.org/pkg/beginlatex}
+    \hfciteurl{flynn:formatting}
 
 \item[\LaTeX\ for Complete Novices:]
     An extensive introduction for a non-technical person.~\cite{talbot:novices}
@@ -460,24 +932,35 @@ program.
     discussion about bibliographies, indexes, and glossaries.~\cite{talbot:phd}
     \texdoc{dickimaw-thesis}
 
+\item[Getting Started with \LaTeXe:]
+    A beginner's bare-bones overview.~\cite{morris:gettingstarted}
+    \texdoc{startlatex2e}
+
 \item[Writing Scientific Documents Using \LaTeX:]
-    An introduction to typesetting scientific documents.~\cite{Bennieston:scientific} \\
-    \hfurl{https://ctan.org/pkg/intro-scientific}
+    An introduction to typesetting scientific documents.~\cite{Bennieston:scientific}
+    \newline
+    \hfciteurl{Bennieston:scientific}
 
 \item[The Not So Short Introduction to \LaTeXe:]
 	Covers introductory material, customizations,
 	and a simple package.  Available in many languages~\cite{oetiker:introduction}
-	\texdoc{-l lshort} \hfurl{https://ctan.org/pkg/lshort}
+	\texdoc{-l lshort}
+    \hfciteurl{oetiker:introduction}
 
 \item[\LaTeXe: An unofficial reference manual:]
 	A thorough but concise reference manual for \LaTeXe,
-	available in several languages.~\cite{greenwade:reference} \\
-	\texdoc{-l latex2e-help} \\
-    \hfurl{https://latexref.xyz}
+	available in several languages.~\cite{greenwade:reference}
+	\texdoc{-l latex2e-help}
+    \hfciteurl{greenwade:reference}
 
 \item[LaTeX WikiBook:] An online book, includes information about
-	creating \LaTeX\ packages and classes. \\
-	\hfurl{https://en.wikibooks.org/wiki/LaTeX}
+	creating \LaTeX\ packages and classes.~\cite{latexwikibook}
+    \hfciteurl{latexwikibook}
+
+\item[\LaTeXe\ for authors:]
+    An overview of the new features of \LaTeXe\ compared to \LaTeX 2.09.
+   ~\cite{latex:authors}
+    \texdoc{usrguide}
 \end{description}
 
 \subsection{Lua\LaTeX}
@@ -503,6 +986,37 @@ program.
     programming environment.    \texdoc{interface3}
 \end{description}
 
+
+\subsection{Math typesetting}
+\label{sec:math}
+
+\begin{description}
+\item [User’s Guide for the amsmath Package:]
+    How to use \pkg{amsmath}.~\cite{amsmath} \texdoc{amsmath} \\
+    Also see \nameref{sec:international} for the Italian, Japanese,
+    and Vietnamese translations.
+
+\item[Short Math Guide for \LaTeX:]
+    A summary of features in \LaTeX\ and packages for writing
+    math formulas.~\cite{downes:shortmath}
+    \texdoc{short-math-guide}
+
+\item[Farbige Mathematik:]
+    Math in color.  In German, but with easy-to-use examples.~\cite{voss:farbige}
+    \texdoc{voss-mathcol}
+\end{description}
+
+
+\subsection{Music typesetting}
+
+\begin{description}
+\item [\LaTeX\ for Musicians:]
+    Packages and programs for music symbols, lyrics, chord sheets, sheet music,
+    and guitar tablature.~\cite{Gonzato:musicians}
+    \texdoc{latex4musicians}
+\end{description}
+
+
 \subsection{Symbol references}
 
 These are lists of the \LaTeX\ commands which produce symbols.
@@ -510,7 +1024,7 @@ These are lists of the \LaTeX\ commands which produce symbols.
 \begin{description}
 \item[Comprehensive \LaTeX\ Symbol List:]
 More than 14,000 symbols and \LaTeX\ commands.~\cite{pakin:list}
-\texdoc{symbols-letter} \\ \texdoc{symbols-a4}
+\texdoc{symbols-letter} \texdoc{symbols-a4}
 
 \item[Every symbol (most symbols) defined by unicode-math:]
 Unicode math symbols.~\cite{robertson:mathsymbols}
@@ -526,8 +1040,7 @@ The source code for \LaTeXe\ itself is also included in the distribution.
 \item[The \LaTeXe\ sources:] Occasionally useful for figuring out how
     something really works.~\cite{latexteam:sources}
         \texdoc{source2e}
-\item[List of internal \LaTeXe\ macros
-      \\\hspace*{-\leftmargin}useful to package authors:]
+\item[List of internal \LaTeXe\ macros useful to package authors:]
     A list of the core \LaTeX\ macros, each of which is linked to the
     source code.~\cite{scharrer:listinternal}
     \texdoc{macros2e}
@@ -540,11 +1053,10 @@ The source code for \LaTeXe\ itself is also included in the distribution.
 %Frequently-Asked Questions
 
 \begin{description}
-\item[\TeX\ FAQ:] A wide-ranging list of
-fre\-quently-asked questions.
-(formerly the UK TUG FAQ)
-~\cite{TeX:FAQ} \\
-\texdoc{letterfaq} \\
+\item[\TeX\ FAQ:] A wide-ranging list of fre\-quently-asked questions.
+(Formerly the UK TUG FAQ.)
+~\cite{TeX:FAQ}
+\texdoc{letterfaq}
 \texdoc{newfaq}
 
 \item[Visual \LaTeX\ FAQ:] Click on a visual element to learn how
@@ -553,35 +1065,98 @@ it is programmed.~\cite{pakin:visual}
 \end{description}
 
 
-\subsection{Non-English}
-
-\begin{description}
-\item[Initiation à LATEX:] A French guide on \LaTeX — for beginners
-    or advanced users.~\cite{bouzigues:guide} \\
-    \hfurl{https://ctan.org/pkg/guide-latex-fr}
-
-\item[\LaTeXe\ Via Exemplos:] A study course
-in Brazilian Portuguese.~\cite{massago:exemplos}
-    \hfurl{https://ctan.org/pkg/latex-via-exemplos}
-
-\item[The Not So Short Introduction to \LaTeXe:]
-    Covers introductory material, customizations,
-    and a simple package.  Available in many languages~\cite{oetiker:introduction}
-    \texdoc{-l lshort} \hfurl{https://ctan.org/pkg/lshort}
+\subsection{International languages}
+\label{sec:international}
 
-\item[\LaTeXe: An unofficial reference manual:]
-    A thorough but concise reference manual for \LaTeXe,
-    available in several languages.~\cite{greenwade:reference} \\
-    \texdoc{-l latex2e-help} \\
-    \hfurl{https://latexref.xyz}
-
-\item [Ebook Foundation — Free Programming Books:] A variety
-of \TeX-related and other programming books and documents,
-in a number of languages.~\cite{ebookfoundation:free}
-\hfurl{https://github.com/EbookFoundation/free-programming-books}
+\begin{description}[style=standard]
+    \item [Multiple languages:] The following are available in several languages.
+    \begin{description}
+        \item[The Not So Short Introduction to \LaTeXe:]
+            Covers introductory material, customizations,
+            and a simple package.~\cite{oetiker:introduction}
+            \texdoc{-l lshort}
+            \hfciteurl{oetiker:introduction}
+
+        \item[\LaTeXe: An unofficial reference manual:]
+            A thorough but concise reference manual
+            for \LaTeXe.~\cite{greenwade:reference}
+            \texdoc{-l latex2e-help}
+            \hfciteurl{greenwade:reference}
+
+        \item [Ebook Foundation — Free Programming Books:] A variety
+        of \TeX-related and other programming books
+        and documents.~\cite{ebookfoundation:free}
+        \hfciteurl{ebookfoundation:free}
+    \end{description}
+    \item[Brazilian Portuguese:] \
+        \begin{description}
+        \item[\LaTeXe\ Via Exemplos:] A study course.~\cite{massago:exemplos}
+            \hfciteurl{massago:exemplos}
+        \end{description}
+    \item[French:] \
+        Also see \nameref{sec:online}.
+        \begin{description}
+        \item[TeXniques:]
+            A collection of resources.~\cite{gutenberg:TeXniques}
+            \hfciteurl{gutenberg:TeXniques}
+        \item[%
+            Tout Ce Que Vous Avez Toujours Voulu Savoir
+            Sur \LaTeX\ Sans Jamais Os Er Le Demander:%
+        ]
+            A book for beginners.~\cite{lozano:everythingLaTeX}
+            \hfciteurl{lozano:everythingLaTeX}
+        \item[Apprends \LaTeX!:] A full textbook written for
+            École Nationale Supérieure de Techniques Avancées.~\cite{baudoin:learnLaTeX}
+            \hfciteurl{baudoin:learnLaTeX}
+        \item[Initiation à LATEX:] A guide on \LaTeX\ — for beginners
+            or advanced users.~\cite{bouzigues:guide}
+            \hfciteurl{bouzigues:guide}
+        \item[Rédaction avec \LaTeX:]
+            An introductory course prepared for
+            Université Laval, Québec, Canada.~\cite{Goulet:Redaction}
+            \texdoc{formation-latex-ul}
+            \texdoc{formation-latex-ul-diapos}
+        \end{description}
+    \item[German:] \
+        See \nameref{sec:math}, \nameref{sec:groups}, and \nameref{sec:online}.
+    \item[Indian:] \
+        \begin{description}
+        \item [A practical guide to \LaTeX\ and polyglossia for Indian Languages:]
+            \LaTeX\ and \pkg{polyglossia} for Indian languages.~\cite{Holkar:polyglossia}
+            \texdoc{latex-mr}
+        \end{description}
+    \item[Italian:] \
+        \begin{description}
+        \item [Manuale utente per il pacchetto amsmath:] Manual for \pkg{amsmath}.
+            \cite{amsmath-it}
+            \texdoc{amsldoc-it}
+        \end{description}
+    \item[Japanese:] \
+        \begin{description}
+        \item [\LaTeX2e for authors:] \cite{latex2e-japanese}
+            \hfciteurl{latex2e-japanese}
+        \item [User’s Guide for the amsmath Package:] \cite{amsmath-jp}
+            \hfciteurl{amsmath-jp}
+        \item [Short Math Guide for LaTeX:] \cite{shortmath-jp}
+            \hfciteurl{shortmath-jp}
+        \end{description}
+    \item[Portuguese:] \
+        \begin{description}
+        \item [Introdução ao Uso do Preparador de Documentos \LaTeX:]
+            A tutorial as \acro{PDF} slides.~\cite{campani:tutorial}
+            \texdoc{cursolatex}
+        \end{description}
+    \item[Vietnamese:] \
+        \begin{description}
+        \item [%
+            {\setmainfont{Latin Modern Roman} \textbf{Hướng dẫn sử dụng gói}}
+            amsmath:%
+        ] Manual for \pkg{amsmath}.~\cite{amsmath-vn}
+            \texdoc{amsldoc-vn}
+        \end{description}
 \end{description}
 
-\subsection{General typeseting theory}
+\subsection{General typesetting theory}
 
 Discussion about general typesetting theory,
 presented by various \TeX-related authors.
@@ -630,7 +1205,7 @@ Enter ``\prog{texdoc -l <name>}'' to search for
 matching package, file, or program names.  In some cases the same document
 is available in both letter or A4 paper sizes, or in several languages.
 \prog{texdoc} is also available online~\cite{texdocnet},
-with popular packages sorted by category. \hfurl{texdoc.net}
+with popular packages sorted by category. \hfciteurl{texdocnet}
 
 \subsection{\prog{kpsewhich}}
 
@@ -693,7 +1268,17 @@ topics then shows you related packages.~\cite{ctan}
 
 
 \needspace{7\baselineskip}
-\section{Packages useful for programming \LaTeX}
+\section{Useful packages}
+
+\subsection{General use}
+
+\begin{description}
+\item [A First Set of \LaTeX\ Packages:]
+    A list of packages useful for beginners.~\cite{hefferon:firstset}
+    \texdoc{first-packages}
+\end{description}
+
+\subsection{Programming \LaTeX}
 
 A number of packages are especially useful for \LaTeX\ programmers:
 \texdoc{<packagename>}
@@ -766,25 +1351,29 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
 \end{description}
 
 \section{Users groups}
+\label{sec:groups}
 
 \begin{description}[style=unboxed]
 \item[\TeX\ Users Group:] \url{http://tug.org}
+\item[Dante:] German users group.  \url{https://www.dante.de}
 \item[List of international users groups:] \url{http://tug.org/usergroups.html}
 \end{description}
 
 \section{Online communities}
+\label{sec:online}
 
 \begin{description}[style=unboxed]
 \item[English forums:] \
 \begin{description}[style=unboxed]
 \raggedright
 \item[TeX\Dash \LaTeX\ Stack Exchange:] 
-    \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} \\
+    \url{http://tex.stackexchange.com}
+\item[\LaTeX\ Community:]
     A traditional forum with quick replies
 	to your questions
+    \url{http://www.latex-community.org}
 \end{description}
 
 \item[German forums:] \
@@ -798,8 +1387,10 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
 \item[TeXnique.fr:] \url{http://texnique.fr}
 \end{description}
 
-\item[Mailing lists:] \url{http://tug.org/mailman/listinfo} \\
+\item[Mailing lists:]
     Several dozen, spanning a wide range of \TeX-related topics.
+    \url{http://tug.org/mailman/listinfo}
+
 \item[Newsgroup:] \url{comp.text.tex}
 \end{description}
 
@@ -831,225 +1422,15 @@ Using \LaTeX\ to keep away from the Dark Side:] An overview of the
     Updated host and name for \TeX\ \acro{FAQ}.  Added \pkg{latex-via-exemplos} and
     Ebook Foundation free programming books.
 \item[2018/10/18:] Updated \acro{URL} for \pub{\LaTeXe: An unofficial reference manual}.
+\item[2020/12/14:] Improved bibliography.
+    Added categories for math and music; \pkg{startlatex2e};
+    items written in French, German, Indian, Italian, Japanese, Portuguese, Vietnamese;
+    Dante users group.
 \end{description}
 
 
-\begin{thebibliography}{99}
-
-\bibitem{lamport:latex}
-\pub{\LaTeX: A Document Preparation System},
-Leslie Lamport,
-second edition, Addison Wesley, 1994, ISBN 0201529831.
-
-\bibitem{hokpkadaly:guide}
-\pub{Guide to \LaTeX},
-Helmut Kopka and Patrick W. Daly,
-fourth edition, Addison-Wesley, 2004, ISBN 0321173856.
-
-\bibitem{gratzer:moremath}
-\pub{More Math Into \LaTeX},
-George Gr\"{a}tzer,
-5th ed., Springer, 2016,
-ISBN 3319237950.
-%ISBN-13: 978-3319237954.
-
-\bibitem{kottwitz:beginner}
-\pub{\LaTeX\ Beginner's Guide},
-Stefan Kottwitz,
-Packt Publishing, 2011, ISBN 1847199860.
-%ISBN-13 1847199860.
-
-\bibitem{kottwitz:cookbook}
-\pub{\LaTeX\ Cookbook}, Stefan Kottwitz, Packt Publishing, 2015,
-ISBN-13 9781784395148. \\
-\url{http://latex-cookbook.net}
-
-\bibitem{mittelbachgossens: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{talbot:novices}
-\pub{\LaTeX\ for Complete Novices},
-Nicola L. C. Talbot, 2012.
-Dickimaw Books.
-\url{http://www.dickimaw-books.com}
-
-\bibitem{talbot:phd}
-\pub{Using \LaTeX\ to Write a PhD Thesis},
-Nicola L. C. Talbot, 2013.
-Dickimaw Books.
-\url{http://www.dickimaw-books.com}
-
-\bibitem{Bennieston:scientific}
-\pub{Writing Scientific Documents Using \LaTeX},
-Andrew J. Bennieston, 2009. \\
-\url{https://ctan.org/pkg/intro-scientific}
-
-\bibitem{oetiker:introduction}
-\pub{The Not So Short Introduction to \LaTeXe},
-Tobias Oetiker, 2015. \url{https://ctan.org/pkg/lshort}
-
-\bibitem{greenwade:reference}
-\pub{\LaTeXe: An unofficial reference manual},
-George~D. Greenwade, Stephen Gilmore,
-Torsten~Martinsen, and Karl Berry.
-\url{https://latexref.xyz}
-
-\bibitem{pakin:list}
-\pub{The Comprehensive \LaTeX\ Symbol List},
-Scott Pakin, 2017.
-\url{https://ctan.org/pkg/comprehensive}
-
-\bibitem{robertson:mathsymbols}
-\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{TeX:FAQ}
-\TeX\ FAQ.
-\url{https://texfaq.org/}
-
-\bibitem{pakin:visual}
-\pub{The Visual \LaTeX\ FAQ},
-Scott Pakin.
-\url{https://ctan.org/pkg/visualfaq}
-
-\bibitem{bouzigues:guide}
-\pub{Initiation à \LaTeX}, Pour débutants ou jeunes utilisateurs,
-Adrien Bouzigues, 2017. \\
-\url{https://ctan.org/pkg/guide-latex-fr}
-
-\bibitem{massago:exemplos}
-\pub{\LaTeXe\ Via Exemplos},
-Sadao Massago, 2018.
-\url{https://ctan.org/pkg/latex-via-exemplos}
-
-\bibitem{ebookfoundation:free}
-\pub{Free Programming Books},
-Ebook Foundation. \\
-\url{https://github.com/EbookFoundation/free-programming-books}
-
-\bibitem{wilson:design}
-\pub{A Few Notes on Book Design},
-Peter Wilson, 2009.
-\url{https://ctan.org/pkg/memdesign}
-
-\bibitem{kohm:typearea}
-\pub{KOMA-Script — The Guide},
-Markus Kohm, 2018.
-\url{https://ctan.org/pkg/koma-script}
-
-\bibitem{tufte:book}
-\pub{A TUFTE-STYLE BOOK},
-The Tufte-LaTeX Developers, 2015.
-\url{https://ctan.org/pkg/tufte-latex}
-
-\bibitem{revets:octavo}
-\pub{The Octavo Package},
-Stefan A. Revets,
-\pub{TUGboat} 23 3/4 (2002), p.~269.
-\url{https://ctan.org/pkg/octavo}
-
-\bibitem{beccari:canoniclayout}
-\pub{Package canoniclayout},
-Claudio Beccari, 2011.
-\url{https://ctan.org/pkg/canoniclayout}
-
-\bibitem{fear:booktabs}
-\pub{Publication-quality tables in \LaTeX},
-Simon Fear, 2016.
-\url{https://ctan.org/pkg/booktabs}
-
-\bibitem{tantu:pgf}
-\pub{Till Tantau}, 2015.
-\url{https://ctan.org/pkg/pgf}
-
-\bibitem{texdocnet}
-TeXdoc Online.
-\url{http://texdoc.net}
-
-\bibitem{ctan}
-Comprehensive \TeX\ Archive Network (CTAN).
-\url{https://ctan.org}
-
-\bibitem{pakin:dtxtut}
-\pub{How to Package Your \LaTeX\ Package},
-Scott~Pakin.
-\url{https://ctan.org/pkg/dtxtut}
-
-\bibitem{latexteam:class}
-\pub{\LaTeXe\ for class and package writers},
-\LaTeX3 Project.
-\url{https://ctan.org/pkg/clsguide}
-
-\bibitem{mittelbach:doc}
-\pub{The doc and shortvrb packages},
-Frank Mittelbach.
-\url{https://ctan.org/pkg/doc}
-
-\bibitem{mittelbach:docstrip}
-\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}
-\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}
-\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}
-\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}
-
-\end{thebibliography}
-% \vfilneg
+\printbibliography
+
 
 
 \end{document}