Sophie: FaxMail-2.3-13mdv2008.1 x86

FaxMail-2.3-13mdv2008.1.x86_64.rpm

<HTML>
<HEAD>
<!-- This HTML file has been created by texi2html 1.51
     from FaxMail.texi on 13 November 1998 -->

<!-- edited by mcdavey to put all info in one file -->

<TITLE>FaxMail Manual</TITLE>
</HEAD>
<BODY>
<a name="TOC">
<H1>FaxMail Manual</H1>
<P>
<a HREF="#SEC1">[Requirements]</A>
<A HREF="#SEC2">[Installation]</A>
<A HREF="#SEC3">[The Email-Fax gateway]</A>
<A HREF="#SEC4">[Faxing]</A>
<A HREF="#SEC5">[Addresses]</A>
<A HREF="#SEC6">[Problems]</A>
<A HREF="#SEC7">[About]</A>
<P><HR><P>
<P>
FaxMail Manual
<P>
Matthew Davey
FaxMail is Copyright 1996, 1997, 1998 David Burns, Shyamal Somaroo, Matthew
Davey.  The program is issued under the GNU GPL.
<P>
FaxMail version 2.3 <BR>
November 1998

FaxMail homepage: <a href="http://wol.ra.phy.cam.ac.uk/FaxMail/">
http://wol.ra.phy.cam.ac.uk/FaxMail/</a>

</P>
<P>
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.

</P>



<H1><A NAME="SEC1" HREF="#TOC">Requirements</A></H1>

<P>
Before installing FaxMail, check that your system contains the following
components.

</P>

<UL>
<LI>

<B>X</B> You must have a running X server.......
<LI>

<B>Tcl</B> Any reasonably up to date version of Tcl should be fine.
<LI>

<B>Tk</B> You will need Tk version 4.0 or later.
<LI>

<B>convert</B> It is possible to fax most popular image formats, but you
will need to install ImageMagick if you haven't already got it.  The
homepage is at <CODE>http://www.wizards.dupont.com/cristy/ImageMagick.html</CODE>.
</UL>



<H1><A NAME="SEC2" HREF="#TOC">Installation</A></H1>

<P>
FaxMail uses a library directory to store the main Tcl script and a
guide to the coverage of the email-fax system.  Two binaries will be
installed, one to check whether a particular fax number is covered, and
a wrapper to call the Tcl script.  To install FaxMail, proceed as
follows:

</P>

<OL>
<LI>

Unpack the tar file FaxMail-2.3.tgz and change into the FaxMail-2.3 directory:

<PRE>
<CODE>gunzip -c FaxMail-2.3.tgz | tar x
cd FaxMail-2.3</CODE>
</PRE>

<LI>

Edit the Makefile to specify the installation directories.  You must
also specify the location of the `wish' program and a low-level mailer
such as <CODE>sendmail</CODE> or <CODE>smail</CODE>.  On some systems (eg SunOS) you
will need to uncomment the line to link with `-lresolv'.
<LI>

Run make:

<PRE>
<CODE>make</CODE>
</PRE>

At this point you should be able to test the program by running it
from the current directory:

<PRE>
<CODE>./FaxMail</CODE>
</PRE>

<LI>

If everything seems fine you can complete the installation by running

<PRE>
<CODE>make install</CODE>
</PRE>

</OL>



<H1><A NAME="SEC3" HREF="#TOC">The Email-Fax gateway</A></H1>

<P>
FaxMail is simply an interface to the Internet's Email-Fax gateway.
When you send your email, a central server figures out whether the
desired number is covered by the system.  If so, it forwards your email
to a computer that has agreed to provide a service to that number and
that computer places the phonecall.

</P>
<P>
As such the service is as efficient as email is. Several attempts are
made at delivering faxes and in all events the outcome will ultimately
reach you via email (so you don't have to guess if the fax got there or
not).

</P>
<P>
As with almost everything on the internet, it is up to each individual
to make sure that they use the service responsibly (So no faxing of PhD
theses and the like! ). Several ps files are better sent in succession
rather than in one big email. This is likely to be quicker, the only
possible drawback being a replication of the cover sheet at the remote
end. It is perhaps wise not to send material of a highly confidential or
important nature via this means. It's up to you though.

</P>
<P>
Finally, the success of the Email-Fax gateway depends on individuals and
organisations agreeing to provide the local fax service.  If you have a
fax-modem and would like to help, check out
<CODE>http://www.tpc.int/servers/jointpchowto.html</CODE> for details.
<CODE>www.tpc.int</CODE> is also the starting point for information on the
Email-Fax gateway.

</P>



<H1><A NAME="SEC4" HREF="#TOC">Faxing</A></H1>

<P>
The first time you run FaxMail you will be presented with a small window
asking you to supply your contact details such as name, address and fax
number.  These are used to produce a cover sheet for your fax.  Once
this is done you can hit the `done' button to save the details in your
home directory in the <CODE>.faxinit</CODE> file.

</P>
<P>
To send a fax via email it is only necessary to supply a valid fax
number and a message. The number should be input in the fields at the
bottom of the window using the IDDD format (only numbers please) which
is stripped of international access codes (no leading 0). So faxing to
Cambridge UK, would require you to input

</P>

<PRE>
Country code: 44
Local code: 1223
Fax Number: xxxxxx
</PRE>

<P>
or if faxing Montreal Canada one would enter

</P>

<PRE>
Country code: 1
Local code: 514
Fax Number: xxxxxxx
</PRE>

<P>
The behaviour of the buttons is pretty much self-explanatory:

</P>

<UL>
<LI>

<CODE>FAX:</CODE> When you are happy with your fax, you send it using the <CODE>FAX</CODE> button.

<LI>

<CODE>RESET:</CODE> Clear the entire fax message, including the list of files
to be attached.

<LI>

<CODE>PERSONAL:</CODE> Amend your contact details.

<LI>

<CODE>COVERAGE:</CODE>
Test whether your chosen number is accessible via the email-fax
system.
<LI>

<CODE>ABOUT:</CODE> Addresses for fanmail.
<LI>

<CODE>ADDRESSES:</CODE> Access the address book feature, described in the next
section.
<LI>

<CODE>ADD:</CODE>
Select a filetype from the drop-down menu to include a file into your
fax.
<CODE>DELETE:</CODE>
Remove the highlighted file from the list of included files.
<CODE>CLEAR:</CODE>
Clear the test message box.
<LI>

<CODE>CHECK NUMBER:</CODE>
Identical to COVERAGE button.
</UL>



<H1><A NAME="SEC5" HREF="#TOC">Addresses</A></H1>

<P>
You can use FaxMail to keep an address book of frequently used numbers.
These are stored in the user's home directory in the file
<CODE>.fax_addr</CODE>.  This file is automatically created the first time you
select the address book feature from the main window.

</P>
<P>
The address book simply associates an alias with the six fields defining
your recipient (country, area and local phone numbers, name,
organisation and email address).  The left-hand side of the address book
shows the names of the currently defined aliases while the right-hand
side shows the definition of the currently selected alias.  The fields
on the right-hand side may be edited at any time.  The <CODE>USE</CODE> button
copies the currently selected alias into the main FaxMail window.

</P>
<P>
The remaining address book buttons have the following effects:

</P>

<UL>
<LI>

<CODE>NEW:</CODE> The user supplies an alias name and a new blank alias is
added to the address book.

<LI>

<CODE>DELETE:</CODE> Delete the currently selected alias from the address
book.

<LI>

<CODE>RENAME:</CODE> Rename the currently selected alias.

<LI>

<CODE>CLEAR:</CODE> Blank the currently selected alias.

<LI>

<CODE>CLOSE:</CODE> Close the address book window, optionally saving any
changes made to the address book.

</UL>



<H1><A NAME="SEC6" HREF="#TOP">Problems</A></H1>

<P>
FaxMail has been successfully installed under Linux, SunOS, OSF/1 and
HP-UX, as these were the systems available to the authors.  As long as
you have reasonably a up to date versions of Tk/Tcl you should be able
to get FaxMail going.  If tryfax.c fails to compile, you may need to
link with <CODE>libresolv</CODE>, see the Makefile.

</P>
<P>
If you have problems or think you have found any bugs, you can email
Matthew Davey at <CODE>mcdavey@mrao.cam.ac.uk</CODE>.  Also, if you need to
make changes to compile on a new system, please let us know.

</P>
<P>
Enjoy!

</P>


<H1><A NAME="SEC7" HREF="#TOP">About</A></H1>

<P>
FaxMail is based on the faxtool program written by David Burns and
Shyamal Somaroo.  Faxtool became FaxMail in 1997 when the address book
and postscript file browser were added by Matthew Davey, the name was
changed to avoid a clash with a different package.

</P>
<P>
FaxMail is Copyright 1996, 1997, 1998 David Burns, Shyamal Somaroo, Matthew
Davey.  The program is issued under the GNU GPL.

<p> FaxMail homepage: <a href="http://wol.ra.phy.cam.ac.uk/FaxMail/">
http://wol.ra.phy.cam.ac.uk/FaxMail/</a>



</P>
<P><HR><P>
This document was generated on 13 November 1998 using the
<A HREF="http://wwwcn.cern.ch/dci/texi2html/">texi2html</A>
translator version 1.51.</P>
</BODY>
</HTML>