File	Date	Author	Commit
.hgignore	2011-11-19	Martin Scharrer	[86e928] Updated ignore list.
.hgtags	2011-08-13	Martin Scharrer	[126edd] Added tag v0.5alpha-2011/08/11 for changeset 2c...
Makefile	2020-09-29	Martin Scharrer	[fdb77e] Updated email address in Makefile
README	2016-04-24	Martin Scharrer	[6fabfc] Updated ZIP Makefile target and copyright year.
TODO	2011-03-18	Martin Scharrer	[660021] dev/ydoc_doc.dtx::
ydoc-code.sty	2012-05-03	Martin Scharrer	[bf40e4] Fixed scope of listing settings.
ydoc-desc.sty	2011-12-18	Martin Scharrer	[691b92] Added "=" handler.
ydoc-doc.sty	2011-11-16	Martin Scharrer	[2fbcb9] Improved bundle code.
ydoc-expl.sty	2012-05-03	Martin Scharrer	[bf40e4] Fixed scope of listing settings.
ydoc.cfg	2011-08-13	Martin Scharrer	[330e2d] Changed to "fourier" font.
ydoc.cls	2011-08-12	Martin Scharrer	[53b86a] Placed all files in DTX file including "ydocstr...
ydoc.dtx	2012-05-03	Martin Scharrer	[3e4ab8] Updated date.
ydoc.ins	2011-11-18	Martin Scharrer	[6012e9] Made documentation compile properly.
ydoc.sty	2013-01-01	Martin Scharrer	[2af710] Removed loading of 'svn-prov' package.
ydocincl.tex	2011-11-19	Martin Scharrer	[4aa2cf] Fixed DTX compilation.
ydocstrip.tex	2011-11-19	Martin Scharrer	[4aa2cf] Fixed DTX compilation.

Read Me

The 'ydoc' class and packages
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Copyright (c) 2011-2016 by Martin Scharrer <martin@scharrer-online.de>

'ydoc' provides macros and environments to document LaTeX packages and classes.
It is an alternative to the 'ltxdoc' class and 'doc' package.
It targets a different layout and tries to provide more modern styles (xcolor, hyperref, etc.).

This is an alpha release. It should not be used yet for other packages.

INSTALL
~~~~~~~

This package might be part of your LaTeX distribution (TeX Live, MikTeX, ...) and then is installable using
the distributions package manager (TeX Live: 'tlmgr install ydoc').
However, it is also manually installable using the following ways:

1) TDS ZIP FILE
A TDS ZIP file includes all files in a installable format and using the required directory structure.
Simply unzip the TDS ZIP file over your TEXMF tree.

The TDS ZIP file can be downloaded from CTAN:
http://mirrors.ctan.org/install/macros/latex/contrib/ydoc.tds.zip


2) DTX FILE
The 'ydoc.dtx' file includes all required files, which can be extracted by compiling it using TeX (not LaTeX):

    tex ydoc.dtx

To build the documentation compile the same file using LaTeX (preferable 'pdflatex') multiple times:

    pdflatex ydoc.dtx
    pdflatex ydoc.dtx
    pdflatex ydoc.dtx

Copy all files to their correct location of your local TEXMF tree.
For example under Linux a personal TEXMF is normally located at '~/texmf' ('$HOME/texmf').
The files can be installed using the following Linux commands. For 

    mkdir -p "${TEXMF}/tex/latex/ydoc/"
    mkdir -p "${TEXMF}/source/latex/ydoc/"
    mkdir -p "${TEXMF}/doc/latex/ydoc/"
    mkdir -p "${TEXMF}/tex/generic/ydoc/"
    cp ydoc.sty ydoc.cls ydoc-code.sty ydoc-desc.sty ydoc-doc.sty ydoc-expl.sty ydoc.cfg "${TEXMF}/tex/latex/ydoc"
    cp ydoc.dtx ydoc.ins "${TEXMF}/source/latex/ydoc"
    cp ydoc.pdf README "${TEXMF}/doc/latex/ydoc"
    cp ydocincl.tex ydocstrip.tex "${TEXMF}/tex/generic/ydoc"

Update the tree database file (might be not required for modern versions and personal TEXMF trees):

    texhash ${TEXMF}