Date: July 8, 2003 9:32:04 PM CEST
On Tue, 8 Jul 2003, Lars Hellström wrote:
> I have to ftp.dante.de uploaded an archive xdoc.tar.gz into /incoming. It
> contains a directory xdoc with the six files:
> and I would like to have them put in /macros/latex/contrib/xdoc. The
> licence that applies is the LPPL.
> This is an update of the material in /macros/latex/exptl/xdoc, so that
> directory and its contents can be removed. It should probably be replaced
> by a link to the new contrib/xdoc directory.
> BTW, am I right if I assume that you are in a process of moving the
> previous contents of /macros/latex/contrib/other and
> /macros/latex/contrib/supported to simply /macros/latex/contrib? (It
> certainly looks that way in the archive.)
Yes, we are. We announced this on the ctan-ann mailing lsit a while ago.
Thanks for the upload, I installed the new material in
and changed the directory
to a link to the new one.
For the CTAN Team
> On what these files are:
> The xdoc2 package contains reimplementations of some of
> the features found in the standard LaTeX doc package
> by Mittelbach et al. Amongst other things, these
> reimplementations provide support for:
> * definiting new commands similar to \DescribeMacro and
> new environments similar to the macro environment,
> * two-sided document layouts,
> * sorting of version numbers as 2 < 11 < 100
> (if they are marked up using \uintver),
> * external cross-referencing,
> * making index entries for invisible characters,
> * optionally ignoring certain prefixes (such as @ and
> @@) in macro names when sorting them.
> The xdocdemo document demonstrates a couple of these
> I consider the xdoc2 package to merely be the second
> prototype for an (as yet nonexistant) package xdoc which
> should provide the same features (and more). I have
> decided to release the prototype to make its functionality
> generally avaiable, but under a variant name to avoid
> future incompatibility problems. (E.g., the final xdoc
> package will probably use many LaTeX2e* features that are
> still on the prototype stage. xdoc2, on the other hand,
> uses no LaTeX2e* features.)
> docindex.dtx contains a reimplementation of the doc mechanisms for
> sorting and formatting a sorted index. docindex.ins installs two forms
> of this package: docindex (which is a LaTeX2e* package) and docidx2e
> (which works with the normal LaTeX2e). The main advantage of these
> packages over the doc mechanisms is that configuration has been made
> much easier.
xdoc – Extending the LaTeX doc system
Xdoc is a project to rewrite the implementation of the LaTeX doc
package (in a broader sense) to make its features more general and
flexible. For example, where doc only provides commands for
documenting macros and environments, xdoc also provides commands
for similarly documenting package options and switches. This is
furthermore done in such a way that it is very easy to add more
such commands for documenting things, such as e.g., templates (an
important concept in the future LaTeX3) and program components for
other languages (functions, classes, procedures, etc.). A side
effect is that many minor bugs in doc are fixed.
The design aims to take advantage of many still experimental
features of future versions of LaTeX, but since these are neither
reasonably stable nor widely available, the configuration
interfaces and package author commands of xdoc are likely to
change. To still provide a stable interface for other packages to
build upon, the actual package names include a "major version
number" of sorts. The drop-in replacement package for standard doc
is xdoc2; it requires nothing outside standard LaTeX2ε.
The docindex/docidx2e package changes the index
and list of
changes typesetting so that none of the formatting has to be
controlled via the index style file. The docindex package provides
control of formatting via templates (nice interface, but requires
several experimental packages), whereas the docidx2e package has
traditional raw macro interfaces and works with standard LaTeX2ε.