% \iffalse
% $Id: gillcm.dtx,v 1.6 2010-07-30 20:40:55 boris Exp $
%
% Copyright (c) 2010, Boris Veytsman
%
% All rights reserved.
%
% Redistribution and use in source and binary forms, with or without
% modification, are permitted provided that the following conditions
% are met:
%
% * Redistributions of source code must retain the above copyright
% notice, this list of conditions and the following disclaimer.
% * Redistributions in binary form must reproduce the above
% copyright notice, this list of conditions and the following
% disclaimer in the documentation and/or other materials provided
% with the distribution.
% * Neither the name of the original author nor the names of the
% contributors may be used to endorse or promote products derived
% from this software without specific prior written permission.
%
% THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
% CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
% INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
% MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
% DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
% BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
% EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
% TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
% DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
% ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
% OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
% OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
% POSSIBILITY OF SUCH DAMAGE.
%
% \fi
% \CheckSum{138}
%
%
%% \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 \~}
%
%\iffalse
% Taken from xkeyval.dtx
%\fi
%\makeatletter
%\def\DescribeOption#1{\leavevmode\@bsphack
% \marginpar{\raggedleft\PrintDescribeOption{#1}}%
% \SpecialOptionIndex{#1}\@esphack\ignorespaces}
%\def\PrintDescribeOption#1{\strut\emph{option}\\\MacroFont #1\ }
%\def\SpecialOptionIndex#1{\@bsphack
% \index{#1\actualchar{\protect\ttfamily#1}
% (option)\encapchar usage}%
% \index{options:\levelchar#1\actualchar{\protect\ttfamily#1}\encapchar
% usage}\@esphack}
%\def\DescribeOptions#1{\leavevmode\@bsphack
% \marginpar{\raggedleft\strut\emph{options}%
% \@for\@tempa:=#1\do{%
% \\\strut\MacroFont\@tempa\SpecialOptionIndex\@tempa
% }}\@esphack\ignorespaces}
%\makeatother
%
%
% \MakeShortVerb{|}
% \GetFileInfo{gillcm.dtx}
% \title{Unslanted Italic Computer Modern Fonts Based on Eric Gill's Ideas}
% \author{Boris Veytsman\thanks{%
% \href{mailto:borisv@lk.net}{\texttt{borisv@lk.net}},
% \href{mailto:boris@varphi.com}{\texttt{boris@varphi.com}}}}
% \date{\filedate, \fileversion}
% \maketitle
% \begin{abstract}
% This is a demonstration of the use of virtual fonts for unusual
% effects. We employ virtual fonts to implement an old idea of Eric
% Gill. This package was written for the author's talk
% at TUG'2010.
% \end{abstract}
% \tableofcontents
% \listoffigures
% \listoftables
% \clearpage
%
% \changes{v1.0}{2010/05/08}{First fully functional version}
% \changes{v1.1}{2010/07/28}{Documentation update}
%
%\section{Introduction}
%\label{sec:intro}
%
% This package is mostly a demonstration of the use of
% \textsf{Fontinst}~\cite{Jeffrey04:Fontinst} for mixing and changing
% fonts. I wrote it as an appendix for my talk at TUG'2010. Of
% course, as it happens with many teachers, I myself learned a lot
% while making this demo.
%
% The demo assumes some knowledge of \TeX{} and the way of writing
% |dtx| files~\cite{Clsguide}.
%
% Eric Gill said that unslanted italics should use Roman uppercase
% letters~\cite{Gill:Typography}:
% \begin{quote}
% Properly speaking, there is no such thing as an alphabet of italic
% capitals, and where upright or nearly upright italics are used
% ordinary upright Roman capitals go perfectly well with them.
% \end{quote}
%
% Let us create a font with italic lowercase and upright uppercase.
% Actually we create \emph{two} fonts: one based on ``normal'', i.e.
% slanted italics, and one based on unslanted ones (we call them
% |gishape| and |gushape|). In both cases we start with Computer
% Modern Italics, and perform all changes using virtual fonts
% mechanism.
%
% Alan Hoenig in his book~\cite{Hoenig98:TeXUnbound} gives another
% example of a font based on Gill's idea.
%
%
% A couple words about the installation of the system. You need the file
% \url{http://ctan.tug.org/install/fonts/psfonts/public/gillcm.tds.zip}/
% Unzip this file in \path{$TEXMF}. Add |+cmg.map| to the
% configuration files of dvips, pdftex and your dvi previewer. How
% exactly you do this depends on the \TeX{} distribution you use. For \TeX Live you create a file
% \path{$TEXMF/updmap.d/50gcm.cfg} with just the line
% \begin{verbatim}
% Map gcm.map
% \end{verbatim}
% and then run |texhash| and |updmap|. If you use Debian or Ubuntu,
% the system-wide |updmap.d| directory is located in |/etc|, and you
% need to create the file |gcm.list| in
% \path{/var/lib/tex-common/fontmap-cfg/} with the line
% \begin{verbatim}
% 50gcm
% \end{verbatim}
%
%
% If you use Mik\TeX2.6, run
% \begin{verbatim}
% initexmf --edit-config-file updmap
% \end{verbatim}
% Add to the config file
% \begin{verbatim}
% Map gcm.map
% \end{verbatim}
% save, exit and run |updmap|.
%
% If you use Mik\TeX2.5 or earlier, edit
% \path{localtexmf\web2c\updmap.cfg}, adding the line
% \begin{verbatim}
% Map gcm.map
% \end{verbatim}
% and run |updmap|.
%
% After this run updmap and texhash programs to update the
% configuration files and file names database.
%
% Refer to your distribution documentation for the further details.
%
%
%
%
%\DescribeMacro{\gishape}
%\DescribeMacro{\gushape}
% To use the fonts in \LaTeX{} just add
% |\usepackage{gillcm}| to the preamble of your document. The style
% adds two new commands |\gishape| and |\gushape| that typeset
% ``Gillized'' italics and ``Gillized'' upright italics.
%
%
%
%
% \StopEventually{
%
% \section{Acknowledgements}
%
% Most of the things I know about virtual fonts I learned from the
% excellent book~\cite{Hoenig98:TeXUnbound} and the
% manual~\cite{fontinstallationguide}. I am grateful to \TeX{} Users
% Group and Karl Berry for encouraging my interest in virtual fonts
% and to my consulting customers for their support of my font
% projects.
%
% \bibliography{gillcm}
% \bibliographystyle{unsrt}}
%
%\section{Implementation}
%\label{sec:impl}
%
%\subsection{Identification}
%\label{sec:ident}
%
%
% We start with the declaration who we are. Most |.dtx| files put
% driver code in a separate driver file |.drv|. We roll this code into the
% main file, and use the pseudo-guard || for it. This means
% that the text between |<*gobble>| and || will \emph{not}
% end in any derived file, but it will be used to typeset this manual.
%
% We also use the following guards: |
% \end{macrocode}
%
%
%\subsection{Creation of Installation Archive}
%\label{sec:tds}
%
% The last step is to put all the files in the structure suitable for
% the modern \TeX{} installations (the so called TDS structure). We
% will create the archive |gillcm.tds.zip| with the relevant files.
% The archive is packed into the |gillcm.tgz| file ready to be shipped
% to CTAN. Of course, we do not want to ship Computer Modern fonts,
% so we delete them from the directory first.
%
% The corresponding fragment of |Makefile| is shown on
% Figure~\ref{fig:archive}.
%
% \begin{figure}
% \centering
% \begin{verbatim}
% archive: all clean
% $(RM) cmr*.tfm cmt*.tfm cmb*.tfm
% $(RM) cmr*.afm cmt*.afm cmb*.afm
% $(RM) cmr*.vf cmt*.vf cmb*.vf
% mkdir -p fonts/tfm/$(FOUNDRY)/$(PACKAGE)
% cp *.tfm fonts/tfm/$(FOUNDRY)/$(PACKAGE)
% mkdir -p fonts/vf/$(FOUNDRY)/$(PACKAGE)
% cp *.vf fonts/vf/$(FOUNDRY)/$(PACKAGE)
% mkdir -p fonts/map/dvips/$(PACKAGE)
% cp *.map fonts/map/dvips/$(PACKAGE)
% mkdir -p tex/latex/$(PACKAGE)
% cp *.fd *.sty tex/latex/$(PACKAGE)
% mkdir -p doc/latex/$(PACKAGE)
% cp README *.pdf *.tex *.bib *.dtx *.ins doc/latex/$(PACKAGE)
% zip -r $(PACKAGE).tds.zip fonts tex doc
% tar -czvf $(PACKAGE).tgz \
% README $(PACKAGE).tds.zip *.tex *.pdf *.bib *.dtx *.ins
% \end{verbatim}
% \caption{Creation of Installation File for CTAN}
% \label{fig:archive}
% \end{figure}
%
%
% This finishes our task!
%
%\Finale
%\clearpage
%
%\PrintChanges
%\clearpage
%\PrintIndex
%
\endinput