Personal tools
HylaFAX The world's most advanced open source fax server

Difference between revisions of "Beta Versions"

(Temple-based email notifications)
(Updated for newest stable branch release candidates)
 
(14 intermediate revisions by 2 users not shown)
Line 2: Line 2:
  
 
=Reporting Bugs=
 
=Reporting Bugs=
The HylaFAX Bugzilla is located at [http://bugs.hylafax.org/ http://bugs.hylafax.org/]. Please file a bug report there if you can. If you prefer to send a message to the mailing lists to discuss the problem, we encourage you to subscribe to hylafax-devel@hylafax.org and post it there. The hylafax-users mailing list will also reach many of the right people, and is the next best thing if subscribing to -devel and filing a bug report seem like too much trouble. Bottom line - we want your bugs!!
+
The HylaFAX Bugzilla is located at [http://bugs.hylafax.org/ http://bugs.hylafax.org/]. Please file a bug report there if you can. If you prefer to send a message to the [[Mailing Lists]] to discuss the problem, we encourage you to subscribe to hylafax-devel@hylafax.org and post it there. The hylafax-users mailing list will also reach many of the right people, and is the next best thing if subscribing to -devel and filing a bug report seem like too much trouble. Bottom line - we want your bugs!!
  
  
=Current beta release (4.3.1beta1)=
+
=Current release candidate=
  
The source can be downloaded from:
+
There is no current release candidate for the development branch.
 
 
ftp://ftp.hylafax.org/source/BETA/hylafax-4.3.1beta1.tar.gz
 
 
 
Please refer to our [[Red_Hat_Packages]] page for a source RPM that should build on most Red Hat, Fedora and SuSE distributions.
 
  
 
==New features of particular note==
 
==New features of particular note==
  
===Template-based email notifications===
+
None yet.
  
In the past, there has been discussion about both customizing and translating the e-mails that faxrcvd and notify send. In this version of HylaFAX, we've done some work to make faxrcvd and notify use "templates" for their e-mail messages.
+
==Changelog==
  
This means that faxrcvd and notify no longer use the "bin/dictionary" and eval "echo $..." everywhere when creating their e-mails, but now directly use a template file.
+
A complete list of changes since HylaFAX 6.0 was branched off for stable maintenance is available in the [http://git.hylafax.org/HylaFAX?a=blob;f=doc/RELEASENOTES-GIT.txt;hb=master HylaFAX GIT release notes]
  
These versions continue the tradition of sourcing etc/FaxDispatch (for faxrcvd) and etc/FaxNotify (for notify) to get "command" variables that influence what they do.  Of course, these shell scripts can continue to do whatever else they were doing (including calling exit to terminate normal faxrcvd/notify handling if desired).
+
=Current stable branches release candidates=
  
These shell scripts can now also set the TEMPLATE variable to control the source of template files that faxrcvd/notify use to generate their e-mails.  Templates are taken from (relative $SPOOL, where notify/faxrcvd are run from):
+
These releases are maintenance releases, and do not contain any new
 +
features or functionality, but only contain bugfixes.
  
etc/templates/$TEMPLATE/<template name>
+
There currently are release candidates for the following stable branches:
  
So, with TEMPLATES unset, you get the default templates.  If TEMPLATES=fr, you would use the templates in:
 
  
etc/templates/fr/<template name>
+
6.0.4-rc2 [ [ftp://ftp.hylafax.org/source/testing/hylafax-6.0.4-rc2.tar.gz Source] ] [ [http://git.hylafax.org/HylaFAX?a=blob;f=doc/RELEASENOTES-6.0.txt;hb=6.0 Release Notes] ]
  
We've created a basic set of templates, and a set of translations of them, based on our reading and knowledge of the current faxrcvd and notify scripts. We're sure there are problems with some of the templates, so corrections are welcome.
+
4.4.6-rc2 [ [ftp://ftp.hylafax.org/source/testing/hylafax-4.4.6-rc2.tar.gz Source] ] [ [http://git.hylafax.org/HylaFAX?a=blob;f=doc/RELEASENOTES-4.4.txt;hb=4.4 Release Notes] ]
  
Templates are of the format:
+
4.3.9-rc2 [ [ftp://ftp.hylafax.org/source/testing/hylafax-4.3.9-rc2.tar.gz Source] ] [ [http://git.hylafax.org/HylaFAX?a=blob;f=CHANGES;hb=4.3 Release Notes] ]
  
<pre>
 
From: FAX Agent <$FROMADDR>
 
Subject: Fax received from "$SENDER"
 
Content-type: text/plain; charset=us-ascii
 
  
$FILE (ftp://$HOSTNAME:4559/$FILE):                                 
+
Please refer to our [[Red_Hat_Packages]] page for a source RPM that should build on most Red Hat, Fedora and SuSE distributions.
  Sender: $SENDER
 
  Pages: $PAGES
 
Quality: $QUALITY
 
    Size: $PAGE
 
Received: $RECEIVED
 
Time To Receive: $TIMETORECV
 
    Signal Rate: $SIGNALRATE
 
    Data Format: $DATAFORMAT
 
  Error Correct: $ERRCORRECT
 
CallID1: $CALLID1
 
CallID2: $CALLID2
 
    Received On: $DEVICE
 
  CommID: $COMMID (ftp://$HOSTNAME:4559/log/$COMMID)     
 
</pre>
 
 
 
Templates are 2 sections, separated by a blank line.  The "header" section is included in the headers of the e-mail.  So the template can actually specify the content-type it is, including any charset, etc.
 
 
 
This means that you *can* make your template something like:
 
 
 
<pre>
 
From: ...
 
Subject: ...
 
Content-type: text/html
 
 
 
<html>
 
<body>
 
  <table>
 
  <tr><td>Sender:</td><td>$SENDER</td></tr>
 
  ....
 
</body>
 
</html>
 
</pre>
 
 
 
==Features that were introduced in 4.3.0==
 
 
 
===Internationalization===
 
 
 
HylaFAX can now send emails in <b>your</b> native language! It presently supports:
 
 
 
# Polish
 
# French
 
# Italian
 
# Portugese
 
# Spanish
 
# German
 
 
 
and can be easily extended to support many others.
 
 
 
The translation of emails is carried out by the new <tt>bin/dictionary</tt> shell script. Remember that relative paths like this are relative to the fax spool directory, which in many cases means you will find this in <tt>/var/spool/hylafax/bin/dictionary</tt>. Check it out, ... you can see it's basically just a file where the strings HylaFAX uses when sending email are defined for each of the supported languages.
 
 
 
Many of the scripts in HylaFAX's bin directory are designed so that you place local customizations into a separate file (usually in etc/) that gets 'sourced' by the script as it executes. This protects local changes from being overwritten during an upgrade, and helps separate code that you maintain locally from that of the standard HylaFAX core. For the <tt>bin/faxrcvd</tt> script this local file is <tt>etc/FaxDispatch</tt>, for <tt>bin/notify</tt> it's <tt>etc/FaxNotify</tt> and for <tt>bin/pollrcvd</tt> it's <tt>etc/PollDispatch</tt>. To activate translation in <tt>faxrcvd</tt>, <tt>notify</tt> or <tt>pollrcvd</tt>, you simply add the following lines to <tt>FaxDispatch</tt>, <tt>FaxNotify</tt>, or <tt>PollDispatch</tt>:
 
 
 
<pre>
 
CHARSET=ISO-8859-1
 
LANG=es_MX
 
</pre>
 
 
 
The <tt>bin/dictionary</tt> script will look at the value of <tt>$LANG</tt> and set the various texts used in faxrcvd, notify, and pollrcvd accordingly.
 
 
 
As with each of the other scripts mentioned above, <tt>bin/dictionary</tt> also has a local customizations file in the etc/ directory, called <tt>etc/FaxDictionary</tt>. This is to allow administrators to further customize particular phrases to their liking. If there is a phrase in <tt>bin/dictionary</tt> that you wish to reword or for it to say something custom for your installation or company, for example:
 
 
 
  DICTRECEIVEAGENT="The HylaFAX Receive Agent";
 
 
 
Simply add a similar entry in etc/FaxDictionary such as:
 
 
 
  DICTRECEIVEAGENT="My Company Fax Server";
 
 
 
and the custom string should now appear in all emails from HylaFAX.
 
 
 
===JobControl===
 
 
 
JobControl is a feature that many people have wanted, in a round-about
 
way, for quite some time.
 
 
 
JobControl gives HylaFAX servers the ability to "virtualize" the
 
sending configuration in a standard way.  Many users want to use
 
different TSI or calling_party numbers for different users who submit
 
jobs.  JobControl gives them the abilty to do so.
 
 
 
The administrator can configure/setup a JobControlCmd that can assign
 
these types of settings, and these values can be based on arbitrary job
 
values, instead of being limited only to the destination number.
 
 
 
This means that parameters can be changed/set based on the client (IP) of
 
the job submitter, the owner of the job, the email address of the sender,
 
etc, as well as the destination, etc.
 
 
 
Some possible uses include:
 
 
 
* Specifying a different ModemGroup set for each owner/submitter
 
* Specifying a different ModemGroup based on the email address of the sender
 
* Specifying MaxSendPages/MaxDials/MaxTries on a per "owner" basis to override/force specific maximums.
 
* Specifying TimeOfDay restrictions for certain senders
 
* Rejecting jobs based on the submitters requested ModemGroup
 
* Setting the TSI based on the sender
 
* Setting the DialRules/ModemDialCmd basd on the details of the submitted job owner/email and destination modemgroups.
 
  
Some samples can be found at http://people.ifax.com/~aidan/jobcontrol/
 
  
 
==Changelog==
 
==Changelog==
  
A complete list of changes from 4.3.1 is as follows:
+
A complete list of changes since 6.0.3/4.4.5/4.3.8 is as follows:
  
* make cover pages visible in /docq/ through hfaxd (17 Sep 2006)
+
* Class1: ECM page and block count should be sent as modulus. (4.3, 4.4, 6.0)
* handle +FHNG/+FNG after AT+FDT in Class 2 (15 Sep 2006)
+
* faxsend: Class1 1 ECM when skipping pages needs to be more careful (6.0)
* Unify mime encoding between notify and faxrcvd
+
* Class1: Initialize blockNumber (4.3, 4,4)
* Add templates for use in faxrcvd translations (14 Aug 2006)
+
* hfaxd: log what address(es) we're listing on when starting (6.0)
* don't exit faxq with assertion failure when a job times out and is interrupted during sending (21 Jul 2006)
+
* Update releasenotes and documentation re IPv6 support (6.0)
* faxaddmodem: Allow identification when no AT+FMM? or AT+FMI? (21 Jul 2006)
+
* hfaxd:  Cleanup uid initialization and theoretical overflow (4.3, 4.4, 6.0)
* fix error of accepting too-short of DCS signal (20 Jul 2006)
+
* Class1: Initialize blockNumber (4.3, 4,4)
* fix faxgetty hang in ECM due to missing timeouts (20 Jul 2006)
+
* Str::vformat() Don't reuse va_args (4.3, 4.4, 6.0)
* fix indicator when 100% non-zero TCF data is received (20 Jul 2006)
+
* PageHandling:  Fix handling of large blank areas (4.3, 4.4, 6.0)
* do Class1SwitchingCmd before sending MCF after PPS-NULL (20 Jul 2006)
+
* faxq: Don't assert on bad FIFO messages (4.3, 4.4, 6.0)
* replace Class1SendMsgDelay with Class1SwitchingCmd (20 Jul 2006)
+
* Page sent protocol trace fixes (6.0)
* fix faxaddmodem config parsing for Digicom Leonardo modems(19 Jul 2006)
+
* Don't duplicate any file in a release tarball (6.0)
* don't skip initial NSF bytes in station ID search when no known T.35 manufacturer ID was used (18 Jul 2006)
+
* IPv6: Rework initial bind (6.0)
* Documentation updates (18 Jul 2006)
+
* Some CVS-GIT cleanups/release notes (6.0)
* Fix RecvFmt string printing (Bug 805) (18 Jul 2006)
+
* pagesend: Fix broken switch statement (6.0)
* fix timeout on AT command sending to modem (5 Jul 2006)
+
* nls: Add German translation (6.0)
* don't use tiffcp "-r" option on JBIG TIFFs (5 Jan 2006)
+
* Add support for libtiff 3.9 (6.0)
* Avoid problems when resending single ECM Frame (5 Jul 2005)
+
* Updated RPM dependencies (6.0)
* Improve recovery after Class 1 TCF receipt times out (4 Jul 2006)
 
* Improve the handling of user aborts in Class 1 sending (4 Jul 2006)
 
* Add missing From: headers to notify (4 Jul 2006)
 
* correct CIELAB to be ITULAB (4 Jul 2006)
 
* fix Class 2 data format parsing of +FIS response (4 Jul 2006)
 
* Enhance faxinfo with formating options (2 Jul 2006)
 
* Fix faxmail's handling of nested mime (14 Jun 2006)
 
* Add JobProtection option to hfaxd (12 Jun 2006)
 
* Enhance SHIELDED_DTMF (5 Jun 2006)
 
* Add resubmit capability to faxalter (2 Jun 2006)
 
* Use ] && [ instead of -a for shell portability (2 Jun 2006)
 
* Add continuation support to FaxClient in libfaxutil (31 May 2006)
 
* Add UseJobTagLine config option for faxsend  (4 Apr 2006)
 

Latest revision as of 20:52, 18 December 2009

The HylaFAX development team often asks other developers and interested HylaFAX users to test upcoming software releases. As these are beta versions of software they may contain more bugs than usual, and should probably not be used on production servers if your job depends on the performance of that server!

Reporting Bugs

The HylaFAX Bugzilla is located at http://bugs.hylafax.org/. Please file a bug report there if you can. If you prefer to send a message to the Mailing Lists to discuss the problem, we encourage you to subscribe to hylafax-devel@hylafax.org and post it there. The hylafax-users mailing list will also reach many of the right people, and is the next best thing if subscribing to -devel and filing a bug report seem like too much trouble. Bottom line - we want your bugs!!


Current release candidate

There is no current release candidate for the development branch.

New features of particular note

None yet.

Changelog

A complete list of changes since HylaFAX 6.0 was branched off for stable maintenance is available in the HylaFAX GIT release notes

Current stable branches release candidates

These releases are maintenance releases, and do not contain any new features or functionality, but only contain bugfixes.

There currently are release candidates for the following stable branches:


6.0.4-rc2 [ Source ] [ Release Notes ]

4.4.6-rc2 [ Source ] [ Release Notes ]

4.3.9-rc2 [ Source ] [ Release Notes ]


Please refer to our Red_Hat_Packages page for a source RPM that should build on most Red Hat, Fedora and SuSE distributions.


Changelog

A complete list of changes since 6.0.3/4.4.5/4.3.8 is as follows:

  • Class1: ECM page and block count should be sent as modulus. (4.3, 4.4, 6.0)
  • faxsend: Class1 1 ECM when skipping pages needs to be more careful (6.0)
  • Class1: Initialize blockNumber (4.3, 4,4)
  • hfaxd: log what address(es) we're listing on when starting (6.0)
  • Update releasenotes and documentation re IPv6 support (6.0)
  • hfaxd: Cleanup uid initialization and theoretical overflow (4.3, 4.4, 6.0)
  • Class1: Initialize blockNumber (4.3, 4,4)
  • Str::vformat() Don't reuse va_args (4.3, 4.4, 6.0)
  • PageHandling: Fix handling of large blank areas (4.3, 4.4, 6.0)
  • faxq: Don't assert on bad FIFO messages (4.3, 4.4, 6.0)
  • Page sent protocol trace fixes (6.0)
  • Don't duplicate any file in a release tarball (6.0)
  • IPv6: Rework initial bind (6.0)
  • Some CVS-GIT cleanups/release notes (6.0)
  • pagesend: Fix broken switch statement (6.0)
  • nls: Add German translation (6.0)
  • Add support for libtiff 3.9 (6.0)
  • Updated RPM dependencies (6.0)

This page was last edited on 18 December 2009, at 20:52.

Powered by MediaWiki
Attribution-ShareAlike 2.5

Project hosted by iFAX Solutions