% 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: