diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/fax/faxdoc.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/fax/faxdoc.tex | 179 |
1 files changed, 179 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} + |