Updating comments, adding a few aliases, re-arranging some other aliases.

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

1 files changed, 99 insertions, 54 deletions

diff --git a/Master/texmf/texdoc/texdoc.cnf b/Master/texmf/texdoc/texdoc.cnf
index 6ce0a5b918c..e7ebe061cd2 100644
--- a/Master/texmf/texdoc/texdoc.cnf
+++ b/Master/texmf/texdoc/texdoc.cnf
@@ -6,15 +6,19 @@
 #   TEXMFLOCAL/texdoc/texdoc-<arch>.cnf
 #   TEXMFLOCAL/texdoc/texdoc.cnf
 # where <arch> stands for your achitecture (eg, win32, i386-linux,
-# powerpc-darwin).  Those are read by texdoc in this order, and former values
-# override later ones.
+# powerpc-darwin).  You can get this list with variables expanded by typing 
+#       texdoc -f
+# Those are read by texdoc in this order, and former values
+# override later ones. 
 #
-# In those files, you can set your preferred viewer for various formats, the
-# programs used to unzip compressed documentation, and some nice names (alias)
-# for specific documentation.
+# In those files, you can set your preferred viewer for various formats, 
+# some nice names (alias) for specific documentation, and your preferred default
+# values of texdoc's configuration settings.
 #
 # Everything after a # on a line is ignored. 
-# Spaces on a line as well as empty lines are ignored.
+# Spaces at the beginning/end of a line, as well as empty lines, are ignored.
+#
+# For more details, see the texdoc manual (try `texdoc texdoc').
 
 ### Viewer settings ###
 
@@ -22,67 +26,113 @@
 # %s stands for the filename.
 #  
 # viewer_pdf = xpdf         # works
-# viewer_pdf = (xpdf %s) &  # works even better
+# viewer_pdf = xpdf %s &    # works even better
 
 ### Aliases ###
 
-## TeX Live documentation (later)
+## Essential documentation
 
-# alias live = texlive-en
-# alias texlive = texlive-en
+alias live = texlive-en
+alias texlive = texlive-en
+alias texdoc = texdoc/texdoc # avoid the man page to be displayed first
 
-## some useful stuff not in texdoctk.dat
+## various stuff
 
+# a few useful general documents
 alias mathmode = Mathmode
 alias visualfaq = visualFAQ
-alias luatex = luatexref-t
-alias luatex-pkg = luatex
+alias symbols = symbols-a4
+
+# *TeX engines reference manuals, man pages and related
+alias etex-ref = etex_man
+alias pdftex-ref = pdftex-a
+alias luatex-ref = luatexref-t
+alias etex-man = man1/etex
+alias pdftex-man = man1/pdftex
+#alias luatex-man = man1/luatex #???
+alias luatex-pkg = oberdiek/luatex.pdf
+
+# ams 
 alias amsmath = amsldoc
+alias amscls = instr-l
+alias amsart = instr-l
+alias amsproc = instr-l
+alias amsbook = instr-l
+#
 alias amsmath-dev = amsmath
+alias amscls-dev = amsclass
+alias amsart-dev = amsclass
+alias amsproc-dev = amsclass
+alias amsbook-dev = amsclass
+
+# pstricks
+alias pstricks = pst-user
+alias pstricks-add = pstricks-add-doc
+alias pst-tree = pst-user
+alias pst-node = pst-user
+alias pst-coil = pst-coil-doc
+alias pst-circ = pst-circ-doc
+
+# koma-script
+alias koma-script = scrguien
+alias koma = scrguien
+alias scrartcl = scrguien
+alias scrreprt = scrguien
+alias scrbook = scrguien
+alias typearea = scrguien
+#
+alias koma-script-de = scrguide
+alias koma-de = scrguide
+alias scrartcl-de = scrguide
+alias scrreprt-de = scrguide
+alias scrbook-de = scrguide
+alias typearea-de = scrguide
+
+# tugboat package and classes
+alias tugboat = ltubguid
+alias tugboat-plain = tubguide
+alias ltugboat = ltubguid
+alias ltugproc = ltubguid
+
+# misc
+alias titletoc = titlesec
+alias fontinst = fontinstallationguide
+alias psfrag = pfgguide
 
 ## a few easy patterns not already in texdoctk.dat
 
-# excerpt from "egrep 'manual\.pdf\>' texlive.tlpdb"
-alias cjhebrew = cjhebrew/manual.pdf
-alias geomsty = geomsty/manual.pdf
-alias elpres = elpres-manual.pdf
-alias interactiveworkbook = interactiveworkbookmanual.pdf
-alias msc = msc/manual.pdf
-alias pdfslide = pdfslide/manual.pdf
-alias pdftricks = pdftricks/manual.pdf
-alias pst-qtree = pst-qtree-manual.pdf
-alias sciposter = scipostermanual.pdf
-alias sectionbox = sectionboxmanual.pdf
-alias t-angles = t-manual.pdf
-alias texmate = texmate2manual.pdf
-alias tree-dvips = tree-manual.pdf
-alias lingmacros = lingmacros-manuals.pdf
-alias velthuis = velthuis/manual.pdf
-alias wallpaper = wallpapermanual.pdf
-alias xecjk = xeCJK-manual.pdf
-
-# egrep 'user\.pdf\>' texlive.tlpdb
-alias cweb-latex = cweb-user.pdf
-alias pstricks = pst-user.pdf
-
-
-## default list basically borrowed from texdoctk.dat with some adaptations
-# (additions are marked sith a trailing #)
-# should disappear in the future
-
-# alias symbols = english/comprehensive/symbols-a4.pdf
+# egrep 'manual\.pdf\>' docfiles.list
+alias cjhebrew = cjhebrew/manual
+alias geomsty = geomsty/manual
+alias elpres = elpres-manual
+alias interactiveworkbook = interactiveworkbookmanual
+alias msc = msc/manual
+alias pdfslide = pdfslide/manual
+alias pdftricks = pdftricks/manual
+alias pst-qtree = pst-qtree-manual
+alias sciposter = scipostermanual
+alias sectionbox = sectionboxmanual
+alias t-angles = t-manual
+alias texmate = texmate2manual
+alias tree-dvips = tree-manual
+alias lingmacros = lingmacros-manuals
+alias velthuis = velthuis/manual
+alias wallpaper = wallpapermanual
+alias xecjk = xeCJK-manual
+
+# egrep 'user\.pdf\>' docfiles.list
+alias cweb-latex = cweb-user
+alias footnpag = footnpag-user
+alias seminar = sem-user
+alias rcs = rcs-user
+
+## aliases basically borrowed from texdoctk.dat with some adaptations
+
 alias texguide = latex/base/usrguide.pdf
 alias lehman = english/Type1fonts/fontinstallationguide.pdf
-alias fontinst = english/Type1fonts/fontinstallationguide.pdf #
 alias uktugfaq = english/FAQ-en/newfaq.pdf
-alias pdftex = pdftex/manual/pdftex-a.pdf
 alias ttf = english/truetype/ttf-tetex.pdf
-alias KOMAg = latex/koma-script/scrguide.pdf
-alias etex = etex/base/etex_man.pdf
-alias AMSguide = amstex/base/amsguide.pdf
-alias AMSinstr = latex/amscls/instr-l.pdf
 alias ctan = english/help/CTAN.sites
-alias TDS = english/tds/tds.pdf
 alias datenumber = latex/datenumber/doc.dvi
 alias bibtexhak = bibtex/base/btxhak.pdf
 alias bibtexdoc = bibtex/base/btxdoc.pdf
@@ -129,7 +179,6 @@ alias ltugboat = latex/tugboat/ltubguid.pdf
 alias startex = startex/base/guide.pdf
 alias rotfloat = latex/rotfloat/examples.tex
 alias overpic = latex/overpic/opic-rel.dvi
-alias pstcirc = generic/pst-circ/pst-circ-doc.pdf
 alias apmgraph = latex/pmgraph/pmgraph.dvi
 alias pstoptic = generic/pst-optic/pst-optic-doc.pdf
 alias petri-nets = latex/petri-nets/pndoc.pdf
@@ -141,7 +190,6 @@ alias metaobj = metapost/metaobj/momanual.pdf
 alias pgf = generic/pgf/pgfmanual.pdf
 alias treetex = plain/treetex/tree_doc.dvi
 alias PSfrag = latex/psfrag/pfgguide.pdf
-alias psfrag = latex/psfrag/pfgguide.pdf #
 alias rst = latex/rst/rst-package.pdf
 alias xypic1 = generic/xypic/xyguide.pdf
 alias xypic2 = generic/xypic/xyrefer.pdf
@@ -154,7 +202,6 @@ alias prosper = latex/prosper/prosper-doc.pdf
 alias prosper1 = latex/prosper/prosper-tour.pdf
 alias beamer = latex/beamer/doc/beameruserguide.pdf
 alias ifmslide = latex/ifmslide/ifmman.pdf
-alias seminar = latex/seminar/sem-user.pdf
 alias arydshln = latex/arydshln/arydshln-man.pdf
 alias easytable = latex/easy/doc.dvi/doctable.dvi
 alias multirow = latex/multirow/README
@@ -186,7 +233,6 @@ alias amsfonts = fonts/amsfonts/amsfndoc.pdf
 alias doublestroke = fonts/doublestroke/dsdoc.pdf
 alias footnote1 = latex/mdwtools/footnote.pdf
 alias footnote2 = latex/yafoot/yafoot-man.dvi
-alias footnpag = latex/footnpag/footnpag-user.pdf
 alias linguex = latex/linguex/linguex-doc.pdf
 alias nath = latex/nath/nathguide.pdf
 alias clock = latex/clock/clockdoc.pdf
@@ -235,7 +281,6 @@ alias skak = latex/skak/skakdoc.tex
 alias isov2 = latex/iso/isoman.pdf
 alias cv = latex/curve/curve.pdf
 alias preprint = latex/preprint/00readme.txt
-alias rcs = latex/rcs/rcs-user.pdf
 alias sffms = latex/sffms/sffms_manual.pdf
 alias siunits = latex/SIunits/SIunits.pdf
 alias euro1 = latex/euro/euro.pdf