texlive[56801] Master: amiweb2c-guide (29oct20)

commits+karl at tug.org commits+karl at tug.org
Thu Oct 29 21:47:55 CET 2020


Revision: 56801
          http://tug.org/svn/texlive?view=revision&revision=56801
Author:   karl
Date:     2020-10-29 21:47:54 +0100 (Thu, 29 Oct 2020)
Log Message:
-----------
amiweb2c-guide (29oct20)

Modified Paths:
--------------
    trunk/Master/tlpkg/bin/tlpkg-ctan-check
    trunk/Master/tlpkg/tlpsrc/collection-langenglish.tlpsrc

Added Paths:
-----------
    trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/
    trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/README
    trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/amiweb2c-guide.pdf
    trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/amiweb2c-guide.tex
    trunk/Master/tlpkg/tlpsrc/amiweb2c-guide.tlpsrc

Added: trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/README
===================================================================
--- trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/README	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/README	2020-10-29 20:47:54 UTC (rev 56801)
@@ -0,0 +1,18 @@
+LaTeX on the Amiga - Old-School
+--------------------------------
+
+
+This is a guide to the installation of the LaTeX distribution Amiweb2c in the version 2.1 on an emulated Amiga 4000 computer running Workbench 3.1. Furthermore the installation of a LaTeX server for calling LaTeX from an editor is given and some tips on the installation of new fonts are detailed.
+
+This work is the result of of many a nights tinkering by an amateur who had to make it up as he went along. It cannot claim in any way to be authorative or complete and is written in the hope that it will help fellow nostalgians embarked on a similar quest.
+
+No copyright infringement or monetary gain is intended and if implementing any of the commands given in this guide breaks your system or leads to loss of data or gives you a headache...you are on your own.
+
+This package consists of the file Amiweb2cGuide.pdf and its source file amiweb2c-guide.tex exported from the original .lyx-file. The file amiweb2c-guide.dvi has been obtained from the .tex-file by compiling it with Amiweb2c-TeX on an emulated Amiga.
+
+This material is subject to the LaTeX Project Public License 1.3c. 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.
+
+
+Torsten Finnberg
+29/10/20
+e-mail: torsten.finnberg at web.de


Property changes on: trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/README
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/amiweb2c-guide.pdf
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/amiweb2c-guide.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/amiweb2c-guide.pdf	2020-10-29 20:47:11 UTC (rev 56800)
+++ trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/amiweb2c-guide.pdf	2020-10-29 20:47:54 UTC (rev 56801)

Property changes on: trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/amiweb2c-guide.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/amiweb2c-guide.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/amiweb2c-guide.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/amiweb2c-guide.tex	2020-10-29 20:47:54 UTC (rev 56801)
@@ -0,0 +1,1203 @@
+%% LyX 2.3.4.2 created this file.  For more info, see http://www.lyx.org/.
+%% Do not edit unless you really know what you are doing.
+\documentclass[english]{article}
+\usepackage[T1]{fontenc}
+\usepackage[latin9]{inputenc}
+\usepackage[active]{srcltx}
+\usepackage{amsbsy}
+
+\makeatletter
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% LyX specific LaTeX commands.
+%% Because html converters don't know tabularnewline
+\providecommand{\tabularnewline}{\\}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% User specified LaTeX commands.
+\usepackage{mflogo}
+\usepackage{amsfonts}
+
+\makeatother
+
+\usepackage{babel}
+\begin{document}
+\title{\LaTeX{} on the Amiga - Old-School}
+\author{Torsten Finnberg}
+\date{10/28/2020\\v1.0}
+\maketitle
+\begin{abstract}
+This is a guide to the installation of the \LaTeX{} distribution AmiWeb2c
+in the version 2.1 on an emulated Amiga~4000 computer running Workbench
+3.1. Furthermore the installation of a \LaTeX{} server for calling
+\LaTeX{} from an editor is given and some tips on the installation
+of new fonts are detailed. Also regard is given (code for: I have
+no idea what I'm talking about) for the handling of PostScript fonts.
+\end{abstract}
+
+\section{Preface}
+
+This guide is the result of many a night's tinkering, driven by both
+nostalgia and stubbornness to get this damn thing to work, no matter
+how many more cryptic error messages appeared\footnote{I am still convinced one of these was ``Out of Cheese Error.''}.
+So as a way of exorcism and as a guide to fellow nostalgians\footnote{Is that a word?}
+this guide was written. It could however never be written without
+standing on the shoulders of those giants and gurus who ported \LaTeX{}
+to the Amiga and the many people who keep Amiga related websites alive.
+This guide is a small way of giving back.
+
+Although this guide is based on an emulated Amiga running Workbench
+3.1, there is no reason why it should not work on a physical Amiga.
+An attempt to install TeX on a AmigaOs3.9 failed in the regard that
+\LaTeX{} could not find the .aux-file generated by it. As \LaTeX{}
+would only run on an a .tex-file if the full path was specified on
+the command line, I suspect some changes in the command line parsing.
+
+Note however that \TeX{} and \MF{} are resource hungry. The full installation
+takes as near as makes no difference 50~MB of disk space, not accounting
+for additional PostScript fonts. For \MF{} to run, I needed to set
+Motherboard RAM to at least 16~MB. For an Amiga~4000 emulation the
+compilation of a \LaTeX{} document can be said to be reasonably fast
+but generation of fonts is something that calls for a cup of coffee.
+Several ones. Likewise, rendering of a .ps-file by Ghostscript can
+only be called...well, remember those old SF movies in which computers
+spell out messages one letter at a time? Well, the title of the guide
+has the word Old-School included, so don't expect the speed or functionality
+of modern \TeX{} systems.
+
+It must also be said what this guide is not about: The programming
+of a \LaTeX{} document itself and the setup and running of the emulator\footnote{I used FS-UAE}.
+It is also assumed that the reader has - like the author - a rudimentary
+acquaintance with the command line (CLI) on an Amiga. I found the
+website 
+\begin{quotation}
+\texttt{https://wiki.amigaos.net/AmigaOS\_Manual:\_AmigaDOS}
+\end{quotation}
+very helpful in that aspect. 
+
+\subsection{Legalese}
+
+There are a lot of trademarks mentioned in this guide and a lot of
+programs which have authorship different from this author. All rights
+to these trademarks and programs lie with their respective owners.
+No infringement or financial gain is intended. On the same note, you
+are free to copy this guide any way you wish, although if you publish
+it in a modified form, please change the author. Oh, and a reference
+to the original author would be nice.
+
+\subsection{Disclaimer}
+
+If using any of the instructions in this guide breaks your system
+or leads to loss of data or gives you a headache...you are on your
+own.
+
+\section{Installation of the \protect\LaTeX{} system}
+
+We now turn to the installation of the AmiWeb2c distribution in the
+version 2.1 on an emulated Amiga~4000 with Workbench~3.1 installed.
+For this distribution the \TeX{} version is 3.14159 and \LaTeX{} in
+the form of \LaTeXe{} dates from 2001/06/01. But first we need some
+
+\subsection{Preliminaries}
+
+For the installation to proceed you need, besides a working emulated
+Amiga, the archives \texttt{amiweb2c.tar.gz}, \texttt{amiweb2c-patch.tar.gz}
+which can be found on the CTAN website
+\begin{quotation}
+\texttt{www.ctan.org/tex-archive/systems/amiga/amiweb2c}
+\end{quotation}
+The meat on the bones (for reasons I cannot fathom) is the archive
+\begin{quotation}
+\texttt{texmflib-7.10.tar.gz}
+\end{quotation}
+which can be found on
+\begin{quotation}
+\texttt{http://ftp.math.utah.edu/pub/tex/historic/systems/}
+
+\texttt{web2c/texmflib}
+\end{quotation}
+We now set up the machinery to deal with compressed tar archives.
+If you have this machinery already set up (and the \texttt{lha} program
+installed) you can skip most of this and only do the final step of
+the preliminaries. To uncompress the .tar.gz-files into .tar-files
+you need \texttt{gzip:}
+\begin{quotation}
+\texttt{http://aminet.net/dev/gg/gzip-bin.lha }
+\end{quotation}
+To extract this .lha-file you need the \texttt{lha} program contained
+in the file: 
+\begin{quotation}
+\texttt{http://aminet.net/util/arc/lha.run }
+\end{quotation}
+The file \texttt{lha.run} is a self-extracting archive you extract
+simply by executing it. Afterwards rename the extracted file \texttt{lha\_xxxxx}
+to \texttt{lha} where \texttt{xxxxx} corresponds to your CPU. Then
+move the file \texttt{lha} to \texttt{S:}. Now you can extract the
+file \texttt{gzip-bin.lha }by
+\begin{quotation}
+\texttt{lha x gzip-bin.lha }
+\end{quotation}
+which creates the file \texttt{gzip-1.2.4-bin.tar}. To extract .tar-files
+you need the \texttt{tar} program:
+\begin{quotation}
+\texttt{http://aminet.net/dev/gg/tar-bin.lha }
+\end{quotation}
+Extract this file and copy the resultant file \texttt{tar} to \texttt{S:}.
+Then issue the command
+\begin{quotation}
+\texttt{tar xvf gzip-1.2.4-bin.tar}
+\end{quotation}
+The option ''x'' tells \texttt{tar} to extract the archive, the
+option ``v'' to be verbose about it (list the files extracted) and
+``f'' that \texttt{tar} should use the file given instead of the
+default tape device. After this you'll find the new subdirectory \texttt{bin/}
+in which various files reside. Copy the one file named \texttt{gzip}
+to\texttt{ S:}. The program \texttt{gzip} needs a library file
+\begin{quotation}
+\texttt{http://aminet.net/util/libs/ixemul-48.0.lha}
+\end{quotation}
+After extracting this with \texttt{lha}, rename the resultant file
+\texttt{ixemul-xxx.library}, where \texttt{xxx} corresponds to your
+68xxx CPU-type, to \texttt{ixemul.library} and copy it to \texttt{LIBS:}.
+After all this uncompress the three archive files given at the start
+of this section by issuing
+\begin{quotation}
+\texttt{gzip -d amiweb2c.tar.gz}
+\end{quotation}
+producing the file \texttt{amiweb2c.tar}. The other archives are uncompressed
+similarly.
+
+Finally the previewer ShowDVI needs the file \texttt{req.library}
+contained in the file
+\begin{quotation}
+\texttt{http://aminet.net/util/libs/ReqLib28.lha}
+\end{quotation}
+Extract \texttt{Reqlib28.lha} and move the file \texttt{req.library}
+to \texttt{LIBS:}. After all these preliminaries we can now turn to
+the actual
+
+\subsection{Installation}
+
+First find or generate via \texttt{makedir} a directory in which you
+want to install Amiweb2c and \texttt{cd} into that directory. Then
+issue the command 
+\begin{quotation}
+\texttt{tar xvf PATHTO:amiweb2c-patch.tar}
+\end{quotation}
+where \texttt{PATHTO:} is the path to the .tar-file. A message that
+\texttt{pdftex.pool} could not be extracted as there is no such file
+appears. Ignore it. Then \texttt{cd} into the new subdirectory \texttt{Amiweb2c-2.1}
+and issue the command
+\begin{quotation}
+\texttt{tar xvf PATHTO:texmflib-7.10.tar}
+\end{quotation}
+extracting the files in this archive to the subdirectory \texttt{texmf}.
+Now go one level up in the directory tree by \texttt{cd /} and issue
+\begin{quotation}
+\texttt{tar xvf PATHTO:amiweb2c.tar}
+\end{quotation}
+The reason for this strange sequence of commands is that both \texttt{amiweb2c.tar}
+and \texttt{texmflib-7.10.tar} come with their own .pool files, but
+the initex process (see below) fails with the texmflib ones. So extracting
+amiweb2c \emph{after} texmflib overwrites the non-working .pool-files.
+The extraction of \texttt{amiweb2c-patch.tar} first is just a convenient
+way to create the \texttt{Amiweb2c-2.1} directory. In the following
+there will be given a lot of paths beginning with \texttt{../texmf}
+where \texttt{..} stands for the full path of the \texttt{Amiweb2c-2.1}
+directory.
+
+In the \texttt{Amiweb2c-2.1} directory there is a subdirectory
+\begin{quotation}
+\texttt{bin/m68000-amigaos2.1/local}
+\end{quotation}
+which holds a file \texttt{DosPrefs}. Copy this file to the folder
+\texttt{System:wbstartup}. Not sure what this program does, but apparently
+there are different conventions on directory naming which make \TeX{}
+find files only if the full path is given if \texttt{DosPrefs} has
+not been started beforehand.
+
+The next step is to make the file
+\begin{quotation}
+\texttt{..texmf/amiweb2c/s/user-startup.entry}
+\end{quotation}
+writable by issuing in its directory the command
+\begin{quotation}
+\texttt{protect user-startup.entry +w}
+\end{quotation}
+and then edit the file according to the comments in that file. After
+that, insert a line
+\begin{quotation}
+\texttt{execute ..texmf/amiweb2c/s/user-startup.entry}
+\end{quotation}
+in the file \texttt{S:user-startup} where you must replace the \texttt{..}
+with the omitted part of the absolute path. The \texttt{rxset...}
+lines in \texttt{user-startup} are used to set necessary preferences
+for the \TeX{}-server (see below). To process these lines correctly
+you need to preface the \texttt{execute} line given above with the
+line \texttt{rexxmast}, starting the Rexx server during startup. Also
+the lines containing \texttt{PSFONTS:} can be commented out, if you
+do not use PostScript fonts. It is not necessary, but I found it helpful
+to add the line
+\begin{quotation}
+\texttt{assign TEXMF: ..texmf}
+\end{quotation}
+where again the \texttt{..} must be replaced by the full path. This
+gives a quick way to \texttt{cd} into the central \texttt{../texmf}
+directory.
+
+Finally, in \texttt{..texmf/amiweb2c} there are two subdirectories,
+namely \texttt{s} and \texttt{rexx}. Copy all files in \texttt{s}
+to \texttt{S:} (except \texttt{user-startup.-entry}) and all files
+in \texttt{rexx} to \texttt{REXX:} (By default \texttt{S:} and \texttt{REXX:}
+point to the same directory.). After these steps reboot your Amiga.
+
+After rebooting, \texttt{cd} into \texttt{..texmf} and start the script
+\texttt{mktexlsr}. This creates the file \texttt{ls-R} which acts
+as a lookup table for the \TeX{} system. Without it \TeX{} complains
+a lot about files it can't find. There is a zoo of environment variables
+to take care of that, found here 
+\begin{quotation}
+\texttt{http://kirste.userpage.fu-berlin.de/chemnet/use/info/}
+
+\texttt{kpathsea/kpathsea\_5.html}
+\end{quotation}
+If you want to set these manually, be my guest. This script must always
+be started in \texttt{../texmf}. Then issue \texttt{cd} w\texttt{eb2c}
+and make the file \texttt{texsys.aux} writable by
+\begin{quotation}
+\texttt{protect texsys.aux +w}
+\end{quotation}
+Now to install \TeX , issue
+\begin{quotation}
+\texttt{tex -{}-ini -{}-fmt=tex plain}
+\end{quotation}
+\TeX{} will start and the CLI prompt will change to the \TeX{} prompt.
+(Without having run the script \texttt{mktexlsr} before this step
+\TeX{} will complain that it cannot find the file \texttt{plain}.)
+At this prompt enter the optional lines
+\begin{quotation}
+\texttt{\textbackslash input hyphen.cfg}
+\end{quotation}
+or else just
+\begin{quotation}
+\texttt{\textbackslash dump}
+\end{quotation}
+This runs the initex process for the plain \TeX{} format and will return
+to the CLI prompt. Afterwards issue
+\begin{quotation}
+\texttt{mf -{}-ini -{}-base=mf plain}
+\end{quotation}
+so the initiation process for \MF{} will start. At the \MF{} prompt,
+enter the lines
+\begin{quotation}
+\texttt{input modes}
+
+\texttt{dump}
+\end{quotation}
+and \MF{} will run its initiation process and return to the CLI prompt.
+The last initiation process is that for \MP{} started with the command
+\begin{quotation}
+\texttt{mpost -{}-ini -{}-mem=mpost plain}
+\end{quotation}
+At the \MP{} prompt enter the line 
+\begin{quotation}
+\texttt{dump}
+\end{quotation}
+Afterwards issue \texttt{cd /} and run the script \texttt{mktexlsr}.
+You now have a working \TeX -system.
+
+To install \LaTeX , issue\texttt{ }in\texttt{ ../web2c} the command
+\begin{quotation}
+\texttt{tex -{}-ini -{}-fmt=latex latex.ltx}
+\end{quotation}
+running the initex process for the \LaTeX{} system. Finally execute
+\texttt{mktexlsr} again in \texttt{..texmf}. You can check the success
+of the initex process for \LaTeX{} by
+\begin{quotation}
+\texttt{latex ltxcheck}
+\end{quotation}
+You can now compile a \LaTeX{} document \texttt{filename.tex} in your
+current directory by
+\begin{quotation}
+\texttt{latex filename}
+\end{quotation}
+Note that if \LaTeX{} finds the .mf-file of a font but not the corresponding
+.tfm-file, it will call \MF{} automatically via CallMF2. However
+this needs memory to keep both \LaTeX{} and \MF{} running at the same
+time. For me worked 2~MB Chip RAM and 8~MB Fast RAM. Lower values
+may work, but I did not test this. The previewer ShowDVI does not
+seem to have this problem. This concludes the installation of the
+\LaTeX{} system.
+
+\subsubsection{A note on other \protect\TeX{} systems}
+
+The file \texttt{README.amiweb2c} in \texttt{../texmf/doc/amiga},
+which informs much (but not all) of the preceding section, details
+the initex processes for further \TeX{} systems. These are the $\varepsilon$-\TeX ,
+pdf\TeX{} and omega systems. To install these, additional files are
+needed.
+
+\paragraph{$\boldsymbol{\varepsilon}$-\protect\TeX}
+
+The installation of $\varepsilon$-TeX is not really necessary since
+$\varepsilon$-\TeX{} is of version 3-14159-2.0 from 2001/06/01 same
+as the \LaTeXe{} system which incorporates all feature of $\varepsilon$-\TeX{}
+so $\varepsilon$-\TeX{} muyo!\footnote{Wait! Where did that giant hammer come from?}
+To install the $\varepsilon$-\TeX{} system you need the file
+\begin{quotation}
+\texttt{http://ftp.math.utah.edu/pub/tex/historic/systems/web2c/}
+
+\texttt{etex/etexlib-2.1.tar.gz}
+\end{quotation}
+which gets untar-ed in \texttt{...Amiweb2c-2.1}. After a run of \texttt{mktexlsr}
+\texttt{cd} to \texttt{...web2c} and issue the commands
+\begin{quotation}
+\texttt{etex -{}-ini -{}-efmt=etex {*}etex.src}
+
+\texttt{\textbackslash input hyphen.cfg (optional)}
+
+\texttt{dump}
+
+\texttt{etex -{}-ini -{}-efmt=tex plain}
+
+\texttt{\textbackslash input hyphen.cfg (optional)}
+
+\texttt{dump}
+\end{quotation}
+I issued a \texttt{mktexlsr} at this point. Not sure if it makes any
+difference but it surely can't hurt. To run the initiation process
+for $\varepsilon$-\LaTeX{} issue the commands
+\begin{quotation}
+\texttt{etex -{}-ini -{}-efmt=elatex {*}latex.ltx}
+
+\texttt{etex -{}-ini -{}-progname=elatex latex.ltx}
+\end{quotation}
+so the initiation processes for $\varepsilon$-\TeX{} and its \LaTeX{}
+variant run without problems. Calling these programs is done by \texttt{etex}
+or \texttt{elatex} on the appropriate .tex-file.
+
+\paragraph{pdf\TeX{}}
+
+In order to install pdf\TeX{} get the file
+\begin{quotation}
+\texttt{http://ftp.math.utah.edu/pub/tex/historic/systems/web2c/}
+
+\texttt{web2c-7.2/pdftexlib-0.12h.tar.gz}
+\end{quotation}
+and extract it in \texttt{../amiweb2c-2.1/}. Then from \texttt{../texmf/web2c}
+issue the commands
+\begin{quotation}
+\texttt{pdftex -{}-ini -{}-fmt=pdftex plain.tex}
+
+\texttt{\textbackslash input hyphen.cfg (optional)}
+
+\texttt{dump}
+\end{quotation}
+and to initiate the pdf\LaTeX{} system
+\begin{quotation}
+\texttt{pdftex -{}-ini -{}-fmt=pdflatex latex.ltx}
+\end{quotation}
+Calling these programs is done by \texttt{pdftex} or\texttt{ pdflatex}
+on the appropriate .tex-file. For a manual see
+\begin{quotation}
+\texttt{https://tex.loria.fr/moteurs/pdftex0.12-manual.pdf}
+\end{quotation}
+There is also a file \texttt{pdftexlib-0.14h.tar.gz} but I chose the
+file above as it corresponds to the version of the pdf\TeX{} binary.
+Note that installing the 0.14h library does not update the pdf\TeX{}
+binary. If you want to do that you need to install from web2c source.
+I have no idea how to do that.
+
+\paragraph{omega}
+
+For the omega system, a 16~bit, Unicode based \TeX{}-system there
+is the file
+\begin{quotation}
+\texttt{http://ftp.math.utah.edu/pub/tex/historic/systems/web2c/}
+
+\texttt{omega/omega-lib-1.5.tar.gz}
+\end{quotation}
+which gets untar-ed in \texttt{../Amiweb2c-2.1}. After the customary
+\texttt{mktexlsr} the ini process is started in \texttt{../web2c}
+by
+\begin{quotation}
+\texttt{omega -{}-ini -{}-progname=lambda lambda.tex}
+\end{quotation}
+after which a further 8~MB of disk space are taken up. This gets
+run on a \texttt{test.tex} file as
+\begin{quotation}
+\texttt{lambda test.tex}
+\end{quotation}
+I do not use the omega system which has been abandoned anyway so this
+is just for completeness sake.
+
+\subsection{Configuration of ShowDVI\label{subsec:Configuration-of-ShowDVI}}
+
+To view the .dvi-file \texttt{filename.dvi}, produced by the compilation
+of your \TeX{} document, you need the command
+\begin{quotation}
+\texttt{showdvi filename}
+\end{quotation}
+For standard resolution of 100~dpi this should produce results. For
+full functionality, however, some tweaks need to be made in the configuration
+of ShowDVI:
+
+The configuration file \texttt{ShowDVI.config} located in \texttt{..texmf/pastex/config}
+is set to run ShowDVI on its own screen in the NTSC format. If, like
+me, you are running a PAL monitor the line
+\begin{quotation}
+\texttt{screen-mode ntsc}
+\end{quotation}
+must be changed to 
+\begin{quotation}
+\texttt{screen-mode pal}
+\end{quotation}
+ShowDVI in the installed configuration starts on its own screen. If
+you want the program to run on the Workbench screen, the line
+\begin{quotation}
+\texttt{use-own-screen no}
+\end{quotation}
+must be changed to
+\begin{quotation}
+\texttt{use-own-screen yes}
+\end{quotation}
+The disadvantage of this is, you loose the automatic switching to
+the previewer when calling the \LaTeX{} server.
+
+The fonts for LA\TeX{} are defined via .mf-files which \MF{} uses
+to produce the .tfm-files for typesetting and the .pk-files which
+ShowDVI uses for graphical representation. The .mf-files are found
+in directories of the form \texttt{..texmf/fonts/source/supplier }where
+\texttt{mode} is a printer specific mode used by \MF{} detailed in
+\texttt{modes.mf}. The \texttt{supplier} part refers to subdirectories
+in \texttt{..texmf/fonts/source} as for example \texttt{public/cm}
+or \texttt{jknappen/ec}.\texttt{ }
+
+The way ShowDVI finds the .pk-files is defined in \texttt{ShowDVI.fnt}
+located in \texttt{..texmf/pastex/config}. The main part consists
+of lines of the form
+\begin{quotation}
+\texttt{basepkdir res res /mode}
+
+\texttt{basepkdir res res \TeX :..fonts/pk/mode/supplier1}
+
+\texttt{basepkdir res res \TeX :..fonts/pk/mode/supplier2}
+
+\texttt{...}
+\end{quotation}
+For example one of the ``suppliers `` is ``misc'' so to use the
+fonts in that subdirectory you need for the mode \texttt{amiga} below
+the line
+\begin{quotation}
+\texttt{basepkdir 100 100 /amiga }
+\end{quotation}
+to add the line
+\begin{quotation}
+\texttt{basepkdir 100 100 \TeX :..fonts/pk/amiga/misc}
+\end{quotation}
+and likewise for all other modes. 
+
+An edit is necessary for the existing resolution 120~dpi which uses
+the mode \texttt{OneTwoZero}. The lines below the line
+\begin{quotation}
+\texttt{basepkdir 120 120 /OneTwoZero}
+\end{quotation}
+are of the form
+\begin{quotation}
+\texttt{basepkdir 120 120 \TeX :..fonts/pk/amiga/supplier}
+\end{quotation}
+but need to be changed for each supplier to
+\begin{quotation}
+\texttt{basepkdir 120 120 \TeX :..fonts/pk/OneTwoZero/supplier}
+\end{quotation}
+as CallMF2 for this resolution is called with the mode \texttt{OneTwoZero}
+and thus stores the .pk-files in the subdirectory \texttt{../texmf/fonts/pk}/\texttt{OneTwoZero},
+so in the original version of \texttt{ShowDVI.fnt} ShowDVI would search
+in the subdirectory \texttt{../texmf/fonts/pk}/\texttt{amiga} and
+not find the files.
+
+\subsubsection{AMS fonts}
+
+The AMS fonts also contain Cyrillic fonts which are stored in the
+subdirectory \texttt{..ams/cyrillic} in \texttt{..texmf/fonts/source}.
+So if you need these fonts, add the lines
+\begin{quotation}
+\texttt{basepkdir res res \TeX :../fonts/pk/mode/ams/cyrillic} 
+\end{quotation}
+for the respective resolutions/modes in \texttt{ShowDVI.fnt}. 
+
+If you want to use AMS fonts, there is a file 
+\begin{quotation}
+\texttt{..texmf/doc/fonts/amsfonts/amsfndoc.tex}
+\end{quotation}
+which can be \TeX -ed in that directory with the CLI command \texttt{tex~amsfndoc.tex}.
+where the .tfm-files are part of the distribution. However as ShowDVI
+generates the .pk-files for \emph{all} AMS fonts, viewing the .dvi-file
+can take a bit of time.
+
+\section{Installation of the \protect\TeX{} server}
+
+The Amiweb2c distribution comes with a set of scripts located in\texttt{
+\TeX :rexx} which enables you to call \LaTeX{} from a text editor with
+the push of a key. There are scripts for Cygnus Editor (CED) with
+the ending .ced and for MicroEmacs (memacs) ending on .mg. This guide
+only details the use of these scripts for CED.
+
+Independent of what editor you use, \texttt{InitTex}, copied during
+the installation to\texttt{ S:}, needs a bit of editing: comment out
+the lines
+\begin{quotation}
+\texttt{run >NIL: SpecialHost}
+
+\texttt{WaitForPort special\_dvi}
+\end{quotation}
+by putting a semicolon at the beginning of the lines. The reason is
+that \texttt{SpecialHost} needs the file \texttt{muimaster.library}
+to work. But even with MUI installed I could not get \texttt{SpecialHost}
+to work. Furthermore the \LaTeX{} server calls the Rexx script \texttt{namestruc}
+located in \texttt{\TeX :rexx}. But the server script expects this
+routine in \texttt{REXX:} so issue the command
+\begin{quotation}
+\texttt{copy \TeX :rexx/namestruc REXX:}
+\end{quotation}
+The \TeX -server scripts for CED need not be copied to \texttt{REXX:},
+but are called from where they reside. To install the \TeX -server
+scripts in CED, use the menu entry ``Install DOS/ARexx command''
+in the ``Special'' menu, enter the number of the function key where
+you want to install the command and then enter the command. You need
+to use the menu entry ``Save DOS/ARexx commands'' to make this permanent.
+
+The scripts thus to install in CED are
+\begin{quotation}
+\texttt{\TeX :rexx/InitTex} 
+
+\texttt{\TeX :rexx/Start\_\TeX .ced} 
+
+\texttt{\TeX :rexx/Quit\_Tex} 
+\end{quotation}
+I installed the above three scripts on F1,F3 and F10 in that order.
+This choice of function keys is of course just one possibility. 
+
+The script \texttt{InitTex} starts the \TeX -server and ShowDVI on
+a different screen, but does not call \TeX{} to compile your document.
+To compile your active document, run \texttt{Start\_\TeX .ced}. If
+you use \texttt{Start\_\TeX .ced} and the server is not running yet,
+\texttt{Start\_\TeX .ced} will automatically start the server. 
+
+You can install \texttt{Start\_\TeX .ced} with the option ``\texttt{?}'',
+so that \texttt{Start\_\TeX .ced} \texttt{?} will always ask for the
+format to use. Standard would be \texttt{plain} or \texttt{latex}.
+If you set the environment variable \texttt{ASKFORMAT} to \texttt{1}
+then you will always be asked which format to use. You can call \texttt{Start\_\TeX .ced}
+with a definite format by installing the command \texttt{Start\_\TeX .ced
+\&format} where \texttt{format} is the format in question. Regardless
+of the method, the format will be stored in the environment variable
+\texttt{TEXFORMAT} which is updated whenever you use a different format.
+If you add the line
+\begin{quotation}
+\texttt{setenv TEXFORMAT format}
+\end{quotation}
+to your user-startup file, the \TeX -server and do not use an argument
+for \texttt{Start\_\TeX .ced} the \TeX -server will be always be called
+with the format \texttt{format}.
+
+Calling \texttt{Quit\_TeX} then stops the server and closes ShowDVI.
+You need to stop the server in order to stop ShowDVI manually.
+
+As a final tweak: ShowDVI is configured to switch to CED by pressing
+the F5 key. There is a counterpart \texttt{showdvitofront} in \texttt{\TeX :rexx}
+which similarly switches to the ShowDVI screen. Installing \texttt{showdvitofront}
+on the F5 key in CED in the same way as detailed above gives a nice
+way of toggling between the editor and the previewer.
+
+\subsection{Wishlist}
+
+The \TeX -server so far accepts only the commands \texttt{compile}
+for starting \LaTeX{} and \texttt{quit} for, well, you've guessed it.
+It does not automatically call \LaTeX{} again to correct for unresolved
+references nor does it support programs like bibtex, makeindex or
+dvips. It would be possible to take the subbranch of the script executing
+the compile order as a template to expand the capabilities of the
+\TeX -server, but as these scripts are themselves derived from web2c
+programs it would be less messy if the original web2c program CallMF2
+is extended. So if any \TeX -guru out there fancies some nights of
+tinkering...
+
+\section{Fonts and all that}
+
+Actually this section is not about ``and all that''. It is not about
+what fonts actually are, but what is most memorable about them\footnote{``1066 and all that'' by Sellar and Yeatman. When working out the
+test questions for each chapter do not attempt to write on both sides
+of the paper at the same time.}... What is most memorable about fonts is that there two kinds: Bitmap
+fonts using \MF{} to generate .pk-files giving the pixelated representation
+of the font and outline fonts defined so that they can be rendered
+in terms of curves ``on the fly'' to give a graphical representation
+using the programming language PostScript. We start with the former
+and then turn to the latter.
+
+\subsection{Installation of new fonts}
+
+To install new fonts based on \MF{}, you need the defining .mf-files.
+Store these in a subdirectory to \texttt{..texmf/fonts/source}, say
+\texttt{newfontsdir} and run \texttt{mktexlsr} from \texttt{..texmf/}
+to make these files findable to \MF{}. If you compile your document
+with \LaTeX , CallMF2 will automatically generate the .tfm-files \LaTeX{}
+needs to typeset the new fonts. For PostScript fonts this process
+is more involved, and will only be briefly (read: to the extent of
+my meager knowledge) be touched upon below.
+
+Like \LaTeX , ShowDVI will automatically use CallMF2 to generate the
+.pk files, but first you need to tell ShowDVI where to find the .pk-files.
+To do this, you need to add for each resolution or mode in \texttt{ShowDVI.fnt}
+the line
+\begin{quotation}
+\texttt{basepkdir \TeX :../fonts/pk/mode/newfontsdir} 
+\end{quotation}
+where \texttt{mode} is the respective mode in question found in \texttt{modes.mf}.
+To use the new font in \LaTeX , include the line
+\begin{quotation}
+\texttt{\textbackslash newfont\{\textbackslash fontcommand\}\{mffilename
+at xxxpt\}}
+\end{quotation}
+where \texttt{xxx} is the size of the font in pt (1/72.27 inch) before
+the part in your document where you actually use the font. Alternatively
+you can use
+\begin{quotation}
+\texttt{\textbackslash newfont\{\textbackslash fontcommand\}\{mffilename
+scaled 1000\}}
+\end{quotation}
+The factor 1000 means a scaling factor of 1. So if \texttt{mffilename}
+encodes a font of 10~pt size \texttt{..scaled 1200} would tell \TeX{}
+to use it magnified at 12~pt size. 
+
+Replace \texttt{fontcommand} with any label you want. To switch to
+the new font, use the command \texttt{\textbackslash fontcommand}.
+If you don't want to use the font for the remainder of your document,
+enclose \texttt{\textbackslash fontcommand} and the text it applies
+to in curly brackets. If you want to switch back to the standard computer
+modem font, use
+\begin{quotation}
+\texttt{\textbackslash fontfamily\{cmr\}\textbackslash selectfont}
+\end{quotation}
+Alternatively you can enclose the \texttt{\textbackslash fontcommand}
+in curly brackets
+\begin{quotation}
+\texttt{\{\textbackslash fontcommand text...\}}
+\end{quotation}
+If you want to save a bit of time by calling \MF{} only once, forgo
+the calling of \texttt{mktexlsr} and generate the .tfm-files and the
+.pk-files in one go by \texttt{cd}'ing into \texttt{..texmf/fonts/source/newfontsdir}
+and issuing the commands
+\begin{quotation}
+\texttt{mf ``\textbackslash mode:=amiga;'' ``mag:=1;'' input
+mffilename}
+
+\texttt{gftopk mffilename.100gf mffilename.pk}
+\end{quotation}
+where \texttt{mffilename} is the name of the .mf-file in question.
+Then move the generated .tfm-file to\textbf{ }
+\begin{quotation}
+\texttt{..texmf/fonts/tfm/newfontsdir}
+\end{quotation}
+and the .pk-file to 
+\begin{quotation}
+\texttt{..texmf/fonts/pk/amiga/newfontsdir/dpi100}
+\end{quotation}
+It is advisable to run \texttt{mktexlsr} from \texttt{..texmf/} at
+this point. Furthermore, you need still need to edit \texttt{ShowDVI.fnt}
+as outlined above. This gives you the fonts for the standard resolution
+of 100~dpi in one go. For other resolutions ShowDVI needs to call
+\MF{} again, though. This method is only workable for small sets
+of fonts. For whole font families it is advisable to use the automatic
+generation process.
+
+For other printers/resolutions the corresponding definition can be
+found in \texttt{modes.mf} (in \texttt{..texmf/metafonts}). If you
+run \MF{} in another mode with resolution \texttt{xxx~dpi} or with
+another magnification, you get a file \texttt{ending on .xxxgf}, the
+.pk-file of which needs to be stored in 
+\begin{quotation}
+\texttt{..texmf/fonts/pk/mode/newfontsdir/dpixxx}
+\end{quotation}
+If \MF{} cannot find the .mf-file in question and you want \MF{}
+to stop asking, enter ``\texttt{null}'', and \MF{} will use the
+default file \texttt{null.mf}. 
+
+\subsection{A note on ec fonts}
+
+The Amiweb2c distribution includes the .mf-files of the ec font family
+in the T1 encoding. You can set your document in this font family
+by using
+\begin{quotation}
+\texttt{\textbackslash usepackage{[}T1{]}\{fontenc\}}
+\end{quotation}
+in the preamble. You need to configure \texttt{ShowDVI.fnt} for the
+ec fonts, as shown in section~\ref{subsec:Configuration-of-ShowDVI}
+where the subpath to the .mf-files is
+\begin{quotation}
+\texttt{..texmf/fonts/source/jknappen/ec}
+\end{quotation}
+The \MF{} run on an ec-font takes about 4 minutes while a run on
+a cm font takes 1 minute 30 seconds, so it is advisable to download
+the .tfm-files of the ec fonts from CTAN and copy them to \texttt{..fonts/tfm/jknappen/ec}
+so that only the generation of the -pk-files is necessary.
+
+A hitch exists for the small ec fonts like ecrm0500 as CallMF2, called
+by \LaTeX , runs \MF{} in \texttt{nullmode} with a 101~dpi resolution.
+For small fonts this mode throws up the error message ``strange path
+(turning number zero)``, seemingly due to rounding errors. A list,
+not claiming to be complete, of problematic .mf-files for the ec fonts
+is: 
+\begin{verbatim}
+eccc0500-0800,ecoc0500,ecsc0500-0800,ecsi0500-0800,
+ecsl0500-0900,ecso0500-0700, ectc0500-0700, ecs1200, 
+ecss0500-2488, ectt0500, ectt0900, ecti 0500, ecti0700, ecbx0500
+\end{verbatim}
+The trick is to generate the .tfm- and .pk\-files for such offending
+fonts by the manual method described in the previous subsection with
+the mode \texttt{ljfour} corresponding to 600~dpi and store the .tfm-files
+in
+\begin{quotation}
+\texttt{..texmf/fonts/tfm/jknappen/ec/}
+\end{quotation}
+and the the .pk-files in 
+\begin{quotation}
+\texttt{..texmf/fonts/pk/ljfour/jknappen/ec/dpi600/}
+\end{quotation}
+If you are using the small ec fonts for the first time, it is advisable
+to run ShowDVI from the command line and not from the server as in
+the former case you get detailed error messages about which font is
+causing such problem. ShowDVI is not configured ``out of the box''
+for the use of ec fonts, so need to modify its config file as outlined
+in the previous section.
+
+\subsection{PostScript fonts}
+
+The following is a few notes based on gleanings from the wild world
+of PostScript fonts for \LaTeX{}. It does not claim to be authoritative
+or in any way complete. Nor should the same functionality as of a
+modern \TeX{} system be expected. After all, pdf\TeX{} for Amiweb2c
+is in version 0.12h. I will not even begin to discuss OpenType or
+TrueType fonts.
+
+\subsubsection{Crating PostScript files with dvips}
+
+To convert a .dvi-file \texttt{test.dvi} produced by TeX into a PostScript
+documents is done by the program dvips by calling 
+\begin{quotation}
+\texttt{dvips test}
+\end{quotation}
+producing the PostScript file \texttt{test.ps}. Dvips can be made
+to tailor its output to a specific printer by calling it with the
+option \texttt{-Pxxx}, where \texttt{xxx} is part of the name in files
+of the type \texttt{config.xxx}, usually located in \texttt{..texmf/dvips/config}.
+The \texttt{xxx} also correspond to modes found in \texttt{modes.mf}
+(in \texttt{..texmf/metafonts/misc}) which also gives the physical
+printer model these modes refer to. For Amiweb2c the following config
+files are available:
+\begin{quotation}
+\begin{tabular}{|c|c|c|}
+\hline 
+\texttt{xxx} & \texttt{resolution / dpi} & \texttt{printer model}\tabularnewline
+\hline 
+\hline 
+\texttt{canonex} & \texttt{600} & \texttt{LaserWriter Pro 630}\tabularnewline
+\hline 
+\texttt{cx} & \texttt{300} & \texttt{Canon CX}\tabularnewline
+\hline 
+\texttt{deskjet} & \texttt{300} & \texttt{HP DeskJet 500}\tabularnewline
+\hline 
+\texttt{epson} & \texttt{240x216} & \texttt{Epson MX/FX 9-pin}\tabularnewline
+\hline 
+\texttt{ibmvga} & \texttt{110} & \texttt{IBM VGA monitor}\tabularnewline
+\hline 
+\texttt{ljfour} & \texttt{600} & \texttt{HP LaserJet 4}\tabularnewline
+\hline 
+\texttt{qms} & \texttt{300} & \texttt{QMS (Xerox engine)}\tabularnewline
+\hline 
+\texttt{toshiba} & \texttt{180} & \texttt{Toshiba 13XX}\tabularnewline
+\hline 
+\end{tabular}
+\end{quotation}
+The mode \texttt{config.deskjet} is the default one. 
+
+\subsubsection{Dvips with PostScript fonts}
+
+Dvips works with CallMF2 to produce .pk-files on the fly. However
+dvips also works\footnote{And I use the word works in a very fuzzy sense.}
+with native PostScript fonts. In the \TeX{} world a font is defined
+via two files: the .tfm-file encoding the way a font is typeset and
+a .mf-file encoding in lines and curves how a font actually looks.
+Their counterparts the PostScript world are the .afm-file (Adobe Font
+Metric) and the .pfa-file (PostScript Font Adobe) in human readable
+format or in packed, binary form as .pfb-files.
+
+For the standard Computer Modern (cm) fonts there is a PostScript
+version known as bakoma fonts which can be found in the bakoma package
+on CTAN. To install the bakoma fonts, copy the .pfb-files to the sub-directories
+\texttt{cm/ and ams/ in} \texttt{..fonts/type1/bakoma/}. Then copy
+the files \texttt{cmfonts.map}, \texttt{amsfonts.map} to \texttt{..texmf/dvips/config}
+and edit the file \texttt{config.ps} in \texttt{..texmf/dvips} to
+include the lines
+\begin{quotation}
+\texttt{p +cmfonts.map}
+
+\texttt{p +amsfonts.map}
+\end{quotation}
+A run of \texttt{mktexlsr} is to follow. Then using \texttt{dvips
+<filename>} on a .dvi-file \texttt{<filename.dvi>} containing cm fonts
+will produce a .ps-file \texttt{<filename.ps>} containing the PostScript
+outline versions of cm fonts. Dvips ``downloads'' that is incorporates
+the .pfb files into the PostScript file. If you don't want that for
+reason of file size you need to edit the corresponding map files and
+remove the ``<'' in front of the token xxx.pfb where xxx is the
+name of the -pfb-file in question. A test is given by \texttt{cd}-ing
+into \texttt{..texmf/doc/fonts/amsfonts} and running \texttt{dvips}
+on \texttt{amsfndoc.dvi}.
+
+Running dvips on a .dvi-file in OT1 encoding with the bakoma .pfb-files
+present but not with the map files of the bakoma package installed,
+it throws up the error message that it cannot find the file \texttt{f7b6d320.enc}.
+This file is referred to in the default map file \texttt{psfonts.map}.
+You can download this .enc-file (and other .enc files also referred
+to in \texttt{psfonts.map} for cm fonts) from
+\begin{quote}
+\texttt{http://chocolatshalba.ch/files/texlive/texmf/fonts/}
+
+\texttt{enc/dvips/tetex/}
+\end{quote}
+all of which which gets copied into \texttt{.../dvips/base}. Then
+dvips runs cleanly. 
+
+If you want to use the ec fonts in their Postscript version, get the
+file \texttt{cm-super.zip} from CTAN. Note that they eat up about
+60MB of disk space. Copy the .pfb-files to \texttt{.../texmf/fonts/type1/public/cm-super}
+and the .enc-files to \texttt{../dvips/base}. Dvips comes with the
+default map \texttt{psfonts.map} which already contains the necessary
+mappings for the cm-super fonts. A run of \texttt{mktexlsr} is to
+follow.
+
+For pdf\TeX{} copy the .enc-files and .map-files from \texttt{cm-super.zip}
+to\\ \texttt{..texmf/pdftex/base} and add to \texttt{pdftex.cfg}
+in the same directory the line
+\begin{quotation}
+\texttt{m +cm-super-t1.map}
+\end{quotation}
+and similar for all the other .map-files.
+
+\subsubsection{Ghostscript}
+
+ShowDVI in its Amiweb2c incarnation can only preview .dvi-files containing
+bitmap-based fonts but not .dvi-files containing PostScript fonts
+which are based on outlines. In the same vain ShowDVI does not know
+how to handle .ps-files or .pdf-files created by dvips or pdflatex.
+However there is a previewer for .ps- and .pdf-files called Ghostscript.
+To install Ghostscript, download from \texttt{aminet.net} the files
+\begin{quotation}
+\texttt{GS510-fonts-st.lha}
+
+\texttt{GS510-fonts-ot.lha}
+
+\texttt{GS510-data.lha}
+
+\texttt{GS510-040fpu.lha}
+
+\texttt{GS510Fontmap.lha}
+\end{quotation}
+To automatize the install process also download \texttt{GS510-Install.lha}.
+Extract this file and copy the above .lha-files into the created directory
+\texttt{Ghost\_Install}. Then get \texttt{Installer\_43.3.lha} from
+\texttt{aminet.net}, extract it and copy the file \texttt{Installer}
+to \texttt{C:}. Then run one of the install-scripts in \texttt{Install\_Ghost}.
+To install Ghostscript in \texttt{../Amiweb2c-2.1/ghostscript} as
+in \texttt{user-startup.entry} create the subdirectory \texttt{ghostscript}
+in \texttt{../Amiweb2c-2.1} either by hand or during the installation
+process. Note that this installation adds to \texttt{user-startup}
+a section starting with \texttt{;Begin Ghostscript} which has then
+entry \texttt{assign PSFONTS:Ghostscript:fonts} without the qualifier
+``\texttt{add}'', undoing all the settings to \texttt{PSFONTS:}
+in \texttt{user-startup.entry}. So it is advisable to uncomment this
+line. AFAICT Ghostscript 5.10 ignores that assignment anyway. 
+
+Invoke Ghostscript on a .ps-file in the directory of that .ps-file
+by \texttt{gs <psfile>}. The resolution of the display window of can
+be changed by the command line option \texttt{\textendash r<dpi>}.
+I have found that \texttt{<dpi>=250} is the maximum value, for \texttt{<dpi>=300}
+Ghostscript crashes. This might be a problem of insufficient memory. 
+
+Ghostscript has two ways of finding the .pfb-files (or .pfa-files,
+the ASCII variant of the binary .pfb-files) for a font: One is the
+file \texttt{Fontmap} in \texttt{Ghostscript:} which has lines of
+the form
+\begin{quotation}
+\texttt{/fontname (pfbfilename.pfb);}
+\end{quotation}
+where \texttt{fontname} is the full font name as given in the .pfb-file
+in the line beginning with /Fontname and \texttt{pfbfilename} is,
+well, you've guessed it. If only \texttt{pfbfilename} is given, Ghostscript
+looks for it in \texttt{Ghostscript:fonts}. But you can also give
+the full path like \texttt{TYPE1DIR:supplier/typeface/pfbfilename.pfb}.
+Another way is to set the environment variable \texttt{GS\_FONTPATH}
+by
+\begin{quotation}
+\texttt{setenv GS\_FONTPATH Path}
+\end{quotation}
+The problem is that AFAICT Ghostscript 5.10 does not search in multiple
+paths of the form \texttt{Path1,Path2...} nor does it accept wild
+cards like \texttt{\#?} or \texttt{{*}} so for Ghostscript all .pfb-files
+would be needed to be stored in one directory if you want to use the
+environment variable.
+
+On a final note, avoid running \texttt{dvips} and \texttt{gs} from
+the same CLI window. There seem to be some incongruities which causes
+dvips to crash or stall.
+
+\subsubsection{Ghostscript and PostScript cm/ec fonts}
+
+Running dvips on a .dvi-file containing cm fonts in the OT1 encoding
+using the default psfonts.map gives a clean run. But when viewing
+the resulting .ps-file in Ghostscript 5.10 there are missing glyphs.
+Viewing that .ps-file on a modern modern PC with TeXLive installed
+gives the same result. An even bigger but\footnote{I can't lie, I had to.}
+is that using the maps from bakoma package, the .ps-file is displayed
+correctly in Ghostscript but has missing glyphs and weird font substitution
+when viewing on a modern PC.
+
+For the ec fonts in the cm-super form dvips runs cleanly, but Ghostscript
+throws up the maddeningly unhelpful error message ``/undefined in
+T1Encoding''. Viewing the same .ps-file on a modern PC has missing
+glyphs. 
+
+\subsubsection{Ghostscript and pdf\TeX{}}
+
+Running pdflatex on .tex files with bakoma or cm-super PostScript
+fonts produces a .pdf-file which is is displayed without errors on
+a modern PC but Ghostscript throws up the maddeningly unhelpful error
+message ``undefined in \yen''. For PostScript ec fonts from the
+Latin Modern package pdflatex throws up ``unexpected end of file''.
+
+\subsubsection{Ghostview and PostScript New Font Selection Scheme\label{subsec:psnfss}}
+
+The PostScript New Font Selection System (psnfss) detailed in \texttt{psnfss.pdf}
+in \texttt{..texmf/doc/latex/psnfss} works in Amiweb2c for all packages
+like \texttt{avant, courier} etc. (see \texttt{psnfss.pdf} for a full
+list) . Note that the font outlines for all packages in the psnfss
+are not part of the distribution due to licensing. However, for the
+fonts used in \texttt{psnfss} (see below) Ghostscript comes equipped
+with its own version of the .pfb-files (the .gsf-files) and will call
+them automatically. The .gsf versions are generally seen as lacking
+in quality, but with the resolution on an old-school Amiga this is
+not really an issue. Two exceptions are the Utopia fonts and the Charter
+fonts which Ghostscript has on board in the form of .pfa-files. Alternatively
+for the packages \texttt{charter} and \texttt{utopia} there are freely
+available .pfb-files on CTAN. To install these, copy them into
+\begin{quotation}
+\texttt{.../texmf/fonts/type1/adobe/charter/}
+
+\texttt{.../texmf/fonts/xxx/adobe/utopia}.
+\end{quotation}
+respectively. The map files \texttt{charter.map}, \texttt{utopia,map}
+are already in \texttt{../dvips/psnfss}. Activate these map files
+by adding the lines 
+\begin{quotation}
+\texttt{p +psnfss/utopia.map}
+
+\texttt{p +psnfss/charter.map}
+\end{quotation}
+to \texttt{..dvips/config.ps}. Dvips reads in map files according
+to the file \texttt{config.ps}. See section \ref{subsec:psnfss}.
+Another way is to specify the map on the command line with \texttt{-u}
+option like
+\begin{quotation}
+\texttt{dvips -upsnfss/utopia.map test}
+\end{quotation}
+However displaying the resulting .ps-file in Ghostscript causes the
+program to fail and throw up a lot of incomprehensible error messages.
+According to the man page of dvips using this \texttt{-u} option means
+that dvips uses the specified map file exclusively. It should be possible
+to call dvips as
+\begin{quotation}
+\texttt{dvips -u +psnfss/utopia.map test}
+\end{quotation}
+so that \texttt{utopia.map} is used \emph{in addition} to \texttt{psfonts.map}.
+But this causes dvips to complain that it cannot find the headerfile
+\texttt{+psnfss/utopia.map}. 
+
+\subsubsection{General PostScript fonts}
+
+The installation of any PostScript font can be done pretty much as
+outlined in the two above examples. Most packages on CTAN for PostScript
+fonts come with the relevant files which just need to be copied to
+their appropriate locations and then run \texttt{mktexlsr}. The best
+way is keep in accordance with the TDS (TeX Directory Structure) is
+to copy the files of type \texttt{xxx} of a font designed by the ``supplier''
+and with the ``typeface'' into \texttt{.../texmf/fonts/xxx/supplier/typeface}. 
+
+If you have only .afm- and .pfb-files, the process is more daunting
+and I cannot claim to fully understand it. A starting point for DIY
+PostScript font installation would be
+\begin{quotation}
+\texttt{https://www.tug.org/TUGboat/tb27-1/}
+
+\texttt{tb86kroonenberg-fonts.pdf} 
+\end{quotation}
+for details. 
+
+There is a package fontinst on CTAN which automatizes most of the
+installation process of PostScript fonts (see:
+\begin{quotation}
+\texttt{http://texdoc.net/texmf-dist/doc/fonts/Type1fonts/}
+
+\texttt{fontinstallationguide.pdf}
+\end{quotation}
+However this can be time consuming. The process of converting a single
+.afm-file to a .pl-file (the ASCII version of the binary .tfm-file)
+and several .vpl-files the ASCII version of the binary .vf-files takes
+about 15 minutes. So installing whole font families from scratch is
+something of a project.
+
+\subsubsection{Automatic font creation}
+
+The Amiweb2c-2.1 distribution can create .tfm- and .pk-files form
+\MF{} source files automatically. However PostScript fonts are outline
+fonts and not bitmaps like .pk-fonts. So pk is pk and pfb is pfb and
+never shall the twain meet. In principle CallMF2 contains a subsection
+for the generation of .pk-files from .pfb-files using the program
+\texttt{ps2pk}. Calling ShowDVi on a .dvi-file containing PostScript
+fonts (or more to the point their .tfm-file) then effects a call on
+\MF{} via CallMF2 which complains that is cannot find some .mf-file. 
+
+However \texttt{MakeTeXFont.rexx}, the heart of the automatic font
+generation scripts for Amiweb2c looks for the fonts according to the
+names given in the .dvi-file. These names depend on the encoding (OT1,T1...)
+chosen in the \LaTeX{} file. But \texttt{MakeTeXFont.rexx} looks
+for the corresponding .pfb-files according to that encoding scheme
+determined by the final two symbols (number and letter) in the .tfm-filename
+which which it was called. For the Utopia-Roman font in the T1 encoding
+that filename is \texttt{putr8t}. But \texttt{MakeTexFont.,rexx} then
+looks for that string in a single map file \texttt{ps2pk.map} which
+isn't even the default map of dvips. The problem is that the naming
+convention by Karl Berry has the names of the .pfb-files end on two
+letters determining the encoding (8a for Adobe, 7t for OT1, 8t for
+T1, see input98.pdf in the package fontinst for a partial list and
+Karl Berry Filenames for fonts 
+\begin{quotation}
+\texttt{https://www.tug.org/TUGboat/tb11-4/tb30berry.pdf}
+\end{quotation}
+for a full list. The naming scheme is a result of the restriction
+on the length of filename on old operating systems. Note however that
+modern packages come with filenames which break the maximum length
+of filenames for AmigaOS. Here you are on your own. So to make a long
+story short, \texttt{MakeTexFont.rexx} fails to find the .pfb-file
+and proceeds to look for a corresponding .mf-file. Which fails. While
+it would be possible to patch the script by hand, CallMF2 for Amiweb2c
+is derived from web2c sources, which should be edited. Summoning some
+TeX-genie at this point...
+
+\subsection{Afterword}
+
+After my adventure in PostScript land so far as it applies to the
+Amiweb2c distribution on an Old-School Amiga, it is my considered
+opinion that PostScript fonts should only be used with Amiweb2c in
+connection with the psnfss. For this Ghostscript displays the files
+correctly. For common cm/ec fonts it is best to stick to the classic
+\MF{} world. If you want to use their PostScript versions nonetheless,
+my advice is to use pdf\LaTeX{} and display the .pdf-file on a modern
+PC with a modern \TeX{} installation.
+
+\section{Conclusion}
+
+This concludes the installation of the \LaTeX{} distribution Amiweb2c
+on an emulated Amiga with Workbench 3.1. Happy \TeX -ing!
+
+\appendix
+
+\section{Keyboard}
+
+The keyboard of the emulated Amiga and the modern PC keyboard are
+not identical, so the mapping of the emulated Amiga keyboard to your
+physical keyboard can be a bit ...opaque. Below is a list of keymappings
+I found out --- some of them quite by accident --- to be helpful.
+Note that they depend on my keyboard with German layout. The left
+side of the equation sign is the PC keyboard and the right side is
+the Amiga keyboard:
+\begin{quotation}
+\texttt{Einf = \#}
+
+\texttt{Shift + Einf = \textasciicircum}
+
+\texttt{\# = \textbackslash}
+
+\texttt{Shift + \# = |}
+
+\texttt{\textasciicircum{} = `}
+
+\texttt{Shift + \textasciicircum{} = \textasciitilde}
+
+\texttt{Pos 1 = {[}}
+
+\texttt{Shift + Pos 1 = \{}
+
+\texttt{Bild up = {]}}
+
+\texttt{Shift + Bild up = \}}
+
+\texttt{Bild down = Amiga key}
+\end{quotation}
+The key \texttt{Einf} corresponds to \texttt{Ins} and \texttt{Bild}
+corresponds to \texttt{Pg} on an English keyboard.
+
+The keymapping of the emulator has consequences for the navigation
+of the cursor in CED:
+\begin{quotation}
+\texttt{Line up: Shift + Numpad 8}
+
+\texttt{Line down: Shift + Numpad 2}
+
+\texttt{Beginning of file: Ctrl (left) + Shift + Numpad 8}
+
+\texttt{End of file: Ctrl (left) + Shift + Numpad 2}
+
+\texttt{Character left: Shift + Numpad 4}
+
+\texttt{Character right: Shift + Numpad 6}
+
+\texttt{Word left: Ctrl (left) + Shift + Numpad 4}
+
+\texttt{Word right: Ctrl (left) + Shift + Numpad 6}
+
+\texttt{Beginning of line: Ctrl (left) + Shift + Numpad 7}
+
+\texttt{End of line: Ctrl (left) + Shift + Numpad 1}
+
+\texttt{12 lines up: Ctrl + Shift + Numpad 9}
+
+\texttt{12 lines down: Ctrl + Shift + Numpad 3}
+\end{quotation}
+
+\section{Searching files}
+
+Quite often during the installation process you will have to find
+out where a particular file is located or whether it contains a particular
+phrase. This can be achieved from the CLI by the \texttt{search} command:
+\begin{quotation}
+\texttt{search from pattern file all quiet}
+\end{quotation}
+The option \texttt{from} is the full directory path in which to search.
+If the search is to be conducted from the currently active directory
+the \texttt{from} part is just \texttt{``''} (not an empty string,
+but double quotation marks). The option \texttt{pattern} is whatever
+you are searching for. For example to search for files with the ending
+.mf, use the pattern \texttt{\#?.mf}. The options \texttt{file} means
+that only file names are searched, without it the pattern is looked
+for also inside the files. Which can come in handy but slows things
+down. The option \texttt{all} means to search in all subdirectories
+and the option \texttt{quiet} means to show only the files where pattern
+is found, not to show all files being searched.
+
+If the list of results is rather long and scrolls past too quickly
+you can use w
+\begin{quotation}
+\texttt{search from pattern file all quiet > filename}
+\end{quotation}
+and the output will be redirected to the file \texttt{filename} for
+you leisurely perusal at you convenience.
+\end{document}


Property changes on: trunk/Master/texmf-dist/doc/latex/amiweb2c-guide/amiweb2c-guide.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/tlpkg/bin/tlpkg-ctan-check
===================================================================
--- trunk/Master/tlpkg/bin/tlpkg-ctan-check	2020-10-29 20:47:11 UTC (rev 56800)
+++ trunk/Master/tlpkg/bin/tlpkg-ctan-check	2020-10-29 20:47:54 UTC (rev 56801)
@@ -37,7 +37,7 @@
     aligned-overset
     alkalami allrunes almendra almfixed alnumsec
     alpha-persian alphalph
-    altfont ametsoc amiri
+    altfont ametsoc amiri amiweb2c-guide
     amsaddr amscdx amscls amscls-doc amsfonts amslatex-primer
     amsldoc-it amsldoc-vn
     amsmath amsmath-it amsrefs amstex amsthdoc-it 

Added: trunk/Master/tlpkg/tlpsrc/amiweb2c-guide.tlpsrc
===================================================================
Modified: trunk/Master/tlpkg/tlpsrc/collection-langenglish.tlpsrc
===================================================================
--- trunk/Master/tlpkg/tlpsrc/collection-langenglish.tlpsrc	2020-10-29 20:47:11 UTC (rev 56800)
+++ trunk/Master/tlpkg/tlpsrc/collection-langenglish.tlpsrc	2020-10-29 20:47:54 UTC (rev 56801)
@@ -8,6 +8,7 @@
 #
 depend MemoirChapStyles
 depend Type1fonts
+depend amiweb2c-guide
 depend amscls-doc
 depend amslatex-primer
 depend around-the-bend



More information about the tex-live-commits mailing list.