doc 4

git-svn-id: svn://tug.org/texlive/trunk@80 c570f23f-e606-0410-a88d-b1316a301751

3 files changed, 258 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/fax/faxdoc.tex b/Master/texmf-dist/doc/latex/fax/faxdoc.tex
new file mode 100644
index 00000000000..04c785868ba
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/fax/faxdoc.tex
@@ -0,0 +1,179 @@
+\documentclass[oldtoc,a4paper,10pt]{artikel3}
+%\usepackage{a4wide}
+\begin{document}
+\author{J.B.~Rhebergen}
+\date{\today}
+\title{{\tt fax.cls} Documentation}
+\maketitle
+
+\section{Introduction}
+This fax class is written to work with the following other classes or
+packages:
+
+\begin{tabular}{ll}
+{\tt artikel3.cls} &One of the dutch article styles.\\
+{\tt lastpage.sty} &A small package that lets you reference the last
+page.\\
+\end{tabular}
+
+It can however still work without these files. If the {\tt artikel3.cls}
+cannot be found the {\tt article.cls} will be loaded instead. If available
+{\tt lastpage.sty} will also be loaded. If you do not have {\tt
+lastpage.sty} you can set the fax page numbers by hand by using the
+\verb|\setcounter{faxpages}{..}| command.
+
+\section{Other files}
+The following files should be prepared by the user:
+
+\begin{tabular}{ll}
+{\tt from.fax} &containing your name etc.\\
+{\tt note.fax} &containing a note which you would like to add.\\
+\end{tabular}
+
+If you are using the {\tt dutch} class option you need:
+
+\begin{tabular}{ll}
+{\tt van.fax} &containing your name etc. (in dutch)\\
+{\tt nb.fax}  &containing a note which you would like to add. (in dutch)\\
+\end{tabular}
+
+Of course this can easily be changed or added for any other language. Feel
+free to do so.
+
+\section{Options}
+The following class options are at your disposal:
+\begin{description}
+\item[dutch] Switches to dutch language and reads the files {\tt van.fax}
+  and {\tt nb.fax} instead of the default {\tt from.fax} and {\tt note.fax}
+\item[note] Adds a note to your fax header. This note should be specified
+  in the file {\tt note.fax} or if you have used the {\tt dutch} option
+  {\tt nb.fax}
+\item[nosep] Omits the {\tt faxtopset} length variable which is currently
+  set at {\tt 3ex} This white space separates your fax header from the rest
+  of the text.
+\end{description}
+
+The fax is typeset in \verb|\sf| (sans serif) by default, because I felt
+that this would give the most legible results on a fax machine.
+
+\section{Commands}
+In the preamble of the fax document the following commands are available:
+\begin{description}
+\item[$\backslash$to] Specifies what you want in the `to' box. This should
+  preferably be in the form of a {\tt tabular} environment. If omitted the
+  box will stay empty.
+\begin{verbatim}
+\to{\begin{tabular}[t]{rl}
+  to:      &You\\
+  address: &Your place\\
+  tel:     &Your number\\
+  fax:     &Whatever\\
+  \end{tabular}}
+\end{verbatim}
+\item[$\backslash$from] Specifies what you want in the `from' box. This should
+  preferably be in the form of a {\tt tabular} environment. If omitted the
+  {\tt from.fax} file will be used.
+\begin{verbatim}
+\from{\begin{tabular}[t]{rl}
+  from:    &Me\\
+  address: &My place\\
+  tel:     &My number\\
+  fax:     &Whatever\\
+  \end{tabular}}
+\end{verbatim}
+  If you want an empty `from' box use \verb|\from{}|.
+\item[$\backslash$mymsg] Normally the fax header begins with the message:
+  {\sc Tele-Fax Message}. If you have specified the {\tt dutch} option the
+  fax header will begin with: {\sc Fax Boodschap} If you want to start with
+  your own header (or logo even) you can use the \verb|\mymsg| command like
+  this:
+  \begin{center}
+  \vspace{1.5ex}
+  \verb|\mymsg{{\Large\bsf Watch out! here comes a FAX!}}|
+  \vspace{1.5ex}
+  \end{center}
+  If you want absolutely no fax top message just specify \verb|\mymsg{}|
+  i.e. an empty command.
+\item[$\backslash$bsf] Switches to bold sans serif. i.e. \verb|{\bsf this is bold}|
+\item[$\backslash$slsf] Switches to slanted sans serif. i.e. \verb|{\slsf this is slant}|
+\end{description}
+
+\section{Suggestions}
+To make your faxes even more `beautiful' you could use the {\tt wasysym}
+package which provides a \verb|\phone| command. This can be used to get a
+cute little telephone icon in your `to' or `from' box. Like this:
+\begin{verbatim}
+\from{\begin{tabular}[t]{rl}
+  from:    &Me\\
+  address: &My place\\
+  \phone:  &My number\\
+  fax:     &Whatever\\
+  \end{tabular}}
+\end{verbatim}
+Don't forget to put \verb|\usepackage{wasysym}| in your preamble though.
+
+For my own convenience I have made a signature package. This provides a
+signature for my fax documents. Of course you need to get your signature
+scanned first and make the signature available in the form of a {\tt .pcx}
+file or {\tt .msp} file. If you want to know more about this compile and
+read the {\tt sigdoc.tex} file.
+
+\section{Conversion}
+Once you've successfully used the {\tt fax.cls} to make a fax document you
+have a choice.
+
+\begin{itemize}
+\item Print it, feed it to the fax machine and send it. (trivial)
+\item Convert it to a fax-modem compatible file and send it.
+\end{itemize}
+
+These days lots of people have a fax-modem. To convert the {\tt .dvi} file
+you generated, to some kind of fax-modem compatible file you need a
+conversion program. Let me describe how I go about sending a fax.
+
+I am using em\TeX{} for {\tt DOS} to compile my {\tt .tex} documents. The
+latest em\TeX{} release, version [4a], has a {\tt fax.cnf} file and
+\verb|fax_base.fli| file which facilitate generating {\tt .dvi} files in fax
+resolution.
+
+I subsequently convert this fax {\tt .dvi} file to a {\tt .pcx} file, using
+the following batch file.
+
+\begin{verbatim}
+@echo off
+dvidrv dvidot pcx @fax.cnf /fl=-1 %1 %1.p?? %2 %3 %4 %5 %6 %7 %8 %9
+\end{verbatim}
+
+This will generate a number of {\tt .pcx} files one for each page of the
+fax document. The {\tt .pcx} files are numbered {\tt myfax.p01, myfax.p02,
+myfax.p03} if your original {\tt myfax.dvi} has three pages.
+
+The last step is to convert these {\tt .p??} files to one single {\tt .fax}
+file. I have found the {\tt 2FAX} program by Hans Harder very useful.
+However there was a bug in this program. Herre de Jonge the co\-author of
+this {\tt fax.cls} and I have debugged the program and added some
+functionality. Actually, Herre did most of the work on debugging the {\tt
+2FAX} program while I did most of the work on the {\tt fax.cls}. We've
+modified version 1.62 of {\tt 2FAX} and called it version 1.62a. I will
+make this debugged version available for ftp as soon as possible. We've
+also added some functionality. You now can use wildcards at the {\tt 2FAX}
+command line. Like this: \verb|2fax indoc.p?? outdoc.fax /hr|
+
+At this stage you have a file which can be sent by the fax-modem. In the
+case of {\tt 2FAX} this file is in the {\tt ZFAX} format. I am using an
+unregistered version of {\tt BGFAX} to send (or receive) faxes. {\tt BGFAX}
+is written by B.J.Guillot and is a simple but solid command line driven fax
+program. It's primarily intended for use with people who operate a bulletin
+board but who also want to send or receive faxes. There are various other
+programs for {\tt DOS} that will also send {\tt ZFAX} files. I will
+probably send the debugged version of {\tt 2FAX} to B.J. Guillot's bulletin
+board soon so people can download or ftp it from there. At the moment I
+still have to write a readme file and make some minor changes. If you're in
+a hurry to get the debugged version of {\tt 2FAX}, mail me and I'll send it
+to you.
+
+{\tt jbrhebergen@et.tudelft.nl}\\
+{\tt rheberg@morra.et.tudelft.nl}
+
+\end{document}
+
diff --git a/Master/texmf-dist/doc/latex/fax/sigdoc.tex b/Master/texmf-dist/doc/latex/fax/sigdoc.tex
new file mode 100644
index 00000000000..77a7a1ec074
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/fax/sigdoc.tex
@@ -0,0 +1,56 @@
+\documentclass[oldtoc,a4paper,10pt]{artikel3}
+\usepackage{a4wide}
+\begin{document}
+\author{J.B.~Rhebergen}
+\date{\today}
+\title{{\tt sig.sty} Documentation}
+\maketitle
+
+This is the {\tt sig.sty} package which can be used to put a scanned
+signature in your fax document or other documents. If you want to use this
+{\tt sig.sty} there are a number of things you need to change.
+
+The dimension of the \verb|\vbox| and \verb|\hbox| depend on the size of
+the signature. Measure them and change accordingly. The \verb|\sig| command
+puts the signature in the text. I added some negative kern which causes the
+signature to overlap a little just as happens sometimes when you put your
+signature on a document by hand. If you don't want this, use
+\verb|\altsig|. The \verb|\zsig| and \verb|zaltsig| are similar except that
+the \verb|\vbox| and \verb|\hbox| have zero dimensions. This allows you to
+put the signature on top of other text. (yes I know that is weird but it
+can be handy sometimes)
+
+Remember that you need to scale your signature to the proper size with
+a graphics program. To use with a fax document in fax resolution just put
+the command \verb|\usepackage[fax]{sig}| in the preamble of your document.
+In non fax document leave out the {\tt fax} option.
+
+\footnotesize
+\begin{verbatim}
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{sig}[1995/07/04 v1.0 by: JBR]
+
+\newcommand{\sig}{\leavevmode
+  \hbox to 62mm{\kern-5mm\vbox to 12mm{\kern-5mm\special{em:graph sig}\vfil}\hfil}}
+\newcommand{\altsig}{\leavevmode
+  \hbox to 67mm{\vbox to 17mm{\special{em:graph sig}\vfil}\hfil}}
+\newcommand{\zsig}{\leavevmode
+  \hbox to 0mm{\kern-5mm\vbox to 0mm{\kern-10mm\special{em:graph sig}\vfil}\hfil}}
+\newcommand{\zaltsig}{\leavevmode
+  \hbox to 0mm{\vbox to 0mm{\special{em:graph sig}\vfil}\hfil}}
+                   
+\DeclareOption{fax}{\typeout{Using signature for fax!}
+\renewcommand{\sig}{\leavevmode%
+  \hbox to 62mm{\kern-5mm\vbox to 12mm{\kern-5mm\special{em:graph faxsig}\vfil}\hfil}}
+\renewcommand{\altsig}{\leavevmode%
+  \hbox to 67mm{\vbox to 17mm{\special{em:graph faxsig}\vfil}\hfil}}
+\renewcommand{\zsig}{\leavevmode%
+  \hbox to 0mm{\kern-5mm\vbox to 0mm{\kern-10mm\special{em:graph faxsig}\vfil}\hfil}}
+\renewcommand{\zaltsig}{\leavevmode%
+  \hbox to 0mm{\vbox to 0mm{\special{em:graph faxsig}\vfil}\hfil}}
+}
+\ProcessOptions
+\end{verbatim}
+\normalsize
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/fax/test.tex b/Master/texmf-dist/doc/latex/fax/test.tex
new file mode 100644
index 00000000000..23043b7aa0a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/fax/test.tex
@@ -0,0 +1,23 @@
+\documentclass[nosep,note,a4paper,12pt]{fax}
+%\usepackage{wasysym}
+%\usepackage{4wide}
+\pagestyle{empty}
+\to{\begin{tabular}[t]{rl}
+    to: &{\bsf You!}\\
+    \end{tabular}}
+\setcounter{faxpages}{3}
+\mymsg{{\Large\bsf Watch out here comes a Fax!}}
+\begin{document}
+the quick brown dog jumped over the lazy fox 0 1 2 3.1459 4 5 6 7 8 9 times!
+\newpage
+the quick brown dog jumped over the lazy fox 0 1 2 3.1459 4 5 6 7 8 9 times!
+\newpage
+the quick brown dog jumped over the lazy fox 0 1 2 3.1459 4 5 6 7 8 9 times!
+\newpage
+the quick brown dog jumped over the lazy fox 0 1 2 3.1459 4 5 6 7 8 9 times!
+\newpage
+the quick brown dog jumped over the lazy fox 0 1 2 3.1459 4 5 6 7 8 9 times!
+\newpage
+the quick brown dog jumped over the lazy fox 0 1 2 3.1459 4 5 6 7 8 9 times!
+\newpage
+\end{document}