summaryrefslogtreecommitdiff
path: root/macros/plain/contrib/pdcmac/pdcl1maa.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'macros/plain/contrib/pdcmac/pdcl1maa.dtx')
-rw-r--r--macros/plain/contrib/pdcmac/pdcl1maa.dtx248
1 files changed, 248 insertions, 0 deletions
diff --git a/macros/plain/contrib/pdcmac/pdcl1maa.dtx b/macros/plain/contrib/pdcmac/pdcl1maa.dtx
new file mode 100644
index 0000000000..8e13681ea0
--- /dev/null
+++ b/macros/plain/contrib/pdcmac/pdcl1maa.dtx
@@ -0,0 +1,248 @@
+% 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~<pdc \filedate>\}
+ |
+\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:
+