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 beta release (4.3.1beta1)

The source can be downloaded from:

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

Temple-based email notifications

Documentation coming soon!

Features that were introduced in 4.3.0

Internationalization

HylaFAX can now send emails in your native language! It presently supports:

1. Polish
2. French
3. Italian
4. Portugese
5. Spanish
6. German

and can be easily extended to support many others.

The translation of emails is carried out by the new bin/dictionary 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 /var/spool/hylafax/bin/dictionary. 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 bin/faxrcvd script this local file is etc/FaxDispatch, for bin/notify it's etc/FaxNotify and for bin/pollrcvd it's etc/PollDispatch. To activate translation in faxrcvd, notify or pollrcvd, you simply add the following lines to FaxDispatch, FaxNotify, or PollDispatch:

CHARSET=ISO-8859-1
LANG=es_MX

The bin/dictionary script will look at the value of $LANG and set the various texts used in faxrcvd, notify, and pollrcvd accordingly.

As with each of the other scripts mentioned above, bin/dictionary also has a local customizations file in the etc/ directory, called etc/FaxDictionary. This is to allow administrators to further customize particular phrases to their liking. If there is a phrase in bin/dictionary 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

A complete list of changes from 4.3.1 is as follows:

• make cover pages visible in /docq/ through hfaxd (17 Sep 2006)
• handle +FHNG/+FNG after AT+FDT in Class 2 (15 Sep 2006)
• Unify mime encoding between notify and faxrcvd
• Add templates for use in faxrcvd translations (14 Aug 2006)
• don't exit faxq with assertion failure when a job times out and is interrupted during sending (21 Jul 2006)
• faxaddmodem: Allow identification when no AT+FMM? or AT+FMI? (21 Jul 2006)
• fix error of accepting too-short of DCS signal (20 Jul 2006)
• fix faxgetty hang in ECM due to missing timeouts (20 Jul 2006)
• fix indicator when 100% non-zero TCF data is received (20 Jul 2006)
• do Class1SwitchingCmd before sending MCF after PPS-NULL (20 Jul 2006)
• replace Class1SendMsgDelay with Class1SwitchingCmd (20 Jul 2006)
• fix faxaddmodem config parsing for Digicom Leonardo modems(19 Jul 2006)
• don't skip initial NSF bytes in station ID search when no known T.35 manufacturer ID was used (18 Jul 2006)
• Documentation updates (18 Jul 2006)
• Fix RecvFmt string printing (Bug 805) (18 Jul 2006)
• fix timeout on AT command sending to modem (5 Jul 2006)
• don't use tiffcp "-r" option on JBIG TIFFs (5 Jan 2006)
• Avoid problems when resending single ECM Frame (5 Jul 2005)
• 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)