diff options
Diffstat (limited to 'fonts/dingbat/dingbat.dtx')
-rw-r--r-- | fonts/dingbat/dingbat.dtx | 329 |
1 files changed, 329 insertions, 0 deletions
diff --git a/fonts/dingbat/dingbat.dtx b/fonts/dingbat/dingbat.dtx new file mode 100644 index 0000000000..a30fb90400 --- /dev/null +++ b/fonts/dingbat/dingbat.dtx @@ -0,0 +1,329 @@ +% \iffalse meta-comment +% +% Copyright (C) 2001 Scott Pakin <pakin@uiuc.edu> +% ------------------------------------------------------- +% +% This package may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either version 1.2 +% of this license or (at your option) any later version. +% The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.2 or later is part of all distributions of LaTeX +% version 1999/12/01 or later. +% +% \fi +% \iffalse +%% File: dingbat.dtx Copyright (C) 2001 Scott Pakin <pakin@uiuc.edu> +% +%<package>\NeedsTeXFormat{LaTeX2e} +%<package>\ProvidesPackage{dingbat} +%<package> [2001/04/27 v1.00 Hands and other dingbats] +%<uarkfd>\ProvidesFile{uark.fd} +%<uarkfd> [2001/04/27 v1.00 Font definitions for the ark10 font] +%<udingbatfd>\ProvidesFile{udingbat.fd} +%<udingbatfd> [2001/04/27 v1.00 Font definitions for the dingbat font] +% +%<*driver> +\documentclass{ltxdoc} +\usepackage{dingbat} +\usepackage{tabularx} +\EnableCrossrefs +\CodelineIndex + +% Uncomment the following line if you don't want to include a +% source-code listing. +%\OnlyDescription + +\begin{document} +\DocInput{dingbat.dtx} +\end{document} +%</driver> +% \fi +% +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% \CheckSum{76} +% \GetFileInfo{dingbat.sty} +% +% \title{The \textsf{dingbat} package\thanks{This file +% has version number \fileversion, last +% revised \filedate.}} +% \author{Scott Pakin\\pakin@uiuc.edu} +% \date{\filedate} +% \maketitle +% +% \changes{v1.00}{2001/04/27}{Initial version} +% +% \DoNotIndex{\newcommand,\selectfont} +% +% \StopEventually{^^A +% \section{Credits} +% +% Just so it's clear who did what, here are the various components of +% the \textsf{dingbat} package and the associated copyright information: +% +% \begin{center} +% \begin{tabularx}{0.9\textwidth}{lX} +% \texttt{ark10.mf} & Copyright (c) 1988 by Arthur M. Keller \\ +% & The ARK font was initially done in MF79 +% by Scott Kim. It was converted to (new) MF by N.N. Billawala +% of Metamarks. \\ +% \texttt{dingbat.dtx} & Copyright (C) 2001 Scott Pakin \\ +% \texttt{dingbat.ins} & Copyright (C) 2001 Scott Pakin \\ +% \texttt{dingbat.mf} & Created 3-3-89 by Doug Henderson \\ +% \texttt{uark.fd} & Copyright (C) 2001 Scott Pakin +% \end{tabularx} +% \end{center} +% +% \PrintIndex +% } +% +% \begin{abstract} +% The \textsf{dingbat} package provides a \LaTeXe\ interface to the +% |ark10.mf| and |dingbat.mf| fonts. +% \end{abstract} +% +% +% \section{Usage} +% +% ^^A Typeset a symbol in one column and its name in the next. +% \def\tblsym#1{#1 & \texttt{\string#1}} +% +% \DescribeMacro{\rightpointright} +% \DescribeMacro{\leftpointright} +% \DescribeMacro{\leftthumbsdown} +% \DescribeMacro{\leftthumbsup} +% \DescribeMacro{\rightpointleft} +% \DescribeMacro{\rightthumbsdown} +% \DescribeMacro{\rightthumbsup} +% The \textsf{dingbat} package defines the following hand gestures: +% +% \begin{center} +% \renewcommand{\arraystretch}{1.2} +% \begin{tabular}{lll} +% \tblsym{\rightpointright} & Right hand pointing to the right \\ +% \tblsym{\leftpointright} & Left hand pointing to the right \\ +% \tblsym{\leftthumbsdown} & Left hand, thumbs down \\ +% \tblsym{\leftthumbsup} & Left hand, thumbs up \\ +% \tblsym{\rightpointleft} & Right hand pointing to the left \\ +% \tblsym{\rightthumbsdown} & Right hand, thumbs down \\ +% \tblsym{\rightthumbsup} & Right hand, thumbs up \\ +% \end{tabular} +% \end{center} +% +% \noindent +% (|\rightpointright| comes from |dingbat.mf|, while the rest come from +% |ark10.mf|, hence, the discrepency in style.) +% +% \DescribeMacro{\squarewithdots} +% \DescribeMacro{\filledsquarewithdots} +% \DescribeMacro{\Sborder} +% \DescribeMacro{\Zborder} +% The following symbols are intended to be used to create fancy borders +% around a box or the entire page. +% +% \begin{center} +% \renewcommand{\arraystretch}{1.2} +% \begin{tabular}{lll} +% \tblsym{\squarewithdots} & Unfilled square with dots \\ +% \tblsym{\filledsquarewithdots} & Filled square with dots \\ +% \tblsym{\Sborder} & \textit{S}-like border design \\ +% \tblsym{\Zborder} & \textit{Z}-like border design \\ +% \end{tabular} +% \end{center} +% +% \noindent +% Note that if you \emph{are} going to create fancy borders, I recommend +% using the \textsf{niceframe} package. \textsf{niceframe} is geared +% to drawing fancy borders and knows specifically about the border +% characters in |dingbat.mf|. The symbols defined by the +% \textsf{dingbat} package, |\squarewithdots|, |\filledsquarewithdots|, +% |\Sborder|, and |\Zborder|, are the only border characters that might +% be useful outside of a border (e.g., in a straight line or as a bullet +% in a fancy itemized list); the other, unnamed, characters defined in +% |dingbat.mf| represent a frame's corners and sides. +% +% \DescribeMacro{\largepencil} +% \DescribeMacro{\anchor} +% \DescribeMacro{\carriagereturn} +% \DescribeMacro{\checkmark} +% \DescribeMacro{\eye} +% \DescribeMacro{\satellitedish} +% \DescribeMacro{\smallpencil} +% The following \textsf{dingbat} symbols don't fit into either of the +% previous categories: +% +% \begin{center} +% \renewcommand{\arraystretch}{1.2} +% \begin{tabular}{lll} +% \tblsym{\largepencil} & Large pencil \\ +% \tblsym{\anchor} & Anchor \\ +% \tblsym{\carriagereturn} & Carriage return \\ +% \tblsym{\checkmark} & Check mark \\ +% \tblsym{\eye} & Eye \\ +% \tblsym{\satellitedish} & DLA satellite dish \\ +% \tblsym{\smallpencil} & Small pencil \\ +% \end{tabular} +% \end{center} +% +% For some of these symbols, most notably |\largepencil|, the font +% metrics seem to be a bit off. As a result, the symbols tend to jut +% into previous or subsequent lines. +% +% +% \section{Implementation} +% +% There's nothing particularly interesting about the implementation. +% Section~\ref{sec:symbol-commands} defines the symbol commands that +% make up |dingbat.sty|, and Section~\ref{sec:font-definitions} creates +% the |uark.fd| and |udingbat.fd| font definition files, which \LaTeX\ +% loads when |dingbat.sty| selects font encoding~|U| and font family +% |ark| or |dingbat|. +% +% \subsection{Symbol commands} +% \label{sec:symbol-commands} +% +% \begin{macrocode} +%<*package> +% \end{macrocode} +% +% \begin{macro}{\arkfamily} +% \begin{macro}{\ark@sym} +% Define a macro, |\arkfamily|, which switches the font to |ark| and +% another macro, |\ark@sym| which typesets a symbol in the |ark| font. +% \begin{macrocode} +\newcommand{\arkfamily}{\fontencoding{U}\fontfamily{ark}\selectfont} +\newcommand{\ark@sym}[1]{{\arkfamily\symbol{#1}}} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\carriagereturn} +% \begin{macro}{\leftthumbsdown} +% \begin{macro}{\eye} +% \begin{macro}{\rightpointleft} +% \begin{macro}{\smallpencil} +% \begin{macro}{\leftpointright} +% \begin{macro}{\leftthumbsup} +% \begin{macro}{\largepencil} +% \begin{macro}{\rightthumbsdown} +% \begin{macro}{\rightthumbsup} +% There are only ten symbols in the |ark| font. We define names +% individually for each of them. Note that |\largepencil|'s bounding box +% is a little too short, so |\largepencil| may jut into the previous line +% of text. I think some of the other bounding boxes may be the wrong +% size, as well, but I haven't yet tested that carefully. +% \begin{macrocode} +\newcommand{\carriagereturn}{\ark@sym{'103}} +\newcommand{\leftthumbsdown}{\ark@sym{'104}} +\newcommand{\eye}{\ark@sym{'105}} +\newcommand{\rightpointleft}{\ark@sym{'114}} +\newcommand{\smallpencil}{\ark@sym{'120}} +\newcommand{\leftpointright}{\ark@sym{'122}} +\newcommand{\leftthumbsup}{\ark@sym{'125}} +\newcommand{\largepencil}{\ark@sym{'127}} +\newcommand{\rightthumbsdown}{\ark@sym{'144}} +\newcommand{\rightthumbsup}{\ark@sym{'165}} +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\dingbatfamily} +% \begin{macro}{\dingbat@sym} +% Define a macro, |\dingbatfamily|, which switches the font to |dingbat| +% and another macro, |\dingbat@sym| which typesets a symbol in the +% |dingbat| font. +% \begin{macrocode} +\newcommand{\dingbatfamily}{\fontencoding{U}\fontfamily{dingbat}\selectfont} +\newcommand{\dingbat@sym}[1]{{\dingbatfamily\symbol{#1}}} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\checkmark} +% \begin{macro}{\satellitedish} +% \begin{macro}{\rightpointright} +% \begin{macro}{\anchor} +% The following are definitions for all the non-border characters in +% |dingbat.mf|. +% \begin{macrocode} +\newcommand{\checkmark}{\dingbat@sym{'104}} +\newcommand{\satellitedish}{\dingbat@sym{'111}} +\newcommand{\rightpointright}{\dingbat@sym{'116}} +\newcommand{\anchor}{\dingbat@sym{'117}} +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\squarewithdots} +% \begin{macro}{\filledsquarewithdots} +% \begin{macro}{\Sborder} +% \begin{macro}{\Zborder} +% The following are the border characters. There are many more, but I +% haven't yet made up \LaTeX\ names for them. +% \begin{macrocode} +\newcommand{\squarewithdots}{\dingbat@sym{'102}} +\newcommand{\filledsquarewithdots}{\dingbat@sym{'103}} +\newcommand{\Sborder}{\dingbat@sym{'123}} +\newcommand{\Zborder}{\dingbat@sym{'132}} +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \begin{macrocode} +%</package> +% \end{macrocode} +% +% \subsection{Font definition files} +% \label{sec:font-definitions} +% +% \subsubsection{\ttfamily uark.fd} +% +% All we do here is define |ark| as a symbol font (|U|~encoding) and tell +% \LaTeX\ to scale |ark10.mf| to whatever font size is requested. +% +% \begin{macrocode} +%<*uarkfd> +% \end{macrocode} +% +% \begin{macrocode} +\DeclareFontFamily{U}{ark}{} +\DeclareFontShape{U}{ark}{m}{n}{<-> ark10}{} +% \end{macrocode} +% +% \begin{macrocode} +%</uarkfd> +% \end{macrocode} +% +% \subsubsection{\ttfamily udingbat.fd} +% +% Similarly, we define |dingbat| as another, |U|-encoded symbol font and +% instruct \LaTeX\ to scale |dingbat.mf| to whatever font size is requested. +% +% \begin{macrocode} +%<*udingbatfd> +% \end{macrocode} +% +% \begin{macrocode} +\DeclareFontFamily{U}{dingbat}{} +\DeclareFontShape{U}{dingbat}{m}{n}{<-> dingbat}{} +% \end{macrocode} +% +% \begin{macrocode} +%</udingbatfd> +% \end{macrocode} +% +% \Finale +% |