% pdcl1maa.dtx -- documentation & source for pdcl1maa.tex -*-tex-*- %%%@TeX-document-file { %%% title = "PDCL1MAA -- Formatting Macros", %%% filename = "$texmf/doc/plain/pdcmac/pdcl1maa.dtx", %%% version = "$Revision: 1.3 $", %%% package = "pdcmac 1.0", %%% date = "$Date: 1995/03/30 16:09:52 $", %%% author = "P. Damian Cugley", %%% email = "damian.cugley@comlab.ox.ac.uk", %%% address = "Oxford University Computing Laboratory," %%% Parks Road, Oxford OX1 3QD, UK", %%% abstract = "This document describes and is the source code for %%% the TeX definitions file pdcl1maa.tex. %%% Running plain TeX on this file produces both the %%% definitions file and the printed documentation.", %%% copyright = "Copyright (c) 1995 P. Damian Cugley", %%% copying = "This program is free software; you can redistribute %%% it and/or modify it under the terms of the GNU %%% General Public License as published by the Free %%% Software Foundation; either version 2 of the License, %%% or (at your option) any later version.", %%% notice = "This program 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. See the GNU General Public %%% License for more details.", %%% notice = "You should have received a copy of the GNU General %%% Public License along with this program; if not, write %%% to the Free Software Foundation, Inc., 675 Mass Ave, %%% Cambridge, MA 02139, USA.", %%% codetable = "USASCII", %%% dependencies = "pdccode.tex" %%%} %{{{ pdcl1maa %{{{ preamble \relax \input pdccode \document \rcs$Id: pdcl1maa.dtx,v 1.3 1995/03/30 16:09:52 pdc Exp $\endrcs \codefile{pdcl1maa.tex} %}}} preamble %{{{ introduction \author{P. Damian Cugley} \title{PDCL1MAA---Macros for using Latin-1 characters with Malvern~A} \section{Introduction} This document describes |pdcl1maa.tex|, a collection of definitions designed to make Malvern~A characters available using the ISO~8859--1 input encoding (Latin-1). \subsec{About this document} The definitions file and the printed documentation are both in |pdcl1maa.dtx|, a `documented \TeX\ macros' file\footnote*{The \LaTeX~2e distribution uses files with the `|dtx|' suffix for similar purposes.} which, when processed by plain \TeX, generates a fresh copy of |pdcl1maa.tex| in the current directory in addition to the |dvi| file. This ensures that the printed documentation and the code it describes are identical. The |dtx| file uses the macros in |pdccode.tex|. %}}} introduction %{{{ File identification \section{File identification} Nowadays, macro files start with some comments identifying the file. \code \|\% pdcl1maa.tex \fileversion~\filedate~-- Latin-1 chars in Malvern-A | |%%%@TeX-definition-file { |%%% filename = "$texmf/tex/plain/pdcmac/pdcl1maa.tex", \|\%\%\% version~~~~~~~~= "\fileversion", \|\%\%\% date~~~~~~~~~~~= "\filedate", |%%% package = "pdcmac 1.0", |%%% author = "P. Damian Cugley", |%%% email = "damian.cugley@comlab.ox.ac.uk", |%%% address = "Oxford University Computing Laboratory, |%%% Parks Road, Oxford OX1 3QD, UK", |%%% codetable = "USASCII", |%%% keywords = "TeX, plain TeX, macros", |%%% supported = "Maybe", |%%% abstract = "ISO 8859-1 characters using Malvern-A fonts. |%%% This file was generated by running \|\%\%\%~~~~~~~~~~~~~~~~~~~plain TeX on \jobname.dtx", |%%% copyright = "Copyright (c) 1995 P. Damian Cugley", |%%% copying = "DO NOT DISTRIBUTE THIS FILE. \|\%\%\%~~~~~~~~~~~~~~~~~~~Distribute \jobname.dtx only as part of the |%%% package it came in.", |%%% dependencies = "", |%%% } | \|\\message\{\fileversion~\} | \endcode %}}} file id %{{{ ISO 8859-1 support \section{ISO 8859--1 input} \subsec{Symbols} Those characters whose code is the same as the code of the corresponding glyph are left alone (with catcode~12). For example, |^^a3| (pounds sterling) is left alone. Those that have an equivalent |\chardef| (or |\mathchardef|) name are defined with |\let|. Those with an equivalent standard ligature use that ligature. I don't use |\declareactivechar| on these because they would not work properly in verbatim text with catcode~12. (Extending verbatim text to include Latin-1 will take a few definitions along the same lines as |\ttlq| etc.) \code |\catcode`^^a0\active \let^^a0=~ % A1 % A2 % A3 % A4 |\catcode`^^a5\active \let^^a5=\yen % A6 |\catcode`^^a7\active \let^^a7=\S |\catcode`^^a8\active \let^^a8=\" |\catcode`^^a9\active \let^^a9=\copyright |\catcode`^^aa\active \let^^aa=\orda |\catcode`^^ab\active \def^^ab{<<} |\catcode`^^ac\active \let^^ac=\lnot |\catcode`^^ad\active \let^^ad=\- |\catcode`^^ae\active \let^^ae=\registered |\catcode`^^af\active \let^^af=\= \smallbreak |\catcode`^^b0\active \let^^b0=\degrees |\catcode`^^b1\active \let^^b1=\pm |\catcode`^^b2\active \def^^b2{^2} |\catcode`^^b3\active \def^^b3{^3} |\catcode`^^b4\active \let^^b4=\' |\catcode`^^b5\active \let^^b5=\mu |\catcode`^^b6\active \let^^b6=\P |\catcode`^^b7\active \let^^b7=\gbdecimal |\catcode`^^b8\active \let^^b8=\c |\catcode`^^b9\active \def^^b9{^1} |\catcode`^^ba\active \let^^ba=\ordo |\catcode`^^bb\active \def^^bb{>>} |\catcode`^^bc\active \def^^bc{\frac14} |\catcode`^^bd\active \def^^bd{\frac12} |\catcode`^^be\active \def^^be{\frac34} |\catcode`^^bf\active \def^^bf{?`} \smallbreak |\catcode`^^d7\active \let^^d7=\times |\catcode`^^f7\active \let^^f7=\div \endcode \subsec{Composite letters} The characters that represent marks for composite letters\footnote*{This phrase is used on the grounds that the word {\it accent} tends to provoke lectures on ways in which many composite letters do {\it not} represent accents in the languages in which they are used.} are |\let| to the corresponding composite-letter-making command---one may write `{\tt\char"7F u\char"18 c}' to get `\"u\c c'. \code |\catcode`^^c0\active \def^^c0{\`A} |\catcode`^^c1\active \def^^c1{\'A} |\catcode`^^c2\active \def^^c2{\^A} |\catcode`^^c3\active \def^^c3{\~A} |\catcode`^^c4\active \def^^c4{\"A} |\catcode`^^c5\active \let^^c5=\AA |\catcode`^^c6\active \let^^c6=\AE |\catcode`^^c7\active \def^^c7{\c C} |\catcode`^^c8\active \def^^c8{\`E} |\catcode`^^c9\active \def^^c9{\'E} |\catcode`^^ca\active \def^^ca{\^E} |\catcode`^^cb\active \def^^cb{\"E} |\catcode`^^cc\active \def^^cc{\`I} |\catcode`^^cd\active \def^^cd{\'I} |\catcode`^^ce\active \def^^ce{\^I} |\catcode`^^cf\active \def^^cf{\"I} \smallbreak |\catcode`^^d0\active \let^^d0=\DH |\catcode`^^d1\active \def^^d1{\~N} |\catcode`^^d2\active \def^^d2{\`O} |\catcode`^^d3\active \def^^d3{\'O} |\catcode`^^d4\active \def^^d4{\^O} |\catcode`^^d5\active \def^^d5{\~O} |\catcode`^^d6\active \def^^d6{\"O} |\catcode`^^d8\active \let^^d8=\O |\catcode`^^d9\active \def^^d9{\`U} |\catcode`^^da\active \def^^da{\'U} |\catcode`^^db\active \def^^db{\^U} |\catcode`^^dc\active \def^^dc{\"U} |\catcode`^^dd\active \def^^dd{\'Y} |\catcode`^^de\active \let^^de=\TH |\catcode`^^df\active \let^^df=\ss \smallbreak |\catcode`^^e0\active \def^^e0{\'a} |\catcode`^^e1\active \def^^e1{\`a} |\catcode`^^e2\active \def^^e2{\^a} |\catcode`^^e3\active \def^^e3{\~a} |\catcode`^^e4\active \def^^e4{\"a} |\catcode`^^e5\active \let^^e5=\aa |\catcode`^^e6\active \let^^e6=\ae |\catcode`^^e7\active \def^^e7{\c c} |\catcode`^^e8\active \def^^e8{\`e} |\catcode`^^e9\active \def^^e9{\'e} |\catcode`^^ea\active \def^^ea{\^e} |\catcode`^^eb\active \def^^eb{\"e} |\catcode`^^ec\active \def^^ec{\`i} |\catcode`^^ed\active \def^^ed{\'i} |\catcode`^^ee\active \def^^ee{\^i} |\catcode`^^ef\active \def^^ef{\"i} \smallbreak |\catcode`^^f0\active \let^^f0=\dh |\catcode`^^f1\active \def^^f1{\~n} |\catcode`^^f2\active \def^^f2{\`o} |\catcode`^^f3\active \def^^f3{\'o} |\catcode`^^f4\active \def^^f4{\^o} |\catcode`^^f5\active \def^^f5{\~o} |\catcode`^^f6\active \def^^f6{\"o} |\catcode`^^f8\active \let^^f8=\o |\catcode`^^f9\active \def^^f9{\`u} |\catcode`^^fa\active \def^^fa{\'u} |\catcode`^^fb\active \def^^fb{\^u} |\catcode`^^fc\active \def^^fc{\"u} |\catcode`^^fd\active \def^^fd{\'y} |\catcode`^^fe\active \let^^fe=\th |\catcode`^^ff\active \def^^ff{\"y} \endcode %}}} ISO 8859-1 support \endcodefile \enddocument \bye %}}} pdcl1maa.dtx %Local variables: %fill-prefix: "\t" %fold-folded-p: t %End: