From e1ed0075e33f4d74cc66bf8e13f2e2ccd3d8fdbf Mon Sep 17 00:00:00 2001 From: Manuel Pégourié-Gonnard Date: Mon, 6 Jun 2011 03:15:16 +0000 Subject: Move texdoc.cnf in preparation for texdoc 0.81. git-svn-id: svn://tug.org/texlive/trunk@22811 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/texdoc/texdoc.cnf | 452 ++++++++++++++++++++++++++++++++++++ 1 file changed, 452 insertions(+) create mode 100644 Master/texmf-dist/texdoc/texdoc.cnf (limited to 'Master/texmf-dist/texdoc') diff --git a/Master/texmf-dist/texdoc/texdoc.cnf b/Master/texmf-dist/texdoc/texdoc.cnf new file mode 100644 index 00000000000..5c3feb95eca --- /dev/null +++ b/Master/texmf-dist/texdoc/texdoc.cnf @@ -0,0 +1,452 @@ +# texdoc.cnf +# +# 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 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 +# in the order they are printed. If a value is set multiple times, first wins. +# +# 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 at the beginning/end of a line, as well as empty lines, are ignored. +# +# For more details, see the texdoc manual (try `texdoc texdoc'). + + +# General settings +# ================ + +## Viewers + +# Defaults depend on what is available on your system, as well as your desktop +# environment. Here are a few examples. +# +# %s is optional and stands for the filename. +# +# viewer_pdf = xpdf # works +# viewer_pdf = xpdf %s & # works even better + +# If you want to enable support for zipped documentation (see below), +# you may want to adapt viewer_* so that it starts a subshell: +# +# viewer_pdf = (xpdf %s) & +# +# Otherwise, the & will have no effect since the viewing command is followed by +# some cleanup-commands for temporary files. For the same reason, %s must be the +# last thing on your command line: (xpdf %s -option) will not work. +# +# WARNING: for zip support your viewer needs to be blocking, i.e. it must not +# return immediately: otherwise the temporary file will be deleted too early. + +## 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 +# warning concerning viewers. + +# Built-in defaults (for reference): +# +# zipext_list = # (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 + +## User interaction + +# Built-in defaults (for reference): +# +# mode = view +# +# interact_switch = true +# machine_switch = false +# +# 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 +# badbasename_list = readme, 00readme + +# Known suffixes for documentation +suffix_list = doc, -doc, _doc, .doc, /doc, manual, /manual, -manual, userguide, /user_guide, -guide, -user, -man, notes + + +# Score adjustments +# ================= + +# Results are sorted by score (decreasing). +# Only results with positive scores are displayed (unless mode is 'showall'). +# 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 +# also possible to set the score directly in alias directives, see the next +# section. +# +# As a general rule, use 'adjscore' if you only want to adjust the score of +# particular results, and 'alias' if you want to add new results (possibly +# adjusting their score) for a particular query. +# +# To override one of the settings below, use the 'noadjscore' directive in +# your personal configuration file, see the manual for details. + +## General adjustments + +# 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 + +# 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 + +# 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 test = -3 +adjscore tests = -3 +adjscore example = -3 +adjscore examples = -3 +adjscore sample = -3 +adjscore samples = -3 +adjscore /images/ = -3 + +# readme's usually get a negative score because they have a bad extension, +# 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 + +## Specific adjustments + +# 'texdoc' may look like "tex's documentation" but it isn't +# similar problem with 'tex-*' +adjscore(tex) texdoc = -10 +adjscore(tex) tex-gyre = -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 +# file names +adjscore(latex) Content_LaTeX_Package_Demo = -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 + +# misc +adjscore(context) circuitikz = -10 +adjscore(symbols) /staves/ = -5 + +# catalogue info missing in the tlcontrib version of the package :-( +adjscore(pgf) pgfmanual.pdf = +5 + + +# Aliases +# ======= + +# Aliases allow to add results for a specific query, by making texdoc search +# for additional keywords in the file name. Matches for the new keyword get a +# very high score by default, but this can be adjusted. +# +# To override one of the settings below, use the 'noalias' directive in +# your personal configuration file, see the manual for details. + +## Essential documentation + +alias live = texlive-en +alias texlive = texlive-en + +## various stuff + +# a few useful general documents +alias faq-en = newfaq +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 = ptlshort # portuguese +alias lshort-sk = slshorte # slovak +alias lshort-es = lshort-spanish/lshort # spanish + +# *TeX engines reference manuals, man pages and related +alias e-tex-ref = etex_man +alias etex-ref = etex_man +alias pdftex-ref = pdftex-a +alias luatex-ref = luatexref-t + +# by default, = -ref (duplicated: no alias cascading) +alias e-tex = etex_man +alias etex = etex_man +alias xetex = XeTeX-reference +alias luatex = luatexref-t + +alias etex-man = etex.man1 +alias pdftex-man = pdftex.man1 +#alias xetex-man = xetex.man1 # XXX +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 = XXX +#alias minimal = XXX +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(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 +# 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 graphics-dev = graphics +alias graphicx-dev = graphicx +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 + +# ams +alias amsfonts = amsfndoc +alias amslatex2 = technote +alias amsmath = amsldoc +alias amsrefs = amsrdoc +alias amsthm = amsthdoc +alias amsart-dev = amsclass +alias amsbook-dev = amsclass +alias amscls-dev = amsclass +alias amsmath-dev = amsmath +alias amsproc-dev = amsclass + +# 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-script-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-dev = caption.pdf + +# metapost by various names +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 + +# misc +alias autofe = ucs +alias afoot = arabtex-doc +alias asymptote = asymptote # not mentioned in the catalogue currently +alias arabicfont = bezos +alias bibtex = btxdoc +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 pstricks = pstricks-doc +alias xstring-fr = xstring_doc_fr +alias arabic = arabi/user_guide +alias 3parttable = threeparttable +alias croatian = babel +alias letterspace = microtype +alias mls = montex +alias vrbexin = verbasef +alias dtk = dtk/doc/beispiel.pdf +alias musixtex = musixdoc +alias mychemistry = mychemistry_en +alias mychemistry-de = mychemistry_de + +## a few easy patterns + +# egrep 'manual\.pdf\>' +alias t-angles = t-manual +alias tree-dvips = tree-manual + +# egrep 'user\.pdf\>' +alias cweb-latex = cweb-user + +# egrep 'doc\.pdf\>' +alias barcode = eandoc.pdf +alias enctex-cz = encdoc +alias german = gerdoc +alias ngerman = gerdoc +alias jurabib-de = jbgerdoc +alias ofs-cz = ofsdoc +alias ofs = ofsdoc-e +alias pst-eucl-fr = pst-eucl/euclide +alias pst-eucl = pst-eucl/euclide_english +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 datenumber-de = datenumber/docgerman +alias labels(1) = envlab/elguide +alias euro = eurosamp +alias expressg = expeg +alias flcards = flashcards +alias lehman = fontinstallationguide +alias gnlogic = gn-logic14 +alias index = ind +alias kluwer = kluwer/usrman +alias lmfonts = lm-info +alias latex3 = ltx3info +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 ppower4 = ppower4/report +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 + +# the score used is 4.1 because: +# - it is less than 4.5, the default score of foobar/foobar.pdf for name foobar +# - it is greater than the worse false positive here (.../VERSION for version) +# +# Anyway, this is a hopefully a temporary measure, since work is going on to +# 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) statex2 = statex2.sty +alias(4.1) statex = statex.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 + + +# 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 +# . +# +# It is strongly recommended NOT to use it in any other circumstance. +lastfile_switch = true -- cgit v1.2.3