summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/texdoc
diff options
context:
space:
mode:
authorManuel Pégourié-Gonnard <mpg@elzevir.fr>2011-06-06 03:15:16 +0000
committerManuel Pégourié-Gonnard <mpg@elzevir.fr>2011-06-06 03:15:16 +0000
commite1ed0075e33f4d74cc66bf8e13f2e2ccd3d8fdbf (patch)
tree0e6baf3609db246bc32651fb245f53af772c99ea /Master/texmf-dist/texdoc
parent500c05901060f0f36237659ac18e0415ca44614d (diff)
Move texdoc.cnf in preparation for texdoc 0.81.
git-svn-id: svn://tug.org/texlive/trunk@22811 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/texdoc')
-rw-r--r--Master/texmf-dist/texdoc/texdoc.cnf452
1 files changed, 452 insertions, 0 deletions
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, <engine> = <engine>-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
+# <http://tug.org/texdoc/dev/>.
+#
+# It is strongly recommended NOT to use it in any other circumstance.
+lastfile_switch = true