summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-02-11 00:11:40 +0000
committerKarl Berry <karl@freefriends.org>2015-02-11 00:11:40 +0000
commit13e3251ec8da9abe378dd662a288d2261ae9b8c0 (patch)
treeb89235b38a35350bc55dd9fff1d8b0107a7cb08c /Master/texmf-dist/doc/latex
parent06035cd2a957fc5063b466c181f360a743fc9d0a (diff)
cdpbundl (9feb15)
git-svn-id: svn://tug.org/texlive/trunk@36255 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/cdpbundl/00readme.txt88
-rw-r--r--Master/texmf-dist/doc/latex/cdpbundl/Makefile122
-rw-r--r--Master/texmf-dist/doc/latex/cdpbundl/README11
-rw-r--r--Master/texmf-dist/doc/latex/cdpbundl/cdp-ver-0-36.pdfbin0 -> 352386 bytes
-rw-r--r--Master/texmf-dist/doc/latex/cdpbundl/cdp-ver-0-36.tex1102
-rw-r--r--Master/texmf-dist/doc/latex/cdpbundl/cdpbundl-doc.pdfbin0 -> 392111 bytes
-rw-r--r--Master/texmf-dist/doc/latex/cdpbundl/manifest.txt45
-rw-r--r--Master/texmf-dist/doc/latex/cdpbundl/overview.pdfbin679245 -> 0 bytes
8 files changed, 1322 insertions, 46 deletions
diff --git a/Master/texmf-dist/doc/latex/cdpbundl/00readme.txt b/Master/texmf-dist/doc/latex/cdpbundl/00readme.txt
index a6e828117d0..3ed84fdec7f 100644
--- a/Master/texmf-dist/doc/latex/cdpbundl/00readme.txt
+++ b/Master/texmf-dist/doc/latex/cdpbundl/00readme.txt
@@ -4,7 +4,8 @@ This is file `00readme.txt'.
This file is part of a work named "C.D.P. Bundle".
-Copyright (C) 1999-2006 by Gustavo MEZZETTI <mezzetti@math.unipd.it>.
+Copyright (C) 1999-2015 by Gustavo MEZZETTI
+ <gustavo.mezzetti@istruzione.it>.
The C.D.P. Bundle may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3
@@ -12,7 +13,7 @@ of this license or (at your option) any later version.
The latest version of this license is in
http://www.latex-project.org/lppl.txt
and version 1.3 or later is part of all distributions of LaTeX
-version 2003/12/01 or later.
+version 2005/12/01 or later.
The C.D.P. Bundle has the LPPL maintenance status
"author-maintained".
@@ -26,7 +27,7 @@ This file, after giving a brief description of the C.D.P. Bundle,
explains how to install it and how to generate its--alas, still
incomplete!--documentation.
-January 1, 2006 (vers. 0.34)
+February 8, 2015 (vers. 0.36)
@@ -39,6 +40,7 @@ CONTENTS
- Checking the contents of the distribution
- How to install the C.D.P. Bundle
- How to generate the documentation
+- The makefile
@@ -57,7 +59,7 @@ sections and paragraphs, to include floating figures and tables, and to use
the commands "\tableofcontents", "\listoffigures", and "\listoftables" to
compile the relevant indexes. A single input file can contain several
letters, and each letter will have its own table of contents, etc.,
-independent from the other ones.
+independent of the other ones.
@@ -66,11 +68,11 @@ DRAWBACKS
The documentation included in this distribution is absolutely minimal. For
meaningful instructions on how to use the macros, the reader is referred to
-other documents available at the web site of the author's department,
+other documents available at the web site of the past author's department,
which, however, are written in Italian. Since the main purpose of these
macros is to typeset letters according to Italian conventions, this should
not be a problem. I will consider translating the documentation in English
-only if at least 5 persons ask me to.
+only if at least 5 persons ask me to. Nobody has asked yet.
@@ -107,7 +109,11 @@ under the title "MEANING OF THE TERM `Work'", but not those listed under
HOW TO INSTALL THE C.D.P. BUNDLE
================================
-To install the C.D.P. Bundle, follow these steps:
+Note that in many pre-packaged TeX distributions, like MiKTeX and TeX Live,
+the C.D.P. Bundle is already installed, and you can use it straight away.
+
+If, for some reason, you need to install the C.D.P. Bundle yourself, follow
+these steps (but also see the section titled "The makefile", below):
1) Make sure that the files `cdpbundl.dtx' and `cdpbundl.ins' are placed in
the same directory; below, we shall indicate this directory as "the current
@@ -116,14 +122,15 @@ directory".
2) Run LaTeX (or Plain TeX) once on the file `cdpbundl.ins'. This will
generate, in the current directory, the following LaTeX input files:
- adiseal.sty
articoletteracdp.cls
cdpaddon.sty
+ cdpbabel.sty
+ cdpnamesenglish.ldf
+ cdpnamesitalian.ldf
cdpshues-example.def
cdpshues.cfg
epson-stylus-740.def
hp-laserjet-4500.def
- lettcdpadi.cls
letteracdp.cls
3) Move all the files listed in 2) from the current directory to a LaTeX
@@ -138,10 +145,7 @@ the terminal at the end of the run of the file `cdpbundl.ins'.
b) The documentation of your TeX installation should tell you how to find
the LaTeX input directory/ies, and probably also how to create new LaTeX
-input directories reserved to hold your private classes and packages. If
-your TeX installation offers you the chance of defining your private LaTeX
-input directories, I recommend you exploit this possibility and place the
-generated files into such a directory.
+input directories reserved to hold your private classes and packages.
c) If you are not able to find the LaTeX input directories, or you are not
allowed to modify them and cannot create your personal LaTeX input
@@ -160,11 +164,11 @@ directory devoted to private classes and packages). In this case, note
that the TDS-compliant location for the C.D.P. Bundle, that is, the
directory inside which you should put all the files listed in 2), is
- $TEXMF/tex/latex/cdpbundl/
+ tex/latex/cdpbundl/
The documentation, on the other hand, should be stored inside
- $TEXMF/doc/latex/cdpbundl/
+ doc/latex/cdpbundl/
Of course, in order to do so you must have appropriate access priviledges
to the texmf tree of your site.
@@ -174,27 +178,29 @@ to the texmf tree of your site.
HOW TO GENERATE THE DOCUMENTATION
=================================
-A shortened form of the documentation, already typeset and packaged in PDF
-format, is given in the file `overview.pdf' that you might have found on
+A shortened form of the documentation, already typeset and packaged in PDF,
+is provided in the file `cdpbundl-doc.pdf' that you might have found on
some sites (e.g., the CTAN sites). This file, however, is not part of the
C.D.P. Bundle and distributors are not requested to include it among the
distributed files. Moreover, it does not contain any implementation notes
-(in which most users are not at all interested).
+(in which most users, though, are not at all interested).
If the distributor from whom you obtained the C.D.P. Bundle did not provide
-the file `overview.pdf', or if you want the full documentation, complete
-with all the available implementation notes (but, alas, still incomplete
-for many respects), you can generate it by following these steps:
+the file `cdpbundl-doc.pdf', or if you want the full documentation,
+complete with all the available implementation notes (but, alas, still
+unfinished for many respects), you can generate it following these steps
+(but also see the section titled "The makefile", below):
1) Run LaTeX (_not_ Plain TeX) _twice_ on the file `cdpbundl.dtx'.
This, among other things, will generate the files `cdpbundl.idx' and
`cdpbundl.glo' in the same directory as the file `cdpbundl.dtx'.
2) Run MakeIndex on the file `cdpbundl.idx' obtained in 1), using the style
-file `gind.sty', which is part of the standard LaTeX distribution.
+file `gind.ist', which is part of the standard LaTeX distribution.
3) Run MakeIndex on the file `cdpbundl.glo' obtained in 1), using the style
-file `gglo.sty', which is part of the standard LaTeX distribution.
+file `gglo.ist', which is part of the standard LaTeX distribution, and
+specifying the file `cdpbundl.gls' as the output file.
4) Run LaTeX _two_ more times on the file `cdpbundl.dtx'.
@@ -208,6 +214,7 @@ file `gglo.sty', which is part of the standard LaTeX distribution.
cdpbundl.ind
cdpbundl.lof
cdpbundl.log
+ cdpbundl.out
cdpbundl.toc
After step 4), you should get the documentation in DVI format in the file
@@ -219,8 +226,41 @@ run LaTeX three or four times, instead of two, in step 1)... :-)
Other LaTeX typesetting engines should work in the same way, perhaps
producing the output in a different format; for example, you may use
-pdflatex in place of LaTeX to obtain the documentation in PDF format.
+pdflatex in place of LaTeX to obtain the documentation in PDF.
+
+
+
+THE MAKEFILE
+============
+
+Starting with version 0.36 of the C.D.P. Bundle, a (quite trivial!)
+makefile that "knows" how to produce the documentation is offered along
+with the Bundle itself. Although it is not a required part of the
+distribution (as per LPPL), you may find that some distributors supply it
+all the same (I hope the CTAN sites will do so). With this makefile in
+the same directory as `cdpbundl.dtx', the shell command
+
+ make doc
+
+will take all the necessary actions to produce the full documentation
+(in PDF; the modifications you need to introduce into the makefile
+in order to obtain DVI output should be quite obvious, however).
+
+The same makefile can also be used to extract the various class, package,
+and ancillary (definition and configuration) files: simply issue the
+command
+
+ make code
+
+at the shell prompt; whereas
+
+ make
+
+will _both_ extract the code _and_ typeset the documentation. Type
+
+ make help
+for more information.
Have fun with the C.D.P. Bundle!
diff --git a/Master/texmf-dist/doc/latex/cdpbundl/Makefile b/Master/texmf-dist/doc/latex/cdpbundl/Makefile
new file mode 100644
index 00000000000..d2c09827c0c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/cdpbundl/Makefile
@@ -0,0 +1,122 @@
+# makefile
+#
+# 2015 Feb 08
+#
+# Macro definitions
+ROOT_NAME = cdpbundl
+DTX_NAME = $(ROOT_NAME).dtx
+INS_NAME = $(ROOT_NAME).ins
+DOC_AUX_FIL = $(ROOT_NAME).aux $(ROOT_NAME).log \
+ $(ROOT_NAME).glo $(ROOT_NAME).gls \
+ $(ROOT_NAME).idx $(ROOT_NAME).ind $(ROOT_NAME).ilg \
+ $(ROOT_NAME).toc $(ROOT_NAME).lof \
+ $(ROOT_NAME).out
+DOCUM_FILE = $(ROOT_NAME).pdf
+CODE_FILES = letteracdp.cls \
+ articoletteracdp.cls \
+ cdpaddon.sty \
+ cdpbabel.sty \
+ *.ldf \
+ *.def \
+ cdpshues.cfg
+#
+LATEX = pdflatex
+MAKEINDEX = makeindex
+
+#
+define GEN_FAKE_INDEX
+ @echo '\\begin{theindex}' > $(ROOT_NAME).ind
+ @echo '\\end{theindex}' >> $(ROOT_NAME).ind
+ @echo "Generating fake .ind file."
+endef
+#
+define GEN_FAKE_GLOSSARY
+ @echo '\\begin{theglossary}' > $(ROOT_NAME).gls
+ @echo '\\end{theglossary}' >> $(ROOT_NAME).gls
+ @echo "Generating fake .gls file."
+endef
+
+
+
+.PHONY: default
+.PHONY: code doc
+.PHONY: clean cleandoc cleanaux cleancode cleanall
+.PHONY: help
+
+# Default target
+default: doc code
+
+# Generating the code
+code:
+ openout_any=r tex $(INS_NAME)
+
+# Generating the documentation
+doc: $(DOCUM_FILE)
+
+$(DOCUM_FILE): $(DTX_NAME)
+ # Hack for getting index and glossary in the toc since first run:
+ $(GEN_FAKE_INDEX)
+ $(GEN_FAKE_GLOSSARY)
+ # We know how many runs are needed:
+ $(LATEX) $(DTX_NAME)
+ $(LATEX) $(DTX_NAME)
+ $(MAKEINDEX) -s gind.ist -o $(ROOT_NAME).ind $(ROOT_NAME).idx
+ $(MAKEINDEX) -s gglo.ist -o $(ROOT_NAME).gls $(ROOT_NAME).glo
+ $(LATEX) $(DTX_NAME)
+ $(LATEX) $(DTX_NAME)
+
+# Cleaning up: command "make clean" defaults to "make cleanall"
+clean: cleanall
+
+# Cleaning the code files
+cleancode:
+ -rm $(CODE_FILES)
+
+# Cleaning the documentation files
+cleandoc: cleanaux
+ -rm $(DOCUM_FILE)
+
+# Cleanng just the auxiliary files used in producing the documentation
+cleanaux:
+ -rm $(DOC_AUX_FIL)
+
+# Cleaning up all the generated files
+cleanall: cleancode cleandoc
+
+# Giving help
+help:
+ @echo "Here is a list of the available commands:"
+ @echo
+ @echo " make"
+ @echo " Generate both the code and the documentation (see below)."
+ @echo
+ @echo " make code"
+ @echo " Generate the LaTeX sources for all the classes, packages,"
+ @echo " definition files, etc. of the C.D.P. Bundle; these files go"
+ @echo " into the LaTeX input directories."
+ @echo
+ @echo " make doc"
+ @echo " Generate the documentation (in PDF); the resulting PDF file"
+ @echo " goes into the LaTeX documentation directories (the auxiliary"
+ @echo " files may be discarded)."
+ @echo
+ @echo " make clean"
+ @echo " make cleanall"
+ @echo " These two commands are synonyms; they remove all of the"
+ @echo " generated files (both code and documentation)."
+ @echo
+ @echo " make cleancode"
+ @echo " Remove the LaTeX source files (the \"code files\")."
+ @echo
+ @echo " make cleandoc"
+ @echo " Remove the documentation, together with all the auxiliary"
+ @echo " files used to generate it."
+ @echo
+ @echo " make cleanaux"
+ @echo " Remove only the auxiliary files used to generate the"
+ @echo " documentation."
+ @echo
+ @echo " make help"
+ @echo " Print this help message."
+ @echo
+
diff --git a/Master/texmf-dist/doc/latex/cdpbundl/README b/Master/texmf-dist/doc/latex/cdpbundl/README
index 34f3bd25fe4..a153cc57295 100644
--- a/Master/texmf-dist/doc/latex/cdpbundl/README
+++ b/Master/texmf-dist/doc/latex/cdpbundl/README
@@ -11,12 +11,17 @@ paragraphs, to include floating figures and tables, and to use the
commands "\tableofcontents", "\listoffigures", and "\listoftables" to
compile the relevant indexes. A single input file can contain several
letters, and each letter will have its own table of contents, etc.,
-independent from the other ones.
+independent of the other ones.
+
+The C.D.P. Bundle may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either version 1.3
+of this license or (at your option) any later version.
For more information, read the following files:
-00readme.txt -- start by reading this file
-overview.pdf -- general information on the C.D.P. Bundle (PDF)
+00readme.txt -- start by reading this file
+cdpbundl-doc.pdf -- overview of the C.D.P. Bundle (PDF)
+cdp-ver-0-36.pdf -- instructions specific to version 0.36 (PDF)
Other files that make up the distribution are:
diff --git a/Master/texmf-dist/doc/latex/cdpbundl/cdp-ver-0-36.pdf b/Master/texmf-dist/doc/latex/cdpbundl/cdp-ver-0-36.pdf
new file mode 100644
index 00000000000..590b0cbc917
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/cdpbundl/cdp-ver-0-36.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/cdpbundl/cdp-ver-0-36.tex b/Master/texmf-dist/doc/latex/cdpbundl/cdp-ver-0-36.tex
new file mode 100644
index 00000000000..996a6603141
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/cdpbundl/cdp-ver-0-36.tex
@@ -0,0 +1,1102 @@
+\begin{filecontents}{myarticletter.cls}
+\NeedsTeXFormat{LaTeX2e}[1998/06/01] % LaTeX2e is required!
+\ProvidesClass{myarticletter}
+ [2015/02/08 v0.01 (development)]
+\DeclareOption*{\PassOptionsToClass{\CurrentOption}{articoletteracdp}}
+\ProcessOptions\relax
+\LoadClass{articoletteracdp}[2015/01/20]
+\input{mylogo.def}
+\endinput
+\end{filecontents}
+
+
+
+\begin{filecontents}{mylogo.def}
+\ProvidesFile{mylogo.def}[2015/02/08 v0.01 (development)]
+
+\RequirePackage[customletterhead]{cdpaddon}[2015/01/21]
+\RequirePackage{color}
+
+\DeclareFontFamily{T1}{my@calli}{}
+\DeclareFontShape{T1}{my@calli}{m}{n}{<->s*[1.44]callig15}{}
+\definecolor{my@lh@color}{rgb}{0,.4,.4}
+
+\begin{customletterhead}{\textwidth}
+ \color{my@lh@color}
+ \fontsize{17}{21}\usefont{T1}{my@calli}{m}{n}
+ \leftline{%
+ \setlength{\unitlength}{1cm}%
+ \begin{picture}(0,0)
+ \put(-2,0){\framebox(1.8,1.2){%
+ \normalsize\ttfamily My Logo%
+ }}
+ \end{picture}%
+ My Company'\,s Letterhead\enspace
+ \hrulefill\hspace{-2cm}%
+ }
+\end{customletterhead}
+
+\settowidth{\longindentation}{%
+ \fontsize{17}{21}\usefont{T1}{my@calli}{m}{n}%
+ My Company'\,s Letterhead\enspace
+}
+
+\begin{customletterfoot}{\textwidth}
+ \color{my@lh@color}
+ \fontsize{5}{6}\usefont{T1}{pplx}{m}{n}
+ \raggedleft
+ \ruleacrossheadorfoot[-2cm]
+ My (almost unreadable) \textsc{small print},\\
+ aligned along the \textit{right} edge\\
+ of the main text.
+\end{customletterfoot}
+
+\renewcommand*{\foldingtagrule}{%
+ \color{my@lh@color}\CDPFactoryFoldingTagRule
+}
+
+\endinput
+\end{filecontents}
+
+
+
+\documentclass
+ [twoside,boldsubject,italicsignature,shortindent,signaturerule]
+ {myarticletter}[2015/02/08]
+\usepackage[T1]{fontenc}
+\usepackage[english]{cdpbabel}
+\usepackage[bookmarksnumbered,hypertexnames=false]{hyperref}
+\usepackage{lipsum}
+
+\name{Gustavo Mezzetti}
+\signature{Gustavo Mezzetti}
+\address{
+ Gustavo \textsc{Mezzetti}\\
+ \protect\href
+ {mailto:gustavo.mezzetti@istruzione.it}
+ {\protect\nolinkurl{gustavo.mezzetti@istruzione.it}}
+}
+\date{February~8, 2015}
+
+\hypersetup{
+ pdftitle = {The C.D.P. Bundle version 0.36},
+ pdfauthor = {G. Mezzetti},
+ pdfsubject = {Instructions on how use the C.D.P. Bundle},
+ pdfcreationdate = {D:20150208120000},
+ pdfmoddate = {D:20150208120000}
+}
+
+\pagestyle{headings}
+\setcounter{tocdepth}{2}
+
+\newcommand*{\pdfbslash}{}
+{\catcode`\|=0 |catcode`|\=12 |gdef|pdfbslash{\\}}
+
+\DeclareRobustCommand*{\packlass}[1]{{\normalfont\sffamily #1}}
+\DeclareRobustCommand*{\opz}[1]{{\normalfont\ttfamily #1}}
+\DeclareRobustCommand*{\env}[1]{%
+ {\texorpdfstring{\normalfont\ttfamily}{}#1}%
+}
+\DeclareRobustCommand*{\sty}[1]{{\normalfont\ttfamily #1}}
+\DeclareRobustCommand*{\filedir}[1]{{\normalfont\ttfamily #1}}
+\DeclareRobustCommand*{\cntr}[1]{{\normalfont\ttfamily #1}}
+\DeclareRobustCommand*{\command}[1]{%
+ {\texorpdfstring{\normalfont\ttfamily \char\escapechar}{\pdfbslash}#1}%
+}
+\newcommand*{\meta}[1]{\(\langle\textit{#1}\rangle\)}
+\newcommand*{\strongemph}[1]{\textbf{#1}}
+\newcommand*{\zerolistvertspaces}{%
+ \setlength{\parskip}{0pt}%
+ \setlength{\topsep}{\parskip}%
+ \setlength{\partopsep}{\parskip}%
+}
+
+\newcommand*{\lcdp}{\packlass{letteracdp}}
+\newcommand*{\acdp}{\packlass{articoletteracdp}}
+\newcommand*{\hyre}{\packlass{hyperref}}
+\newcommand*{\cdpa}{\packlass{cdpaddon}}
+\newcommand*{\adic}{\packlass{lettcdpadi}}
+\newcommand*{\adip}{\packlass{adiseal}}
+\newcommand*{\babel}{\packlass{babel}}
+\newcommand*{\cdpbabel}{\packlass{cdpbabel}}
+\newcommand*{\Bundle}{C.D.P. Bundle}
+\newcommand*{\oclh}{\opz{customletterhead}}
+\newcommand*{\eclh}{\env{customletterhead}}
+\newcommand*{\eclf}{\env{customletterfoot}}
+
+\makeatletter
+
+\newcounter{listing}[letter]
+\renewcommand*\thelisting{\@arabic\c@listing}
+\@ifdefinable\fps@listing{\def\fps@listing{tbp}}
+\@ifdefinable\ftype@listing{\def\ftype@listing{4}}
+\@ifdefinable\ext@listing{\def\ext@listing{lol}}
+\@ifdefinable\fnum@listing{\def\fnum@listing{\listingname~\thelisting}}
+\newenvironment*{listing}
+ {\@float{listing}}
+ {\end@float}
+\newenvironment*{listing*}
+ {\@dblfloat{listing}}
+ {\end@dblfloat}
+\newcommand*\listoflistings{%
+ \section*{\listlistingname \sectionmark\listlistingname}%
+ \if@loX@in@toc@
+ \addcontentsline{toc}{section}{\protect\listlistingname}%
+ \fi
+ \@starttoc{lol}%
+}
+\@ifdefinable\l@listing{\let\l@listing\l@figure}
+\newcommand*\listlistingname{List of listings}
+\newcommand*\listingname{Listing}
+\@ifdefinable\toclevel@listing{\def\toclevel@listing{\toclevel@figure}}
+% Note that we use "\def" here, not "\let".
+
+\newcommand*\cleantop{%
+ \dimen@ \baselineskip
+ \advance \dimen@ -\topskip
+ \prevdepth \dimen@
+}
+\newcommand*\cleanbot{%
+ \dimen@ \baselineskip
+ \advance \dimen@ -\topskip
+ \advance \dimen@ -\prevdepth
+ \vskip \dimen@
+ \prevdepth \z@
+}
+\newcommand*\cleanbotp{%
+ \vskip -\prevdepth
+ \prevdepth \z@
+}
+
+\makeatother
+
+\hfuzz = 0pt
+\vfuzz = 0pt
+
+
+
+
+
+
+\begin{document}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% %
+% Letter no. 1 %
+% %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{letterhead}[Whom it may concern]{
+ To whom may be concerned\\
+ with writing letters with \LaTeX\\
+ (and want them to bear a letterhead
+ of \emph{their own} choice!)
+}[
+ The \Bundle\ version 0.36.
+]
+
+\opening{Dear friends:}
+
+This letter describes the new ``bells and whistles'' that have been made
+available in version~0.36 of the \Bundle. This version is just a provisional
+patch applied on what essentially remains ``fossil'' code, in need of a thorough
+redesign; nontheless, it does provide some long-awaited features, most
+prominently the ability to modify, with reasonable ease, the letterhead produced
+by the \env{letterhead} environment.
+
+The author wishes to thank Lorenzo Pantieri for having promoted, in his
+excellent work ``\emph{Complementi all'Arte di scrivere con \LaTeX}''
+(``Additions to The art of writing with \LaTeX''), the use of the \lcdp\
+document class, which is the main component of the \Bundle. This letter
+(indirectly) uses the \acdp\ document class.
+
+
+
+\tableofcontents
+\listoflistings
+
+
+
+\setcounter{secnumdepth}{0}
+
+\section{Introduction}
+
+The \Bundle\ was essentially written between 1999 and 2000 (for an Italian
+audience), and even at that time it contained code that was already deprecated;
+even worse, its design was flawed since the beginning, because it had been
+conceived for a specific and limited application (the letters of the C.D.P.,
+exactly), and was adapted for more general use only as an afterthought.
+
+A thorough redesign would therefore be needed; on the other hand, some users
+have suggested, or asked for, improvements and additions, in particular for what
+concerns the use of the bundle with other languages besides Italian (see
+Section~\ref{S:Languages}), that can be implemented rather easily by means of
+provisional patches. I~have already been deferring the introduction of these
+comparatively harmless enhancements for five years, waiting for the right moment
+to undertake the task of redesigning the bundle from scratch, but now I~have
+resolved to simply patch up the existing version.
+
+The version herein presented, therefore, is far from being optimal: no serious
+attempt has been made to remove ``fossil'' code, nor to bring it up to date with
+modern \LaTeX\ usage. I~have removed, however, the \adip\ package and the
+\adic\ document class, of which, probably, nobody besides me even remembers the
+purpose.
+
+Though\marginpar{\hfill\strongemph{$*{*}*\;$WOW!!$\;*{*}*$}},
+% Yes, I know, I should use \textasteriskcentered...
+\strongemph{good news} are coming for all those users who asked for a means to
+\strongemph{customize the letterhead} produced by the \Bundle: a reasonably
+viable method for doing so has been provided at
+last!~\facesmile\facesmile\facesmile\space The method requires the use of the
+\cdpa\ package, passing in the new option \oclh. You can specify the contents
+of your custom head and foot by means of two new environments, called \eclh\ and
+\eclf, which are similar, to a certain extent, to the \env{minipage}
+environment. This should give you the maximum freedom in designing the
+letterhead (having recourse to \env{picture}s and images, if you want to),
+whilst adopting an interface you are surely well familiar with. See
+Section~\ref{S:Letterhead} for more information.
+
+Another nifty feature is the ability to draw a thin rule to guide your hand in
+signing your letters: you ask for this behavior by passing the new
+\opz{signaturerule} option to the \lcdp\ document class. See
+Section~\ref{S:Options} for more information.
+
+Finally, some minor corrections of an aesthetic nature have also been brought
+in, which are concisely discussed in Section~\ref{S:Adjustments}.
+
+
+
+\setcounter{secnumdepth}{2}
+
+\section{My own letterhead, at last!}
+\label{S:Letterhead}
+
+One of the questions that users ask most frequenty about the \Bundle\ is perhaps
+``How the hell can I~put \emph{my own} letterhead in the place of that silly
+greenish thing?''; so, let's start with this one!
+
+%%%%
+\begin{listing}[p]
+ \cleantop
+\begin{verbatim}
+\documentclass
+ [twoside,boldsubject,italicsignature,shortindent,signaturerule]
+ {letteracdp}[2015/01/20]
+\usepackage[T1]{fontenc}
+\usepackage[english]{cdpbabel}
+\usepackage[customletterhead]{cdpaddon}[2015/01/21]
+\usepackage{url,lipsum}
+
+\address{
+ Gustavo \textsc{Mezzetti}\\
+ \protect\url{gustavo.mezzetti@istruzione.it}
+}
+\signature{Gustavo Mezzetti}
+\date{February~8, 2015}
+\place{Padova}
+
+
+
+% Definition of your letterhead occurs here:
+
+\begin{customletterhead}{\textwidth}
+ \centering \Huge
+ My Huge Centered Letterhead
+\end{customletterhead}
+\begin{customletterfoot}{\textwidth}
+ \raggedleft \tiny
+ \ruleacrossheadorfoot
+ My (almost unreadable) small print\\
+ flushed against the right margin.
+\end{customletterfoot}
+
+
+
+\begin{document}
+
+\begin{foldedletterhead}[Whom it may concern]
+ {To whom it may concern}
+ [My own letterhead, at last!]
+
+\makepresentation
+\maketopdate\relax
+
+\lipsum[1-2]
+
+\makesignature
+
+\end{foldedletterhead}
+
+\end{document}
+\end{verbatim}
+ \caption{How to customize the letterhead}
+ \label{lis:customletter}
+ \cleanbotp
+\end{listing}
+%%%%
+
+
+
+\paragraph{For the impatient}
+\label{P:LetterHeadImpatient}
+
+Listing~\ref{lis:customletter} explains what you have to do, in order to define
+a simple customized letterhead, by means of a practical example. It shows the
+complete contents of the \LaTeX\ source file: by mimicking this code, you should
+easily obtain what suits your needs. Let us skim briefly through it.
+
+First of all, note that we load the \cdpa\ package, with the \oclh\ option (as
+well as a few other useful packages that, of course, have nothing to do with
+letterheads). Then come the usual declarations concerning the sender, the date,
+etc.
+
+Still in the preamble---as we will soon see, we could do this in other places
+too, but also the preamble is absolutley OK\@---we start a \eclh\ environment.
+This environment has the following synopsis:
+%
+\begin{flushleft}
+ \verb|\begin{customletterhead}{|\meta{wdth}\verb|}|\quad
+ \meta{text}\quad
+ \verb|\end{customletterhead}|
+\end{flushleft}
+%
+As you can see, it resembles a \env{minipage} environment, except that you
+cannot specify the vertical alignment of the material contained therein (because
+you don't need to: the mini page you are producing has not to be aligned with
+any nearby constructs); and indeed, it creates a ``mini page'' of width
+\meta{wdth} containing the \meta{text} you specify. This \meta{text} should be
+your letterhead: for example, the code shown here will produce a letterhead,
+centered between the margins of the body of the main text, which reads ``My Huge
+Centered Letterhead''---and actually looks like that!~\facesmile
+
+Next, we do the same for the footer, using the \eclf\ environment, which is
+syntactically identical to \eclh:
+%
+\begin{flushleft}
+ \verb|\begin{customletterfoot}{|\meta{wdth}\verb|}|\quad
+ \meta{text}\quad
+ \verb|\end{customletterfoot}|
+\end{flushleft}
+%
+By examining the code, you can easily tell that, this time, the footer will be
+aligned against the right margin (\verb|\raggedleft|) and set in \verb|\tiny|
+type---which is what the text itself says, after all. But what does the
+\verb|\ruleacrossheadorfoot| command do? Well, it simply draws a horizontal
+rule, which\ldots\ yes, extends across the whole footer. You could use one of
+the standard commands for producing rules, here (\LaTeX's \verb|\rule|, plain
+\TeX's \verb|\hrule|), but this one has been specifically crafted for use inside
+the two abovementioned environments; it consumes no vertical space, and does not
+alter the distance (\verb|\baselinekip|) between the baselines of adjacent lines
+of text. Moreover, it can take optional arguments to modify its appearance, as
+we shall see \hyperref[P:FinePoints]{in a minute}.
+
+You can try out this example by yourself (I~advise you to do so), but for your
+convenience the output it typesets is reproduced in a separate letter that you
+find enclosed with this one, just after it in this same file. If you have a
+look at the result, you will be glad to note that the thin sign that the
+\env{foldedletterhead} environment is supposed to draw along the right edge of
+the sheet, to mark the exact point where it should be folded, is drawn also when
+the original letterhead is replaced by yours. This is just fine (but see also
+Paragraph~\ref{P:FinePoints}).
+
+
+
+\paragraph{A deeper look}
+\label{P:Deeper}
+
+As you, certainly, have already guessed, the two environments introduced
+\hyperref[P:LetterHeadImpatient]{above} simply save their contents into a box;
+the \oclh\ option causes these two boxes to be used in place of the header and
+the footer, respectively, that had been originally defined by the \lcdp\
+document class. More precisely, when the \oclh\ option is in force, a copy of
+those boxes is centered, with first-order infinite glue, in the header (resp.,
+in the footer) line, pretending that they have zero height and depth, with the
+bottom (resp., top) margin of the box defined by \eclh\ (resp., \eclf) aligned
+along the baseline of the header (resp., of the footer) line of the page. Note
+that the \cdpa\ package defines the \eclh\ and \eclf\ environments, and their
+associated storage boxes, even if you do \emph{not} specify the \oclh\ option:
+this option simply dictates whether or not those two boxes should be \emph{used}
+for the letterhead. This is good, since it means that the presence or absence
+of the \oclh\ option will not affect the \emph{syntax} of your document, but
+only the appearance of the typeset output, which is how options should behave.
+
+
+
+\paragraph{The letterhead is defined locally}
+\label{P:Local}
+
+As we indicated in Paragraph~\ref{P:LetterHeadImpatient}, the output produced by
+Listing~\ref{lis:customletter} is shown in a separate letter enclosed after this
+one; you may be wondering how did I~manage to produce two (actually, several)
+letters with different letterheads in a single \LaTeX\ run (yes, it \emph{was} a
+single run). Well, I~am the author of the package, and I~could have played some
+nasty trick; but actually I~didn't need to, because the \eclh\ and \eclf\
+environments save their contents in their associated storage boxes
+\emph{locally}. This means that if they are postioned \emph{within} the
+environment that produces a certain letter (say, \emph{e.g.},
+\env{foldedletterhead}), the header and the footer will be changed \emph{only}
+for that letter; for subsequent ones, the former header and footer will be
+reinstated. Of course, the redefinitions must occur before the \verb|\opening|
+command (or anything else that typesets text).
+
+%%%%
+\begin{listing}[tbp]
+ \cleantop
+\begin{verbatim}
+\begin{foldedletterhead}[Someone Else]{
+ To Someone Else\\
+ Some other place\\
+ Some other city
+}[
+ Another letterhead.
+]
+
+\begin{customletterhead}{\textwidth}
+ \raggedright \Huge
+ A different head
+\end{customletterhead}
+\begin{customletterfoot}{\textwidth}
+ \centering
+ \ruleacrossheadorfoot
+ A different foot
+\end{customletterfoot}
+
+\opening{Dear Someone,}
+
+\lipsum[1-2]
+
+\closing{Best regards.}
+
+\end{foldedletterhead}
+\end{verbatim}
+ \caption{How to customize the letterhead for a single letter}
+ \label{lis:customletterlocal}
+ \cleanbot
+\end{listing}
+%%%%
+
+This point is further illustrated in listing~\ref{lis:customletterlocal}, which
+shows how to customize the letterhead for just a single letter. This code has
+been copied and then pasted toward the end of this file, to show, in a third,
+independent letter, the output it produces. Actually, for this I~\emph{did}
+have to play some tricks not included in the code of the listing, in order to
+``decolor'' the thin sign that marks the point where the sheet is to be folded,
+and to reset the value of the \verb|\longindentation| parameter; but both these
+changes can be made ``locally'' too. There is a slight complication deriving
+from the fact that, in order for a change to \verb|\longindentation| to turn
+effective in a given ``letter-making'' environment, the change must occur
+\emph{outside} the ``letter-making'' environment itself: this forced me to
+supply an additional level of grouping.
+
+
+
+\paragraph{Your own classes for your own letterhead}
+\label{P:Classes}
+
+If you know \LaTeX\ well, there will probably be one last point that still
+bothers you. We said, in Paragraph~\ref{P:LetterHeadImpatient}, that the \eclh\
+and \eclf\ environments can very well be embedded in the preamble, without
+causing any trouble: how come the typesetting that occurs inside these
+environments does not trigger the ``Missing \verb|\begin{document}|'' error?
+The answer is simply that these two environments have been specifically made
+exempt from this error, precisely in order to permit you to include them in the
+preamble too; and this, in turn, has been done because the concept of
+``preamble'' also covers the code included in custom classes that you write
+yourself.
+
+This means that you can write your own custom classes that produce your own
+custom letterhead, which is nice.~\facesmile\space We use the plural, because
+you will surely want to define customized versions of \emph{both} the \lcdp\
+class \emph{and} the \acdp\ class; the best way to do so is to write three
+distinct files, as we are now going to explain.
+
+%%%%
+\begin{listing}[p]
+ \cleantop
+\begin{verbatim}
+\NeedsTeXFormat{LaTeX2e} % LaTeX2e is required!
+\ProvidesClass{myletter}
+ [2015/02/08 v0.01 (development)]
+\DeclareOption*{\PassOptionsToClass{\CurrentOption}{letteracdp}}
+\ProcessOptions\relax
+\LoadClass{letteracdp}[2015/01/20]
+\input{mylogo.def}
+\endinput
+\end{verbatim}
+ \caption{Contents of the\/ \filedir{myletter.cls} file}
+ \label{lis:myletter}
+\end{listing}
+%%%%
+
+%%%%
+\begin{listing}[p]
+\begin{verbatim}
+\NeedsTeXFormat{LaTeX2e} % LaTeX2e is required!
+\ProvidesClass{myarticletter}
+ [2015/02/08 v0.01 (development)]
+\DeclareOption*{\PassOptionsToClass{\CurrentOption}{articoletteracdp}}
+\ProcessOptions\relax
+\LoadClass{articoletteracdp}[2015/01/20]
+\input{mylogo.def}
+\endinput
+\end{verbatim}
+ \caption{Contents of the\/ \filedir{myarticletter.cls} file}
+ \label{lis:myarticletter}
+\end{listing}
+%%%%
+
+%%%%
+\begin{listing}[p]
+ \cleantop
+\begin{verbatim}
+\ProvidesFile{mylogo.def}[2015/02/08 v0.01 (development)]
+
+\RequirePackage[customletterhead]{cdpaddon}[2015/01/21]
+
+\begin{customletterhead}{\textwidth}
+ \centering \Huge
+ My Huge Centered Letterhead
+\end{customletterhead}
+\begin{customletterfoot}{\textwidth}
+ \raggedleft \tiny
+ \ruleacrossheadorfoot
+ My (almost unreadable) small print\\
+ flushed against the right margin.
+\end{customletterfoot}
+
+\endinput
+\end{verbatim}
+ \caption{Contents of the\/ \filedir{mylogo.def} file}
+ \label{lis:mylogo}
+ \cleanbotp
+\end{listing}
+%%%%
+
+So, let us suppose that you want to define two custom classes, named
+\packlass{myletter} and \packlass{myarticletter}, respectively, that both
+produce the same letterhead as the one we saw in listing~\ref{lis:customletter}.
+For this, you write three files called \filedir{myletter.cls},
+\filedir{myarticletter.cls}, and \filedir{mylogo.def}, whose contents are
+reproduced in listings \ref{lis:myletter}, \ref{lis:myarticletter},
+and~\ref{lis:mylogo}, respectively. As you can see, the purpose of
+\filedir{myletter.cls}\slash\filedir{myarticletter.cls} is just to supply ``glue
+code'' toward (the \lcdp\slash\acdp\ classes and) the \filedir{mylogo.def} file,
+which is the single place where the redefinition of the letterhead occurs.
+
+%%%%
+\begin{listing}[tbp]
+ \cleantop
+\begin{verbatim}
+\ProvidesFile{mylogo.def}[2015/02/08 v0.01 (development)]
+
+\RequirePackage[customletterhead]{cdpaddon}[2015/01/21]
+\RequirePackage{color}
+
+\DeclareFontFamily{T1}{my@calli}{}
+\DeclareFontShape{T1}{my@calli}{m}{n}{<->s*[1.44]callig15}{}
+
+\definecolor{my@lh@color}{rgb}{0,.4,.4}
+
+\begin{customletterhead}{\textwidth}
+ \color{my@lh@color}
+ \fontsize{17}{21}\usefont{T1}{my@calli}{m}{n}
+ \leftline{%
+ \setlength{\unitlength}{1cm}%
+ \begin{picture}(0,0) % you can use \includegraphics instead
+ \put(-2,0){\framebox(1.8,1.2){%
+ \normalsize\ttfamily My Logo%
+ }}
+ \end{picture}%
+ My Company'\,s Letterhead\enspace
+ \hrulefill\hspace{-2cm}%
+ }
+\end{customletterhead}
+
+\settowidth{\longindentation}{%
+ \fontsize{17}{21}\usefont{T1}{my@calli}{m}{n}%
+ My Company'\,s Letterhead\enspace
+}
+
+\begin{customletterfoot}{\textwidth}
+ \color{my@lh@color}
+ \fontsize{5}{6}\usefont{T1}{pplx}{m}{n}
+ \raggedleft
+ \ruleacrossheadorfoot[-2cm]
+ My (almost unreadable) \textsc{small print},\\
+ aligned along the \textit{right} edge\\
+ of the main text.
+\end{customletterfoot}
+
+\renewcommand*{\foldingtagrule}{%
+ \color{my@lh@color}\CDPFactoryFoldingTagRule
+}
+
+\endinput
+\end{verbatim}
+ \caption{Contents of a more elaborated\/ \filedir{mylogo.def} file}
+ \label{lis:mylogo-more}
+ \cleanbotp
+\end{listing}
+%%%%
+
+Listing~\ref{lis:mylogo-more} shows a more elaborate example of a
+\filedir{mylogo.def} file to go together with the same two class files shown in
+listings~\ref{lis:myletter} and~\ref{lis:myarticletter}. Here we have added a
+touch of superior style not only by employing color and some fancy fonts, but
+also by having recourse to the fine adjustments described in
+\hyperref[P:FinePoints]{the next paragraph} (because of the fonts, this example
+might not work on all \TeX\ installations). The letterhead defined by this
+example is exactly the same as the one this letter itself bears on its first
+page.
+
+
+
+\paragraph{Fine points of style}
+\label{P:FinePoints}
+
+The first fine point of style that should be noted in
+listing~\ref{lis:mylogo-more} is that the \verb|\longindentation| rigid length
+is set equal to the width of the writing of the letterhead (``My Company's
+Letterhead''). Since the ``letter-making'' environments indent the address of
+the addressee precisely by the amount of \verb|\longindentation|, this will
+cause such addresses to be neatly aligned with a visually relevant element of
+the design of the letterhead (the rule on the right); you should do the same
+with your own letterhead, if it contains a similarly relevant component. If you
+do not yourself assign it a value, \verb|\longindentation| is set to half the
+value of \verb|\textwidth|.
+
+The second fine point to note is that the sign that marks the fold is drawn in
+the same color as the rest of the letterhead. The \Bundle\ computes the
+vertical position of this sign, but to actually draw it, it calls the
+\verb|\foldingtagrule| command, which the end user can redefine. This command
+works similarly to \verb|\footnoterule|, and, like the latter, should take up no
+vertical space. Its ``factory'' definition is backed up in the
+\verb|\CDPFactoryFoldingTagRule| command (which should \emph{never} be
+redefined, of course); as you can see, in listing~\ref{lis:mylogo-more} we
+redefine \verb|\foldingtagrule| to simply invoke the factory default after
+setting the appropriate color.
+
+The third, and last, point to note is that the \verb|\ruleacrossheadorfoot|
+command can get an optional argument in which an inset from the text margins can
+be specified; a \emph{negative} inset, like here, causes the rule to protrude
+into the margins. A second optional argument let you indicate different insets
+for the left and the right margin, in this order. Note that these arguments
+\emph{must} contain \emph{rigid} lengths.
+
+
+
+\section{Other languages besides Italian}
+\label{S:Languages}
+
+Like many other document classes and packages, the classes of the \Bundle\ mark
+up some portions of the output they produce by adding certain descriptive
+strings, that, by default, are written in Italian. For example, when you have
+requested the \sty{headings} page style, the name of the addressee, which is
+printed atop pages, is preceded by the string ``\emph{A:}'' (=~``To:'');
+similarly, when you issue the command \verb|\tableofcontents| in a documents
+that adopts the \acdp\ document class, the table it produces is titled
+``\emph{Sommario}'' (=~``Contents''); and so on.
+
+When the \Bundle\ was used only by the members of the \emph{Coordinamento}, the
+Italian defaults it provided for those captions were, of course, quite adequate;
+as long as its use remained confined to the Italian \LaTeX\ community, they were
+still acceptable; but now, questions about how to adapt the \Bundle\ to foreign
+languages have begun to be asked in some Internet forums by users around the
+world, pushing me to reconsider the matter.
+
+Of course, the Italian captions are not (nor they have ever been) ``hard-wired''
+in the code: they are defined by macros that follow the usual naming conventions
+(\verb|\headtoname|, \verb|\contentsname|, and so on). Thus, it's only a matter
+of redefining these ``hooks'' to suit the target language. However, it would be
+desirable to have some standard definitions set for each language; but
+unfortunately, this cannot be attained just by loading the \babel\ package, for
+two reasons. In the first place, there are some captions that are specific to
+the \Bundle\ and are therefore not cared for by the \babel\ package: for
+example, the (optional) subject of a letter is preceded by the expansion of
+\verb|\subjectname| (which is ``\emph{Oggetto:}'' in Italian and should be
+``Subject:'' in English), a hook the \babel\ package knows nothing about.
+Secondarily, even for those hooks that are standard, sometimes the definition
+provided by the \babel\ package seems (at least to me) not adequate for a
+letter; in particular, alas, if you load \babel\ with the \opz{italian} option
+(as you ordinarily do when you are writing in Italian), it actually
+\emph{cancels} the definitions preset by the \Bundle, substituting for them
+strings that I~deem more suitable for articles or books, for which they are
+indeed intended, than for letters (for example, \( \verb|\contentsname| \to
+\mbox{``\emph{Indice}''} \) in \babel, instead of \( \verb|\contentsname| \to
+\mbox{``\emph{Sommario}''} \), as defined by the \Bundle; \( \verb|\refname| \to
+\mbox{``\emph{Riferimenti bibliografici}''} \) in \babel, instead of \(
+\verb|\refname| \to \mbox{``\emph{Testi citati}''} \), as I~prefer).
+
+To supply a \emph{provisional} solution to this problem, a new component has
+been added to the \Bundle: the \cdpbabel\ package. The idea is that, when using
+one of the document classes of the \Bundle, you load the \cdpbabel\ package
+\emph{instead of} \babel, and let the former load the latter on your behalf; in
+this way, you offer it a chance to augment, or amend, the definitions made by
+\babel\ itself. This solution might seem inelegant (and admittedly it is), but
+the problem is more subtle than it may look at first sight, involving also
+compatibility issues with existing documents, and I~need to further investigate
+it. It is hoped that a more satisfactory scheme will be found for future
+releases.
+
+In practice, all the \cdpbabel\ package has to do is (to load \babel\ and) to
+issue an \verb|\addto{\captions|\meta{language}\verb|}{|\ldots\verb|}| command
+(or better, one such command for each required \meta{language}), with ``\ldots''
+replaced by the appropriate redefinitions; the list, and the details, of such
+redefintions are of course dictated by \meta{language}, so \cdpbabel\ takes them
+from what we will call a ``C.D.P. language definition file''. This is a text
+file that, by convention, must be named
+\filedir{cdpnames}\meta{language}\filedir{.ldf}, where \meta{language} is the
+name of the corresponding language option (for example,
+%
+\begin{verbatim}
+ \usepackage[english,italian]{cdpbabel}
+\end{verbatim}
+%
+invokes both \filedir{cdpnamesenglish.ldf} and \filedir{cdpnamesitalian.ldf}, in
+this order), and which must adhere to the format shown in
+listing~\ref{lis:cdpnames}.
+
+%%%%
+\begin{listing}[tbp]
+ \cleantop
+ \zerolistvertspaces
+ \begin{flushleft}
+ \verb|\ProvidesFile{cdpnames|\meta{language}\verb|.ldf}[|%
+ \meta{date \& version}\verb|]|
+ \end{flushleft}
+\begin{verbatim}
+
+\def\@cdpbabel@letter@names{%
+\end{verbatim}
+ \begin{flushleft}
+ \verb| \def\subjectname {|\meta{Subject:}\verb|}%|\\
+ \verb| \def\registeredname {|\meta{Registered}\verb|}%|\\
+ \verb| \def\registeredRRname {|\meta{Registered R.R.}\verb|}%|\\
+ \verb| \def\andccname {|\meta{cc (in addresses)}\verb|}%|\\
+ \verb| \def\ccname {|\meta{cc (at end of letters)}\verb|}%|\\
+ \verb| \def\enclname {|\meta{Encl:}\verb|}%|\\
+ \verb| \def\PSname {|\meta{P.S.:}\verb|}%|\\
+ \verb| \def\headtoname {|\meta{To:}\verb|}%|\\
+ \verb| \def\lettername {|\meta{Letter}\verb|}%|
+ \end{flushleft}
+\begin{verbatim}
+ % More captions could be added in the future.
+}
+\def\@cdpbabel@artlet@names{%
+\end{verbatim}
+ \begin{flushleft}
+ \verb| \def\contentsname {|\meta{Contents}\verb|}%|\\
+ \verb| \def\listfigurename {|\meta{List of figures}\verb|}%|\\
+ \verb| \def\listtablename {|\meta{List of tables}\verb|}%|\\
+ \verb| \def\refname {|\meta{References}\verb|}%|\\
+ \verb| \def\indexname {|\meta{Index}\verb|}%|\\
+ \verb| \def\figurename {|\meta{Figure}\verb|}%|\\
+ \verb| \def\tablename {|\meta{Table}\verb|}%|\\
+ \end{flushleft}
+\begin{verbatim}
+ % More captions could be added in the future.
+}
+
+\endinput
+\end{verbatim}
+ \caption{Contents of a
+ \filedir{cdpnames}\protect\meta{language}\filedir{.ldf} file}
+ \label{lis:cdpnames}
+ \cleanbot
+\end{listing}
+%%%%
+
+As you can see, a ``C.D.P. language definition file'' must define two macros,
+named \verb|\@cdpbabel@letter@names| and \verb|\@cdpbabel@artlet@names|,
+respectively: in the first you put the redefinitions that should be added to
+\verb|\captions|\meta{language} when only the \lcdp\ class has been loaded; in
+the second you list the additional redefinitions that apply if the \acdp\ class
+is loaded too; and that's all. Listing~\ref{lis:cdpnames} details exactly what
+hooks need to be redefined when switching to another language; in principle, you
+must supply a suitable redefinition for each of them, but of course, when a hook
+is already defined by the \babel\ package in a way that you think suits, you may
+omit it from your list (or, perhaps better, comment it out).
+
+At present, the \Bundle\ ships with \emph{just two} such definition files
+included: they are \filedir{cdpnamesitalian.ldf}, for Italian, and
+\filedir{cdpnamesenglish.ldf}, for English. For all other languages, you'll
+have to write and install appropriate files yourself. Needless to say, you are
+most welcome if, after doing so, you want to contribute your work for inclusion
+in future releases of the \Bundle. Look at these two provided files, and in
+particular at \filedir{cdpnamesenglish.ldf}, for inspiration about the intended
+meaning of the captions (which sould be quite obvious, however).
+
+
+
+\section{The new \opz{signaturerule} option}
+\label{S:Options}
+
+Some users have asked for a means to add a thin rule in signatures, just above
+the signer's name, to mark the place when the handwritten signature should be
+put. Although, in my opinion, such usage is highly questionable (only pupils in
+primary school need rules to guide their writing!\@), nevertheless it has now
+been supported. You request this behavior by passing the new
+\opz{signaturerule} option to the \lcdp\ document class. Indeed, the decision
+whether to draw the rule or not is a matter of style and, as such, should be
+made, once for all, for the whole document.
+
+Even if you do specify the \opz{signaturerule} option, the rule will \emph{not}
+be drawn inside a \env{signatureenv*} environment, because this environment is
+meant exactly to be used when you are not going to sign the letter by hand.
+This applies also to the \mbox{$*$-form} of the \verb|\closing| and of the
+\verb|\makesignature| commands, which are used for the same purpose and which
+invoke, directly or indirectly, precisely the \env{signatureenv*} environment.
+
+To produce the rule, the \lcdp\ class calls the \verb|\signaturerule| command,
+which you can customize, if you want to, to suit your needs. This command is
+called in \LaTeX's ``LR~mode'' (or, to be more precise, in \TeX's ``restricted
+horizontal mode''), and it should construct a horizontal box containing the
+rule, aligned along the baseline of the box itself; for example,
+%
+\begin{verbatim}
+ \renewcommand*{\signaturerule}{%
+ \makebox[5cm]{\hrulefill}
+ }
+\end{verbatim}
+%
+could be a typical (re)definition. The default definition of
+\verb|\signaturerule| is actually like this one, except that it draws a thinner
+rule, and that it allows you to specify the horizontal length of the rule
+(\emph{i.e.}, its width). Specifically, the \verb|\signaturerulewidth|
+parameter, which is a rigid length, indicates the width of the rule produced by
+the default definition of \verb|\signaturerule|. Should you ever redefine the
+latter, you should honor this parameter in your redefinition, \emph{e.g.},
+%
+\begin{verbatim}
+ \renewcommand*{\signaturerule}{%
+ \makebox[\signaturerulewidth]{\hrulefill}
+ }
+\end{verbatim}
+%
+But I~think you will hardly need this: most users will content themselves with
+changing the width of the rule.
+
+For completeness' sake, the \opz{nosignaturerule} option is defined too: it is
+the default, and it does not draw the rule.
+
+
+
+\section{Aesthetic adjustments}
+\label{S:Adjustments}
+
+The \verb|\cc| and \verb|\encl| command have been reimplemented in such a way to
+include the ``correct'' interline glue above and below their output. Remember
+that the output produced by these command is kept on the same page as the
+signature; this means, in particular, that the \verb|\encl| command should be
+used only for very short lists of enclosures (one item or two). For longer
+lists, utilize the \env{enclosures} environment, which mildly encourages a page
+break above itself.
+
+
+
+\section{A sample letter}
+\label{S:Sample}
+
+Listing~\ref{lis:sample} shows a sample input file that illustrates the features
+covered in this letter: it uses the \packlass{myletter} sample class defined in
+Paragraph~\ref{P:Classes}, with the letterhead drawn by the ``more elaborate''
+version of the \filedir{mylogo.def} file that is reproduced in
+listing~\ref{lis:mylogo-more}, the \opz{signaturerule} option described in
+Section~\ref{S:Options}, and the \verb|\encl| command touched upon in
+Section~\ref{S:Adjustments}. As before, the output produced by this example is
+shown in a separate letter at the end of this file.
+
+%%%%
+\begin{listing}[tbp]
+ \cleantop
+\begin{verbatim}
+\documentclass
+ [twoside,boldsubject,italicsignature,shortindent,signaturerule]
+ {myletter}
+\usepackage[T1]{fontenc}
+\usepackage[english]{cdpbabel}
+\usepackage{url,lipsum}
+
+\name{Michael Youngster Name}
+\address{
+ Mike Y. \textsc{Name}\\
+ Sails Manager\\
+ \protect\url{m.y.name@my.company.com}
+}
+\signature{Mike Y. Name\\Sails Manager}
+\date{February~8, 2015}
+\place{Mamina del Rey}
+
+\hfuzz = 0pt
+\vfuzz = 0pt
+
+
+
+\begin{document}
+
+\begin{foldedletterhead}[R.~J.~Drofnats]{
+ Revinu~J. \textsc{Drofnats}\\
+ Department of Farm Ecology\\
+ University of St.\,Anford\\
+ Haga Alto, CA~94321
+}[
+ Our new sails.
+]
+
+\opening{Dear affectionate customer:}
+
+we are delighted to have the opportunity of presenting our new
+collection of sails for the incoming yachting season\ldots
+
+\lipsum[1-2]
+
+\closing{Sincerely,}
+
+\encl{2015 Catalogue\\Invitation card}
+
+\end{foldedletterhead}
+
+\end{document}
+\end{verbatim}
+ \caption{A sample input file that uses the new features}
+ \label{lis:sample}
+ \cleanbotp
+\end{listing}
+%%%%
+
+
+
+\epilogue
+
+That, more or less, is all we had to say about version~0.36 of the \Bundle. For
+further information, write to the author: his e-mail address is on the first
+page.
+
+\closing*{Best regards.}
+
+\end{letterhead}
+
+
+
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% %
+% Letter no. 2 %
+% %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begingroup
+
+\begin{customletterhead}{\textwidth}
+ \centering \Huge
+ My Huge Centered Letterhead
+\end{customletterhead}
+\begin{customletterfoot}{\textwidth}
+ \raggedleft \tiny
+ \ruleacrossheadorfoot
+ My (almost unreadable) small print\\
+ flushed against the right margin.
+\end{customletterfoot}
+\setlength\longindentation{.5\textwidth}
+\let \foldingtagrule = \CDPFactoryFoldingTagRule
+
+\begin{foldedletterhead}[Whom it may concern]
+ {To whom it may concern}
+ [My own letterhead, at last!]
+
+\makepresentation
+\maketopdate\relax
+
+\lipsum[1-2]
+
+\makesignature
+
+\end{foldedletterhead}
+
+
+
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% %
+% Letter no. 3 %
+% %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{foldedletterhead}[Someone Else]{
+ To Someone Else\\
+ Some other place\\
+ Some other city
+}[
+ Another letterhead.
+]
+
+\begin{customletterhead}{\textwidth}
+ \raggedright \Huge
+ A different head
+\end{customletterhead}
+\begin{customletterfoot}{\textwidth}
+ \centering
+ \ruleacrossheadorfoot
+ A different foot
+\end{customletterfoot}
+
+\opening{Dear Someone,}
+
+\lipsum[1-2]
+
+\closing{Best regards.}
+
+\end{foldedletterhead}
+
+\endgroup
+
+
+
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% %
+% Letter no. 3 %
+% %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{foldedletterhead}[R.~J.~Drofnats]{
+ Revinu~J. \textsc{Drofnats}\\
+ Department of Farm Ecology\\
+ University of St.\,Anford\\
+ Haga Alto, CA~94321
+}[
+ Our new sails.
+]
+
+\name{Michael Youngster Name}
+\address{
+ Mike Y. \textsc{Name}\\
+ Sails Manager\\
+ \protect\url{m.y.name@my.company.com}
+}
+\signature{Mike Y. Name\\Sails Manager}
+\date{February~8, 2015}
+\place{Mamina del Rey}
+
+\opening{Dear affectionate customer:}
+
+we are delighted to have the opportunity of presenting our new collection of
+sails for the incoming yachting season\ldots
+
+\lipsum[1-2]
+
+\closing{Sincerely,}
+
+\encl{2015 Catalogue\\Invitation card}
+
+\end{foldedletterhead}
+
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/cdpbundl/cdpbundl-doc.pdf b/Master/texmf-dist/doc/latex/cdpbundl/cdpbundl-doc.pdf
new file mode 100644
index 00000000000..675f29c8349
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/cdpbundl/cdpbundl-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/cdpbundl/manifest.txt b/Master/texmf-dist/doc/latex/cdpbundl/manifest.txt
index 4c63e5af5c7..7d5ab51e67b 100644
--- a/Master/texmf-dist/doc/latex/cdpbundl/manifest.txt
+++ b/Master/texmf-dist/doc/latex/cdpbundl/manifest.txt
@@ -3,7 +3,8 @@ This is file `manifest.txt'.
This file is part of a work named "C.D.P. Bundle".
-Copyright (C) 1999-2006 by Gustavo MEZZETTI <mezzetti@math.unipd.it>.
+Copyright (C) 1999-2015 by Gustavo MEZZETTI
+ <gustavo.mezzetti@istruzione.it>.
The C.D.P. Bundle may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3
@@ -11,7 +12,7 @@ of this license or (at your option) any later version.
The latest version of this license is in
http://www.latex-project.org/lppl.txt
and version 1.3 or later is part of all distributions of LaTeX
-version 2003/12/01 or later.
+version 2005/12/01 or later.
The C.D.P. Bundle has the LPPL maintenance status
"author-maintained".
@@ -21,7 +22,7 @@ precisely, it explains how the locutions "Work" and "Compiled Work",
used in the LaTeX Project Public License, are to be interpreted
in the case of this work.
-January 1, 2006 (vers. 0.34)
+February 8, 2015 (vers. 0.36)
@@ -52,29 +53,32 @@ a) the following 2 files that are also part of the "Work" (see above):
manifest.txt
AND
-b) the following 10 files:
+b) the following 11 files:
letteracdp.cls -- the letteracdp LaTeX document class
articoletteracdp.cls -- the articoletteracdp LaTeX document class
-adiseal.sty -- the adiseal LaTeX package
-lettcdpadi.cls -- the lettcdpadi LaTeX document class
cdpaddon.sty -- the cdpaddon LaTeX package
+cdpbabel.sty -- the cdpbabel LaTeX package
+cdpnamesenglish.ldf -- language-dependent definitions of the captions
+cdpnamesitalian.ldf /
cdpshues-example.def -- prototype color definition file
epson-stylus-740.def -- other example color definition files
hp-laserjet-4500.def /
cdpshues.cfg -- configuration file for the cdpaddon package
-cdpbundl.dvi -- documentation in DVI format
+cdpbundl.dvi -- full documentation in DVI format
-You may, at your option, substitute the file `cdpbundl.dvi' with the
-following one:
+You may, at your option, substitute the file `cdpbundl.dvi' with either
+one (or both) of the following two files:
-cdpbundl.pdf -- documentation in PDF format
+cdpbundl.pdf -- full documentation in PDF
+cdpbundl-doc.pdf -- overview of the C.D.P. Bundle (PDF)
-but at least one among the files `cdpbundl.dvi' and `cdpbundl.pdf' must be
-included in a "Compiled Work" that you want to distribute. The file
-`cdpbundl.pdf' is obtained by submitting to the program pdflatex the file
-`cdpbundl.dtx', following the same steps as those explained in
-`00readme.txt' under the title "How to generate the documentation".
+but at least one among the files `cdpbundl.dvi', `cdpbundl.pdf', and
+`cdpbundl-doc.pdf' must be included in a "Compiled Work" that you intend
+to distribute. The file `cdpbundl.pdf' is obtained by submitting to the
+program pdflatex the file `cdpbundl.dtx', following the same steps as
+those explained in `00readme.txt' under the title "How to generate the
+documentation".
@@ -82,12 +86,15 @@ ANCILLARY FILES
===============
The package of files distributed through the Comprehensive TeX Archive
-Network (CTAN) includes also the following two files:
+Network (CTAN) includes also the following five files:
-README -- guide to directory contents
-overview.pdf -- general information on the C.D.P. Bundle (PDF)
+README -- guide to directory contents
+cdpbundl-doc.pdf -- overview of the C.D.P. Bundle (PDF)
+cdp-ver-0-36.pdf -- instructions specific to version 0.36 (PDF)
+cdp-ver-0-36.tex -- LaTeX source of the preceding item
+Makefile -- Makefile to generate code and/or documentation
-These two files are included only for informative purposes and are _not_ a
+These five files are included only for convenience's sake and are _not_ a
required part of the C.D.P. Bundle (of course you may, if you wish, include
them in your distribution too).
diff --git a/Master/texmf-dist/doc/latex/cdpbundl/overview.pdf b/Master/texmf-dist/doc/latex/cdpbundl/overview.pdf
deleted file mode 100644
index 2d93205b58f..00000000000
--- a/Master/texmf-dist/doc/latex/cdpbundl/overview.pdf
+++ /dev/null
Binary files differ