[Bug 126] various documentation fixes/updates/enhancments

Nice cleanup work Lee - thanks!

diff --git a/CHANGES b/CHANGES
index 098f82f437f5ddd323ea354a33b704277e8cfce6..8835d2888b3b503a93e6d20438987316233ec7bd 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -87,6 +87,8 @@ Changelog for HylaFAX 4.1beta3 - Feb 21, 2001
 * portably fix faxaddmodem to not cause grep to complain about directories
   (29Aug2000)
 * Class 2 RTN algorithm changed. RTNHandlingMethod parameter added (26Aug2000)
+  -RTC is not sent automatically anymore (affects usr-2.0 and 
+   ppi-pm14400fxmt)
 * checks added to prevent possible crash when the DTE returns a broken NSF
   frame (25Aug2000)
 * typerules support for PDF (23Aug2000)
@@ -175,4 +177,4 @@ Changelog for HylaFAX 4.1beta3 - Feb 21, 2001
 * added support for Elsa Microlink modem (15Jul1999)
 * various information updates for change to hylafax.org (15Jul1999)
 * change ModemClass parameter to ModemGroup (10Jul1999)
-* created a BreakIntoCommentX faxcover function (30Jun1999, 10Jul1999)
\ No newline at end of file
+* created a BreakIntoCommentX faxcover function (30Jun1999, 10Jul1999)

diff --git a/man/hosts.hfaxd.4f b/man/hosts.hfaxd.4f
index dc17245eb8842c6fc4b891dcfe654fd57f85cbb9..8ae97e241f4c7b4bf7cc3a6a4790d0d0336125d4 100644 (file)
--- a/man/hosts.hfaxd.4f
+++ b/man/hosts.hfaxd.4f
@@ -27,7 +27,7 @@
 .\"
 .if n .po 0
 .ds Fx \fIHyla\s-1FAX\s+1\fP
-.TH HOSTS ${MANNUM4_5} "January 18, 1996"
+.TH HOSTS.HFAXD ${MANNUM4_5} "January 18, 1996"
 .SH NAME
 hosts.hfaxd \- \*(Fx client access control list
 .SH DESCRIPTION

diff --git a/man/hylafax-client.1 b/man/hylafax-client.1
index 7da14770d4af76690595d279e4d0b714069f3957..f19ca11551e6effd552819a84db76252cffa1152 100644 (file)
--- a/man/hylafax-client.1
+++ b/man/hylafax-client.1
@@ -78,7 +78,7 @@ command.
 Remote facsimile machines may be polled to retrieve
 publicly available documents.
 .IP \(bu 3
-\*(Ps\(rg and
+\*(Ps\(rg, PDF, and
 .SM TIFF
 Class F documents are passed directly to the fax server for transmission;
 the system attempts to convert other file formats to either \*(Ps or

diff --git a/man/hylafax-server.4f b/man/hylafax-server.4f
index 5fa959ef55f7b11c05945918d0a091f2011a0d5f..b883af0ec8622585c869f8723050bb5a29b07b1b 100644 (file)
--- a/man/hylafax-server.4f
+++ b/man/hylafax-server.4f
@@ -29,7 +29,7 @@
 .ds Fx \fIHyla\s-1FAX\s+1\fP
 .ds Ps P\s-2OST\s+2S\s-2CRIPT\s+2
 .ds Pc \s-1PCL\s+1
-.TH HYLAFAX ${MANNUM4_5} "January 18, 1996"
+.TH HYLAFAX-SERVER ${MANNUM4_5} "January 18, 1996"
 .SH NAME
 HylaFAX \- introduction to \*(Fx server operation and file formats
 .SH DESCRIPTION
@@ -205,7 +205,7 @@ subdirectory (though it is also possible to reference documents
 from the
 .B recvq
 directory).
-\*(Fx accepts \*(Ps, \*(Pc, and
+\*(Fx accepts \*(Ps, PDF, \*(Pc, and
 .SM TIFF
 documents for transmission (though support for
 \*(Pc documents is not currently implemented).
@@ -579,7 +579,11 @@ files, the
 .I faxmodem
 program, and the
 .I faxconfig
-program.
+program.  If multiple modems share the same priority value,
+then
+.IR faxq (${MANNUM1_8})
+will allocate jobs to them in a round-robin 
+fashon.
 .SH "JOB MANAGEMENT"
 Outbound jobs are considered to be in one of several states
 that reflect their treatment by the central scheduling process.

diff --git a/man/log.4f b/man/log.4f
index 704bdf9c06a1afa1cdbb87743cc75a8f39b43122..3bb8224875148d1757f727750776a4eb5892446d 100644 (file)
--- a/man/log.4f
+++ b/man/log.4f
@@ -105,6 +105,12 @@ A
 .IR schedctl (2)
 system call to set the server process priority failed.
 .PP
+\fBsched policy=%d, priority=%d\fP.
+(\fIOnly on POSIX compliant systems.\fP)
+Describes a
+.IR setscheduler (2)
+system call to enhance real-time job scheduling.
+.PP
 \fBUnable to set %s scheduling parameters: %m\fP.
 (\fIOnly on \s-1SVR4\s+1-style systems.\fP)
 A

diff --git a/man/pdf2fax.1m b/man/pdf2fax.1m
index a6216d2f4552aa0764f0686fa360c6881581d0e8..724562324bbf43fe1a780c57087290257f69231c 100644 (file)
--- a/man/pdf2fax.1m
+++ b/man/pdf2fax.1m
@@ -170,29 +170,11 @@ extension to the X server.
 The default Ghostscript-based environment is more uncertain;
 consult the Ghostscript documentation for information on
 what fonts are available.
-.SH FILES
-.ta \w'${SPOOL}/etc/dpsprinter.ps    'u
-.nf
-${SPOOL}/etc/dpsprinter.ps     PDF code read at startup for \s-1DPS\s+1
-/usr/lib/DPS/default.dps_vm    startup VM file for \s-1DPS\s+1
-/usr/lib/DPS/outline   Type 1 fonts for \s-1DPS\s+1
-/usr/lib/DPS/prebuilt  prebuilt versions of fonts for \s-1DPS\s+1
-.fi
 .SH BUGS
 Output from the Display PDF version of this command
 is encoded according to the Display PDF binary encoding
 protocol.
 .PP
-No prebuilt bitmap fonts are currently available for the
-.SM DPS\c
--based imager;
-this would greatly improve legibility at low resolutions,
-as the rendering of outline fonts at 98 lpi is particularly
-poor.
-.PP
-Both
-.SM DPS-
-and
 Ghostscript-based versions of this program fail to exit with
 non-zero status when an invalid PDF document is processed;
 this makes it problematic for the \*(Fx queue manager to

diff --git a/man/typerules.4f b/man/typerules.4f
index 8a19384ab4b0cd58042728326fb977711a819bb0..cb3913089a37d0ae8b592dd7aaa3d27bcd07b473 100644 (file)
--- a/man/typerules.4f
+++ b/man/typerules.4f
@@ -32,9 +32,9 @@
 .SH NAME
 typerules \- \*(Fx file type identification and conversion rules
 .SH DESCRIPTION
-Only two types of files are accepted by the \*(Fx
+Only three types of files are accepted by the \*(Fx
 server for transmission as facsimile:
-\*(Ps\(rg files and 
+\*(Ps\(rg files, PDF files, and 
 .SM TIFF
 Class F (bilevel Group 3-encoded) files.
 All other types of files must be converted to one
@@ -177,6 +177,7 @@ that are handled directly by the server:
 .ta \w'offset    'u +\w'datatype    'u +\w'#Inventor V    'u +\w'result    'u +\w'command        'u
 #offset        datatype        match   result  command
 0      string  %!      ps              # \*(Ps
+0      string  %PDF    ps              # \*(Ps by Ghostscript
 0      short   0x4d4d  tiff            # big-endian \s-1TIFF\s+1
 0      short   0x4949  tiff            # little-endian \s-1TIFF\s+1
 .fi

diff --git a/man/xferfaxlog.4f b/man/xferfaxlog.4f
index 4652c7e14d86f9ce6b04b7ff8ab8381ad3015049..42ef61f29ada374286bb8f83f5142b4c7b229f0f 100644 (file)
--- a/man/xferfaxlog.4f
+++ b/man/xferfaxlog.4f
@@ -27,7 +27,7 @@
 .\"
 .if n .po 0
 .ds Fx \fIHyla\s-1FAX\s+1\fP
-.TH XFERLOG ${MANNUM4_5} "June 5, 1996"
+.TH XFERFAXLOG ${MANNUM4_5} "June 5, 1996"
 .SH NAME
 xferfaxlog \- \*(Fx activity log
 .SH DESCRIPTION
@@ -144,6 +144,13 @@ The simple
 .SM ASCII
 format was designed to be easy to process with programs like
 .IR awk (1).
+.SH NOTES
+The sender field does not necessarily represent the submitter's 
+actual identity.  For example, it reflects the value given by
+the
+.IR sendfax (${MANNUM1_8})
+``-f'' option.  Be cautious that this field is not utilized
+for auditing if the fax user base is not trusted.
 .SH BUGS
 The date format will ``break'' in the year 2000.
 Information should be recorded on a per-page basis for facsimile

diff --git a/man/xferfaxstats.1m b/man/xferfaxstats.1m
index 7027e858eeb1e26b42d174191a5a20274e4c7f62..e56ff269c42e3c75439a274710484c8220eddbd9 100644 (file)
--- a/man/xferfaxstats.1m
+++ b/man/xferfaxstats.1m
@@ -27,7 +27,7 @@
 .\"
 .if n .po 0
 .ds Fx \fIHyla\s-1FAX\s+1\fP
-.TH XFERSTATS ${MANNUM1_8} "May 12, 1996"
+.TH XFERFAXSTATS ${MANNUM1_8} "May 12, 1996"
 .SH NAME
 xferfaxstats \- summarize \*(Fx transmission accounting
 .SH SYNOPSIS
@@ -173,6 +173,13 @@ account name.
 ``\fBWarning, weird user address/name "%s".\fP''
 During address mapping an address was encountered that multiple ``@''
 symbols in it.
+.SH NOTES
+The sender field does not necessarily represent the submitter's
+actual identity.  For example, it reflects the value given by
+the
+.IR sendfax (${MANNUM1_8})
+``-f'' option.  Be cautious that this field is not utilized
+for auditing if the fax user base is not trusted.
 .SH FILES
 .nf
 .ta \w'${SPOOL}    'u