From 9a9ef91ab4bb9d03f36a05fcda4f27b46a62e3dc Mon Sep 17 00:00:00 2001 From: "Simon L. B. Nielsen" Date: Sat, 18 Oct 2003 18:22:23 +0000 Subject: [PATCH] Whitespace cleanup for last commit, and a few other areas with very long lines. No content change. --- en_US.ISO8859-1/articles/mh/article.sgml | 389 +++++++++++++---------- 1 file changed, 215 insertions(+), 174 deletions(-) diff --git a/en_US.ISO8859-1/articles/mh/article.sgml b/en_US.ISO8859-1/articles/mh/article.sgml index 4477dfb4b9..074c553e07 100644 --- a/en_US.ISO8859-1/articles/mh/article.sgml +++ b/en_US.ISO8859-1/articles/mh/article.sgml @@ -36,41 +36,46 @@ - This document contains an introduction to using MH on - FreeBSD + This document contains an introduction to using + MH on FreeBSD Introduction - MH started back in 1977 at the RAND Corporation, where the - initial philosophies behind MH were developed. MH is not so much - a monolithic email program but a philosophy about how best to - develop tools for reading email. The MH developers have done a - great job adhering to the KISS principle: Keep It + MH started back in 1977 at the + RAND Corporation, where the initial philosophies behind + MH were + developed. MH is not so much a + monolithic email program but a philosophy about how best to + develop tools for reading email. The + MH developers have done a great job + adhering to the KISS principle: Keep It Simple Stupid. Rather than have one large program for reading, sending and handling email they have written specialized - programs for each part of your email life. One might liken MH to - the specialization that one finds in insects and nature. Each - tool in MH does one thing, and does it very well. + programs for each part of your email life. One might liken + MH to the specialization that one + finds in insects and nature. Each tool in + MH does one thing, and does it very + well. Beyond just the various tools that one uses to handle their - email MH has done an excellent job keeping the configuration of - each of these tools consistent and uniform. In fact, if you are - not quite sure how something is supposed to work or what the - arguments for some command are supposed to be, then you can - generally guess and be right. Each MH command is consistent - about how it handles reading the configuration files and how it - takes arguments on the command line. One useful thing to - remember is that you can always add a to - the command to have it display the options for that - command. + email MH has done an excellent job + keeping the configuration of each of these tools consistent and + uniform. In fact, if you are not quite sure how something is + supposed to work or what the arguments for some command are + supposed to be, then you can generally guess and be right. Each + MH command is consistent about how it + handles reading the configuration files and how it takes + arguments on the command line. One useful thing to remember is + that you can always add a to the command + to have it display the options for that command. The first thing that you need to do is to make sure that you - have installed the MH package on your FreeBSD machine. If you - installed from CDROM you should be able to execute the following - to load MH: + have installed the MH package on your + FreeBSD machine. If you installed from CDROM you should be able + to execute the following to load MH: &prompt.root; pkg_add /cdrom/packages/mh-6.8.3.tgz @@ -84,50 +89,60 @@ URL="ftp://louie.udel.edu/">louie.udel.edu. This primer is not a full comprehensive explanation of how - MH works. This is just intended to get you started on the road - to happier, faster mail reading. You should read the manual pages - for the various commands. You might also want to read the comp.mail.mh newsgroup. Also - you can read the FAQ for MH. - The best resource for MH is Jerry Peek's MH & - nmh: Email for Users & Programmers. + MH works. This is just intended to + get you started on the road to happier, faster mail reading. You + should read the manual pages for the various commands. You might + also want to read the comp.mail.mh newsgroup. Also you + can read the FAQ for + MH. The best resource for + MH is Jerry Peek's + MH & nmh: Email for Users & + Programmers. Reading Mail This section covers how to use inc, - show, scan, next, - prev, rmm, rmf, and - msgchk. One of the best things about MH is the - consistent interface between programs. One thing to keep in - mind when using these commands is how to specify message lists. - In the case of inc this does not really make any - sense but with commands like show it is useful to + show, scan, + next, prev, + rmm, rmf, and + msgchk. One of the best things about + MH is the consistent interface + between programs. One thing to keep in mind when using these + commands is how to specify message lists. In the case of + inc this does not really make any sense but + with commands like show it is useful to know. A message list can consist of something like 23 - 20 16 which will act on messages 23, 20 and 16. This is - fairly simple but you can do more useful things like - 23-30 which will act on all the messages between - 23 and 30. You can also specify something like - cur:10 which will act on the current message and - the next 9 messages. The cur, last, - and first messages are special messages that refer - to the current, last or first message in the folder. + 20 16 which will act on messages 23, 20 and + 16. This is fairly simple but you can do more useful things + like 23-30 which will act on all the + messages between 23 and 30. You can also specify something + like cur:10 which will act on the + current message and the next 9 messages. The + cur, last, and + first messages are special messages + that refer to the current, last or first message in the + folder. - <command>inc</command>, <command>msgchk</command>—read in your - new email or check it + <command>inc</command>, + <command>msgchk</command>—read in your new email or + check it If you just type in inc and hit - return you will be well on your way to getting - started with MH. The first time you run inc it - will setup your account to use all the MH defaults and ask you - about creating a Mail directory under your HOME directory. If you have mail waiting to - be downloaded you will see something that looks like: + return you will be well on your way to + getting started with MH. The first + time you run inc it will setup your account + to use all the MH defaults and ask + you about creating a Mail directory under + your HOME directory. If you have mail waiting to be downloaded + you will see something that looks like: 29 01/15 Doug White Re: Another Failed to boot problem<<On Mon, 15 J @@ -144,22 +159,25 @@ you. A lot of people like to use POP for grabbing their email. - MH can do POP to grab your email. You will need to give - inc a few command line arguments. + MH can do POP to grab your + email. You will need to give inc a few + command line arguments. &prompt.user; inc -host mail.pop.org -user username -norpop That tells inc to go to - mail.pop.org to download your email, and that - your username on their system is username. The - option tells inc to use - plain POP3 for downloading your email. MH has support for a - few different dialects of POP. More than likely you will never + mail.pop.org to download your email, + and that your username on their system is + username. The + option tells inc + to use plain POP3 for downloading your + email. MH has support for a few + different dialects of POP. More than likely you will never ever need to use them though. While you can do more complex - things with inc such as audit files and scan format files this - will get you going. + things with inc such as audit files and + scan format files this will get you going. The msgchk command is used to get information on whether or not you have new email. msgchk takes @@ -233,10 +251,11 @@ <command>rmm</command> and <command>rmf</command>—remove the current message or folder - rmm is used to remove a mail message. The - default is typically to not actually remove the message but to - rename the file to one that is ignored by the MH commands. You - will periodically need to go through and physically delete the + rmm is used to remove a mail + message. The default is typically to not actually remove the + message but to rename the file to one that is ignored by the + MH commands. You will periodically + need to go through and physically delete the removed messages. The rmf command is used to remove folders. @@ -326,10 +345,11 @@ which I am probably the guilty party). Then if I wanted to read message number 27 I would do a - show 27 and it would be displayed. As you can - probably tell from this sample session MH is pretty easy to - use and looking through emails and displaying them is fairly - intuitive and easy. + show 27 and it would be displayed. As + you can probably tell from this sample session + MH is pretty easy to use and + looking through emails and displaying them is fairly intuitive + and easy. @@ -338,43 +358,52 @@ which I am probably the guilty party). Anybody who gets lots of email definitely wants to be able to prioritize, stamp, brief, de-brief, and number their emails - in a variety of different ways. MH can do this better than just - about anything. One thing that we have not really talked about is - the concept of folders. You have undoubtedly come across the - folders concept using other email programs. MH has folders too. - MH can even do sub-folders of a folder. One thing you should - keep in mind with MH is that when you ran inc for - the first time and it asked you if it could create a - Mail directory it began storing everything in that - directory. If you look at that directory you will find a - directory named inbox. The inbox + in a variety of different ways. MH + can do this better than just about anything. One thing that we + have not really talked about is the concept of folders. You have + undoubtedly come across the folders concept using other email + programs. MH has folders too. + MH can even do sub-folders of a + folder. One thing you should keep in mind with + MH is that when you ran + inc for the first time and it asked you if it + could create a Mail directory it began + storing everything in that directory. If you look at that + directory you will find a directory named + inbox. The inbox directory houses all of your incoming mail that has not been thrown anywhere else. Whenever you create a new folder a new directory is going to - be created underneath your MH Mail directory, and - messages in that folder are going to be stored in that - directory. When a new email message comes, it is thrown - into your inbox directory with a file name that is - equivalent to the message number. So even if you did not have - any of the MH tools to read your email you could still use - standard &unix; commands to munge around in those directories and - just more your files. It is this simplicity that really gives you - a lot of power with what you can do with your email. + be created underneath your MH + Mail directory, and messages in that folder + are going to be stored in that directory. When a new email + message comes, it is thrown into your inbox + directory with a file name that is equivalent to the message + number. So even if you did not have any of the + MH tools to read your email you could + still use standard &unix; commands to munge around in those + directories and just more your files. It is this simplicity that + really gives you a lot of power with what you can do with your + email. Just as you can use message lists like 23 16 - 42 with most MH commands there is a folder option you can - specify with just about every MH command. If you do a - scan +freebsd it will scan your freebsd - folder, and your current folder will be changed to - freebsd. If you do a show +freebsd 23 16 - 42, show is going to switch to your - freebsd folder and display messages 23, 16 and 42. - So remember that syntax. You - will need to make sure you use it to make commands process - different folders. Remember you default folder for mail is - inbox so doing a folder +inbox should - always get you back to your mail. Of course, in MH's infinite + 42 with most MH + commands there is a folder option you can specify with just + about every MH command. If you do a + scan +freebsd it will scan your + freebsd folder, and your current folder + will be changed to freebsd. If you do a + show +freebsd 23 16 42, + show is going to switch to your + freebsd folder and display messages 23, + 16 and 42. So remember that + + syntax. You will need to make sure you use it to make commands + process different folders. Remember you default folder for + mail is inbox so doing a folder + +inbox should always get you back to your mail. Of + course, in MH's infinite flexibility this can be changed but most places have probably left it as inbox. @@ -414,12 +443,13 @@ which I am probably the guilty party). This will show you the same messages you just did not have to work as hard to do it. The option is really an abbreviation of and - pick is just a sequence which contains the message - numbers that matched. You can use sequences with just about - any MH command. So you could have done an rmm pick - and all those messages would be removed instead. You sequence - can be named anything. If you run pick again it will overwrite - the old sequence if you use the same name. + pick is just a sequence which contains the + message numbers that matched. You can use sequences with just + about any MH command. So you could + have done an rmm pick and all those + messages would be removed instead. You sequence can be named + anything. If you run pick again it will overwrite the old + sequence if you use the same name. Doing a pick -search can be a bit more time consuming than just searching for message from someone, @@ -513,10 +543,11 @@ which I am probably the guilty party). &prompt.user; pick -to freebsd-hackers -or -cc freebsd-hackers - That will grab all the email in your inbox that was sent - to freebsd-hackers or cc'd to that list. The brace options - allow you to group search criteria together. This is sometimes - very necessary as in the following example + That will grab all the email in your inbox that was sent to + freebsd-hackers or cc'd to that list. The brace options allow + you to group search criteria together. This is sometimes very + necessary as in the following example &prompt.user; pick -lbrace -to freebsd-hackers -and @@ -531,10 +562,11 @@ which I am probably the guilty party). the subject line. Ordinarily you might have to worry about something called operator precedence. Remember in math how you evaluate from left to right and you do multiplication and - division first and addition and subtraction second? MH has the - same type of rules for pick. It is fairly complex - so you might want to study the manual page. This document is just - to help you get acquainted with MH. + division first and addition and subtraction second? + MH has the same type of rules for + pick. It is fairly complex so you might + want to study the manual page. This document is just to help + you get acquainted with MH. @@ -543,14 +575,15 @@ which I am probably the guilty party). maintenance There are three programs which are primarily just for - manipulating your folders. The folder program is - used to switch between folders, pack them, and list them. At - its simplest level you can do a folder - +newfolder and you will be switched into - newfolder. From there on out all your MH - commands like comp, repl, - scan, and show will act on that - newfolder folder. + manipulating your folders. The folder + program is used to switch between folders, pack them, and list + them. At its simplest level you can do a folder + +newfolder and you will + be switched into newfolder. From + there on out all your MH commands + like comp, repl, + scan, and show will act + on that newfolder folder. Sometimes when you are reading and deleting messages you will develop holes in your folders. If you do a @@ -605,22 +638,25 @@ which I am probably the guilty party). Sending Mail Email is a two way street for most people so you want to be - able to send something back. The way MH handles sending mail can - be a bit difficult to follow at first, but it allows for - incredible flexibility. The first thing MH does is to copy a - components file into your outgoing email. A components file is - basically a skeleton email letter with stuff like the To: and - Subject: headers already in it. You are then sent into your - editor where you fill in the header information and then type - the body of your message below the dashed lines in the message. - When you leave the editor, the whatnow program is run. When you are at the - What now? prompt you can tell it to - send, list, edit, - push, and quit. Most - of these commands are self-explanatory. So the message sending - process involves copying a component file, editing your email, - and then telling the whatnow program what to do with - your email. + able to send something back. The way + MH handles sending mail can be a bit + difficult to follow at first, but it allows for incredible + flexibility. The first thing MH does + is to copy a components file into your outgoing email. A + components file is basically a skeleton email letter with stuff + like the To: and Subject: + headers already in it. You are then sent into your editor where + you fill in the header information and then type the body of + your message below the dashed lines in the message. When you + leave the editor, the whatnow program is run. + When you are at the What now? prompt you can + tell it to send, list, + edit, push, and + quit. Most of these commands are + self-explanatory. So the message sending process involves + copying a component file, editing your email, and then telling + the whatnow program what to do with your + email. <command>comp</command>, <command>forw</command>, @@ -686,19 +722,22 @@ Subject:<userinput>And on the 8th day God created the FreeBSD core team</userinp <para>The <command>repl</command> command will reply to the current message, unless you give it a different message to - reply to. <command>repl</command> will do its best to go ahead and - fill in some of the email headers already. So you will notice - that the <literal>To:</literal> header already has the address of the - recipient in there. Also the <literal>Subject:</literal> line will - already be filled in. You then go about the normal message - composition process and you are done. One useful command line - option to know here is the <option>-cc</option> option. You - can use <parameter>all</parameter>, <parameter>to</parameter>, <parameter>cc</parameter>, - <parameter>me</parameter> after the <option>-cc</option> option to have - <command>repl</command> automatically add the various addresses to - the <literal>Cc:</literal> list in the message. You have probably noticed that the - original message is not included. This is because most <application>MH</application> - setups are configured to do this from the start.</para> + reply to. <command>repl</command> will do its best to go ahead + and fill in some of the email headers already. So you will + notice that the <literal>To:</literal> header already has the + address of the recipient in there. Also the + <literal>Subject:</literal> line will already be filled in. + You then go about the normal message composition process and + you are done. One useful command line option to know here is + the <option>-cc</option> option. You can use + <parameter>all</parameter>, <parameter>to</parameter>, + <parameter>cc</parameter>, <parameter>me</parameter> after the + <option>-cc</option> option to have <command>repl</command> + automatically add the various addresses to the + <literal>Cc:</literal> list in the message. You have probably + noticed that the original message is not included. This is + because most <application>MH</application> setups are + configured to do this from the start.</para> </sect2> <sect2> @@ -708,14 +747,14 @@ Subject:<userinput>And on the 8th day God created the FreeBSD core team</userinp <para>The <filename>components</filename> file is usually in <filename>/usr/local/lib/mh</filename>. You can copy that file - into your <application>MH</application> Mail directory and edit to contain what you want - it to contain. It is a fairly basic file. You have various - email headers at the top, a dashed line and then nothing. The - <command>comp</command> command just copies this - <filename>components</filename> file and then edits it. You can add - any kind of valid RFC822 header you want. For instance you - could have something like this in your <filename>components</filename> - file:</para> + into your <application>MH</application> Mail directory and + edit to contain what you want it to contain. It is a fairly + basic file. You have various email headers at the top, a + dashed line and then nothing. The <command>comp</command> + command just copies this <filename>components</filename> file + and then edits it. You can add any kind of valid RFC822 header + you want. For instance you could have something like this in + your <filename>components</filename> file:</para> <informalexample> <screen>To: @@ -726,11 +765,12 @@ X-Home-Page: http://www.FreeBSD.org/ -------</screen> </informalexample> - <para><application>MH</application> would then copy this components file and throw you into - your editor. The <filename>components</filename> file is fairly - simple. If you wanted to have a signature on those messages - you would just put your signature in that - <filename>components</filename> file.</para> + <para><application>MH</application> would then copy this + components file and throw you into your editor. The + <filename>components</filename> file is fairly simple. If you + wanted to have a signature on those messages you would just + put your signature in that <filename>components</filename> + file.</para> <para>The <filename>replcomps</filename> file is a bit more complex. The default <filename>replcomps</filename> looks like this:</para> @@ -765,14 +805,15 @@ from address</emphasis>, %? <emphasis remap=bf>else</emphasis> {sender} <emphasi message</emphasis>, %> <emphasis remap=bf>endif</emphasis>.</screen> </informalexample> - <para>As you can tell <application>MH</application> formatting can get rather involved. You - can probably decipher what most of the other functions and - variables mean. All of the information on writing these format - strings is in the MH-Format manual page. The really nice thing is - that once you have built your customized - <filename>replcomps</filename> file you will not need to touch it again. - No other email program really gives you the power and - flexibility that <application>MH</application> gives you.</para> + <para>As you can tell <application>MH</application> formatting + can get rather involved. You can probably decipher what most + of the other functions and variables mean. All of the + information on writing these format strings is in the + MH-Format manual page. The really nice thing is that once you + have built your customized <filename>replcomps</filename> file + you will not need to touch it again. No other email program + really gives you the power and flexibility that + <application>MH</application> gives you.</para> </sect2> </sect1> </article>