diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /fonts/bbding/bbding.dtx |
Initial commit
Diffstat (limited to 'fonts/bbding/bbding.dtx')
-rw-r--r-- | fonts/bbding/bbding.dtx | 841 |
1 files changed, 841 insertions, 0 deletions
diff --git a/fonts/bbding/bbding.dtx b/fonts/bbding/bbding.dtx new file mode 100644 index 0000000000..2375cbd587 --- /dev/null +++ b/fonts/bbding/bbding.dtx @@ -0,0 +1,841 @@ +%\manfnttrue ^^A remove this line if the manualfont is not on your system +%\UsersGuidetrue ^^A remove this line to print the full documentation. +% +%\iffalse metacomment +% (c)1995--99 Peter Møller Neergaard +% +% This files may be distributed under the terms of the LaTeX Project Public +% License, as described in lppl.txt in the base LaTeX distribution. +% Either version 1.0 or, at your option, any later version. +% +% For information about the copyright of the metafont sources for bbding, +% please refer to the file ..... +% +% Install by running tex with "bbding.ins". +% +% To get the documentation run latex twice on this file and then print the +% file bbding.dvi. Note that the documentation can be processed without +% the fontmetrices available, the symbols will however be missing. +% +% This file is distributed in the hope that it will be useful, +% but WITHOUT ANY WARRANTY; without even the implied warranty of +% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +%\fi +% \CheckSum{643} +% \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 \~} +% +% +% ^^A I would not like to have the standard LaTeX commands in the index +% ^^A This is taken from `doc.dtx' +% \DoNotIndex{\@,\@@par,\@beginparpenalty,\@empty} +% \DoNotIndex{\@flushglue,\@gobble,\@input} +% \DoNotIndex{\@makefnmark,\@makeother,\@maketitle} +% \DoNotIndex{\@namedef,\@ne,\@spaces,\@tempa} +% \DoNotIndex{\@tempb,\@tempswafalse,\@tempswatrue} +% \DoNotIndex{\@thanks,\@thefnmark,\@topnum} +% \DoNotIndex{\@@,\@elt,\@forloop,\@fortmp,\@gtempa,\@totalleftmargin} +% \DoNotIndex{\",\/,\@ifundefined,\@nil,\@verbatim,\@vobeyspaces} +% \DoNotIndex{\|,\~,\ ,\active,\advance,\aftergroup,\begingroup,\bgroup} +% \DoNotIndex{\mathcal,\csname,\def,\documentstyle,\dospecials,\edef} +% \DoNotIndex{\egroup} +% \DoNotIndex{\else,\endcsname,\endgroup,\endinput,\endtrivlist} +% \DoNotIndex{\expandafter,\fi,\fnsymbol,\futurelet,\gdef,\global} +% \DoNotIndex{\hbox,\hss,\if,\if@inlabel,\if@tempswa,\if@twocolumn} +% \DoNotIndex{\ifcase} +% \DoNotIndex{\ifcat,\iffalse,\ifx,\ignorespaces,\index,\input,\item} +% \DoNotIndex{\jobname,\kern,\leavevmode,\leftskip,\let,\llap,\lower} +% \DoNotIndex{\m@ne,\next,\newpage,\nobreak,\noexpand,\nonfrenchspacing} +% \DoNotIndex{\obeylines,\or,\protect,\raggedleft,\rightskip,\rm,\sc} +% \DoNotIndex{\setbox,\setcounter,\small,\space,\string,\strut} +% \DoNotIndex{\strutbox} +% \DoNotIndex{\thefootnote,\thispagestyle,\topmargin,\trivlist,\tt} +% \DoNotIndex{\twocolumn,\typeout,\vss,\vtop,\xdef,\z@} +% \DoNotIndex{\,,\@bsphack,\@esphack,\@noligs,\@vobeyspaces,\@xverbatim} +% \DoNotIndex{\`,\catcode,\end,\escapechar,\frenchspacing,\glossary} +% \DoNotIndex{\hangindent,\hfil,\hfill,\hskip,\hspace,\ht,\it,\langle} +% \DoNotIndex{\leaders,\long,\makelabel,\marginpar,\markboth,\mathcode} +% \DoNotIndex{\mathsurround,\mbox,\newcount,\newdimen,\newskip} +% \DoNotIndex{\nopagebreak} +% \DoNotIndex{\parfillskip,\parindent,\parskip,\penalty,\raise,\rangle} +% \DoNotIndex{\section,\setlength,\TeX,\topsep,\underline,\unskip,\verb} +% \DoNotIndex{\vskip,\vspace,\widetilde,\\,\%,\@date,\@defpar} +% \DoNotIndex{\[,\{,\},\]} +% \DoNotIndex{\count@,\ifnum,\loop,\today,\uppercase,\uccode} +% \DoNotIndex{\baselineskip,\begin,\tw@} +% \DoNotIndex{\a,\b,\c,\d,\e,\f,\g,\h,\i,\j,\k,\l,\m,\n,\o,\p,\q} +% \DoNotIndex{\r,\s,\t,\u,\v,\w,\x,\y,\z,\A,\B,\C,\D,\E,\F,\G,\H} +% \DoNotIndex{\I,\J,\K,\L,\M,\N,\O,\P,\Q,\R,\S,\T,\U,\V,\W,\X,\Y,\Z} +% \DoNotIndex{\1,\2,\3,\4,\5,\6,\7,\8,\9,\0} +% \DoNotIndex{\!,\#,\$,\&,\',\(,\),\+,\.,\:,\;,\<,\=,\>,\?,\_} +% \DoNotIndex{\discretionary,\immediate,\makeatletter,\makeatother} +% \DoNotIndex{\meaning,\newenvironment,\par,\relax,\renewenvironment} +% \DoNotIndex{\repeat,\scriptsize,\selectfont,\the,\undefined} +% \DoNotIndex{\arabic,\do,\makeindex,\null,\number,\show,\write,\@ehc} +% \DoNotIndex{\@author,\@ehc,\@ifstar,\@sanitize,\@title,\everypar} +% \DoNotIndex{\if@minipage,\if@restonecol,\ifeof,\ifmmode} +% \DoNotIndex{\lccode,\newtoks,\onecolumn,\openin,\p@,\SelfDocumenting} +% \DoNotIndex{\settowidth,\@resetonecoltrue,\@resetonecolfalse,\bf} +% \DoNotIndex{\clearpage,\closein,\lowercase,\@inlabelfalse} +% \DoNotIndex{\selectfont,\mathcode,\newmathalphabet,\rmdefault} +% \DoNotIndex{\bfdefault} +% +% ^^A Exclude commands used for generating the index +% \DoNotIndex{\CodelineIndex,\DeleteShortVerb,\DisableCrossrefs} +% \DoNotIndex{\EnableCrossrefs,\OnlyDescription,\RecordChanges} +% +% \ifUsersGuide +% \OnlyDescription +% \DisableCrossrefs +% \else +% \RecordChanges +% \fi +% +% \GetFileInfo{bbding.sty} +% +% \title{The \bbding-package\thanks +% {This file has \fileversion\ and is dated \filedate}} +% \author{Karel Horak\thanks{Made the \METAFONT-source for the font.} \\ +% Peter Møller Neergaard\thanks{Implemented the \LaTeXe-package.} \\ +% \texttt{turtle}@\texttt{diku.dk} \quad \texttt{http://www.diku.dk/students/turtle}\\ +% Sergue{\"i} Dachian\thanks{Fixed a bug in the symbols for scissors}} +% +% \maketitle +% +% \begin{abstract} +% This package provides an easy-to-use interface to the \texttt{bbding} symbol +% set developed by \emph{Karel Horak}. The naming conventions is made +% close to \emph{Zapf-Dingbat} as it can be found in \package{Wordperfect +% 6.0}, however, sometimes shortening the names. +% \end{abstract} +% +% ^^A Two column table of contents --- borrowed from ``doc.dtx'' +% \ifmulticols +% \addtocontents{toc}{\protect\begin{multicols}{2}} +% \fi +% +% {\parskip 0pt ^^A We have to reset \parskip +% ^^A (bug in \LaTeX) +% \tableofcontents +% } +% +% A special thought should be given to \emph{Mauro Orlandini} and \emph{Max +% Hailperin} who developed a macro for setting paragraphs in parallel. This +% saved me for a lot of work, when developing this manual. +% +% \section{Usage and Symbols} +% +% \noindent +% \bbding\ provides an easy to use interface to the |bbding|-symbolfont +% set. It is loaded by issusing the command +% |\usepackage{bbding}| in your document preamble. +% +% You have the symbols shown in the following tables at your disposal. All +% the symbols are used issuing the command written to the right of the symbol. +% +% \begin{figure} \small +% \begin{commandsInColumns}{2} +% \ScissorRight +% \ScissorRightBrokenBottom +% \ScissorRightBrokenTop +% \ScissorHollowRight +% \ScissorLeft +% \ScissorLeftBrokenBottom +% \ScissorLeftBrokenTop +% \ScissorHollowLeft +% \end{commandsInColumns} +% \caption{Scissors} +% \end{figure} + +% +% \begin{figure} \small +% \begin{commandsInColumns}{3} +% \HandRight +% \HandRightUp +% \HandCuffRight +% \HandCuffRightUp +% \HandLeft +% \HandLeftUp +% \HandCuffLeft +% \HandCuffLeftUp +% \HandPencilLeft +% \end{commandsInColumns} +% \caption{Hands} +% \end{figure} +% +% \begin{figure} \small +% \begin{commandsInColumns}{3} +% \PencilRight +% \PencilRightUp +% \PencilRightDown +% \PencilLeft +% \PencilLeftUp +% \PencilLeftDown +% \NibRight +% \NibSolidRight +% \NibLeft +% \NibSolidLeft +% \end{commandsInColumns} +% \caption{Writing tools} +% \end{figure} +% +% \begin{figure} \small +% \begin{commandsInColumns}{3} +% \XSolid +% \XSolidBold +% \XSolidBrush +% \Plus +% \PlusOutline +% \PlusCenterOpen +% \PlusThinCenterOpen +% \Cross +% \CrossOpenShadow +% \CrossOutline +% \CrossBoldOutline +% \CrossClowerTips +% \CrossMaltese +% \end{commandsInColumns} +% \caption{Crosses, plusses and the like} +% \end{figure} +% +% \begin{figure} \small +% \begin{commandsInColumns}{3} +% \DavidStar +% \DavidStarSolid +% \JackStar +% \JackStarBold +% \FourStar +% \FourStarOpen +% \FiveStar +% \FiveStarLines +% \FiveStarOpen +% \FiveStarOpenCircled +% \FiveStarCenterOpen +% \FiveStarOpenDotted +% \FiveStarOutline +% \FiveStarOutlineHeavy +% \FiveStarConvex +% \FiveStarShadow +% \SixStar +% \EightStar +% \EightStarBold +% \EightStarTaper +% \EightStarConvex +% \TwelweStar +% \SixteenStarLight +% \Asterisk +% \AsteriskBold +% \AsteriskCenterOpen +% \AsteriskThin +% \AsteriskThinCenterOpen +% \AsteriskRoundedEnds +% \FourAsterisk +% \EightAsterisk +% \end{commandsInColumns} +% \caption{All kind of stars} +% \end{figure} +% +% \begin{figure} \small +% \begin{commandsInColumns}{2} +% \FiveFlowerOpen +% \FiveFlowerPetal +% \SixFlowerOpenCenter +% \SixFlowerRemovedOpenPetal +% \SixFlowerAlternate +% \SixFlowerAltPetal +% \SixFlowerPetalDotted +% \SixFlowerPetalRemoved +% \EightFlowerPetalRemoved +% \EightFlowerPetal +% \FourClowerOpen +% \FourClowerSolid +% \Sparkle +% \SparkleBold +% \SnowflakeChevron +% \SnowflakeChevronBold +% \Snowflake +% \end{commandsInColumns} +% \caption{Flowers, snowflakes and the like} +% \end{figure} +% +% \begin{figure} \small +% \begin{commandsInColumns}{2} +% \CircleSolid +% \CircleShadow +% \HalfCircleRight +% \HalfCircleLeft +% \Ellipse +% \EllipseSolid +% \EllipseShadow +% \Square +% \SquareSolid +% \SquareShadowBottomRight +% \SquareShadowTopRight +% \SquareShadowTopLeft +% \SquareCastShadowBottomRight +% \SquareCastShadowTopRight +% \SquareCastShadowTopLeft +% \TriangleUp +% \TriangleDown +% \DiamondSolid +% \OrnamentDiamondSolid +% \RectangleThin +% \Rectangle +% \RectangleBold +% \end{commandsInColumns} +% \caption{Geometrical Shapes} +% \end{figure} +% +% \begin{figure} \small +% \begin{commandsInColumns}{3} +% \Phone +% \PhoneHandset +% \Tape +% \Plane +% \Envelope +% \Peace +% \Checkmark +% \CheckmarkBold +% \SunshineOpenCircled +% \ArrowBoldRightStrobe +% \ArrowBoldUpRight +% \ArrowBoldDownRight +% \ArrowBoldRightShort +% \ArrowBoldRightCircled +% \end{commandsInColumns} +% \caption{Miscellaneous} +% \end{figure} +% \clearpage +% \section{How to Install \texttt{bbding}} +% +% I suppose that you have already got the file |bbding10.mf| containing the \METAFONT-source for the +% \bbding-symbol set from your nearest CTAN-site. It should be placed in a +% directory, where it can be found by \METAFONT. +% +% Then generate the font-metrices |bbding10.tfm| using \METAFONT\ (ask your +% system administrator for details). This is done from a command line issusing, say: +% \begin{code} +% |metafont \mode=|\meta{localmode}|; input bbding10| +% \end{code} +% where \meta{localmode} is one of the modes defined in your local setup +% file, |local.mf|, for \METAFONT. Move the resulting |bbding10.tfm| +% to a directory in the path, where \LaTeX\ looks for |.tfm|-files. If it +% had also generated the bitmap-file, move it to a location, where you +% favourite DVI-viewer can find it. +% +% As the last thing install the package file, by running \TeX\ +% with the file |bbding.ins|. This generates two files: |bbding.sty| and +% |Uding.fd|. |bbding.sty| is the packages file, which is loaded by +% \LaTeX\ and |Uding.fd| contains the loading information about the font. +% +% If the manualfont |manfnt.tfm|---which is only used to generate the logo +% for \METAFONT---is not installed at your system, you should +% remove the first line of this file +% \begin{code} +% |%\manfnttrue ^^A remove this line if|\lttdots\hss +% \end{code} +% +% This file is documented using \package{doc}. This means that documentation +% and commented packagecode is contained in the single file +% |bbding.dtx|. If you want to see the full documentation, you should remove +% the second line of the file |bbding.dtx| +% \begin{code} +% |%\UsersGuidetrue ^^A remove this line|\lttdots +% \end{code} +% and then run \LaTeX\ on the changed file. After this you should generate +% the change history using |makeindex|: +% \begin{code} +% |makeindex -s gglo.ist -o bbding.gls bbding.glo|\hss +% \end{code} +% After this process the file once more. +% +% \medskip +% \parmark[\copyright]^^A +% At last the borrowing formal stuff: You a encouraged to copy, use, delete +% etc.\ the package (|bbding.dtx|, |dingbat.fd| and |semantic.ins|) as much as +% your heart desires as long as you pass it on in complete. +% You are welcome to sneak in the code and get inspiration. You should just +% remember: {\small \copyright 1993 Karel Horak for the \METAFONT-source and +% \copyright 1995--1996 Peter Møller Neergaard for the style file} +% +% \StopEventually{ +% \ifmulticols +% \addtocontents{toc}{\protect\end{multicols}} +% \fi +% } +% +% \section{The Code of \texttt{bbding.dtx}} +% +% \ifmulticols +% \begin{multicols}{2}[\subsection{To e Done (In Priority)}] +% \else +% \subsection{To Be Done (Priority)} +% \fi +% +% \begin{columnItemize} +% \item Add check for the existence of |manfnt.tfm| instead of using the +% flag |\ifmanfnt|. |\checkfont| in |ltxcheck.tex| should be the right +% place to get the inspiration (thanks to \emph{David Carlisle}). + +% \end{columnItemize} +% +% \ifmulticols +% \end{multicols} +% \fi +% +% \subsection{Overview of the Code} +% \changes{1.0}{1996/02/02}{Finished the naming and documentation} +% \changes{1.01}{1999/04/15}{Fixed a bug in the \METAFONT\ source for scissors} +% +% The code consits of five parts: +% +% \begin{itemize} +% \item A hack making it possible to process the rest of the file without +% the package yet installed. +% \item The package header for |bbding.sty|. +% \item The font definitions, which will be put in |Uding.fd| by +% \package{docstrip} and which alse should be used, when printing the +% documentation. +% \item The name definitions, which primarily is intended for +% |bbding.sty|. It is also used in the documentation, thereby making the +% processing of the documentaion possible without the documentation +% installed. +% \item The driver program for preparing the documentation. +% \end{itemize} +% +% \subsection{Stub for Users Guide and Documentation} +% +% First comes a little hack, that makes \LaTeX\ thinks it is loading the +% package \texttt{bbding.sty}. In this way the commands in the +% package can be used---without warnings---when printing the documentation. +% \begin{macrocode} +%<*documentation> + \makeatletter \def\@currname{bbding} +\def\@currext{sty} +%</documentation> +% \end{macrocode} +% |\@currname| and |\@currext| is internal \LaTeX-macros containg the name +% respectively extension of the package currently being loaded. The code is +% encapsulated in |<*documentation>|\lttdots|</documentation>| so that it is +% not included in the style-file, when installing the package. +% +% \subsection{Header of \texttt{bbding.sty}} +% +% First in |bbding.sty| comes the code that identifies the file as a +% \LaTeXe-package +% \begin{macrocode} +%<*sty> +\NeedsTeXFormat{LaTeX2e} +\ProvidesPackage{bbding}% + [1999/04/15 v1.01 Dingbats symbols% + ] +%</sty> +% \end{macrocode} +% +% \subsection{Defining the Fonts for Use} +% +% Before using the fonts the declaration of the font family should be done. +% This is (by convention) kept in |Uding.fd|, which starts by introducing +% itself to \LaTeX. Then the family |ding| is declared and defined in +% one shape (medium (|n|) weight and width) and it is told that all sizes +% comes from scaling the 10pt font. +% +% \begin{macrocode} +%<*fd> +\ProvidesFile{Uding.fd} + [1996/02/01 v1.0 BBding font definitions% + ] +\DeclareFontFamily{U}{ding}{} +\DeclareFontShape{U}{ding}{m}{n}{% + <-> bbding10 }{} +%</fd> +% \end{macrocode} +% +% |Uding.fd| is not loaded until the font is actually used, which is +% the first time that the command |\dingfamily| is used. This command is +% defined in the packagefile: +% +% \begin{macrocode} +%<*sty> +\newcommand{\dingfamily}{\fontencoding{U}\fontfamily{ding}\selectfont} +% \end{macrocode} +% +% \subsection{Definition of Each Symbol} +% +% \begin{macro}{\@chooseSymbol} +% It would unnormal to use more than one symbol at a time, so I +% define a macro for chosing one symbol in the font. This macro is +% called by each of symbolsmacros. This keeps the definitions of the +% names simple and probably saves memory. I see no reason to define a +% ``|\textding|'' command as symbols would be used only one (or perhaps +% two) at a time. +% \begin{macrocode} +\newcommand{\@chooseSymbol}[1]{{\dingfamily\symbol{#1}}} +% \end{macrocode} +% This macro does the fontchange locally by encapsulating it in a group and +% then sets the symbol with the desired number. +% \end{macro} +% +% Then comes the definition of for each symbol: +% As mentioned in the abstract the naming convention is inspired by the +% names used in \package{Wordperfect 6.0} font set 5. I have however +% shortened the +% names. I have made a sligtly difference from the \LaTeX\ convention +% by capitalizing the first letter of each word, which seems more +% readable to me. +% \begin{macrocode} +\newcommand{\ScissorRightBrokenBottom}{\@chooseSymbol{'000}} +\newcommand{\ScissorRight}{\@chooseSymbol{'001}} +\newcommand{\ScissorRightBrokenTop}{\@chooseSymbol{'002}} +\newcommand{\ScissorLeftBrokenBottom}{\@chooseSymbol{'003}} +\newcommand{\ScissorLeft}{\@chooseSymbol{'004}} +\newcommand{\ScissorLeftBrokenTop}{\@chooseSymbol{'005}} +\newcommand{\ScissorHollowRight}{\@chooseSymbol{'006}} +\newcommand{\ScissorHollowLeft}{\@chooseSymbol{'007}} +\newcommand{\Phone}{\@chooseSymbol{'010}} +\newcommand{\PhoneHandset}{\@chooseSymbol{'011}} +\newcommand{\Tape}{\@chooseSymbol{'012}} +\newcommand{\Plane}{\@chooseSymbol{'013}} +\newcommand{\Envelope}{\@chooseSymbol{'014}} +\newcommand{\HandCuffRight}{\@chooseSymbol{'015}} +\newcommand{\HandCuffLeft}{\@chooseSymbol{'016}} +\newcommand{\HandCuffRightUp}{\@chooseSymbol{'017}} +\newcommand{\HandCuffLeftUp}{\@chooseSymbol{'020}} +\newcommand{\HandRight}{\@chooseSymbol{'021}} +\newcommand{\HandLeft}{\@chooseSymbol{'022}} +\newcommand{\HandRightUp}{\@chooseSymbol{'023}} +\newcommand{\HandLeftUp}{\@chooseSymbol{'024}} +\newcommand{\Peace}{\@chooseSymbol{'025}} +\newcommand{\HandPencilLeft}{\@chooseSymbol{'026}} +\newcommand{\PencilRight}{\@chooseSymbol{'027}} +\newcommand{\PencilLeft}{\@chooseSymbol{'030}} +\newcommand{\PencilRightUp}{\@chooseSymbol{'031}} +\newcommand{\PencilLeftUp}{\@chooseSymbol{'032}} +\newcommand{\PencilRightDown}{\@chooseSymbol{'033}} +\newcommand{\PencilLeftDown}{\@chooseSymbol{'034}} +\newcommand{\NibRight}{\@chooseSymbol{'035}} +\newcommand{\NibLeft}{\@chooseSymbol{'036}} +\newcommand{\NibSolidRight}{\@chooseSymbol{'037}} +\newcommand{\NibSolidLeft}{\@chooseSymbol{'040}} +\newcommand{\Checkmark}{\@chooseSymbol{'041}} +\newcommand{\CheckmarkBold}{\@chooseSymbol{'042}} +\newcommand{\XSolid}{\@chooseSymbol{'043}} +\newcommand{\XSolidBold}{\@chooseSymbol{'044}} +\newcommand{\XSolidBrush}{\@chooseSymbol{'045}} +\newcommand{\PlusOutline}{\@chooseSymbol{'046}} +\newcommand{\Plus}{\@chooseSymbol{'047}} +\newcommand{\PlusCenterOpen}{\@chooseSymbol{'050}} +\newcommand{\PlusThinCenterOpen}{\@chooseSymbol{'051}} +\newcommand{\Cross}{\@chooseSymbol{'052}} +\newcommand{\CrossOpenShadow}{\@chooseSymbol{'053}} +\newcommand{\CrossOutline}{\@chooseSymbol{'054}} +\newcommand{\CrossBoldOutline}{\@chooseSymbol{'055}} +\newcommand{\CrossMaltese}{\@chooseSymbol{'056}} +\newcommand{\DavidStarSolid}{\@chooseSymbol{'057}} +\newcommand{\DavidStar}{\@chooseSymbol{'060}} +\newcommand{\FourAsterisk}{\@chooseSymbol{'061}} +\newcommand{\JackStar}{\@chooseSymbol{'062}} +\newcommand{\JackStarBold}{\@chooseSymbol{'063}} +\newcommand{\CrossClowerTips}{\@chooseSymbol{'064}} +\newcommand{\FourStar}{\@chooseSymbol{'065}} +\newcommand{\FourStarOpen}{\@chooseSymbol{'066}} +\newcommand{\FiveStarLines}{\@chooseSymbol{'067}} +\newcommand{\FiveStar}{\@chooseSymbol{'070}} +\newcommand{\FiveStarOpen}{\@chooseSymbol{'071}} +\newcommand{\FiveStarOpenCircled}{\@chooseSymbol{'072}} +\newcommand{\FiveStarCenterOpen}{\@chooseSymbol{'073}} +\newcommand{\FiveStarOpenDotted}{\@chooseSymbol{'074}} +\newcommand{\FiveStarOutline}{\@chooseSymbol{'075}} +\newcommand{\FiveStarOutlineHeavy}{\@chooseSymbol{'076}} +\newcommand{\FiveStarConvex}{\@chooseSymbol{'077}} +\newcommand{\FiveStarShadow}{\@chooseSymbol{'100}} +\newcommand{\AsteriskBold}{\@chooseSymbol{'101}} +\newcommand{\AsteriskCenterOpen}{\@chooseSymbol{'102}} +\newcommand{\AsteriskThin}{\@chooseSymbol{'103}} +\newcommand{\AsteriskThinCenterOpen}{\@chooseSymbol{'104}} +\newcommand{\EightStarTaper}{\@chooseSymbol{'105}} +\newcommand{\EightStarConvex}{\@chooseSymbol{'106}} +\newcommand{\SixStar}{\@chooseSymbol{'107}} +\newcommand{\EightStar}{\@chooseSymbol{'110}} +\newcommand{\EightStarBold}{\@chooseSymbol{'111}} +\newcommand{\TwelweStar}{\@chooseSymbol{'112}} +\newcommand{\SixteenStarLight}{\@chooseSymbol{'113}} +\newcommand{\SixFlowerPetalRemoved}{\@chooseSymbol{'114}} +\newcommand{\SixFlowerOpenCenter}{\@chooseSymbol{'115}} +\newcommand{\Asterisk}{\@chooseSymbol{'116}} +\newcommand{\SixFlowerAlternate}{\@chooseSymbol{'117}} +\newcommand{\FiveFlowerPetal}{\@chooseSymbol{'120}} +\newcommand{\SixFlowerPetalDotted}{\@chooseSymbol{'121}} +\newcommand{\FiveFlowerOpen}{\@chooseSymbol{'122}} +\newcommand{\EightFlowerPetal}{\@chooseSymbol{'123}} +\newcommand{\SunshineOpenCircled}{\@chooseSymbol{'124}} +\newcommand{\SixFlowerAltPetal}{\@chooseSymbol{'125}} +\newcommand{\FourClowerOpen}{\@chooseSymbol{'126}} +\newcommand{\FourClowerSolid}{\@chooseSymbol{'127}} +\newcommand{\AsteriskRoundedEnds}{\@chooseSymbol{'130}} +\newcommand{\EightFlowerPetalRemoved}{\@chooseSymbol{'131}} +\newcommand{\EightAsterisk}{\@chooseSymbol{'132}} +\newcommand{\SixFlowerRemovedOpenPetal}{\@chooseSymbol{'133}} +\newcommand{\SparkleBold}{\@chooseSymbol{'134}} +\newcommand{\Sparkle}{\@chooseSymbol{'135}} +\newcommand{\SnowflakeChevron}{\@chooseSymbol{'136}} +\newcommand{\SnowflakeChevronBold}{\@chooseSymbol{'137}} +\newcommand{\Snowflake}{\@chooseSymbol{'140}} +\newcommand{\CircleSolid}{\@chooseSymbol{'141}} +\newcommand{\Ellipse}{\@chooseSymbol{'142}} +\newcommand{\EllipseSolid}{\@chooseSymbol{'143}} +\newcommand{\CircleShadow}{\@chooseSymbol{'144}} +\newcommand{\EllipseShadow}{\@chooseSymbol{'145}} +\newcommand{\Square}{\@chooseSymbol{'146}} +\newcommand{\SquareSolid}{\@chooseSymbol{'147}} +\newcommand{\SquareShadowBottomRight}{\@chooseSymbol{'150}} +\newcommand{\SquareShadowTopRight}{\@chooseSymbol{'151}} +\newcommand{\SquareShadowTopLeft}{\@chooseSymbol{'152}} +\newcommand{\SquareCastShadowBottomRight}{\@chooseSymbol{'153}} +\newcommand{\SquareCastShadowTopRight}{\@chooseSymbol{'154}} +\newcommand{\SquareCastShadowTopLeft}{\@chooseSymbol{'155}} +\newcommand{\TriangleUp}{\@chooseSymbol{'156}} +\newcommand{\TriangleDown}{\@chooseSymbol{'157}} +\newcommand{\DiamondSolid}{\@chooseSymbol{'160}} +\newcommand{\OrnamentDiamondSolid}{\@chooseSymbol{'161}} +\newcommand{\HalfCircleRight}{\@chooseSymbol{'162}} +\newcommand{\HalfCircleLeft}{\@chooseSymbol{'163}} +\newcommand{\RectangleThin}{\@chooseSymbol{'164}} +\newcommand{\Rectangle}{\@chooseSymbol{'165}} +\newcommand{\RectangleBold}{\@chooseSymbol{'166}} +\newcommand{\ArrowBoldRightStrobe}{\@chooseSymbol{'167}} +\newcommand{\ArrowBoldUpRight}{\@chooseSymbol{'170}} +\newcommand{\ArrowBoldDownRight}{\@chooseSymbol{'171}} +\newcommand{\ArrowBoldRightShort}{\@chooseSymbol{'172}} +\newcommand{\ArrowBoldRightCircled}{\@chooseSymbol{'173}} +%</sty> +% \end{macrocode} +% When naming I have tried to keep a maxium of four words per name. I have +% however made a few exception to have a consistent naming. +% +% \subsection{Driver for the Documentation} +% +% The package-file (|bbding.dtx|) is ended by the \LaTeX-preamble to produce +% the documentation. By placing it at the end, all the commands in the +% package can be used when processing the documentation, though the +% package is not yet installed on the system. The fontmetrices and -bitmaps +% should however be generated before. +% \begin{macrocode} +%<*documentation> +\documentclass{ltxdoc} +\usepackage[T1]{fontenc} + +\newif\ifmulticols + \IfFileExists{multicol.sty}{\multicolstrue}{} + +\newif\ifmanfnt +\newif\ifUsersGuide + +\newcommand{\lttdots}{\ensuremath{\mathtt{\ldots}}} +\newcommand{\CSname}[1]{\texttt{\protect\bslash#1}} +\newcommand{\package}[1]{\textsf{#1}} +\newcommand{\bbding}{\texttt{bbding}} + +\DeclareFontFamily{U}{manual}{} +\DeclareFontShape{U}{manual}{m}{n}{<-> manfnt }{} +\newcommand{\METAFONT}{% + \ifmanfnt + {\fontencoding{U}\fontfamily{manual}\selectfont + \symbol{47}\symbol{48}\symbol{49}\symbol{50}\-% + \symbol{51}\symbol{52}\symbol{53}\symbol{49}}% + \else METAFONT\fi} + + +\def\GetInfo#1{% + \def\filename{#1}% + {\def\ver##1(##2)##3\relax{% + \def\tc{##1}% + \def\td{##2}% + \ifx \td\empty % + \else % + \edef\td{$\csname ##2\endcsname$}% + \fi}% + \def\tb##1 v##2 ##3\end{% + \gdef\filedate{##1}% + \ver ##2()\relax% + \xdef\fileversion{\tc\expandafter\noexpand\td}% + \gdef\fileinfo{##3}}% + \edef\ta{\csname ver@#1\endcsname}% + \expandafter\tb\ta\end\relax}} + +\def\setn@me#1#2{$\backslash$#2} +{\catcode`\^^M=12% + \gdef\st@rtenv{\@ifnextchar^^M{\dropnext\setCommand}{\setCommand}}% + \gdef\setCommand#1#2^^M{% + \hbox to 1cm{#1}\hbox{\expandafter\setn@me\string#1} % + \@ifnextchar\end{}{\setCommand}% +}} + + +\newtoks\p@rm@rk +\newcommand{\setparagraphmark}[1]{\p@rm@rk={#1}} +\newcommand{\parmark}[1][\the\p@rm@rk]{% + \setbox0=\hbox{\huge #1}% + \clubpenalty=10000% + \noindent\hangindent=\wd0 \hangafter=-2% + \llap{\raise.35em\hbox{\vbox to0pt{\box0 \vss}\hfill}}} + +\newenvironment{code}{\begin{verse}\small}{\end{verse}} +\newenvironment{columnItemize}% + {\begin{list}% + {$\bullet$}% + {\settowidth{\labelwidth}{$\bullet$}% + \setlength{\leftmargin}{5mm}% + \setlength{\labelsep}{\leftmargin}% + \addtolength{\labelsep}{-\labelwidth}}}% + {\end{list}} + +\newcount\c@lumnsleft +\newcount\t@talcolumns +\newdimen\c@lumnwidth +\newenvironment{commandsInColumns}[1]{% + \t@talcolumns=#1\advance\t@talcolumns-1\c@lumnsleft=\t@talcolumns% + \c@lumnwidth=-2em\multiply\c@lumnwidth by \t@talcolumns% + \advance\c@lumnwidth by\hsize \divide\c@lumnwidth by #1% + \vskip\z@ % Ensures vertical mode + \catcode`\^^M=12% + \hbox\bgroup% + \st@rtenv% +} +{\ifnum\c@lumnsleft=\t@talcolumns \egroup + \else \egroup \fi} + +{\catcode`\^^M=12% + \gdef\st@rtenv{\@ifnextchar^^M{\dr@pnext\doNextComm@nd}{\doNextComm@nd}}% + \gdef\setComm@nd#1#2^^M{% + \hbox to \c@lumnwidth% + {\hbox to .5cm{#1\hss}\hbox{\expandafter\setn@me\string#1.}\hss}% + \advance\c@lumnsleft-1% + \ifnum\c@lumnsleft>0% + \hskip2em% + \else% + \egroup% + \hbox\bgroup% + \c@lumnsleft\t@talcolumns% + \fi% + \doNextComm@nd% + }} +\def\dr@pnext#1#2{#1} +\def\doNextComm@nd{\@ifnextchar\end{}{\setComm@nd}}% +\def\setn@me#1#2.{\CSname{#2}} + % Removes the first character (^^M) of the name generated by string + +{\catcode`\%=11 +\typeout{} +\typeout{NOTE: If LaTeX complains} +\typeout{\@spaces\@spaces Font U/manual/m/n/9 manfnt at 9.0 not loadable: ...} +\typeout{\@spaces\space\space then remove the very first line of this file} +\typeout{\@spaces\@spaces %\protect\manfnttrue\space ...} +\typeout{} +} + +\makeatother + +\begin{document} + \DocInput{bbding.dtx} +\end{document} +%</documentation> +% \end{macrocode} +% The documentpreamble loads \package{ltxdoc}, which is the standard +% \LaTeXe-class for documentation and issues commands about +% charactertables. Then it defines a bunch of commands (described below), +% that had eased my typing of the documentation. +% It issues some ``relaxing'' typeouts to the user, and at last it is ready +% to really process the documenation, which is done by +% loading itself once more using \package{docstrip}. +% +% The commands defined are +% \begin{description} +% \item[\CSname{ifmulticols}] conditional ensuring that \TeX\ branches over +% parts setting up multiple columns, when this is not provided. +% \item[\CSname{ifmanfnt}] conditional telling whether the manualfont used +% for the \emph{The \TeX-book} is available. The font is used to generate +% the \METAFONT-logo and it is declared to NFSS anyway, as it will only be +% loaded up on request. The user will have to manually set this conditional to +% false to avoid using the |manfnt|, which is done by removing the first +% line. I thought it safer to ask the user to remove something written, +% than adding something ``unwritten''.% +% \item[\CSname{ifUsersGuide}] conditional telling wether only the users +% guide is wanted. As with |\ifmanfnt| the user will have to remove the +% first line of the file to get the full documentation. +% \item[\CSname{lttdots}] gives ellipsis in a typewriter-font +% \item[\CSname{CSname}] typeset a commandname when it is not possible using +% the standard notation, \verb+|+\lttdots\verb+|+, from \package{ltxdoc} (eg.\ in +% headers). Intentionally given a name close to \TeX's |\csname|. +% \item[\CSname{package}] sets the name of \LaTeX-package. +% \item[\CSname{bbding}] gives the package-symbol (name in a typewriter-font) +% \item[\CSname{GetInfo}] defines the commands |\fileversion|, |\filedate| +% and |\fileinfo| with information about \bbding\ +% as provided in +% |\providespackage|. It is mainly borrowed from a command with the same +% name in \package{ltxdoc} but has been changed to type the additional +% greek letter in the package version provided in parenthesis. +% \item[\CSname{parmark} and \CSname{setparagraphmark}] is used to set a +% given symbol in front of a paragraph. |\setparagraphmark| defines the +% symbol to be used by |\parmark|, if no argument is given explicit. +% \item[\texttt{code}] Environment for displaying examples in the Users Guide. +% \item[\texttt{columnitemize}] Makes an itemizing where the bullet is not +% idented, which would make the text too narrow when using columns. +% \item[\texttt{commandsInColumns}] Is as specialized environment---nearly +% deserving its own package. I owe a special thanks to \emph{Mauro +% Orlandini} and \emph{Max Hailperin} for developing a much-like +% environment, which gave me much inspiration. +% +% The environment is used to show the commands of \bbding\ in +% columns. Inside the environment each line contains a entry, which is set +% across the page in the number of columns given by the parameter. On each +% line the first token not being a space is taken as the command. It is +% first set and then its name is set in a \texttt{typewriter} font. +% +% \textbf{Some notes on the code}: First thing in the environment is to +% calculate the width of the columns, +% \[ +% \CSname{c@lumnwidth} = \frac{\textrm{textwidth} - (\textrm{no.\ of columns}-1)*\textrm{column skip}}{\textrm{no.\ of columns}} +% \] +% Then the counters are initialised and \TeX\ is forced into vertical +% mode. Each line is being build in a |\hbox|, which is first started in +% the \emph{beginning definition} of the environment. When the given +% number of columns have been set, the box is ended (and thereby +% added to the vertical list) and a new one is started. +% +% |\setComm@nd| finds one line and sets in a |\hbox| with the calculated +% width. It is therefore declared in a group, where \emph{carriage return} +% (\verb+^^M+) is turned into a \emph{other} character. The actual setting is +% done by |\setn@me|, which matches out the relevant part produced by the +% primitive |\string|. After the command is set, it is tested if this line is +% done, ie.\ the correct number of columns have been set. In that case +% it is ended as described above, otherwise \LaTeX\ skips to the +% next column. At last |\doNextComm@nd| testes if there is a new command +% or it has reaced the |\end| of the environment. +% \end{description} +% +% \Finale \sloppy \PrintChanges +\endinput + + + + + + + + + + |