summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/directory
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
committerKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
commit007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch)
tree90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/directory
parent950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff)
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/directory')
-rw-r--r--Master/texmf-dist/doc/latex/directory/README32
-rw-r--r--Master/texmf-dist/doc/latex/directory/directory.pdfbin0 -> 210349 bytes
-rw-r--r--Master/texmf-dist/doc/latex/directory/directory.tex689
3 files changed, 721 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/directory/README b/Master/texmf-dist/doc/latex/directory/README
new file mode 100644
index 00000000000..75fd0ac5fc6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/directory/README
@@ -0,0 +1,32 @@
+
+This is the 'directory 1.15' distribution.
+
+'directory' is a macro package for LaTeX and BibTeX that facilitates the
+construction, the maintenance and the exploitation of an address book like
+database.
+
+Files included:
+
+ README
+ address-html.bst
+ address.bst
+ birthday.bst
+ business.bib
+ directory.pdf
+ directory.ps
+ directory.sty
+ directory.tex
+ email-html.bst
+ email.bst
+ family.bib
+ letter.bst
+ phone.bst
+
+To rebuild the user's guide (directory.ps or directory.pdf), you must
+run LaTeX, run BibTeX and then run LaTeX twice on the file
+'directory.tex'.
+
+Enjoy!
+
+Christophe Geuzaine (Christophe.Geuzaine@advalvas.be)
+
diff --git a/Master/texmf-dist/doc/latex/directory/directory.pdf b/Master/texmf-dist/doc/latex/directory/directory.pdf
new file mode 100644
index 00000000000..77d2a1b8bee
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/directory/directory.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/directory/directory.tex b/Master/texmf-dist/doc/latex/directory/directory.tex
new file mode 100644
index 00000000000..c5a2fd5f96f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/directory/directory.tex
@@ -0,0 +1,689 @@
+%% directory.tex
+%% Copyright 1999-2000 Christophe Geuzaine
+%
+% Last Mod by Christophe on Sun Aug 27 21:04:05 2000
+%
+% This program can be redistributed and/or modified under the terms
+% of the LaTeX Project Public License distributed from CTAN
+% archives in directory macros/latex/base/lppl.txt; either
+% version 1 of the License, or (at your option) any later version.
+%
+% 'directory' user's guide and example file
+%
+% Christophe.Geuzaine@advalvas.be
+%
+% The parts you may want to customize are labeled with "CUSTOM"
+%
+% The lines beginning with %%tth: are used by TTH (TeX->HTML translator)
+%
+
+\documentclass[10pt]{article}
+\addtolength{\textheight}{6pt}
+
+% CUSTOM try e.g. \usepackage[split]{directory}
+\usepackage[split]{directory}
+
+% CUSTOM uncomment only one of these
+% \directorystyle{email-html}
+% \directorystyle{email}
+% \directorystyle{phone}
+% \directorystyle{birthday}
+% \directorystyle{letter}
+% \directorystyle{address-html}
+\directorystyle{address}
+
+% CUSTOM here is how I customized the directory for this document
+\renewcommand{\dirsymbol}{\raisebox{1ex}{\tiny\textit{(cf.\ section~\ref{dir})}}}
+\renewcommand{\Dirlabel}[1]{{#1}}
+\renewcommand{\Dirbirthday}[2]
+ {{\ifcase #2\or January\or February\or March\or April%
+ \or May\or June\or July\or August\or September%
+ \or October\or November\or December\fi}%
+ {\space\ifnum #1=1 1st\else\number#1\fi}}
+\renewcommand{\Dirbirthyear}[1]{, {#1}}
+\renewcommand{\Dirheader}[1]{\item\hspace{-\dirindent}\textbf{\MakeUppercase{#1}}}
+
+% CUSTOM here is how I handle pdf output
+\ifx\pdfoutput\undefined\else
+ \usepackage[colorlinks=true,urlcolor=blue]{hyperref}
+ \newcommand\MyURL{\begingroup\Url}
+ \renewcommand{\Diremail}[1]{\href{mailto:#1}{\MyURL{#1}}}
+ \renewcommand{\Dirurl}[1]{\href{#1}{\MyURL{#1}}}
+\fi
+
+% Some other definitions
+\newcommand{\BibTeX}{\textsc{Bib}\TeX}
+\newcommand{\TitleTT}[1]{\texttt{#1}}
+\newcommand{\Quote}[1]{`{#1}'}
+\newcommand{\DbleQuote}[1]{``{#1}''}
+\newcommand{\Download}{\footnote{\texttt{directory} is available at
+\url{http://www.geuz.org/directory/} or through the CTAN in the
+\url{biblio/bibtex/contrib/directory/}
+subdirectory. \texttt{directory} is distributed under the \LaTeX\ Project
+Public License (LPPL) since version 1.11.}}
+
+%%tth:\def\TitleTT#1{#1}
+%%tth:\def\Quote#1{'{#1}'}
+%%tth:\def\DbleQuote#1{''{#1}''}
+%%tth:\def\Download{\footnote{\texttt{directory} is distributed under the
+%%tth:\LaTeX\ Project Public License (LPPL) since version 1.11.}}
+
+\pagestyle{headings}
+
+\begin{document}
+
+%%tth:\special{html:<BODY TEXT="#000000" BGCOLOR="#ffffff">}
+
+\title{\TitleTT{directory} 1.15 User's Guide}
+
+% CUSTOM try \author{\wdir{c.geuzaine}} with \directorystyle{letter}
+\author{\dir{c.geuzaine}}
+
+%%tth:\special{html:<H3 align=center>Christophe Geuzaine</H3>}
+
+\date{August 27, 2000}
+
+\maketitle
+
+%%tth:\section*{Download}
+%%tth:The current archive of the package is available
+%%tth:\href{http://www.geuz.org/directory/directory-1.15.tar.gz}{here}.
+%%tth:The separate files are also available through the
+%%tth:\href{http://www.ctan.org/}{CTAN}
+%%tth:sites in the
+%%tth:\href{http://www.ctan.org/tex-archive/biblio/bibtex/contrib/directory/}
+%%tth:{biblio/bibtex/contrib/directory/}
+%%tth:subdirectory. Any questions, comments or suggestions? Send me an
+%%tth:\href{mailto:Christophe.Geuzaine@AdValvas.be}{e-mail}.
+
+\tableofcontents
+
+\section{Introduction}
+
+\texttt{directory}\Download\ is a macro package for \LaTeX\ and \BibTeX\ that
+facilitates the construction, the maintenance and the exploitation of an
+address book like database. It consists of five \BibTeX\ style files
+(\texttt{address.bst}, \texttt{phone.bst}, \texttt{email.bst},
+\texttt{birthday.bst} and \texttt{letter.bst}) designed to be used in
+conjunction with the \LaTeX\ style file \texttt{directory.sty}. According to
+the bibliographical style used, the package has two main applications:
+
+\begin{enumerate}
+\item
+the construction of a list of informations (address, phone number, etc.)
+about selected persons, companies or places;
+\item
+the inclusion of selected informations concerning a person, a place
+or a company at a desired location in a document.
+\end{enumerate}
+
+In the first case, \texttt{directory} behaves just like standard
+bibliographical styles: while standard bibliographical styles handle lists
+of information concerning books, articles, proceedings, etc.,
+\texttt{directory} handles lists of informations relative to people,
+companies or places. For example, the name in the title of this guide refers
+to the corresponding entry in the directory listed in section~\ref{dir}. The
+first four \BibTeX\ files permit several handlings of these informations.
+
+In the second case, the package enables bits of the database to be put in your
+document. It can for example be used to put the address of your correspondent
+in the address field of a letter.
+
+Two special \BibTeX\ style files (\texttt{address-html.bst} and
+\texttt{email-html.bst}) are also provided for an easy generation of
+HTML versions of your directories.
+
+\section{General description}
+
+\subsection{Package inclusion and options}
+
+The package is included by the usual \verb'\usepackage['\emph{options}\verb']{directory}'
+command at the top of the document, where \emph{options} stands for a
+combination of the following options:
+\begin{description}
+\item[\textmd{\texttt{split}:}]
+the directory entries are split on separate pages according to the first
+letter used in the sorting algorithm;
+\item[\textmd{\texttt{break}:}]
+the directory fields can be broken across pages.
+\end{description}
+The old (before version 1.10) formatting options are now handled by the same
+command mechanism as all other customization options (see
+section~\ref{sec:custom}).
+
+The directory is produced by the
+\verb'\directory['\emph{extension}\verb']{'\emph{filename}\verb'}' command,
+where \emph{filename} stands for the name of the \texttt{bib} file (without the
+\texttt{bib} extension) and where the optional argument \emph{extension}
+gives, if necessary, the extension of the file output by \BibTeX\ (see
+section~\ref{sec:usingboth}). As usual, multiple \texttt{bib} files can be
+included, a comma separating the different file names.
+
+\subsection{Making a citation}
+
+An entry is cited in the text by a \verb'\dir{'\emph{key}\verb'}',
+\verb'\pdir{'\emph{key}\verb'}', \verb'\rdir{'\emph{key}\verb'}' or
+\verb'\wdir{'\emph{key}\verb'}' command, equivalent to the standard
+\verb'\cite{'\emph{key}\verb'}' command, where \emph{key} is used in the same
+way as ever (referring to an entry in a \texttt{bib} file).
+The differences between the four citation commands will be explained in the next
+section.
+A \verb'\nodir{'\emph{key}\verb'}' command exists and acts exactly like
+\verb'\nocite{'\emph{key}\verb'}' for standard bibliographies.
+
+\subsection{The \texttt{bst} styles}
+
+The style of the directory is chosen by a \verb'\directorystyle{'\emph{style}\verb'}'
+command, where \emph{style} is one of the following:
+\begin{description}
+\item[\textmd{\texttt{address}:}]
+full listing in the directory of all fields corresponding to the
+\emph{key} entry. The \verb'\dir{'\emph{key}\verb'}' command also prints the
+\texttt{name} field of the entry in the document;
+\item[\textmd{\texttt{phone}:}]
+only the phone, cellular and fax fields corresponding to the cited entry are
+displayed in the directory. The \verb'\dir{'\emph{key}\verb'}' command acts in
+the same way as with the \texttt{address} style, except that the names are
+abbreviated;
+\item[\textmd{\texttt{email}:}]
+only e-mail addresses are displayed in the directory. The
+\verb'\dir{'\emph{key}\verb'}' command acts in the same way as with the
+\texttt{address} style;
+\item[\textmd{\texttt{birthday}:}]
+only the birthdays are displayed, sorting the entries in chronological
+order. The \verb'\dir{'\emph{key}\verb'}' command acts in the same way as with
+the \texttt{address} style;
+\item[\textmd{\texttt{letter}:}]
+acts in a slightly different way than the four preceding styles. No directory
+is produced with the \verb|\directory| command. The
+\verb'\dir{'\emph{key}\verb'}' command results in the \texttt{name} field of
+the \emph{key} entry to be printed in the document. The
+\verb'\pdir{'\emph{key}\verb'}' (respectively \verb'\rdir{'\emph{key}\verb'}'
+or \verb'\wdir{'\emph{key}\verb'}') command prints the name and the private
+(respectively residence or work) address in the document in a tabulated way.
+\end{description}
+
+
+\subsection{The \texttt{bib} file fields}
+
+In all entry types, \texttt{name} is the only mandatory field, since it
+serves as a key for sorting the entries.
+
+\begin{description}
+\item[\textmd{\texttt{person}:}] besides the \texttt{name},
+\texttt{nickname}, \texttt{birthday}, \texttt{birthyear} and \texttt{note}
+fields, the available fields for the \texttt{person} entry in a \texttt{bib}
+file are divided in three main categories. The first one (its associated
+keys begin with \Quote{\texttt{p.}}, which stands for \Quote{private})
+refers to the person's private information: \texttt{p.address},
+\texttt{p.phone}, \texttt{p.cellular}, \texttt{p.fax}, \texttt{p.email},
+\texttt{p.url} and \texttt{p.account}. The second one (for which all the
+keys begin with \Quote{\texttt{r.}}) refers to stuff relative to a person's
+residence (i.e.\ a secondary or temporary address, which is for example
+useful for students): \texttt{r.address}, \texttt{r.phone},
+\texttt{r.cellular}, \texttt{r.fax}, \texttt{r.email}, \texttt{r.url} and
+\texttt{r.account}. The last one (associated keys begin with
+\Quote{\texttt{w.}}, standing for \Quote{work}) refers to professional
+informations: \texttt{w.title}, \texttt{w.name}, \texttt{w.address},
+\texttt{w.phone}, \texttt{w.cellular}, \texttt{w.fax}, \texttt{w.email},
+\texttt{w.url} and \texttt{w.account}.
+\item[\textmd{\texttt{company}:}] the available fields for the
+\texttt{company} entry are: \texttt{name}, \texttt{address}, \texttt{phone},
+\texttt{cellular}, \texttt{fax}, \texttt{email}, \texttt{url},
+\texttt{account} and \texttt{note}.
+\item[\textmd{\texttt{place}:}] the available fields for the \texttt{place}
+entry are: \texttt{name}, \texttt{address}, \texttt{phone},
+\texttt{cellular}, \texttt{fax} and \texttt{note}.
+\end{description}
+
+
+\section{Customization}
+\label{sec:custom}
+
+\subsection{Dimensions}
+
+Three new dimensions defining the indentation of the fields (\verb'\dirindent'
+and \verb'\dirparindent') and the amount of space between two entries
+(\verb'\dirsep') have been introduced. The default values are:
+\begin{quote}
+\begin{verbatim}
+\setlength{\dirindent}{3em}
+\setlength{\dirparindent}{0em}
+\setlength{\dirsep}{3ex}
+\end{verbatim}
+\end{quote}
+
+If you want to explicitly introduce a new paragraph in a field, you
+should use the \verb'\dirbreak' command.
+
+\subsection{Flags and formats}
+
+Each field of a directory is easily customizable by redefining one of the
+commands summarized in the table at the end of this user's guide
+(page~\pageref{tab:commands}). For example, here is how the symbol produced
+in the text after a directory label and the formatting of the label itself are
+redefined in this document:
+\begin{quote}
+\begin{verbatim}
+\renewcommand{\dirsymbol}
+ {\raisebox{1ex}{\tiny\textit{(cf.\ section~\ref{dir})}}}
+\renewcommand{\Dirlabel}[1]{{#1}}
+\end{verbatim}
+\end{quote}
+
+A somewhat more complex example is the redefinition of the birthday format used
+in this document to produce a nice literal expression for dates:
+\begin{quote}
+\begin{verbatim}
+\renewcommand{\Dirbirthday}[2]
+ {{\ifcase #2\or January\or February\or March\or April%
+ \or May\or June\or July\or August\or September%
+ \or October\or November\or December\fi}%
+ {\space\ifnum #1=1 1st\else\number#1\fi}}
+\renewcommand{\Dirbirthyear}[1]{, {#1}}
+\end{verbatim}
+\end{quote}
+
+\subsection{More customization}
+
+When a field type multiply appears in an entry, the default settings assume the
+same formatting for each one. For example, there are three instances of a
+\texttt{phone} type field in a full \texttt{person} entry, i.e.\
+\texttt{p.phone}, \texttt{r.phone} and \texttt{w.phone}, and the
+\verb'\dirphone' and \verb'\Dirphone' customization commands apply to these
+three instances in the same way.
+
+To particularize the formatting of one of these instances, you can use
+special versions of the customization commands, constructed by inserting
+\texttt{p}, \texttt{r} or \texttt{w} after the \verb'\dir' or \verb'\Dir'
+prefix of the original commands. For example, to customize only the
+\texttt{phone} field in the work part, you should use \verb'\dirwphone' and
+\verb'\Dirwphone'.
+
+To change the formatting of names, you have to edit the \BibTeX\ style
+files. For example, the default name format ``Christophe von Geuzaine, Jr.''
+can be changed into ``von Geuzaine C., Jr.'' in your address books by replacing the line
+\begin{quote}
+\begin{verbatim}
+s nameptr "{ff }{vv }{ll}{, jj}" format.name$ 't :=
+\end{verbatim}
+\end{quote}
+in the file \texttt{address.bst} by the line
+\begin{quote}
+\begin{verbatim}
+s nameptr "{vv }{ll}{ f.}{, jj}" format.name$ 't :=
+\end{verbatim}
+\end{quote}
+
+
+\section{Using both \texttt{directory} and \texttt{bibliography}}
+\label{sec:usingboth}
+
+Since \BibTeX\ always produces an output file of the form
+\Quote{\emph{filename}\texttt{.bbl}}, it is necessary---in order to use \emph{both}
+directory and bibliography entries---, after generating the \texttt{bbl} file
+corresponding to the directory, to rename it with a new extension (for example
+\texttt{dir}), and to give this new extension as an optional argument to the
+\verb'\directory' command. The normal procedure can then be followed during the
+rest of the bibliography processing. Remember that changing the directory
+(adding an entry or suppressing one) forces you to restart from the beginning.
+
+\section{Generating directories with hypertext links}
+
+\subsection{Direct HTML output}
+
+Two special \BibTeX\ style files (\texttt{address-html} and
+\texttt{email-html}) allow the easy generation of HTML versions of
+your directories:
+
+\begin{description}
+\item[\textmd{\texttt{address-html}:}]
+full listing in the HTML directory of all fields corresponding to the
+\emph{key} entry. The output formatting is similar to that produced by \LaTeX\
+with the \texttt{address} style;
+\item[\textmd{\texttt{email-html}:}]
+only e-mail addresses are displayed in the HTML directory.
+\end{description}
+
+Since \BibTeX\ directly outputs a \texttt{bbl} file in HTML format, no
+additional program is needed to make the HTML conversion. The \texttt{bbl}
+file directly contains the HTML code, ready to be included in any HTML
+document.
+
+This method presents nevertheless a little drawback: after \BibTeX'ing your
+\LaTeX\ file, running \LaTeX\ on the same file (even with another non-HTML
+\verb|\directorystyle|) would produce errors, since the \texttt{bbl} file
+is not understandable by \LaTeX. You have either to delete the \texttt{bbl}
+file or to override the error messages (and to change the
+\verb|\directorystyle|) before any subsequent successful \LaTeX\ run.
+
+The handling of special characters in the HTML directories is also quite
+imperfect: any special \LaTeX\ character sequence is output the way it is in
+the \texttt{bib} file. This implies for example that \verb|{\'e}| is printed in
+the HTML document as \verb|{\'e}|, and not as \verb|&eacute;|.
+
+\subsection{Using the \texttt{hyperref} package}
+
+You can use the \texttt{hyperref} package along with \texttt{directory}. For
+example, adding the following lines in the preamble of your document and
+using \texttt{pdflatex} will produce a PDF version of your directory, with
+working links for the \verb'email' and \verb'url' fields.
+
+\begin{quote}
+\begin{verbatim}
+\ifx\pdfoutput\undefined\else
+ \usepackage{hyperref}
+ \newcommand\MyURL{\begingroup\Url}
+ \renewcommand{\Diremail}[1]{\href{mailto:#1}{\MyURL{#1}}}
+ \renewcommand{\Dirurl}[1]{\href{#1}{\MyURL{#1}}}
+\fi
+\end{verbatim}
+\end{quote}
+
+
+\section{Example}
+
+Despite the option described in section~\ref{sec:usingboth}, one of the most
+interesting way of using \texttt{directory} is to build a separate address
+book, including several \texttt{bib} files referring to several categories of
+people, companies or places, as in the example shown in this document:
+\begin{quote}
+\verb|\nodir{*}| \\
+\verb|\directory{family,business}|
+\end{quote}
+The use of the \texttt{split} option, along with the redefinition of the
+\verb'\Dirheader' command allows you to produce nicely formatted
+address booklets.
+
+A second interesting way of using \texttt{directory} is to use it in your faxes
+or letters. Using the standard \LaTeX\ class \texttt{letter.cls} with the
+directory style \texttt{letter}, you may for example begin a letter by the
+following command (\verb'\wdir' must be \texttt{protect}'ed since the argument
+of the \texttt{letter} environment is a moving argument):
+\begin{quote}
+\verb'\begin{letter}{\protect\wdir{c.geuzaine}}'
+\end{quote}
+
+Take a look at the example \texttt{tex} and \texttt{bib}
+files (\texttt{directory.tex}, \texttt{family.bib} and
+\texttt{business.bib}) and try the options out. The source files are
+commented and easy to customize. I would be very happy to get your suggestions
+to improve this package.
+
+\subsection{Source file}
+
+Here are four \texttt{bib} entries (taken from \texttt{family.bib} and
+\texttt{business.bib}):
+
+\begin{verbatim}
+@Person{c.geuzaine,
+ name = "Christophe Geuzaine",
+ birthday = "06 02",
+ birthyear = "1973",
+ p.email = "Christophe.Geuzaine@advalvas.be",
+ w.title = "Ir., Research Assistant",
+ w.name = "University of Li{\`e}ge,
+ Dept. of Electrical Engineering",
+ w.address = "Institut Montefiore (B28, P32, I21),\\
+ Sart Tilman Campus, B-4000 Li{\`e}ge, Belgium",
+ w.phone = "+32-(0)4-366.37.10",
+ w.fax = "+32-(0)4-366.29.10",
+ w.email = "Christophe.Geuzaine@ulg.ac.be",
+ w.url = "http://www.geuz.org/",
+}
+
+@Person{d.d.knu,
+ name = "Knudson, Daffy Duck and Bunny, Bugs and Pluto",
+ nickname = "gnat and gnu and pluto",
+ birthday = "10 02 and 05 11 and 01 01",
+ p.address = "Haight Street 512, 80214 Novosibirsk, Gnuland",
+ p.phone = "+01-(0)2-765.43.21",
+ p.cellular = "+01-(0)5-555.55.55",
+ p.account = "010-1234567-05",
+ r.address = "Manor Lane 2, 80214 Novosibirsk, Gnuland",
+ r.phone = "+01-(0)2-876.54.32",
+ w.name = "University of Novosibirsk,
+ Department of Octopus Parthenogenesis",
+ w.address = "Planck Institut (V1-V2, Park. U-67),
+ Hessenberg Road, 80214 Novosibirsk, Gnuland",
+}
+
+@Company{knudsoft,
+ name = "The Knudsoft Company",
+ email = "knud@knudsoft.com",
+ url = "http://knudsoft.com/hole/gates.htm",
+}
+
+@Place{knudsoft:rs.2,
+ name = "Knudsoft (RS.2 Computer Room)",
+ phone = "+01-(0)2-434.23.23",
+}
+\end{verbatim}
+
+\subsection{Output}
+\label{dir}
+
+The output resulting from the \verb'\directory{family,business}' command is
+shown below (all entries are listed, thanks to the \verb'\nodir{*}' command):
+
+% CUSTOM try e.g. citing just some of the entries
+\nodir{*}
+
+% CUSTOM this has the same effect: \directory[bbl]{family,business}
+\directory{family,business}
+
+%%tth:directory generated with \href{directory.html.address}{address-html.bst}
+%%tth:and with \href{directory.html.email}{email-html.bst}.
+
+\section{Contributors}
+
+Many thanks to Bernd Schandl, Robert Walker Sumner and Thomas Ruedas for their
+suggestions and corrections.
+
+\section{Versions}
+
+\begin{description}
+\item[0.95]
+First distributed version.
+\item[0.96]
+New documentation. Introduction of customization commands. New alignment
+mechanism in the \texttt{addressbook} and \texttt{phonebook} environments.
+\item[0.97]
+Entries \texttt{ccp} and \texttt{p.ccp} changed to \texttt{account} and
+\texttt{p.account}.
+\item[0.98]
+New style \texttt{letter.bst}. New commands \verb|\pdir|, \verb|\rdir| and
+\verb|\wdir| to produce in-text addresses when used with the
+\texttt{letter.bst} style. New internal key generation.
+\item[0.99]
+Name change of old customization flags (\verb'\'\emph{name}\verb'flag' becomes
+\verb'\dir'\emph{name}). New flags introduced: \verb|\dirnickname|, \verb|\dirphone|,
+\verb|\dirfax|, \verb|\diremail|, \verb|\dirurl|, \verb|\diraccount| and
+\verb|\dirand|.
+\item[1.00]
+New HTML styles (\texttt{address-html.bst} and \texttt{email-html.bst}).
+\item[1.01]
+Minor corrections.
+\item[1.10]
+Major rewriting of \texttt{bst} files (suppression of direct \LaTeX\
+formatting). Definition of new customization commands. New package global
+options to split directories across pages and allow page breaks inside
+directory fields. The \texttt{url.sty} package is now required.
+\item[1.11]
+Introduction of \verb'\dirparindent'.
+\item[1.12]
+Formatting commands can be particularized to each subfield by adding
+\texttt{p}, \texttt{r} or \texttt{w} after the \verb'\dir' or \verb'\Dir'
+prefix of the original customization command. Many simplifications and small
+corrections in the page breaking mechanism and in the list environments.
+\item[1.13]
+Fixed bug for long entries without blank spaces (e.g.\ in \texttt{url}
+fields).
+\item[1.14]
+More flexible definition of \verb|\Dirheader|.
+\item[1.15]
+Added fields for cellular phones (suggested by Stefano Ferrari). Added
+section explaining how to use \texttt{hyperref} to generate PDF documents
+with hyperlinks. Updated web site address.
+\end{description}
+
+
+\begin{table}[p]
+\caption{Summary of customization commands\label{tab:commands}}
+\begin{center}\small
+\begin{tabular}{@{}l@{\hspace{5pt}}c@{\hspace{5pt}}p{3.8cm}l@{}}
+\hline
+Command & Arg. & Explanation & Default \\
+\hline
+
+\verb'\dirsymbol' & 0 &
+\raggedright In-text symbol produced after a directory citation &
+\verb*'' \\
+
+\verb'\dirand' & 0 &
+\DbleQuote{anding} string &
+\verb*'and' \\
+
+\verb'\dirbirthday' & 0 &
+Birthday field flag &
+\verb*'$\star$~' \\
+
+\verb'\dirprivate' & 0 &
+Private field flag &
+\verb*'\emph{p}~' \\
+
+\verb'\dirresidence' & 0 &
+Residence field flag &
+\verb*'\emph{r}~' \\
+
+\verb'\dirwork' & 0 &
+Work field flag &
+\verb*'\emph{w}~' \\
+
+\verb'\dirnote' & 0 &
+Note field flag &
+\verb*'$\triangleright$~' \\
+
+\verb'\dirnickname' & 0 &
+Nickname field flag &
+\verb*'' \\
+
+\verb'\diraddress' & 0 &
+Address fields flag &
+\verb*'' \\
+
+\verb'\dirphone'$^*$ & 0 &
+Phone fields flag &
+\verb*'phn: ' \\
+
+\verb'\dircellular'$^*$ & 0 &
+Cellular phone fields flag &
+\verb*'gsm: ' \\
+
+\verb'\dirfax'$^*$ & 0 &
+Fax fields flag &
+\verb*'fax: ' \\
+
+\verb'\diremail'$^*$ & 0 &
+E-mail fields flag &
+\verb*'' \\
+
+\verb'\dirurl'$^*$ & 0 &
+Url fields flag &
+\verb*'' \\
+
+\verb'\diraccount'$^*$ & 0 &
+Account fields flag &
+\verb*'acc: ' \\
+
+\verb'\dirtitle' & 0 &
+Title field flag &
+\verb*'' \\
+
+\verb'\dirname' & 0 &
+Name field flag &
+\verb*'' \\
+
+\verb'\Dirlabel' & 1 &
+Label format &
+\verb*'{\textbf{#1}}' \\
+
+\verb'\Dirheader' & 1 & \raggedright Header format when &
+\verb'\newpage\markboth' \\
+&& the \texttt{split} option is &
+\verb' {\MakeUppercase{#1}}' \\
+&&\raggedright used$^\dag$ (the arg.\ is the first letter used in the
+sorting algorithm) &
+\verb' {\MakeUppercase{#1}}' \\
+
+\verb'\Dirbirthday' & 2 &
+\raggedright Birthday format (the first arg.\ is the day, the second
+is the month) &
+\verb*'{\number#1}/{\number#2}' \\
+
+\verb'\Dirbirthyear' & 1 &
+\raggedright Birth year format when a \texttt{birthday} field exists &
+\verb*'/{#1}' \\
+
+\verb'\DirbirthyearAlone' & 1 &
+\raggedright Birth year format when no \texttt{birthday} field exists &
+\verb*'{#1}' \\
+
+\verb'\Dirnickname' & 1 &
+Nickname format &
+\verb*'(aka {#1})' \\
+
+\verb'\Diraddress'$^*$ & 1 &
+Address format &
+\verb*'{#1}' \\
+
+\verb'\Dirphone'$^*$ & 1 &
+Phone format &
+\verb*'{#1}' \\
+
+\verb'\Dircellular'$^*$ & 1 &
+Cellular phone format &
+\verb*'{#1}' \\
+
+\verb'\Dirfax'$^*$ & 1 &
+Fax format &
+\verb*'{#1}' \\
+
+\verb'\Diremail'$^*$ & 1 &
+E-mail format &
+\verb*'\url{#1}' \\
+
+\verb'\Dirurl'$^*$ & 1 &
+Url format &
+\verb*'\url{#1}' \\
+
+\verb'\Diraccount'$^*$ & 1 &
+Account format &
+\verb*'\url{#1}' \\
+
+\verb'\Dirtitle' & 1 &
+Title format &
+\verb*'{#1}' \\
+
+\verb'\Dirname' & 1 &
+Name format &
+\verb*'{#1}' \\
+
+\verb'\Dirnote' & 1 &
+Note format &
+\verb*'{#1}' \\
+
+\hline
+\end{tabular}
+\end{center}
+\vspace{-5pt}\small
+$^*$\,The commands marked with an asterisk also exist
+in three other versions, controlling independently the private, residence and
+work parts (e.g.\ \verb'\dirphone' can be particularized to \verb'\dirpphone',
+\verb'\dirrphone' and \verb'\dirwphone').\\[3pt]
+$^\dag$\,and a coherent page style selected
+(e.g.\ \verb'\pagestyle{headings}').
+\end{table}
+
+\end{document}
+