texlive 是否附带软件包文档?

texlive 是否附带软件包文档?

因此我使用以下命令在 ubuntu 上安装了 texlive:

sudo apt-get install texlive-common

使用此命令安装了许多软件包。但我是否也安装了这些软件包的文档?如果答案是肯定的,那么我在文件系统上哪里可以找到它们?如果答案是否定的,我可以使用 apt-get 安装它们吗?

答案1

TeX Live 本身包含大多数软件包的大多数文档。偶尔会因为许可或其他原因而缺少文档。TeX Live 通常会在带有后缀 的软件包的文档目录中放置一条注释来指出这一点TEXLIVE。例如,以下是 的内容texmf-dist/doc/latex/chessfss/

README          README.TEXLIVE  

README.TEXLIVE然后告诉我们在 CTAN 上可以找到丢失的文件的位置:

The following files have been removed in the TeX Live installation of
the current package, typically due to duplication, lack of space, or
missing source code.  You can find these files on CTAN at
        http://mirror.ctan.org/macros/latex/contrib/chessfss
If questions or concerns, email [email protected].

        chessfonts_gallery.pdf
        chessfss.pdf

是否texlive-common安装所含软件包的文档取决于您的发行版打包者的决定。不过,通常我期望如果包含在 TeX Live 中,文档也会包含在内。

texdoc <name of package>

显示软件包 的文档<name of package>。有时软件包包含几种不同的文档。在这种情况下,上述命令可能不会显示您想要的文档。在某些情况下,texdoc的选择实际上不太可能是最有用的。例如,它可能显示源代码而不是最终用户的说明。

texdoc -l <name of package>

列出软件包的所有文档<name of package>。如果您选择其中一个选项,它将被显示出来。

texdoc -h 

提供更多信息,包括其他选项的详细信息等。

Usage: texdoc [OPTION]... NAME...
  or:  texdoc ACTION

Try to find appropriate TeX documentation for the specified NAME(s).
Alternatively, perform the given ACTION and exit.

Current settings: --view, --interact (default).

Actions:
  -h, --help            Print this help message.
  -V, --version         Print the version number.
  -f, --files           Print the list of configuration files used.
  --just-view file      Display file, given with full path (no searching).

Options:
  -w, --view            Use view mode: start a viewer. (default)
  -m, --mixed           Use mixed mode (view or list).
  -l, --list            Use list mode: show a list of results.
  -s, --showall         Use showall mode: show also "bad" results.

  -i, --interact        Use interactive menus. (default)
  -I, --nointeract      Use plain lists, no interaction required.
  -M, --machine         Machine-readable output for lists (implies -I).

  -q, --quiet           Suppress warnings and most error messages.
  -v, --verbose         Print additional information (eg, viewer command).
  -d, --debug[=list]    Activate debug output (restricted to list).

Environment: PAGER, BROWSER, PDFVIEWER, PSVIEWER, DVIVIEWER.
Files: <texmf>/texdoc/texdoc.cnf, see output of the --files option.
Report bugs to <[email protected]>.
Full manual available via `texdoc texdoc'.

请注意,在大多数情况下,texdoc它将在您的默认查看器中打开 PDF。有时,文档是 HTML 格式,或者对于较旧的软件包,它可能会打开 DVI。如果没有这样的可用文件,它将显示纯文本文件或它能找到的任何文件。

有些软件包没有这样的文档,但在源文件顶部的注释中确实有使用说明。或者它们的文档可能不包含任何实际说明。例如,

texdoc setspace

返回以下内容

setspace -- control line spacing in latex documents

This release is a transitional one, with code unchanged from Geoffrey
Tobin's LaTeX 2.09 original, except for patches that avoid a problem
with \@setsize, when the package is used with other 2.09 packages
under LaTeX 2e.

The package now acts "natively" as a 2e package under LaTeX 2e, and
(insofar as is possibe) as a 2.09 package under LaTeX 2.09.

Please report any problems to Robin Fairbairns <[email protected]>
(A revised version of setspace-test.tex, that shows the problem
reported, will be much appreciated.)

这很棒,但可能没什么帮助。不过,setspace.sty在文件顶部包含了说明。

%%% ======================================================================
%% FILE:   setspace.sty in SYS2.TEX.PUB.ISULATEX.STYLES
%% AUTHOR: Erica M. S. Harris
%% DATE:   April 1990
%% MOD:    March 1991
%%%
%%% Update to LaTeX (2e) :  6 Feb 1996.
%%% Description:  LaTeX Document Package "setspace"
%%%
%%% Usage:
%%%                \documentclass[...]{...}
%%%                \usepackage{setspace}
%%%
%%         Based on the doublespace option created by Stephen Page.
%%
%%         This style option provides commands and environments for doing
%%         double and  one-and-a-half spacing based on pt size.
%%
%%         Single spacing is the default.
%%
%%         Three commands, \singlespacing, \onehalfspacing, and
%%         \doublespacing, are for use in the preamble to set the overall
%%         spacing for the document.  If a different spacing is required then
%%         the \setstretch{baselinestretch} command can be used in the
%%         preamble to set the baselinestretch appropriately.  The default
%%         spacing with this style option is single spacing.
%%
%%         Three environments, singlespace, onehalfspace, and doublespace,
%%         allow the spacing to be changed within the document.  Both the
%%         onehalfspace and doublespace environments are intended to increase
%%         the spacing, so the onehalfspace environment should not be used in
%%         a double spaced document.  If an increased spacing different from
%%         one-and-a-half or double spacing is required then the spacing
%%         environment can be used.  The spacing environment takes one
%%         argument which is the larger baselinestretch to use,
%%         e.g., \begin{spacing}{2.5}.
%%
%%         \footins is adjusted the same as \parskip - appears to work. Lose
%%         stretch parts but don't consider that to be crucial
%%
%%         Removed code for altering spacing before and after displayed
%%         equations - just looked too much.
%%
%% MODS:
%%         Redefinition of \spacing and \endspacing for consistency with
%%         TeX 3.x inserted by George Greenwade.  Modification provided by
%%         Philip Ross ([email protected]) and John Byrne via INFO-TeX.
%%
%% PLEASE REPORT ANY BUGS
%%
%%   Old Documentation follows:
%%         1. A new environment "singlespace" is provided, within which single
%%            spacing will apply.
%%            JFL - changed so that it works in regular text and so that
%%            vertical space before and after is correctly computed
%%         2. Double spacing is turned off within footnotes and floats (figures
%%            and tables).
%%         3. Proper double spacing happens below tabular environments and in
%%            other places where LaTeX uses a strut.
%%         4. Slightly more space is inserted before footnotes.
%%         5. JFL - fixes spacing before and after displayed math
%%
%%
%%    mods:   Jean-Francois Lamy
%%            [email protected]
%%            [email protected]
%%
%% POSSIBLE BUGS:
%%    . Increasing struts may possibly cause some other obscure part of
%%      formatting to fall over.
%%    . \begin{singlespace}\begin{quote} produces the wrong spacing before
%%      the quote (extra glue is inserted).
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

这显然更有帮助。

相关内容