summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/currvita
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-11 23:52:07 +0000
committerKarl Berry <karl@freefriends.org>2006-01-11 23:52:07 +0000
commita40339848d3f5b5ffd52e749f77fa50c0f968fe1 (patch)
tree345749d93690a43b3e40df7647dd18ba648ee1d7 /Master/texmf-dist/source/latex/currvita
parent47adfd73a60232c6f1dd3069425bbf491368ea21 (diff)
trunk/Master/texmf-dist/source/latex/currvita
git-svn-id: svn://tug.org/texlive/trunk@211 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/currvita')
-rw-r--r--Master/texmf-dist/source/latex/currvita/currvita.dtx1440
-rw-r--r--Master/texmf-dist/source/latex/currvita/currvita.ins54
2 files changed, 1494 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/currvita/currvita.dtx b/Master/texmf-dist/source/latex/currvita/currvita.dtx
new file mode 100644
index 00000000000..499d8126e23
--- /dev/null
+++ b/Master/texmf-dist/source/latex/currvita/currvita.dtx
@@ -0,0 +1,1440 @@
+% \iffalse
+%
+% currvita.dtx
+% Docstrip archive, run through LaTeX.
+%
+% Copyright (C) 1999 Axel Reichert
+% See the files README and COPYING.
+%
+% \fi
+%
+% \DeclareRobustCommand*{\env}[1]{\texttt{#1}}
+% \DeclareRobustCommand*{\file}[1]{\texttt{#1}}
+% \DeclareRobustCommand*{\flag}[1]{\texttt{#1}}
+% \DeclareRobustCommand*{\mail}[1]{\texttt{#1}}
+% \DeclareRobustCommand*{\option}[1]{\texttt{#1}}
+% \DeclareRobustCommand*{\package}[1]{\texttt{#1}}
+% \DeclareRobustCommand*{\person}[1]{\textsc{#1}}
+% \DeclareRobustCommand*{\source}[1]{\texttt{#1}}
+% \DeclareRobustCommand*{\winkey}{\texttt{(-;}}
+%
+% \changes{v0.9b}{1999-08-06}{First release}
+% \changes{v0.9i}{1999-09-13}{Final clean-up and new release}
+%
+% \CheckSum{235}
+%
+%% \CharacterTable
+%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%% Digits \0\1\2\3\4\5\6\7\8\9
+%% Exclamation \! Double quote \" Hash (number) \#
+%% Dollar \$ Percent \% Ampersand \&
+%% Acute accent \' Left paren \( Right paren \)
+%% Asterisk \* Plus \+ Comma \,
+%% Minus \- Point \. Solidus \/
+%% Colon \: Semicolon \; Less than \<
+%% Equals \= Greater than \> Question mark \?
+%% Commercial at \@ Left bracket \[ Backslash \\
+%% Right bracket \] Circumflex \^ Underscore \_
+%% Grave accent \` Left brace \{ Vertical bar \|
+%% Right brace \} Tilde \~}
+%
+% \title{\file{currvita.sty}}
+% \author{%
+% Axel Reichert \\
+% \mail{axel.reichert@gmx.de}%
+% }
+% \date{1999-09-13}
+% \maketitle
+% \begin{abstract}
+% \noindent
+% \file{currvita.sty} is a package for typesetting a curriculum
+% vitae. See the files~\file{README} and~\file{COPYING} for
+% additional information.
+% \end{abstract}
+%
+% \tableofcontents
+%
+%
+% \section{Introduction}
+%
+% Quite regularly in the \LaTeX{}~newsgroups someone is asking for
+% a package or document class to typeset a curriculum
+% vitae. Normally, the following answers are given:
+% \begin{itemize}
+% \item A curriculum vitae is highly individual and so you should
+% not rely on solutions provided by others but rather think about
+% it on your own and create it in \emph{your} style following
+% \emph{your} taste.
+% \item Use \file{vita.cls}.
+% \item Use \file{resume.sty}.
+% \item Use \file{tabularx.sty}.
+% \end{itemize}
+%
+% In my opinion all answers are unsatisfactory. To create an
+% ``individual style'' with \LaTeX{} is not at all easy, especially
+% if you consider the bunch of questions in the \LaTeX{}~newsgroups
+% about list and tabular environments, which seem to be the obvious
+% choice for the use within a curriculum vitae.
+%
+% The layout produced by~\file{vita.cls} is a little bit crowded,
+% the customization has to be done by class option files
+% (definitely not something for a beginner) and the documentation
+% is sparse.
+%
+% \file{resume.sty} is a totally out-dated (December~1989)
+% \LaTeX\,2.09 style file, in my opinion it gives a crowded layout
+% as well, the documentation can be found in the style file. Those
+% days did not have the neat system
+% of~\file{ins}/\file{dtx}~files.
+%
+% \file{tabularx.sty} is quite good, but to typeset a curriculum
+% vitae spanning more than one page\footnote{\person{David}, I know
+% that there is \file{ltxtable.sty}. Surely this great package was
+% once a hack of 5~minutes on a rainy Sunday like all your other
+% packages. \winkey}, interspersed with section-like headings and
+% various \cmd{\multicolumn}~commands is surely not an easy task.
+%
+% So I finally decided to write this package, replacing the macros
+% that I used earlier for my applications\footnote{Typeset
+% with~\file{longtable.sty} written (again) by~\person{David
+% Carlisle}.}. In fact, there was not much to replace, because
+% that time I made heavy use of~\cmd{\textbf}, \cmd{\large},
+% \cmd{\\} and other \LaTeX nically incorrect commands. \winkey
+%
+% I made it a package because a curriculum vitae can make sense not
+% only on its own, but also within a Ph.\,D.~thesis or a
+% letter. This package (hopefully) has few requirements,
+% (hopefully) produces a clearly arranged layout (also known as
+% puristic or plain and even explained in its own section later),
+% is (hopefully) well documented by this (hopefully) nice
+% \file{dvi}~file, (hopefully) easy to use and can (hopefully)
+% easily be customized. There is even a (hopefully) interesting
+% example file, my curriculum vitae, so you can see what sick
+% brains program (and even document) such packages. If you can
+% understand German. \winkey
+%
+%
+% \section{What You Need}
+%
+% \begin{enumerate}
+% \item \LaTeXe{} (at least the 1996/12/01~release)
+% \item The \package{ifthen}~package, part of the standard
+% \LaTeX{}~tools
+% \item The \package{babel}~package, nowadays a ``required'' part
+% of~\LaTeX, if you want to typeset the example file.
+% \end{enumerate}
+%
+%
+% \section{Loading}
+% \label{sec:loading}
+%
+% Load the package with:
+%\begin{verbatim}
+% \usepackage{currvita}
+%\end{verbatim}
+%
+% \DescribeMacro{LabelsAligned}
+% There are two package options that can be used to change the
+% \DescribeMacro{TextAligned}
+% vertical spacing of the curriculum vitae:\footnote{Credits go to
+% \person{Timm Wetzel} for inspiring me to implement this. He will
+% notice later that I did not follow his suggestion, though.
+% \winkey}
+%\begin{verbatim}
+% \usepackage[LabelsAligned]{currvita}
+%\end{verbatim}
+% will give you a more compact spacing, whereas
+%\begin{verbatim}
+% \usepackage[TextAligned]{currvita}
+%\end{verbatim}
+% will give you the default, more generous spacing. See the
+% explanation of the \env{cvlist}~environment and
+% section~\ref{sec:customization} on
+% page~\pageref{sec:customization} (``Customization'') for
+% details.
+%
+% \DescribeMacro{openbib}
+% If you like the look of the ``open'' format for bibliographies,
+% you can use this layout also for a list of publications within
+% your curriculum vitae. Normally, this option will be passed
+% automatically by the document class to all packages, so there is
+% no need to specify it explicitely. However, if you are
+% typesetting your Ph.\,D.~thesis with a ``normal'' bibliography
+% and you want to include your curriculum vitae with an ``open''
+% publication list, you can pass this option directly to the
+% package:
+%\begin{verbatim}
+% \usepackage[openbib]{currvita}
+%\end{verbatim}
+%
+% \DescribeMacro{ManyBibs}
+% If you want to subdivide your publication list (journal articles,
+% book chapters,~\ldots) but do not want to do without~\BibTeX{}
+% and enter every \cmd{\bibitem} manually, you can use this option:
+%\begin{verbatim}
+% \usepackage[ManyBibs]{currvita}
+%\end{verbatim}
+% This option suppresses the normal heading and also the item
+% labels. This makes sense only in combination
+% with~\file{bibunits.sty}, \file{multibib.sty} or other packages
+% supporting multiple bibliographies. See
+% section~\ref{sec:bibliographies} on
+% page~\pageref{sec:bibliographies} (``Bibliographies'').
+%
+% \DescribeMacro{NoDate}
+% If you have reason to suppress the date normally printed at the
+% bottom of the curriculum vita,\footnote{Credits go to
+% \person{Matt Swift}, who obviously \emph{has} reason and thus
+% suggested this feature. \winkey} use the following option:
+%\begin{verbatim}
+% \usepackage[NoDate]{currvita}
+%\end{verbatim}
+%
+%
+% \section{Usage}
+%
+% \DescribeMacro{cv}
+% A curriculum vitae is written inside a \env{cv}~environment,
+% which takes one mandatory argument, the heading:
+%\begin{verbatim}
+% \begin{cv}{<heading of the curriculum vitae>}
+% <text of the curriculum vitae>
+% \end{cv}
+%\end{verbatim}
+% If you do not want a heading (perhaps because you think the
+% addressee might have read ``Curriculum Vitae'' too often), you
+% can specify an empty argument by leaving the braces empty.
+%
+% \DescribeMacro{cvlist}
+% \label{cvlist}
+% The text of the curriculum vitae is normally divided into several
+% sections, which are typeset as lists, taking the list heading as
+% a mandatory argument:
+%\begin{verbatim}
+% \begin{cvlist}{<heading of the list>}
+% <list items>
+% \end{cvlist}
+%\end{verbatim}
+% As usual, the list items can take a label as an optional
+% argument:
+%\begin{verbatim}
+% \item <item text>
+% \item[<label>] <item text>
+%\end{verbatim}
+%
+% The typesetting of the list depends on the length of the heading
+% and the use of an optional argument in the first item: If the
+% heading is less wide than the width reserved for the label and no
+% optional argument was used, the item is typeset in the same line
+% as the heading. In all other cases the text of the item itself
+% starts a new line.
+%
+% \DescribeMacro{\cvplace}
+% Normally, a curriculum vitae ends with the date when and the
+% place where you wrote it. You can specify the location as
+% follows:
+%\begin{verbatim}
+% \cvplace{<location>}
+%\end{verbatim}
+% If you do not use this command, the printing of a location will
+% be omitted.
+%
+% \DescribeMacro{\date}
+% To specify the date, just use the command provided by the
+% standard \LaTeX{} document classes~\file{article.cls},
+% \file{report.cls} and \file{book.cls}. I took special care that
+% it works also if you are using an other class. If you do not
+% call this macro at all, \cmd{\today} will be used by default,
+% unless you have specified the \option{NoDate}~option.
+%\begin{verbatim}
+% \date{<date>}
+%\end{verbatim}
+%
+%
+% \section{Customization}
+% \label{sec:customization}
+%
+% \DescribeMacro{\cvheadingfont}
+% Normally, the heading of the curriculum vitae is typeset in bold
+% face and \cmd{\Large}~size (see~\cite{Latex:1999} for
+% details). You can change this e.\,g.\ with:
+%\begin{verbatim}
+% \renewcommand*{\cvheadingfont}{\large\bfseries}
+%\end{verbatim}
+%
+% \DescribeMacro{\cvlistheadingfont}
+% Corresponding to the font of the heading, the heading of the
+% \env{cvlist}~environments is typeset in bold face and
+% \cmd{\large}~size. This can be changed e.\,g.\ with the
+% following code:
+%\begin{verbatim}
+% \renewcommand*{\cvlistheadingfont}{\scshape}
+%\end{verbatim}
+%
+% \DescribeMacro{\cvlabelfont}
+% The labels of the \env{cvlist}~environments are typeset in the
+% normal size of the current font. You can change this e.\,g.\ with:
+%\begin{verbatim}
+% \renewcommand*{\cvlabelfont}{\itshape}
+%\end{verbatim}
+%
+% \DescribeMacro{\cvlabelwidth}
+% The default width of the labels of the \env{cvlist}~environments
+% is equal to the width of~``88/8888--88/8888'', because normally
+% in the left hand column dates are typeset (and, at least in
+% Germany, should be formatted in this way).
+%
+% \enlargethispage{-3\baselineskip}
+% If you are using the optional argument of the \cmd{\item}~command
+% for further sectioning (as I did for my curriculum vitae in the
+% example file), you perhaps need to adjust this length by means of
+%\begin{verbatim}
+% \setlength{\cvlabelwidth}{50mm}
+%\end{verbatim}
+% or
+%\begin{verbatim}
+% \AtBeginDocument{%
+% \settowidth{\cvlabelwidth}{%
+% \cvlabelfont This is my longest label%
+% }%
+% }
+%\end{verbatim}
+% or like this, if you want the items to be typeset in-line with
+% the labels wherever possible:
+%\begin{verbatim}
+% \AtBeginDocument{%
+% \settowidth{\cvlabelwidth}{%
+% \cvlistheadingfont This is my longest list heading%
+% }%
+% }
+%\end{verbatim}
+% The first example works correctly only
+% \emph{after}~|\begin{document}|, whereas the other two show how
+% to adjust the label width within the preamble. Make sure that
+% you include the appropriate font if you want to measure the
+% width.\footnote{Credits go to \person{Matt Swift} for reporting
+% the need for a better documentation.} And do not try to get
+% things done in the preamble without~\cmd{\AtBeginDocument},
+% because the font setup will probably not be correct, especially
+% if you use non-standard fonts.
+%
+% \DescribeMacro{\cvlabelskip}
+% This vertical space is inserted if you have a
+% \env{cvlist}~environment with a short heading and the first item
+% of this list has no label, so that the text of the item starts in
+% the same line as the heading. The spacing is controlled by the
+% options \option{TextAligned} and~\option{LabelsAligned},
+% see~section~\ref{sec:loading} on page~\pageref{sec:loading}
+% (``Loading'').
+%
+% By default (\option{TextAligned}), the spacing between the item
+% text belonging to different lists is independent of the length of
+% the list heading and also independent of the use of an optional
+% argument of the \cmd{\item}~command. The gaps between the item
+% \emph{text} blocks are equal. See, for example, the
+% lists~``Fremdsprachen'' or~``Interessen'' of the example file.
+%
+% The option~\option{LabelsAligned} suppresses the additional space
+% necessary to achieve this consistent layout and thus gives a more
+% compact look with evenly distributed gaps between the headings
+% and the \emph{labels}.
+%
+% If you are not satisfied with either of these options, feel free
+% to set hands to it yourself, for example:
+%\begin{verbatim}
+% \setlength{\cvlabelskip}{%
+% 0.5\baselineskip plus 1pt minus 1pt%
+% }%
+%\end{verbatim}
+%
+% \DescribeMacro{\cvlabelsep}
+% The default width of the distance between the labels and the
+% items itself is equal to~\source{1em}. You can customize it
+% e.\,g.\ with
+%\begin{verbatim}
+% \setlength{\cvlabelsep}{1mm}
+%\end{verbatim}
+% or
+%\begin{verbatim}
+% \settowidth{\cvlabelsep}{~}
+%\end{verbatim}
+% I strongly recommend to use relative measures like~\source{1em}
+% (i.\,e.\ dependent on the font size), if you need to customize
+% these lengths at all.
+%
+% \DescribeMacro{\cvbibname}
+% The default heading for bibliographies inside of
+% \env{cv}~environments is~``Publications''. You could change this
+% for example with:
+%\begin{verbatim}
+% \renewcommand*{\cvbibname}{List of Papers}
+%\end{verbatim}
+%
+% Please keep in mind: All the customizations mentioned above are
+% \emph{optional} and in my opinion not necessary (not even the
+% change of~\cmd{\cvlabelwidth}, better use more suggestive label
+% texts). See section~\ref{sec:typography} on
+% page~\pageref{sec:typography} (``Typography'') for some remarks.
+%
+%
+% \section{Example}
+%
+% Run the example file~\file{cvtest.tex} through~\LaTeX. You will
+% get my curriculum vitae. Sorry, it is written in German. Sorry,
+% it is not an original version used for an application (though the
+% data is correct, but I omitted the marks\footnote{It would have
+% been too embarrassing for me. \winkey}), because for this I need
+% some fonts and packages not available to every user and I wanted
+% to use as much standard~\LaTeX{} as possible.
+%
+%
+% \section{Bugs}
+%
+% Some people\footnote{Credits go to \person{Martin Sander} and
+% \person{Sebastian B\"ocker}.} with an older version of the
+% \package{babel}~package~(v3.6h) have reported problems due to the
+% use of the \package{babel}~shortcuts for accented letters within
+% the \cmd{\cvplace}~command. If you encounter this, too, try a
+% more recent version (v3.6x definitely works) of the
+% \package{babel}~package\footnote{Perhaps included in a new
+% \LaTeX{}~release? \winkey} (or~\file{german.sty}).
+%
+%
+% \section{Bibliographies\label{sec:bibliographies}}
+%
+% This package offers several possibilities for bibliographies or
+% publication lists.\footnote{Credits go to \person{Ian Bruce} for
+% suggesting this feature and providing the first lines of code
+% that did start the thing.} You can use \BibTeX{} or enter each
+% \cmd{\bibitem} manually. You can have multiple bibliographies
+% within one \env{cvlist}~environment (with the aid of other
+% packages like~\package{bibunits} or~\package{multibib}), or only
+% one somewhere in the \env{cv}~environment. Of course the main
+% bibliographies of your document remain untouched. You can even
+% use a publication list in document classes without native support
+% for bibliographies, like~\file{letter.cls}.
+%
+% Enough advertising, here we go with some
+% examples. \figurename~\ref{fig:manual} shows the source of a
+% letter with a manually done bibliography and a normal
+% \env{cvlist}~enviroment in comparison. The resulting publication
+% list (not shown here) does not fit well into the layout of the
+% \env{cvlist}~environment, so probably you want to integrate your
+% publication list into a \env{cvlist}~environment and to supply
+% distinctive labels?
+%
+% \begin{figure}
+%\begin{verbatim}
+% \documentclass{letter}
+% \usepackage{currvita}
+% \begin{document}
+% \begin{cv}{Resume}
+% \begin{cvlist}{Gnats and Gnus}
+% \item[Bar] Bar
+% \item[Foo] Foo
+% \end{cvlist}
+% \begin{thebibliography}{1}
+% \bibitem{Bar} Bar.
+% \bibitem{Foo} Foo.
+% \end{thebibliography}
+% \end{cv}
+% \end{document}
+%\end{verbatim}
+% \caption{Curriculum vitae with bibliography, manually done}
+% \label{fig:manual}
+% \end{figure}
+%
+% \begin{figure}
+%\begin{verbatim}
+% \documentclass{article}
+% \usepackage{bibunits}
+% \usepackage[ManyBibs]{currvita}
+% \begin{document}
+% \begin{cv}{Resume}
+% \begin{cvlist}{Gnats and Gnus}
+% \item[Bar] Bar
+% \item[Foo] Foo
+% \end{cvlist}
+% \begin{cvlist}{Publications}
+% \begin{bibunit}[alpha]
+% \nocite{booklet-full,manual-full,techreport-full}
+% \item[Books etc.] \putbib[xampl]
+% \end{bibunit}
+% \begin{bibunit}[plain]
+% \nocite{article-full,inproceedings-full}
+% \item[Papers] \putbib[xampl]
+% \end{bibunit}
+% \end{cvlist}
+% \end{cv}
+% \end{document}
+%\end{verbatim}
+% \caption{Bibliographies inside a \env{cvlist}, done with
+% \file{bibunits.sty}}
+% \label{fig:bibunits}
+% \end{figure}
+%
+% \figurename~\ref{fig:bibunits} shows an example with multiple
+% bibliographies automatically generated by~\BibTeX{} and in
+% combination with~\file{bibunits.sty}. This code will result in a
+% \LaTeX{}~error (``Something's wrong--perhaps a missing
+% \cmd{\item}.'') on the first run, but if you scroll through the
+% errors and run \LaTeX{} again, you will get a nice output once
+% you have run \BibTeX{} according to the
+% \package{bibunits}~manual. Note that the choice of the
+% bibliography style does not influence the labels because they are
+% suppressed anyway by use of the \option{ManyBibs}~option.
+%
+% \begin{figure}
+%\begin{verbatim}
+% \documentclass{report}
+% \usepackage{multibib}
+% \usepackage[openbib,ManyBibs]{currvita}
+% \newcites{books}{bar}
+% \newcites{papers}{foo}
+% \begin{document}
+% \bibliographystyle{alpha}
+% \bibliographystylebooks{unsrt}
+% \bibliographystylepapers{plain}
+% \begin{cv}{Resume}
+% \begin{cvlist}{Gnats and Gnus}
+% \item[Bar] Bar
+% \item[Foo] Foo
+% \end{cvlist}
+% \begin{cvlist}{Publications}
+% \nocitebooks{booklet-full,manual-full,techreport-full}
+% \item[Books etc.] \bibliographybooks{xampl}
+% \nocitepapers{article-full,inproceedings-full}
+% \item[Papers] \bibliographypapers{xampl}
+% \end{cvlist}
+% \end{cv}
+% \nocite{mastersthesis-full,misc-full,unpublished-full}
+% \bibliography{xampl}
+% \end{document}
+%\end{verbatim}
+% \caption{``Open'' publication lists inside a \env{cvlist},
+% additional ``normal'' bibliography outside, done with
+% \file{multibib.sty}}
+% \label{fig:multibib}
+% \end{figure}
+%
+% However, they work as normal outside the \env{cv}~environment,
+% see~\figurename~\ref{fig:multibib}, which shows in addition to
+% the usage of the \package{multibib}~package for ``open''
+% publication lists a ``normal'' bibliography in yet another
+% bibliography style. Note also that the second argument of the
+% \cmd{\newcites}~command does not matter because the heading of
+% the partial bibliographies is suppressed, again by use of the
+% \option{ManyBibs}~option.
+%
+%
+% \section{Typography\label{sec:typography}}
+%
+% A curriculum vitae is an exam. The addressee gets a proof of
+% your skills concerning collecting, discarding, ordering and
+% presenting information. He also gets an impression of some of
+% your qualities that are not even mentioned in the text: Accuracy
+% (consistency and correctness of the micro-typographic things),
+% stinginess (extremely narrow margins) and your taste in questions
+% of aesthetics (font overload as against clear and evident font
+% usage). Even more things are revealed by subtle hints given by
+% the typography of the curriculum vitae and they can be noticed by
+% all professional readers of applications,\footnote{Very often
+% subconsciously.} not only by typographers.
+%
+% Therefore you definitely should do your best not only when
+% thinking about the content but also when thinking about the form
+% of the curriculum vitae. This package tries to help you in this
+% task.
+%
+% The overall appearance of a curriculum vitae is determined mainly
+% by three factors:
+% \begin{description}
+% \item[Layout] Organization and arrangement of the information
+% e.\,g.\ into lists or tabulars, usage of headings, size of the
+% typearea, width of columns, horizontal and vertical spacing
+% \item[Font] Family, sizes, usage of fonts for emphasized in-line
+% text or text serving as an eye-catcher, creation of an atmosphere
+% appropriate to the candidate and the job in question
+% \item[Micro-typography] Formatting of various numbers, avoidance
+% of bad linebreaks, distinction between small and normal spaces,
+% typesetting of company names, usage of quotation marks
+% \end{description}
+%
+%
+% \subsection{Layout}
+%
+% You generally should organize the necessary information (and
+% \emph{only} the necessary information) as clearly as possible,
+% because the addressee is annoyed anyway by the pile of
+% applications that he has to wade, and you definitely should not
+% annoy him any further by not structuring your curriculum vitae.
+%
+% Use generous margins, a not too small font and moderate vertical
+% spacing. I recommend something around~\source{DIV12} for users
+% of~\file{typearea.sty} (part of KOMA-Script), an 11~point font
+% for A4~paper (highly dependent on the font family) and a left
+% hand column as narrow as possible (it will make the linebreaking
+% in the right hand column easier). For the distance between the
+% columns \source{1em}~creates a sufficient separation. A normal
+% word space would not be enough, whereas something
+% around~\source{1cm} would weaken the coherence of the layout,
+% especially if you have some shorter labels.
+%
+% If you ever heard a curriculum vitae should not be longer than
+% one page, forget it, unless you are required (by whom, if I may
+% ask?) to stay below this limit. I made some tries with increased
+% typearea and reduced the font size and the vertical spacing. I
+% finally managed to arrange my test file on one page by usage of a
+% very narrow newspaper font, but it looked horrible. The normal
+% version, though about half a page longer, was much easier (and
+% quicker!) to read.
+%
+%
+% \subsection{Font}
+%
+% The most difficult thing is to choose a good font. For
+% ``normal'' jobs like engineering, economics or similar, the font
+% should look friendly and professional, just like you on the
+% photo. Of course a typographical layman does not identify the
+% font, but he too feels the atmosphere created by it.
+%
+% I made some tries with about 50~fonts, with serifs or without,
+% old-style, transitional and modern fonts and got surprisingly
+% good agreement among the test persons\footnote{Credits go to
+% \person{Melanie Frisch}, \person{R\"udiger Haardt},
+% \person{Steffen Mei\ss ner}, \person{Joachim Gnauk}
+% and~\person{Rainer Messerschmidt} for doing this tedious
+% work.}. Moreover, my analysis and theirs yielded the same
+% result: Computer Modern, Charter, Utopia and Melior really do a
+% good job. Except Melior, these fonts are freely available.
+% Computer Modern looks elegant, dry, precise and reserved, Charter
+% friendly, open, solid and likable and Utopia clear and
+% technical. The last two are nowadays part of good
+% \LaTeX{}~distributions, so you are not sticked to Computer
+% Modern, just try them out:
+%\begin{verbatim}
+% \usepackage{charter}
+%\end{verbatim}
+% or
+%\begin{verbatim}
+% \usepackage{utopia}
+%\end{verbatim}
+%
+% Generally, you should use bold face for the headings, to make
+% them clearly distinct from the main text, italics are not enough.
+% An important aspect of the font choice is the contrast between
+% the normal and the bold face. It should be high enough, so that
+% the headings can be identified at a glance, but neither the
+% regular font nor the bold variant should look too~``loud''. This
+% is a problem e.\,g.\ with New Century Schoolbook, apart from that
+% as good as Computer Modern.
+%
+% Many fonts typically used in novels have too low a contrast,
+% e.\,g.\ Berling, Galliard, Palatino and Stempel
+% Garamond. Although the contrast is good in Bembo, it looks
+% too~``nice'', too familiar from books to create the correct
+% atmosphere for a curriculum vitae, which normally is attached to
+% a stupid letter. Plantin and Trump Medieval and perhaps New
+% Baskerville may be acceptable in some cases, but I think there
+% are better choices. Not everybody's taste because a little
+% unusual, but in my opinion quite good is Oranda, rather bold and
+% small, but friendly and soft. Oh, I almost forgot: The
+% obligatory Times is a good choice, too. Though it is completely
+% over-used and overrated (I am not at all a fan of Times), its
+% domain is the typesetting of (more or less) narrow columns and it
+% does a good job looking both familiar and neutral.
+%
+% My trials with sans-serif fonts were not very
+% successful. Computer Modern Sans Serif, Franklin Gothic or
+% Univers may be acceptable, Helvetica looks too boring (are
+% \emph{you} boring?), Frutiger has too low a contrast, Optima is
+% ``too nice'', Gill Sans and Futura look too bold (and the latter
+% perhaps too cold and technical, but that may be suitable for some
+% jobs). Generally the problem is to achieve consistency with the
+% accompanying letter, which normally is written with a serif font
+% (and should be, because it is a longer text with less structure,
+% the main text only divided into paragraphs. In these cases,
+% so-called ``linear reading'', a serif font is considered more
+% legible by many typographers).
+%
+%
+% \subsection{Micro-typography}
+%
+% Sometimes the pile of applications is pre-sorted by a
+% secretary. You should ensure that the micro-typography (also
+% known as ``pedantic stuff'') is correct, because secretaries
+% learn these things during their education. German users of this
+% package definitely should consult the relevant part of the
+% Duden~\cite{Duden:1996} or have a look into~\cite{Willberg:1997}
+% or the example file. Errors in the formatting of dates, spacing
+% or grouping of telephone numbers, usage of quotation marks or
+% ampersands and so on are too common. Trained secretaries will
+% notice these mistakes and, if they already did not like your
+% photo, will put your application onto stack~W
+% (wastebasket). \winkey
+%
+% Think about it, micro-typography is easy, and if you get used to
+% it, you will typeset things correctly ``by default'' and your
+% documents will require less proof-reading. It is awful if the
+% reader stumbles (and falls) over a bad linebreak. Use ties~(|~|)
+% or other things influencing hyphenation from~\file{babel.sty}
+% or~\file{german.sty} like~\cmd{\,}, |"~| or~|""| not after you
+% have discovered such a mistake, but during entering the text.
+%
+% O.\,K., and now I will turn preaching mode off and programming
+% mode on. \winkey
+%
+%
+% \section{Implementation}
+%
+% \iffalse
+%<*driver>
+\documentclass[12pt,a4paper]{ltxdoc}
+\begin{document}
+ \DocInput{currvita.dtx}
+\end{document}
+%</driver>
+% \fi
+% \StopEventually{
+% \addcontentsline{toc}{section}{References}
+% \begin{thebibliography}{1}
+% \bibitem{Duden:1996}
+% \textsc{Dudenredaktion}~(ed.): \emph{Duden, Rechtschreibung
+% der deutschen Sprache}, vol.~1 of~\emph{Der Duden in
+% 12~B{\"a}nden; das Standardwerk zur deutschen Sprache},
+% chap.~Richtlinien f{\"u}r den Schriftsatz,
+% pp.\,65--73. \newblock Dudenverlag, Mannheim, 21st~edn.,
+% 1996.
+% \bibitem{Goossens:1994}
+% \textsc{Goossens,~M.; Mittelbach,~F.; Samarin,~A.}: \emph{Der
+% \LaTeX-Begleiter}. \newblock Addison-Wesley, Bonn, 1st~edn.,
+% 1994.
+% \bibitem{Kopka:1997}
+% \textsc{Kopka,~H.}: \emph{Erweiterungen}, vol.~3
+% of~\emph{\LaTeX}. \newblock Addison-Wesley-Longman, Bonn,
+% 1997.
+% \bibitem{Latex:1999}
+% \LaTeX3 Project Team. \newblock \emph{\LaTeXe{} font
+% selection}, Jan.\,1999.
+% \bibitem{Willberg:1997}
+% \textsc{Willberg,~H.\,P.; Forssman,~F.}:
+% \emph{Lesetypographie}. \newblock Schmidt, Mainz, 1997.
+% \end{thebibliography}
+% }
+% \iffalse
+%<*package>
+% \fi
+%
+%
+% \subsection{Identification}
+%
+% \changes{v0.9g}{1999-09-06}{A new \LaTeX{} version is needed.}
+% As this package uses the \cmd{\ignorespacesafterend}~command, it
+% does not work with older \LaTeXe{}~versions.
+% \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}[1996/12/01]%
+% \end{macrocode}
+% The package identifies itself with its release date, a version
+% number, and a short description.
+% \begin{macrocode}
+\ProvidesPackage{currvita}[%
+ 1999/09/13 v0.9i Typesetting a Curriculum Vitae%
+]%
+% \end{macrocode}
+%
+%
+% \subsection{Loading Files}
+%
+% The \package{ifthen}~package is used to make some decisions
+% easier.
+% \begin{macrocode}
+\RequirePackage{ifthen}%
+% \end{macrocode}
+%
+%
+% \subsection{Initialization}
+%
+% \begin{macro}{\@cvplace}
+% The string for the place of the curriculum vitae is
+% initialized. It should be defined later by the user.
+% \cmd{\@cvplace} is not declared by means
+% of~\cmd{\DeclareRobustCommand*}, because this adds a
+% superfluous~\cmd{\protect} (causing problems with the
+% \package{ifthen}~package).
+% \begin{macrocode}
+\newcommand*{\@cvplace}{\@empty}%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\@cvlistheading}
+% The box containing the heading of a \env{cvlist}~environment is
+% allocated.
+% \begin{macrocode}
+\newsavebox{\@cvlistheading}%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\cvlabelsep}
+% \begin{macro}{\cvlabelskip}
+% \begin{macro}{\cvlabelwidth}
+% \changes{v0.9d}{1999-08-25}{\cmd{\cvlabelskip} was introduced.}
+% Some lengths are initialized.
+% \begin{macrocode}
+\newlength{\cvlabelsep}%
+\newlength{\cvlabelskip}%
+\newlength{\cvlabelwidth}%
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+% \begin{macro}{cv@many@bibs}
+% \begin{macro}{cv@no@date}
+% \begin{macro}{cv@open@bib}
+% \changes{v0.9f}{1999-09-02}{%
+% Flags~\flag{cv@many@bibs} and \flag{cv@open@bib} were
+% introduced.%
+% }
+% \changes{v0.9g}{1999-09-06}{%
+% Flag~\flag{cv@no@date} was introduced.%
+% }
+% \changes{v0.9g}{1999-09-06}{%
+% New name: \flag{cv@many@bibs} instead of \flag{many@bibs}%
+% }
+% We also need one new flag to handle the bibliography option
+% \option{ManyBibs}, another one to handle the
+% \option{NoDate}~option, and another one to handle the
+% \option{openbib}~option separately for the
+% \package{currvita}~package.
+% \begin{macrocode}
+\newboolean{cv@many@bibs}%
+\newboolean{cv@no@date}%
+\newboolean{cv@open@bib}%
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \end{macro}
+%
+%
+% \subsection{Option Declaration}
+%
+% \changes{v0.9d}{1999-08-25}{%
+% Options \option{LabelsAligned} and~\option{TextAligned} were
+% introduced.%
+% }
+% \begin{macro}{LabelsAligned}
+% The use of this option suppresses the additional vertical space
+% inserted before in-line headings of \env{cvlist}~environments.
+% It ensures that the gaps between the various headings and labels
+% are equal.
+% \begin{macrocode}
+\DeclareOption{LabelsAligned}{%
+ \setlength{\cvlabelskip}{0ex}%
+}%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{TextAligned}
+% Use of this option ensures that the items of the right hand
+% column are separated by equal vertical spacing. To achieve this,
+% an additional gap has to be inserted in case of a short heading
+% and no optional argument given to the \cmd{\item}~command. See
+% also the definition of the \env{cvlist}~environment on
+% page~\pageref{makelabel}.
+% \begin{macrocode}
+\DeclareOption{TextAligned}{%
+ \setlength{\cvlabelskip}{%
+ 1.5\baselineskip plus 3pt minus 3pt%
+ }%
+}%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{openbib}
+% \changes{v0.9e}{1999-08-29}{%
+% Option \option{openbib} was introduced.%
+% }
+% \changes{v0.9e}{1999-08-29}{\cmd{\bibindent} was introduced.}
+% \changes{v0.9f}{1999-09-02}{%
+% Option code moved to \env{thebibliography}~environment, checked
+% with flag.%
+% }
+% \changes{v0.9h}{1999-09-08}{%
+% Initialization of~\cmd{\bibindent} moved into option code.%
+% }
+% \changes{v0.9h}{1999-09-08}{%
+% Option \option{OneBib} is no longer necessary and has been
+% deleted.%
+% }
+% For document classes like letter, i.\,e.\ without native support
+% for bibliographies, it is necessary to provide the length of the
+% indentation used in the \option{openbib}~format. It will not be
+% changed if it is already defined.
+% \begin{macrocode}
+\DeclareOption{openbib}{%
+ \@ifundefined{bibindent}{%
+ \newlength{\bibindent}%
+ }{}%
+ \setlength{\bibindent}{1.5em}%
+ \setboolean{cv@open@bib}{true}%
+}%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{ManyBibs}
+% \changes{v0.9f}{1999-09-02}{%
+% Option \option{ManyBibs} was introduced.%
+% }
+% Use this option in case you need more than one bibliography list,
+% e.\,g.\ for different kinds of publications.
+% \begin{macrocode}
+\DeclareOption{ManyBibs}{%
+ \setboolean{cv@many@bibs}{true}%
+}%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{NoDate}
+% \changes{v0.9g}{1999-09-06}{%
+% Option \option{NoDate} was introduced.%
+% }
+% Use this option in case you want to omit the date normally
+% printed at the bottom of the curriculum vitae.
+% \begin{macrocode}
+\DeclareOption{NoDate}{%
+ \setboolean{cv@no@date}{true}%
+}%
+% \end{macrocode}
+% \end{macro}
+%
+%
+% \subsection{Option Processing}
+%
+% \changes{v0.9d}{1999-08-25}{%
+% \option{TextAligned} is the defined as the default option.%
+% }
+% \changes{v0.9f}{1999-09-02}{%
+% \option{OneBib} added to list of default options.%
+% }
+% \changes{v0.9h}{1999-09-08}{%
+% \option{OneBib} deleted from list of default options.%
+% }
+% If no options are specified, the text of the items is aligned by
+% default. Otherwise the options are processed in the order given
+% by the calling command, i.\,e.\ the last one ``wins''.
+% \begin{macrocode}
+\ExecuteOptions{TextAligned}%
+\ProcessOptions*%
+% \end{macrocode}
+%
+%
+% \subsection{Delaying Code}
+%
+% \changes{v0.9c}{1999-08-16}{%
+% Execution of \cmd{\settowidth} delayed until beginning of
+% document%
+% }
+% \changes{v0.9d}{1999-08-25}{%
+% \cmd{\cvlabelfont} is used for measuring the width of the
+% label.%
+% }
+% \changes{v0.9h}{1999-09-08}{%
+% \cmd{\cvlabelsep} is now initialized at the beginning of the
+% document.%
+% }
+% The distance between labels and items is set to~\source{1em}.
+% The maximum allowed width of the labels of the
+% \env{cvlist}~environments forming the curriculum vitae is set to
+% the width of a typical entry. This is done at the beginning of
+% the document, because then the normal fonts have been setup
+% properly.\footnote{Credits go to \person{Gerd Boerrigter} for
+% reporting this bug.}
+% \begin{macrocode}
+\AtBeginDocument{%
+ \setlength{\cvlabelsep}{1em}%
+ \settowidth{\cvlabelwidth}{%
+ \cvlabelfont 88/8888--88/8888%
+ }%
+}%
+% \end{macrocode}
+%
+%
+% \subsection{Defining Commands}
+%
+% \begin{macro}{\cvheadingfont}
+% Normally, the title of the curriculum vitae is typeset in larger
+% bold face.
+% \begin{macrocode}
+\DeclareRobustCommand*{\cvheadingfont}{\bfseries\Large}%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\cvbibname}
+% \changes{v0.9g}{1999-09-06}{\cmd{\cvbibname} was introduced.}
+% This macro holds the name of the publication list. In my opinion
+% it does not make sense to inherit the definition
+% of~\cmd{\refname} or~\cmd{\bibname}, so a new command is
+% introduced.
+% \begin{macrocode}
+\DeclareRobustCommand*{\cvbibname}{Publications}%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\cvplace}
+% This command is used to change the place to be typeset at the
+% bottom of the curriculum vitae. It takes one mandatory argument,
+% guess what: the place. \winkey
+% \begin{macrocode}
+\DeclareRobustCommand*{\cvplace}[1]{%
+ \gdef\@cvplace{#1}%
+}%
+% \end{macrocode}
+% The \cmd{\@cvplace}~command is changed globally, so that you can
+% use it also inside environments other than
+% \env{cv}~environments.
+% \end{macro}
+% \begin{macro}{\date}
+% This command is used to change the date that is printed below the
+% curriculum vitae. It needs the date as a mandatory
+% argument. Because the standard \LaTeX{}~classes
+% \file{article.cls}, \file{report.cls} and~\file{book.cls} already
+% define such a command, it will only be defined if it is not
+% provided by the class.
+%
+% In contrast, the \cmd{\@date} command is part of the
+% \LaTeX{}~kernel and thus available in every class. \cmd{\@date}
+% is changed globally for the same reason as the
+% \cmd{\@cvplace}~command.
+% \begin{macrocode}
+\providecommand*{\date}[1]{\gdef\@date{#1}}%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{cv}
+% This environment takes the heading of the curriculum vitae as a
+% mandatory argument which is typeset at the beginning of the
+% curriculum vitae without indentation using the corresponding
+% font, whose scope is limited by a separate group. If the
+% argument is empty, no heading is used.
+% \begin{macrocode}
+\newenvironment{cv}[1]{%
+ \ifthenelse{\equal{#1}{\@empty}}{%
+ }{%
+ {%
+ \noindent\cvheadingfont#1\par\nopagebreak
+ }%
+ }%
+% \end{macrocode}
+% \begin{macro}{\@biblabel}
+% \changes{v0.9f}{1999-09-02}{%
+% \cmd{\@biblabel} is set dependent on \option{ManyBibs} option.%
+% }
+% The labels used within the bibliography are redefined locally as
+% empty. In this way it is possible to add explanatory text to the
+% items like~``Articles'' or~``Book Chapters''.
+% \begin{macrocode}
+ \ifthenelse{\boolean{cv@many@bibs}}{%
+ \DeclareRobustCommand*{\@biblabel}[1]{\@gobble{##1}}%
+ }{}%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{\newblock}
+% \changes{v0.9e}{1999-08-29}{%
+% The commands \cmd{\newblock} and \cmd{\@openbib@code} were
+% introduced.%
+% }
+% \changes{v0.9h}{1999-09-08}{%
+% The command~\cmd{\@openbib@code} is no longer necessary and has
+% been deleted.%
+% }
+% \changes{v0.9h}{1999-09-08}{%
+% The definition is now made local inside the
+% \env{cv}~environment.%
+% }
+% To support bibliographies even in document classes like letter
+% (which do not have ``native'' bibliography support), it is
+% necessary to provide this command:
+% \begin{macrocode}
+ \providecommand{\newblock}{%
+ \hspace{0.11em plus 0.33em minus 0.07em}%
+ }%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{thebibliography}
+% The \env{thebibliography}~environment is (re)defined locally, so
+% you can use a ``normal'' bibliography elsewhere in your
+% document.
+% \changes{v0.9e}{1999-08-29}{%
+% \env{thebibliography}~environment is locally defined.%
+% }
+% \changes{v0.9f}{1999-09-02}{%
+% Heading is suppressed if \option{ManyBibs}~option is used.%
+% }
+% \changes{v0.9f}{1999-09-02}{%
+% \cmd{\newblock}~command is redefined locally for
+% \option{openbib} support.%
+% }
+% \changes{v0.9f}{1999-09-02}{%
+% \cmd{\labelsep} is set dependent on \option{ManyBibs}~option.%
+% }
+% \changes{v0.9f}{1999-09-02}{%
+% Code for \option{openbib}~option is executed depending on the
+% \flag{cv@open@bib} flag.%
+% }
+% \changes{v0.9h}{1999-09-08}{%
+% Length of~\cmd{\topsep} was reduced to give spacing consistent
+% to the \env{cvlist}~environments.%
+% }
+% \begin{macrocode}
+ \long\def\thebibliography##1{%
+% \end{macrocode}
+% The heading is omitted if the \option{ManyBibs}~option is
+% used. Otherwise it is typeset using the appropriate font, without
+% indentation. A pagebreak after the heading is suppressed.
+% \begin{macrocode}
+ \ifthenelse{\boolean{cv@many@bibs}}{%
+ }{%
+ {%
+ \noindent\cvlistheadingfont\cvbibname
+ \par\nopagebreak
+ }%
+ }%
+% \end{macrocode}
+% The following redefinition is taken from the standard document
+% classes, as is most of the rest of the environment.
+% \begin{macrocode}
+ \ifthenelse{\boolean{cv@open@bib}}{%
+ \renewcommand{\newblock}{\par}%
+ }{}%
+ \begin{list}{\@biblabel{\@arabic\c@enumiv}}{%
+% \end{macrocode}
+% The lengths of~\cmd{\parsep} and~\cmd{\itemsep} are swapped in
+% comparison with the \env{cvlist}~environments. This gives
+% correct spacing even with the \option{openbib}~option.
+% \begin{macrocode}
+ \setlength{\parsep}{0ex}%
+ \setlength{\itemsep}{%
+ 0.5\baselineskip plus 1pt minus 1pt%
+ }%
+% \end{macrocode}
+% The vertical spacing is adapted to correspond to the other
+% \env{cvlist}~environments.
+% \begin{macrocode}
+ \setlength{\topsep}{0ex}%
+ \setlength{\partopsep}{0ex}%
+% \end{macrocode}
+% With the \option{ManyBibs}~option no labels are used, so no space
+% needs to be reserved.
+% \begin{macrocode}
+ \ifthenelse{\boolean{cv@many@bibs}}{%
+ \setlength{\labelsep}{0em}%
+ }{}%
+% \end{macrocode}
+% And now lots of code adapted from the standard document classes,
+% only written in a \LaTeX nically correct way. \winkey
+% \begin{macrocode}
+ \settowidth{\labelwidth}{\@biblabel{##1}}%
+ \setlength{\leftmargin}{\labelwidth}%
+ \addtolength{\leftmargin}{\labelsep}%
+ \ifthenelse{\boolean{cv@open@bib}}{%
+ \addtolength{\leftmargin}{\bibindent}%
+ \setlength{\itemindent}{-\bibindent}%
+ \setlength{\listparindent}{\itemindent}%
+ }{}%
+ \usecounter{enumiv}%
+ \let\p@enumiv\@empty
+ \renewcommand*{\theenumiv}{\@arabic\c@enumiv}%
+ }%
+ \sloppy
+ \clubpenalty4000%
+ \@clubpenalty\clubpenalty
+ \widowpenalty4000%
+ \sfcode`\.=\@m
+ }%
+ \long\def\endthebibliography{%
+ \renewcommand*{\@noitemerr}{%
+ \@latex@warning{Empty `thebibliography' environment}%
+ }%
+ \end{list}%
+ }%
+}{%
+% \end{macrocode}
+% \changes{v0.9c}{1999-08-16}{\cmd{\noindent} added.}
+% \changes{v0.9g}{1999-09-06}{%
+% Support for \option{NoDate}~option was added.%
+% }
+% \changes{v0.9g}{1999-09-06}{%
+% Text following the \env{cv}~environment start in new line,
+% without indentation.%
+% }
+% The place (if given) followed by the date is typeset at the
+% bottom of the curriculum vitae. It should not be indented, even
+% if there are blank lines prior to the end of the
+% \env{cv}~environment.\footnote{Credits go to \person{Gerd
+% Boerrigter} for discovering this~``feature''.} The amount of
+% vertical space seems quite strange but looks right, much better
+% than the expected~\source{1.5\bslash baselineskip}. Don't know
+% why. \winkey
+% \begin{macrocode}
+ \vspace{1.333\baselineskip plus 3pt minus 3pt}%
+ \ifthenelse{\equal{\@cvplace}{\@empty}}{%
+ }{%
+ \noindent
+ \@cvplace
+ \ifthenelse{\boolean{cv@no@date}}{}{%
+ ,~%
+ }%
+ }%
+ \ifthenelse{\boolean{cv@no@date}}{}{%
+ \@date
+ }%
+ \par\noindent\ignorespacesafterend
+}%
+% \end{macrocode}
+% \end{macro}
+% \end{macro}
+% \begin{macro}{\cvlistheadingfont}
+% The headings of the \env{cvlist}~environments forming the
+% curriculum vitae are typeset in large bold face.
+% \begin{macrocode}
+\DeclareRobustCommand*{\cvlistheadingfont}{%
+ \bfseries\large
+}%
+% \end{macrocode}
+% \end{macro}
+% \changes{v0.9d}{1999-08-25}{\cmd{\cvlabelfont} command added.}
+% \begin{macro}{\cvlabelfont}
+% The labels of the \env{cvlist}~environments are typeset in the
+% normal size of the current font.
+% \begin{macrocode}
+\DeclareRobustCommand*{\cvlabelfont}{%
+ \normalsize
+}%
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}{cvlist}
+% This is the list environment used for the parts of the curriculum
+% vitae. It takes one mandatory argument, the heading of the
+% list.
+% \begin{macrocode}
+\newenvironment{cvlist}[1]{%
+% \end{macrocode}
+% The heading of the list is put into a box, using the
+% corresponding font.
+% \begin{macrocode}
+ \sbox{\@cvlistheading}{\cvlistheadingfont#1}%
+% \end{macrocode}
+% The \env{cvlist}~environment is basically a
+% \env{list}~environment~\ldots
+% \begin{macrocode}
+ \begin{list}{}{%
+% \end{macrocode}
+% \ldots~but with a ``smart'' \cmd{\makelabel}~command which is
+% given the optional argument of the \cmd{\item}~command.
+% \label{makelabel}
+% \begin{macrocode}
+ \renewcommand*{\makelabel}[1]{%
+% \end{macrocode}
+% \changes{v0.9d}{1999-08-25}{%
+% \cmd{\cvlabelfont} is used for measuring the width of the
+% label.%
+% }
+% The width of the heading of the list is measured. If it is
+% positive (i.\,e.\ the box containing the argument of the
+% \env{cvlist}~environment is not empty), the width of the optional
+% argument of the \cmd{\item}~command is measured, too (using the
+% correct font).
+% \begin{macrocode}
+ \settowidth{\@tempdima}{\usebox{\@cvlistheading}}%
+ \ifthenelse{\lengthtest{\@tempdima > 0pt}}{%
+ \settowidth{\@tempdimb}{\cvlabelfont##1}%
+% \end{macrocode}
+% If the heading of the list is less wide than the allowed label
+% width and the optional argument of the \cmd{\item}~command is
+% empty, the \cmd{\item} can be typeset in the same line as the
+% heading.
+%
+% \changes{v0.9d}{1999-08-25}{%
+% \cmd{\cvlabelskip} is used for the vertical spacing before
+% in-line headings%
+% }
+% The box containing the heading is then emptied, the heading is
+% typeset flush to the left.
+% \begin{macrocode}
+ \ifthenelse{%
+ \lengthtest{\@tempdima < \cvlabelwidth} \and
+ \lengthtest{\@tempdimb = 0pt}}{%
+ \parbox[b]{\cvlabelwidth}{%
+ \vspace{\cvlabelskip}%
+ \makebox[\cvlabelwidth][l]{%
+ \box\@cvlistheading
+ }%
+ }%
+ }{%
+% \end{macrocode}
+% If the heading is too wide or the \cmd{\item}~command has an
+% optional argument, the box containing the heading is emptied and
+% the \cmd{\item}~command starts a new line.
+% \begin{macrocode}
+ \parbox[b]{0pt}{%
+ \makebox[0pt][l]{\box\@cvlistheading}%
+ \\*[0.5\baselineskip plus 1pt minus 1pt]%
+ }%
+ }%
+% \end{macrocode}
+% If the box containing the argument of the
+% \env{cvlist}~environment is empty (its width is zero), nothing is
+% done. This case holds for all \cmd{\item}~commands of a
+% \env{cvlist}~environment except for the first or if no heading
+% was specified (this does normally not make sense). You see that
+% it is crucial to empty the box by a
+% plain~\TeX{}~command~\cite{Kopka:1997}, otherwise the heading
+% would be typeset for every \cmd{\item}~command.
+% \begin{macrocode}
+ }{}%
+% \end{macrocode}
+% \changes{v0.9d}{1999-08-25}{\cmd{\cvlabelfont} is used for the
+% label.%
+% }
+% Now that the heading of the list is prepared, the optional
+% argument of the \cmd{\item}~command is typeset flush to the left
+% using the corresponding font and the \cmd{\makelabel}~command has
+% done its work. Sigh. \winkey
+% \begin{macrocode}
+ \cvlabelfont##1\hfill
+ }%
+% \end{macrocode}
+% The spacing used in the \env{cvlist} environments is adjusted.
+% Remember that $\cmd{\itemsep} + \cmd{\parsep}$ is inserted
+% between items~\cite{Goossens:1994}. The label width and the
+% separation between labels and items are set
+% to~\cmd{\cvlabelwidth} and~\cmd{\cvlabelsep}, respectively, which
+% are globally available and thus can be re-adjusted by the user.
+% If the~\source{1} is omitted in the definition of~\cmd{\topsep},
+% ``plus 2pt minus 2pt'' is written into your curriculum vitae.
+% Strange. \winkey
+% \begin{macrocode}
+ \setlength{\itemsep}{0ex}%
+ \setlength{\parsep}{%
+ 0.5\baselineskip plus 1pt minus 1pt%
+ }%
+ \setlength{\topsep}{%
+ 1\baselineskip plus 2pt minus 2pt%
+ }%
+ \setlength{\partopsep}{0ex}%
+ \setlength{\labelsep}{\cvlabelsep}%
+ \setlength{\labelwidth}{\cvlabelwidth}%
+ \setlength{\leftmargin}{\cvlabelwidth}%
+ \addtolength{\leftmargin}{\cvlabelsep}%
+% \end{macrocode}
+% The end of the list initialization and of the
+% \env{cvlist}~environment.
+% \begin{macrocode}
+ }%
+}{%
+ \end{list}%
+}%
+% \end{macrocode}
+% \end{macro}
+% \iffalse
+%</package>
+% \fi
+% \Finale
+% \iffalse
+%<*testfile>
+\documentclass[12pt,a4paper]{article}
+%
+\usepackage[german]{babel}
+\usepackage{currvita}
+%
+\newcommand*{\ac}[1]{\mbox{#1}}
+%
+\tolerance=600
+%
+\begin{document}
+%
+\begin{cv}{Lebenslauf}
+%
+ \begin{cvlist}{Pers"onliche Daten}
+ \item Axel Reichert\\
+ Beethovenstr.~25\\
+ 40233~D"usseldorf
+ \item Tel.:~(02\,11)~6\,91\,24\,15\\
+ E"~Mail:~axel.reichert@gmx.de
+ \item Geb.~am~03.\,08.~1970 in~D"usseldorf\\
+ Ledig, deutsch
+ \end{cvlist}
+%
+ \begin{cvlist}{Schulbildung}
+ \item[08/1976--05/1989] Grundschule und Gymnasium in Mettmann
+ (Leistungskurse Mathematik und Physik)
+ \end{cvlist}
+%
+ \begin{cvlist}{Wehrdienst}
+ \item[10/1989--09/1990] Fernmeldeaufkl"arer in Clausthal-Zellerfeld
+ und Rotenburg/""W"umme
+ \end{cvlist}
+%
+ \begin{cvlist}{Studium}
+ \item[10/1990--09/1992] Maschinenbauvordiplom an der Universit"at
+ Hannover
+ \item[10/1992--06/1993] Wissenschaftliche Hilfskraft am Institut
+ f"ur Umformtechnik und Umformmaschinen, Hannover; Mitarbeit an
+ DFG-Projekt: Implementation eines Stoffgesetzes in das
+ \ac{FEM}-Programm \ac{ABAQUS}
+ \item[10/1992--08/1996] Maschinenbaudiplom an der Universit"at
+ Hannover, Ent"-wicklungs"~~und Konstruktionstechnik (Schwerpunkte
+ Finite Elemente, Schwingungstechnik und Elasto"~/""Plastomechanik)
+ \item[10/1994--04/1996] Mathematikvordiplom an der Universit"at
+ Hannover
+ \end{cvlist}
+%
+ \begin{cvlist}{Praktikum}
+ \item[08/1994--09/1994] Br"uninghaus~\&~Drissner~GmbH, Hilden
+ (mittelst"andisches Pre"s"~, Stanz"~ und Ziehwerk); Konstruktion
+ eines kombinierten Roll"~ und Zudr"uckwerkzeuges f"ur
+ Klemmschellen
+ \end{cvlist}
+%
+ \begin{cvlist}{Berufserfahrung}
+ \item[seit~08/1996] Max-Planck-Institut f"ur Eisenforschung~GmbH,
+ D"usseldorf; wissenschaftlicher Mitarbeiter der Abteilung
+ Metallurgie
+
+ Promotion "uber "`Soft Reduction beim Stranggie"sen und ihr
+ Einflu"s auf die Produktqualit"at"' im Rahmen eines Projektes der
+ Europ"aischen Gemeinschaft f"ur Kohle und Stahl in Zusammenarbeit
+ mit British Steel, den Dillinger H"uttenwerken und der
+ TU~Clausthal
+ \end{cvlist}
+%
+ \begin{cvlist}{Fremdsprachen}
+ \item Englisch, Franz"osisch
+ \end{cvlist}
+%
+ \begin{cvlist}{\ac{EDV}}
+ \item[Betriebssysteme] \ac{UNIX} (Linux, \ac{IRIX}), Windows, Novell
+ Netware, \ac{DOS}
+ \item[Sprachen] Perl, Shell-Skripte, \ac{HTML}, Fortran~77, Pascal,
+ \ac{BASIC}
+ \item[Anwendungen] \ac{ANSYS}, \ac{MARC}, Word, Excel, Corel"-DRAW,
+ Designer, LaTeX, XEmacs
+ \end{cvlist}
+%
+ \begin{cvlist}{Interessen}
+ \item Klassische Musik, Typographie, Tischtennis, Fotografie
+ \end{cvlist}
+%
+ \begin{cvlist}{Sonstiges}
+ \item[04/1992--10/1995] Ehrenamtliche Mitarbeit als Rechnerwart bei
+ der Saalgemeinschaft~"`Exzenter"' (unter studentischer
+ Selbstverwaltung stehender Arbeits"~~und Zeichensaal f"ur
+ Ingenieurstudenten)
+ \item[seit 01/1997] Aktives Mitglied der Deutschen
+ Anwendervereinigung TeX, Vortr"age und Tutorien auf Konferenzen
+ \end{cvlist}
+%
+% \changes{v0.9d}{1999-08-25}{%
+% \LaTeX{} version of the umlaut is used instead of
+% \package{babel}'s~shortcut.%
+% }
+ \cvplace{D\"usseldorf}
+ \date{13.~September~1999}
+%
+\end{cv}
+%
+\end{document}
+%</testfile>
+% \fi
+\endinput
diff --git a/Master/texmf-dist/source/latex/currvita/currvita.ins b/Master/texmf-dist/source/latex/currvita/currvita.ins
new file mode 100644
index 00000000000..256c0ad58dd
--- /dev/null
+++ b/Master/texmf-dist/source/latex/currvita/currvita.ins
@@ -0,0 +1,54 @@
+%
+% currvita.ins
+% Batch file, run through LaTeX.
+%
+% Copyright (C) 1999 Axel Reichert
+% See the files README and COPYING.
+%
+\input docstrip.tex
+%
+\declarepreamble\package
+
+LaTeX package for a curriculum vitae
+
+Copyright (C) 1999 Axel Reichert
+See the files README and COPYING.
+
+\endpreamble
+%
+\declarepreamble\testfile
+
+LaTeX sample file for the currvita package
+
+Copyright (C) 1999 Axel Reichert
+See the files README and COPYING.
+
+\endpreamble
+%
+\keepsilent
+%
+\generate{%
+ \usepreamble\package
+ \file{currvita.sty}{\from{currvita.dtx}{package}}%
+ \usepreamble\testfile
+ \file{cvtest.tex}{\from{currvita.dtx}{testfile}}%
+}%
+%
+\Msg{**************************************************************}
+\Msg{*}
+\Msg{* To finish the installation you have to move the following}
+\Msg{* files into a directory searched by LaTeX:}
+\Msg{*}
+\Msg{* \space\space currvita.sty}
+\Msg{*}
+\Msg{* To produce the documentation and an example, run the}
+\Msg{* following files through LaTeX:}
+\Msg{*}
+\Msg{* \space\space currvita.dtx (three times)}
+\Msg{* \space\space cvtest.tex}
+\Msg{*}
+\Msg{* Happy TeXing!}
+\Msg{*}
+\Msg{**************************************************************}
+%
+\endbatchfile