CTAN Comprehensive TeX Archive Network

Directory support/texdoc


Texdoc ― Find and view documentation in Live


General Information

Using Texdoc

Texdoc is part of the Live distribution. Generally, you don't have to install it yourself.

If you want to try/test the develop version, please see below.

How to Install the Develop Version

Using Bundler

The easiest way to install the develop version of Texdoc is using Bundler and Rake:

$ bundle install
$ rake install

If you want to uninstall the develop version (to use the Live version), just try:

$ rake uninstall

Installing manually

Here, $TEXDOC means the path to the texdoc dev sources you cloned (or downloaded), and $TEXMFHOME denotes your personal TEXMF tree (you can get its location with kpsewhich --var-value TEXMFHOME).

  • The command. Symlink or copy $TEXDOC/script as $TEXMFHOME/scripts/texdoc.
  • The configuration file. Symlink or copy $TEXDOC/texdoc.cnf as $TEXMFHOME/texdoc/texdoc-dist.cnf (notice the -dist part). It will completely override the other configuration files except $TEXMFHOME/texdoc/texdoc.cnf which you can still use for you personal settings.

You can make sure that the right files are used by running texdoc --files: the first line contains the full path to the version of used texdoclib.tlu, and the rest lists the configuration files in use.

Files in This Repository

  • doc/ contains the documentation,
  • script/ contains the source code,
  • spec/ is a directory for testing scripts, and
  • texdoc.cnf is the default configuration file.

Building and Testing

Many building tasks are defined as Rake tasks:

Generating all documentation

The following will generate both the PDF and the manpage in doc/ directory.

$ rake doc

Generating a pre-hashed cache file

The following will generate a pre-hashed cache file script/Data.tlpdb.lua. This task have to be done under a Live setup with tlpdb.

$ rake gen_datafile

Running tests

The following will run all tests in spec/ directory.

$ rake test

Alternatively, you can give spec names with the --list (-l) option for this task. E.g., following will run only spec/action/help_spec.rb and spec/mode/list_spec.rb:

$ rake test -- -l action/help,mode/list

Showing all available tasks

Following will show all available tasks with a short description.

$ rake -T

In addition to that, for options available tasks, e.g., rake test and rake run_texdoc, you can get options information with -h option for each task:

$ rake test -- -h

Further Information

More specific information, such as the TODO list of this project and some information for distributors, can be found in the Wiki of our GitHub repository. Please visit:

Copyright and License

Copyright 2008-2021 Manuel Pégourié-Gonnard, Takuto Asakura, the Live Team.

This package is distributed under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Previous work (texdoc program) in the public domain:

  • Contributions from Reinhard Kotucha (2008).
  • First texlua versions by Frank Küster (2007).
  • Original shell script by Thomas Esser, David Aspinall, and Simon Wilkinson.

Download the contents of this package in one zip archive (148.4k).

texdoc – Documentation access for Live

texdoc is a Lua script providing easy access to the documentation in Live: PDF, DVI, plain text files, and more. Viewing and other configuration can be extensively customized. It is distributed with Live; MiK provides a program by the same name to do the same job, but its implementation is unrelated.

Home pagehttps://tug.org/texdoc/
Bug trackerhttps://github.com/TeX-Live/texdoc/issues
Version3.4.1 2022-03-19
LicensesGNU General Public License
Copyright2008–2022 Manuel Pégourié-Gonnard, Takuto Asakura, the Live Team
MaintainerTakuto Asakura
The Live Team
Thomas Esser (inactive)
Manuel Pégourié-Gonnard (inactive)
Contained inTeX Live as texdoc
MiKTeX as miktex-mthelp-bin-2.9
TopicsView documentation
See alsotexdoctk
Guest Book Sitemap Contact Contact Author