← Back to branch summary

~ubuntu-branches/debian/wheezy/courier/wheezy

« back to all changes in this revision

Viewing changes to courier/module.fax/courierfax.html.in

  • Committer: Bazaar Package Importer
  • Author(s): Stefan Hornburg (Racke)
  • Date: 2009-03-08 16:42:08 UTC
  • mfrom: (1.2.1 upstream) (4.1.1 sid)
  • Revision ID: james.westby@ubuntu.com-20090308164208-nlve2wtx9bbrulmd
Tags: 0.61.2-1
* New upstream release.
* Lintian:
  - fix chown in courier-webadmin postinst
  - removed courier-base preinst
  - added debhelper token to courier-mta.preinst
  - removed *.conffiles

Show diffs side-by-side

added added

removed removed

Lines of Context:
courier/module.fax/courierfax.html.in
1
1
<?xml version="1.0"?>
2
 
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><title>courierfax</title><link rel="stylesheet" href="style.css" type="text/css"/><meta name="generator" content="DocBook XSL Stylesheets V1.72.0"/><link rel="start" href="#courierfax" title="courierfax"/><link xmlns="" rel="stylesheet" type="text/css" href="manpage.css"/><meta xmlns="" name="MSSmartTagsPreventParsing" content="TRUE"/><link xmlns="" rel="icon" href="icon.gif" type="image/gif"/><!--
 
2
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><title>courierfax</title><link rel="stylesheet" href="style.css" type="text/css"/><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"/><link rel="start" href="#courierfax" title="courierfax"/><link xmlns="" rel="stylesheet" type="text/css" href="manpage.css"/><meta xmlns="" name="MSSmartTagsPreventParsing" content="TRUE"/><link xmlns="" rel="icon" href="icon.gif" type="image/gif"/><!--
3
3
 
4
4
Copyright 1998 - 2007 Double Precision, Inc.  See COPYING for distribution
5
5
information.
6
6
 
7
 
--></head><body><div class="refentry" lang="en" xml:lang="en"><a id="courierfax" shape="rect"> </a><div class="titlepage"/><div class="refnamediv"><h2>Name</h2><p>courierfax — Send faxes via E-mail</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">sendmail</code>  [<em class="replaceable"><code>5558888</code></em>@fax]</p></div><div class="cmdsynopsis"><p><code class="command">sendmail</code>  [<em class="replaceable"><code>5558888</code></em>@fax-lowres]</p></div><div class="cmdsynopsis"><p><code class="command">sendmail</code>  [<em class="replaceable"><code>5558888</code></em>@fax-ignore]</p></div><div class="cmdsynopsis"><p><code class="command">sendmail</code>  [<em class="replaceable"><code>5558888</code></em>@fax-cover]</p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id282851" shape="rect"> </a><h2>DESCRIPTION</h2><p>
 
7
--></head><body><div class="refentry" lang="en" xml:lang="en"><a id="courierfax" shape="rect"> </a><div class="titlepage"/><div class="refnamediv"><h2>Name</h2><p>courierfax — Send faxes via E-mail</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">sendmail</code>  [<em class="replaceable"><code>5558888</code></em>@fax]</p></div><div class="cmdsynopsis"><p><code class="command">sendmail</code>  [<em class="replaceable"><code>5558888</code></em>@fax-lowres]</p></div><div class="cmdsynopsis"><p><code class="command">sendmail</code>  [<em class="replaceable"><code>5558888</code></em>@fax-ignore]</p></div><div class="cmdsynopsis"><p><code class="command">sendmail</code>  [<em class="replaceable"><code>5558888</code></em>@fax-cover]</p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id291704" shape="rect"> </a><h2>DESCRIPTION</h2><p>
8
8
The <code class="literal">courierfax</code> module (if enabled by the system
9
9
administrator) sends E-mail messages by fax.
10
10
Addressing an E-mail message to the address <code class="literal">5558888@fax</code>
48
48
Send a cover page only.
49
49
This is useful in limited situations, with something like this
50
50
in a
51
 
<a href="dot-courier.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">dot-courier</span>(5)</span></a>
 
51
<a class="ulink" href="dot-courier.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">dot-courier</span>(5)</span></a>
52
52
file:</p><div class="informalexample"><pre class="programlisting" xml:space="preserve">
53
53
 ./Maildir
54
54
 ! 5552222@fax-cover
55
55
</pre></div><p>
56
56
This <code class="filename">.courier</code> file faxes the contents of a message,
57
57
sans any attachments, immediately upon receipt in addition to saving the
58
 
message in the mailbox.</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id281896" shape="rect"> </a><h2>FAX TRANSMISSION RECEIPT</h2><p>
 
58
message in the mailbox.</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id290891" shape="rect"> </a><h2>FAX TRANSMISSION RECEIPT</h2><p>
59
59
The sender will receive
60
60
a fax transmission receipt if the sender requests an ESMTP
61
61
delivery status notification.
62
62
This is the <code class="option">-N</code> option to
63
 
<a href="sendmail.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">sendmail</span>(8)</span></a>:</p><div class="informalexample"><pre class="programlisting" xml:space="preserve">
 
63
<a class="ulink" href="sendmail.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">sendmail</span>(8)</span></a>:</p><div class="informalexample"><pre class="programlisting" xml:space="preserve">
64
64
sendmail -Nsuccess 5556666@fax &lt;messagefile
65
65
</pre></div><p>
66
66
When using other mail software, consult the mail software's documentation
67
 
for instructions on requesting ESMTP delivery status notifications.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id281934" shape="rect"> </a><h2>ADDITIONAL DIALING OPTIONS</h2><p>
 
67
for instructions on requesting ESMTP delivery status notifications.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id290928" shape="rect"> </a><h2>ADDITIONAL DIALING OPTIONS</h2><p>
68
68
<code class="literal">courierfax</code> configurations that are generated by the
69
 
<span><strong class="command">webadmin</strong></span> tool for North American environments
 
69
<span class="command"><strong>webadmin</strong></span> tool for North American environments
70
70
usually restrict phone numbers to a standardized ten-digit telephone number,
71
71
so that the fax address is always
72
72
&lt;<em class="replaceable"><code>aaabbbcccc</code></em><code class="literal">@fax</code>&gt;,
85
85
the symbols
86
86
“<span class="quote"><code class="literal">*</code></span>” and
87
87
“<span class="quote"><code class="literal">#</code></span>”, or the following
88
 
characters:</p><div class="variablelist"><dl><dt><span class="term"><span><strong class="keycap">W</strong></span></span></dt><dd><p>
 
88
characters:</p><div class="variablelist"><dl><dt><span class="term"><span class="keycap"><strong>W</strong></span></span></dt><dd><p>
89
89
Most faxmodems pause and wait for a secondary dialtone, before dialing
90
 
the rest of the number.</p></dd><dt><span class="term"><span><strong class="keycap">-</strong></span></span></dt><dd><p>
 
90
the rest of the number.</p></dd><dt><span class="term"><span class="keycap"><strong>-</strong></span></span></dt><dd><p>
91
91
The dash is replaced by a comma in the dialing string.
92
92
A comma results in most faxmodems pausing for two or three seconds
93
93
before dialing the rest of the number.
95
95
to separate multiple E-mail addresses.
96
96
Use dashes instead of commas in the dialing string.
97
97
<code class="literal">courierfax</code> replaces all dashes with commas before
98
 
dialing the faxmodem.</p></dd><dt><span class="term"><span><strong class="keycap">+</strong></span></span></dt><dd><p>
 
98
dialing the faxmodem.</p></dd><dt><span class="term"><span class="keycap"><strong>+</strong></span></span></dt><dd><p>
99
99
Similarly, <code class="literal">courierfax</code> replaces all pluses with
100
100
“<span class="quote">@</span>” characters before dialing.
101
101
An “<span class="quote">@</span>”
105
105
telephone number itself, for the obvious reasons.
106
106
Use pluses  instead of “<span class="quote">@</span>”s in the dialing string.
107
107
<code class="literal">courierfax</code> replaces all pluses with “<span class="quote">@</span>” before
108
 
dialing the faxmodem.</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id325370" shape="rect"> </a><h2>CONFIGURATION</h2><p>
 
108
dialing the faxmodem.</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id335322" shape="rect"> </a><h2>CONFIGURATION</h2><p>
109
109
The slightly arcane configuration file,
110
110
<code class="filename">@sysconfdir@/faxrc</code>, sets up which dialing strings are
111
111
valid.
115
115
rejecting all telephone numbers.
116
116
The file must be edited in accordance with the embedded instructions, in order
117
117
to enable faxing.</p><p>
118
 
Using <span><strong class="command">webadmin</strong></span> is highly recommended.
119
 
Upon demand, <span><strong class="command">webadmin</strong></span> will install a suitable configuration
 
118
Using <span class="command"><strong>webadmin</strong></span> is highly recommended.
 
119
Upon demand, <span class="command"><strong>webadmin</strong></span> will install a suitable configuration
120
120
file for the North American numbering plan, that receives all telephone numbers
121
121
as ten-digit numbers, and adds any required long distance prefix, or removes
122
122
the local area code, as appropriate.
123
 
Or, <span><strong class="command">webadmin</strong></span> will install a bare-bones configuration file
 
123
Or, <span class="command"><strong>webadmin</strong></span> will install a bare-bones configuration file
124
124
that dials any requested phone number, without any editing or
125
 
transformation.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id325419" shape="rect"> </a><h2>BUGS</h2><p>
 
125
transformation.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id335367" shape="rect"> </a><h2>BUGS</h2><p>
126
126
There is no good way to sleep until a modem lock is released, so we poll
127
 
every minute.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id325430" shape="rect"> </a><h2>SEE ALSO</h2><p>
128
 
<a href="courier.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">courier</span>(8)</span></a>.</p></div></div></body></html>
 
127
every minute.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id335377" shape="rect"> </a><h2>SEE ALSO</h2><p>
 
128
<a class="ulink" href="courier.html" target="_top" shape="rect"><span class="citerefentry"><span class="refentrytitle">courier</span>(8)</span></a>.</p></div></div></body></html>