$book = '..'?>include "$book/mh.php"; includeHeader('mhstr.html', 'homwotb.html'); ?>
This chapter describes a set of MH programs that handle new mail for you. Here are some of the reasons you might want to use these mhook (mail hook) features:
This chapter has much more about setting up and using these programs. (xmh and exmh users can use these features as well as a special .xmhcheck file, explained in the Sections Incorporate New Mail and Mail Filtering File Examples.)
The mhook utilities are usually set up with a file named .maildelivery in your home directory. (You can run the utilities from another program or from the command line. For example, a shell script of mine uses rcvdist to send Usenet news articles through email.) Each new message is checked against the entries in .maildelivery. Each entry in the file describes the kinds of mail messages it will match -- and the name of a program to run or a file to write when a message matches. The Section The .maildelivery File: Overview has an introduction and the Section The .maildelivery File in Detail has more information.
On systems with the Sendmail MTA (mail transfer agent), you run a special MH program named slocal from the .forward file in your home directory -- and slocal will read your .maildelivery file. The slocal program adds some extra complication and its own quirks to the process. There are several sections of this chapter that are only about slocal, not about the .maildelivery file in general. Life is a little easier on systems running the MMDF II transfer agent. They don't need slocal because MMDF II will read your .maildelivery file automatically. There are a couple of other variations. See the Section Running Your .maildelivery File for more info.
The Section Experimenting? Make Backups! has techniques to keep you from losing mail while you experiment. Next are sections about four MH programs run from your .maildelivery file:
CAUTION: Most people depend on getting email reliably. Remember that you can lose some or all of your incoming mail if your automatic mail handling isn't working right.includeFooter('$Date: 2006-05-31 15:13:43 -0700 (Wed, 31 May 2006) $', 'OReilly: 1991, 1992, 1995; Jerry: 1996, 1997, 1999, 2000, 2002, 2004'); ?>
If mail to your account fails and "bounces" back to the people who send it, they can be confused. If you're on a mailing list, and the list's messages to you bounce back, the list's owner may take you off the list.
Don't worry! Just be careful. If you have a second account, where you can experiment without losing important mail, test this setup there before putting it on your own account. Otherwise, while you're setting up and debugging your new setup, make copies of all your incoming mail -- the Section Experimenting? Make Backups! explains how.