From 58f64f141bad7d97ff02df9375bc53453444ba46 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 28 Mar 2019 20:58:51 +0000 Subject: texdoc (28mar19) git-svn-id: svn://tug.org/texlive/trunk@50627 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/texdoc/texdoc.cnf | 530 ++++++++++++++++++------------------ 1 file changed, 264 insertions(+), 266 deletions(-) (limited to 'Master/texmf-dist/texdoc') diff --git a/Master/texmf-dist/texdoc/texdoc.cnf b/Master/texmf-dist/texdoc/texdoc.cnf index bdf2ad1394d..5fcb2a53448 100644 --- a/Master/texmf-dist/texdoc/texdoc.cnf +++ b/Master/texmf-dist/texdoc/texdoc.cnf @@ -2,10 +2,10 @@ # Public domain. # # DO NOT edit this file! -# For your personal settings, run 'texdoc -f' and use the file indicated by a -# star; you may need to create it. DO NOT copy the present file, please -# create a new one (you may want to copy/paste/edit portions of the present -# file however, or just read it for inspiration). +# For your personal settings, run 'texdoc -f' and use the recommended file; you +# may need to create it. DO NOT copy the present file, please create a new one +# (you may want to copy/paste/edit portions of the present file however, or +# just read it for inspiration). # # For system-wide configuration or other uses, you may want to use the other # files listed, see the manual (texdoc texdoc) for details. The files are read @@ -18,9 +18,8 @@ # Everything after a # on a line is 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'). +# For more details, see the texdoc manual (try 'texdoc texdoc'). - # General settings # ================ @@ -49,52 +48,51 @@ ## Zipped documentation support # WARNING: support for zipped documents works only on Unix. Make sure that the -# values of the associated options are adapted to your system. Read the above +# values of the associated options are adapted to your system. Read the above # warning concerning viewers. # Built-in defaults (for reference): # -# zipext_list = # (empty list) -# rm_file = rm -f -# rm_dir = rmdir +# zipext_list = # the empty list +# rm_file = rm -f +# rm_dir = rmdir # # For each "ext" in zipext_list, you must define a "unzip_ext" unzipper. # The unzipped data must be printed on stdout. Example: # # zipext_list = gz -# unzip_gz = gzip -d -c +# unzip_gz = gzip -d -c ## User interaction # Built-in defaults (for reference): # -# mode = view +# mode = view # -# interact_switch = true -# machine_switch = false +# interact_switch = true +# machine_switch = false # -# verbosity_level = 2 # Print: 0: nothing, 1: errors, 2: warnings, 3: infos -# debug_list = # the empty list +# verbosity_level = 2 # Print: 0: nothing, 1: errors, 2: warnings, 3: infos +# debug_list = # the empty list ## Documentation searching # Built-in defaults (for reference): # -# ext_list = pdf, htm, html, txt, ps, dvi, # Note: empty string at end -# badext_list = txt, # Note: empty string at end -# basename_list = readme, 00readme +# ext_list = pdf, html, htm, txt, md, ps, dvi, # Note: empty string at end +# badext_list = txt, # Note: empty string at end +# basename_list = readme, 00readme # badbasename_list = readme, 00readme ## Fuzzy search # Built-in defaults (for reference): # -# fuzzy_level = 5 +# fuzzy_level = 5 # Known suffixes for documentation suffix_list = doc, -doc, _doc, .doc, /doc, manual, /manual, -manual, userguide, /user_guide, -guide, -user, -man, notes, -info, ref - # Score adjustments # ================= @@ -103,7 +101,7 @@ suffix_list = doc, -doc, _doc, .doc, /doc, manual, /manual, -manual, userguide, # Results with score <= -100 are never displayed. # # The score of results containing a given pattern can be adjusted using the -# 'adjscore' directive, either globally or only for specific queries. It is +# 'adjscore' directive, either globally or only for specific queries. It is # also possible to set the score directly in alias directives, see the next # section. # @@ -119,71 +117,66 @@ suffix_list = doc, -doc, _doc, .doc, /doc, manual, /manual, -manual, userguide, # Makefile are never documentation, just as documents in src or source subdir # -1000 should be enough to kill them adjscore /Makefile = -1000 -adjscore /src/ = -1000 -adjscore /source/ = -1000 +adjscore /src/ = -1000 +adjscore /source/ = -1000 # licence files aren't very likely to contain relevant documentation, but it # feels wrong to totally kill them adjscore copying = -10 adjscore license = -10 -adjscore gpl = -10 +adjscore gpl = -10 # tex-virtual-academy provides a lot of spurious matches adjscore /tex-virtual-academy-pl/ = -50 # test and example files are not likely the best documentation -adjscore example = -1 -adjscore examples = -1 -adjscore sample = -1 -adjscore samples = -1 -adjscore test = -3 -adjscore tests = -3 -adjscore /demo/ = -1 -adjscore /demos/ = -1 +adjscore example = -1 +adjscore examples = -1 +adjscore sample = -1 +adjscore samples = -1 +adjscore test = -3 +adjscore tests = -3 +adjscore /demo/ = -1 +adjscore /demos/ = -1 adjscore /figures/ = -3 -adjscore /images/ = -3 +adjscore /images/ = -3 -# readme's usually get a negative score because they have a bad extension, +# readme files usually get negative scores because they have bad extensions, # but they're still slightly better than other results with negative scores -adjscore readme = 0.1 - -# uncomment this to make the man pages have a greater priority -#adjscore .man1. = 5 -#adjscore .man5. = 5 +adjscore readme = +0.1 ## Specific adjustments -# 'texdoc' may look like "tex's documentation" but it isn't -# similar problem with 'tex-*' -adjscore(tex) texdoc = -10 +# 'texdoc' may look like "tex's documentation" but it isn't; 'tex-*' as well +adjscore(tex) texdoc = -10 adjscore(tex) tex-gyre = -10 -adjscore(tex) tex-ps = -10 +adjscore(tex) tex-ps = -10 # avoid too many results to be shown for 'latex' # package names -adjscore(latex) cjw-latex = -10 -adjscore(latex) cweb-latex = -10 -adjscore(latex) duerer-latex = -10 -adjscore(latex) guide-to-latex = -10 # only useful with the book -adjscore(latex) latex-web-companion = -10 -adjscore(latex) ocr-latex = -10 -adjscore(latex) tufte-latex = -10 +adjscore(latex) cjw-latex = -10 +adjscore(latex) cweb-latex = -10 +adjscore(latex) duerer-latex = -10 +adjscore(latex) guide-to-latex = -10 # only useful with the book +adjscore(latex) latex-web-companion = -10 +adjscore(latex) ocr-latex = -10 +adjscore(latex) tufte-latex = -10 # file names adjscore(latex) Content_LaTeX_Package_Demo = -10 -adjscore(latex) example_latex = -10 -adjscore(latex) test_latex = -10 +adjscore(latex) example_latex = -10 +adjscore(latex) test_latex = -10 # beamer adjscore(beamer) beamer-tut-pt/tutorialbeamer = +10 -adjscore(beamer) beamer-FUBerlin = -3 -adjscore(beamer) beamer-tut-pt = -10 -adjscore(beamer) presentations = -10 +adjscore(beamer) beamer-FUBerlin = -3 +adjscore(beamer) beamer-tut-pt = -10 +adjscore(beamer) presentations = -10 # misc -adjscore(context) circuitikz = -10 -adjscore(context) /gnuplot/ = -3 +adjscore(context) circuitikz = -10 +adjscore(context) /gnuplot/ = -3 adjscore(context) context.man1 = +2 -adjscore(symbols) /staves/ = -5 +adjscore(symbols) /staves/ = -5 # catalogue info missing in the tlcontrib version of the package :-( adjscore(pgf) pgfmanual.pdf = +5 @@ -192,7 +185,7 @@ adjscore(pgf) pgfmanual.pdf = +5 adjscore(hyph-utf8) hyphenation.pdf = +5 # let's not have context version found first -adjscore(fixme) /third/ = -6 +adjscore(fixme) /third/ = -6 # prioritize newer document adjscore(babel-german) ngermanb.pdf = +5 @@ -200,7 +193,9 @@ adjscore(babel-german) ngermanb.pdf = +5 # prioritize man page adjscore(findhyph) findhyph.man1 = +5 - +# prioritize official latex-tools +adjscore(layout) /tools/ = +1 + # Aliases # ======= @@ -213,43 +208,44 @@ adjscore(findhyph) findhyph.man1 = +5 ## Essential documentation -alias live = texlive-en -alias texlive = texlive-en +alias live = texlive-en +alias texlive = texlive-en alias tex-live = texlive-en ## various stuff # a few useful general documents alias faq-en = newfaq -alias faq = newfaq -alias latex = latex-doc-ptr +alias faq = newfaq +alias latex = latex-doc-ptr # various lshort translations adjscore(lshort) /lshort-english/ = +0.5 # original -alias lshort-de = l2kurz # german -alias lshort-pl = lshort-polish/lshort2e # polish -alias lshort-pt = pt-lshort # portuguese -alias lshort-sk = slshorte # slovak -alias lshort-es = lshort-spanish/lshort-a4 # spanish +alias lshort-de = l2kurz # german +alias lshort-ja = jlshort # japanese +alias lshort-pl = lshort-polish/lshort2e # polish +alias lshort-pt = pt-lshort # portuguese +alias lshort-sk = slshorte # slovak +alias lshort-es = lshort-spanish/lshort-a4 # spanish # *TeX engines reference manuals, man pages and related -alias e-tex-ref = etex_man -alias etex-ref = etex_man +alias e-tex-ref = etex_man +alias etex-ref = etex_man alias pdftex-ref = pdftex-a -#alias xetex-ref = xetex-reference # OK -alias xelatex = xetex-reference +#alias xetex-ref = xetex-reference # OK +alias xelatex = xetex-reference alias luatex-ref = luatexref-t # by default, = -ref (duplicated: no alias cascading) -alias e-tex = etex_man -alias etex = etex_man -alias pdftex = pdftex-a -#alias xetex = xetex-reference # OK -alias xelatex = xetex-reference -alias luatex = luatexref-t - -alias e-tex-man = etex.man1 -alias etex-man = etex.man1 +alias e-tex = etex_man +alias etex = etex_man +alias pdftex = pdftex-a +#alias xetex = xetex-reference # OK +alias xelatex = xetex-reference +alias luatex = luatexref-t + +alias e-tex-man = etex.man1 +alias etex-man = etex.man1 alias pdftex-man = pdftex.man1 #alias xetex-man = xetex.man1 # missing alias luatex-man = luatex.man1 @@ -257,169 +253,172 @@ alias luatex-man = luatex.man1 alias luatex-pkg = oberdiek/luatex.pdf # latex/basic classes -alias article = classes -alias book = classes -alias report = classes -#alias ltxguide = ? # missing -#alias minimal = ? # missing +alias article = classes +alias book = classes +alias report = classes +#alias ltxguide = ? # missing +#alias minimal = ? # missing adjscore(minimal) europecv = -1000 # false positive # latex/basic packages, sorted by dtx -alias doc = base/doc -alias shortvrb = base/doc -alias letter = base/letter -alias slides = base/slides -alias(20) fontenc = encguide +alias doc = base/doc +alias shortvrb = base/doc +alias letter = base/letter +alias slides = base/slides +alias(20) fontenc = encguide alias(20) textcomp = encguide -alias fix-cm = fixltx2e -alias bezier = latex209 -alias fleqn = latex209 -alias leqno = latex209 -alias openbib = latex209 -alias t1enc = latex209 -alias makeidx = makeindx -alias showidx = makeindx -alias flafter = source2e -alias fontenc = source2e -alias textcomp = source2e -alias tracefnt = source2e +alias fix-cm = fixltx2e +alias bezier = latex209 +alias fleqn = latex209 +alias leqno = latex209 +alias openbib = latex209 +alias t1enc = latex209 +alias makeidx = makeindx +alias showidx = makeindx +alias flafter = source2e +alias fontenc = source2e +alias textcomp = source2e +alias tracefnt = source2e # TODO: try to avoid the huge amount of false positives for `doc' itself. # latex's required graphics bundle -alias color-dev = color -alias epsfig-dev = epsfig +alias color-dev = color +alias epsfig-dev = epsfig alias graphics-dev = graphics alias graphicx-dev = graphicx -alias color = grfguide -alias epsfig = grfguide -alias graphics = grfguide -alias graphicx = grfguide +alias color = grfguide +alias epsfig = grfguide +alias graphics = grfguide +alias graphicx = grfguide # latex's required psnfss2e bundle -alias avant = psnfss2e -alias bookman = psnfss2e -alias chancery = psnfss2e -alias charter = psnfss2e -alias courier = psnfss2e -alias helvet = psnfss2e -alias mathpazo = psnfss2e -alias mathpple = psnfss2e -alias mathptm = psnfss2e -alias mathptmx = psnfss2e -alias newcent = psnfss2e -alias palatino = psnfss2e -alias times = psnfss2e -alias utopia = psnfss2e +alias avant = psnfss2e +alias bookman = psnfss2e +alias chancery = psnfss2e +alias charter = psnfss2e +alias courier = psnfss2e +alias helvet = psnfss2e +alias mathpazo = psnfss2e +alias mathpple = psnfss2e +alias mathptm = psnfss2e +alias mathptmx = psnfss2e +alias newcent = psnfss2e +alias palatino = psnfss2e +alias times = psnfss2e +alias utopia = psnfss2e # ams -alias amsfonts = amsfndoc -alias amslatex2 = technote -alias amsmath = amsldoc -alias amsrefs = amsrdoc -alias amsthm = amsthdoc -alias amsart = instr-l -alias amsbook = instr-l -alias amscls = instr-l -alias amsproc = instr-l -alias amsart-dev = amsclass +alias amsfonts = amsfndoc +alias amslatex2 = technote +alias amsmath = amsldoc +alias amsrefs = amsrdoc +alias amsthm = amsthdoc +alias amsart = instr-l +alias amsbook = instr-l +alias amscls = instr-l +alias amsproc = instr-l +alias amsart-dev = amsclass alias amsbook-dev = amsclass -alias amscls-dev = amsclass +alias amscls-dev = amsclass alias amsproc-dev = amsclass alias amsmath-dev = amsmath # koma-script -alias koma = scrguien -alias koma-script = scrguien -alias scrartcl = scrguien -alias scrbook = scrguien -alias scrreprt = scrguien -alias typearea = scrguien -alias koma-de = scrguide +alias koma = scrguien +alias koma-script = scrguien +alias scrartcl = scrguien +alias scrbook = scrguien +alias scrreprt = scrguien +alias typearea = scrguien +alias koma-de = scrguide alias koma-script-de = scrguide -alias scrartcl-de = scrguide -alias scrbook-de = scrguide -alias scrreprt-de = scrguide -alias typearea-de = scrguide +alias scrartcl-de = scrguide +alias scrbook-de = scrguide +alias scrreprt-de = scrguide +alias typearea-de = scrguide # tugboat package and classes alias tugboat = ltubguid # caption -alias caption = caption-eng +alias caption = caption-eng alias caption-dev = caption.pdf # metapost by various names -alias metapost = mpman +alias metapost = mpman alias(5) metapost = mpgraph alias(5) metapost = mpintro -alias mpost = mpman -alias(5) mpost = mpgraph -alias(5) mpost = mpintro -alias mp = mpman -alias(5) mp = mpgraph -alias(5) mp = mpintro +alias mpost = mpman +alias(5) mpost = mpgraph +alias(5) mpost = mpintro +alias mp = mpman +alias(5) mp = mpgraph +alias(5) mp = mpintro # latex3 and friends -alias latex3 = ltx3info -alias l3bootstrap = interface3 -alias l3names = interface3 -alias l3basics = interface3 -alias l3expan = interface3 -alias l3prg = interface3 -alias l3quark = interface3 -alias l3token = interface3 -alias l3int = interface3 -alias l3skip = interface3 -alias l3tl = interface3 -alias l3seq = interface3 -alias l3clist = interface3 -alias l3prop = interface3 -alias l3box = interface3 -alias l3coffins = interface3 -alias l3color = interface3 -alias l3msg = interface3 -alias l3keys = interface3 -alias l3file = interface3 -alias l3fp = interface3 -alias l3luatex = interface3 +alias latex3 = ltx3info +alias(3) expl3 = interface3 +alias(3) expl3 = source3 +alias l3bootstrap = interface3 +alias l3names = interface3 +alias l3basics = interface3 +alias l3expan = interface3 +alias l3prg = interface3 +alias l3quark = interface3 +alias l3token = interface3 +alias l3int = interface3 +alias l3skip = interface3 +alias l3tl = interface3 +alias l3seq = interface3 +alias l3clist = interface3 +alias l3prop = interface3 +alias l3box = interface3 +alias l3coffins = interface3 +alias l3color = interface3 +alias l3msg = interface3 +alias l3keys = interface3 +alias l3file = interface3 +alias l3fp = interface3 +alias l3luatex = interface3 # misc -alias autofe = ucs -alias afoot = arabtex-doc -alias arabicfont = bezos -alias bibtex = btxdoc -alias changes = changes.english.pdf -alias(5) cmsuper = cm-super/FAQ -alias cm-super = cm-super/README -alias cmsuper = cm-super/README -alias cyrillic = cyrillic/00readme.txt -alias elsarticle = elsdoc -alias(0.1) fontinst = fontinstallationguide -alias hyperref = hyperref/manual.pdf -alias hyperref-dev = hyperref.pdf -alias iso = isoman -alias lettrine = lettrine # to hide context/third/lettrine-doc.pdf -alias nonfloat-de = nonfloat -alias nonfloat = nonfloat-en -alias xstring-fr = xstring_doc_fr -alias arabic = arabi/user_guide -alias 3parttable = threeparttable -alias croatian = babel -alias mls = montex -alias vrbexin = verbasef -alias dtk = dtk/doc/beispiel.pdf -alias musixtex = musixdoc -alias mychemistry = mychemistry_en -alias mychemistry-de = mychemistry_de -alias cjk = CJK.txt # FIXME: should be case insensitive -alias ieee = IEEEtran_HOWTO -alias layouts = layman -alias plnfss = plnfss.txt # XXX -alias teubner = teubner-doc -alias xypic = xyguide -alias kvoptions-patch = kvoptions # XXX? -alias cweb = cwebman # XXX: is in 'cweb' dir, should win -alias einfuehrung = einfuehrung/README # tl should get "readme" tag +alias autofe = ucs +alias afoot = arabtex-doc +alias arabicfont = bezos +alias bibtex = btxdoc +alias changes = changes.english.pdf +alias cm = cm/README +alias(5) cmsuper = cm-super/FAQ +alias cm-super = cm-super/README +alias cmsuper = cm-super/README +alias cyrillic = cyrillic/00readme.txt +alias elsarticle = elsdoc +alias(0.1) fontinst = fontinstallationguide +alias hyperref = hyperref/manual.pdf +alias hyperref-dev = hyperref.pdf +alias iso = isoman +alias lettrine = lettrine # to hide context/third/lettrine-doc.pdf +alias nonfloat-de = nonfloat +alias nonfloat = nonfloat-en +alias xstring-fr = xstring_doc_fr +alias arabic = arabi/user_guide +alias 3parttable = threeparttable +alias croatian = babel +alias mls = montex +alias vrbexin = verbasef +alias dtk = dtk/doc/beispiel.pdf +alias musixtex = musixdoc +alias mychemistry = mychemistry_en +alias mychemistry-de = mychemistry_de +alias cjk = CJK.txt # FIXME: should be case insensitive +alias ieee = IEEEtran_HOWTO +alias layouts = layman +alias plnfss = plnfss.txt # XXX +alias teubner = teubner-doc +alias xypic = xyguide +alias kvoptions-patch = kvoptions # XXX? +alias cweb = cwebman # XXX: is in 'cweb' dir, should win +alias einfuehrung = einfuehrung/README # tl should get "readme" tag ## a few easy patterns @@ -430,47 +429,46 @@ alias tree-dvips = tree-manual alias cweb-latex = cweb-user # egrep 'doc\.pdf\>' -alias barcode = eandoc.pdf -alias enctex-cz = encdoc -alias ngerman = gerdoc -alias jurabib-de = jbgerdoc -alias ofs-cz = ofsdoc -alias ofs = ofsdoc-e -alias pst-geo = pst-map3d-doc +alias barcode = eandoc.pdf +alias enctex-cz = encdoc +alias ngerman = gerdoc +alias jurabib-de = jbgerdoc +alias ofs-cz = ofsdoc +alias ofs = ofsdoc-e +alias pst-geo = pst-map3d-doc ## aliases basically borrowed from texdoctk.dat with some adaptations - -alias akletter = akletter/lettereng -alias arydshln = arydshln-man -alias cv = curve/curve +alias akletter = akletter/lettereng +alias arydshln = arydshln-man +alias cv = curve/curve alias datenumber-de = datenumber/docgerman -alias labels(1) = envlab/elguide -alias expressg = expeg -alias flcards = flashcards -alias lehman = fontinstallationguide -alias gnlogic = gn-logic14 -alias kluwer = kluwer/usrman -alias lmfonts = lm-info -alias mathenv = mdwtab -alias montex = mlsquick -alias mltex = mltex/mltex.txt -alias natbib2 = natnotes -alias uktugfaq = newfaq -alias onrannual = onrannual/README -alias otibet = otibet/unidoc -alias pbdiagram = pb-manual -alias tikz = pgfmanual -alias apmgraph = pmgraph -alias preprint = preprint/00readme.txt -alias dutch = rapdoc -alias startex = startex/base/guide -alias tangles = t-angles/t-manual -alias tex4ht = tex4ht/mn.html -alias(60) akademia = tex-virtual-academy-pl/index.html -alias treetex = tree_doc -alias lineno = ulineno -alias texguide = usrguide -alias(5) xypic = xyrefer +alias labels(1) = envlab/elguide +alias expressg = expeg +alias flcards = flashcards +alias lehman = fontinstallationguide +alias gnlogic = gn-logic14 +alias kluwer = kluwer/usrman +alias lmfonts = lm-info +alias mathenv = mdwtab +alias montex = mlsquick +alias mltex = mltex/mltex.txt +alias natbib2 = natnotes +alias uktugfaq = newfaq +alias onrannual = onrannual/README +alias otibet = otibet/unidoc +alias pbdiagram = pb-manual +alias tikz = pgfmanual +alias apmgraph = pmgraph +alias preprint = preprint/00readme.txt +alias dutch = rapdoc +alias startex = startex/base/guide +alias tangles = t-angles/t-manual +alias tex4ht = tex4ht/mn.html +alias(60) akademia = tex-virtual-academy-pl/index.html +alias treetex = tree_doc +alias lineno = ulineno +alias texguide = usrguide +alias(5) xypic = xyrefer ## packages from ctan/macros/latex/contrib/misc or with doc in .sty only @@ -482,28 +480,28 @@ alias(5) xypic = xyrefer # produce suitable documentation for all these packages (thanks to Philipp # Stephani and Robin Fairbairns mostly). -alias(4.1) 3parttable = 3parttable.sty -alias(4.1) bibcheck = bibcheck.sty -alias(4.1) concrete = concrete.sty -alias(4.1) linsys = linsys.sty -alias(4.1) mitpress = mitpress.sty -alias(4.1) nextpage = nextpage.sty -alias(4.1) setspace = setspace.sty -alias(4.1) statex = statex.sty -alias(4.1) statex2 = statex2.sty +alias(4.1) 3parttable = 3parttable.sty +alias(4.1) bibcheck = bibcheck.sty +alias(4.1) concrete = concrete.sty +alias(4.1) linsys = linsys.sty +alias(4.1) mitpress = mitpress.sty +alias(4.1) nextpage = nextpage.sty +alias(4.1) setspace = setspace.sty +alias(4.1) statex = statex.sty +alias(4.1) statex2 = statex2.sty alias(4.1) texilikecover = texilikecover.sty -alias(4.1) thrmappendix = thrmappendix.sty -alias(4.1) topcapt = topcapt.sty -alias(4.1) vrbexin = vrbexin.sty +alias(4.1) thrmappendix = thrmappendix.sty +alias(4.1) topcapt = topcapt.sty +alias(4.1) vrbexin = vrbexin.sty - # Final hack +# ================ # # The next line has no effect when this file is installed as the last # configuration file (default) but is useful when you install it as the "tricky" # configuration file (usually TEXMFHOME/texdoc/texdoc-dist.cnf) whose mere -# existence is a hack to make it easier to run the the development version, see -# . +# existence is a hack to make it easier to run the development version, see +# . # # It is strongly recommended NOT to use it in any other circumstance. lastfile_switch = true -- cgit v1.2.3