diff --git a/en_US.ISO8859-1/articles/mh/article.sgml b/en_US.ISO8859-1/articles/mh/article.sgml index f0eb23f863..d395447864 100644 --- a/en_US.ISO8859-1/articles/mh/article.sgml +++ b/en_US.ISO8859-1/articles/mh/article.sgml @@ -1,4 +1,4 @@ - + @@ -54,7 +54,7 @@ for that command. installed the MH package on your FreeBSD machine. If you installed from CDROM you should be able to execute the following to load mh: -# pkg_add /cdrom/packages/mh-6.8.3.tgz +&prompt.root; pkg_add /cdrom/packages/mh-6.8.3.tgz You will notice that it created a /usr/local/lib/mh directory for you as well as adding several binaries to the @@ -107,6 +107,7 @@ time you run inc it will setup your account to use all the MH defaults and ask you about creating a Mail 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 30 01/16 "Jordan K. Hubbar Re: FBSD 2.1<<> Do you want a library instead of @@ -114,6 +115,7 @@ like: 32 01/16 "Jordan K. Hubbar Re: video is up<<> Anyway, mrouted won't run, ev 33 01/16 Michael Smith Re: FBSD 2.1<<Nate Williams stands accused of sa + This is the same thing you will see from a scan (see ). If you just run inc with no arguments it will look on your computer for email that is supposed to @@ -122,9 +124,11 @@ be coming to 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. + -tempest% inc -host mail.pop.org -user username -norpop +&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 @@ -149,9 +153,11 @@ Like inc, show is a fairly straightforward command. If you just type show and hit return then it displays the current message. You can also give specific message numbers to show: + -tempest% show 32 45 56 +&prompt.user; show 32 45 56 + This would display message numbers 32, 45 and 56 right after each other. Unless you change the default behavior show basically just does a more on the email message. @@ -169,12 +175,14 @@ message it automatically displays it. scan will display a brief listing of the messages in your current folder. This is an example of what the scan command will give you. + 30+ 01/16 "Jordan K. Hubbar Re: FBSD 2.1<<> Do you want a library instead of 31 01/16 Bruce Evans Re: location of bad144 table<<>> >It would appea 32 01/16 "Jordan K. Hubbar Re: video is up<<> Anyway, mrouted won't run, ev 33 01/16 Michael Smith Re: FBSD 2.1<<Nate Williams stands accused of sa + Like just about everything in MH this display is very configurable. This is the typical default display. It gives you the message number, the date on the email, the sender, the subject line, and a sentence @@ -214,19 +222,22 @@ drive so you should be careful when you use this command. The first thing that you will want to do is inc your new mail. So at a shell prompt just type in inc and hit return. + -tempest% inc +&prompt.user; inc Incorporating new mail into inbox... 36+ 01/19 "Stephen L. Lange Request...<<Please remove me as contact for pind 37 01/19 Matt Thomas Re: kern/950: Two PCI bridge chips fail (multipl 38 01/19 "Amancio Hasty Jr Re: FreeBSD and VAT<<>>> Bill Fenner said: > In -tempest% +&prompt.user; + This shows you the new email that has been added to your mailbox. So the next thing to do is show the email and move around. + -tempest% show +&prompt.user; show Received: by sashimi.wwa.com (Smail3.1.29.1 #2) id m0tdMZ2-001W2UC; Fri, 19 Jan 96 13:33 CST Date: Fri, 19 Jan 1996 13:33:31 -0600 (CST) @@ -240,8 +251,8 @@ Content-Type: TEXT/PLAIN; charset=US-ASCII Please remove me as contact for pindat.com -tempest% rmm -tempest% next +&prompt.user; rmm +&prompt.user; next Received: from localhost (localhost [127.0.0.1]) by whydos.lkg.dec.com (8.6.11/8 .6.9) with SMTP id RAA24416; Fri, 19 Jan 1996 17:56:48 GMT Message-Id: <199601191756.RAA24416@whydos.lkg.dec.com> @@ -262,14 +273,15 @@ Precedence: bulk This is due to a typo in pcireg.h (to which I am probably the guilty party). - + The rmm removed the current message and the next command moved me on to the next message. Now if I wanted to look at ten most recent messages so I could read one of them here is what I would do: + -tempest% scan last:10 +&prompt.user; scan last:10 26 01/16 maddy Re: Testing some stuff<<yeah, well, Trinity has 27 01/17 Automatic digest NET-HAPPENINGS Digest - 16 Jan 1996 to 17 Jan 19 28 01/17 Evans A Criswell Re: Hey dude<<>From matt@tempest.garply.com Tue @@ -280,8 +292,9 @@ one of them here is what I would do: 35 01/19 support@foo.garpl [garply.com #1138] parlor<<Hello. This is the Ne 37+ 01/19 Matt Thomas Re: kern/950: Two PCI bridge chips fail (multipl 38 01/19 "Amancio Hasty Jr Re: FreeBSD and VAT<<>>> Bill Fenner said: > In -tempest% +&prompt.user; + 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 @@ -343,8 +356,9 @@ system. So you might want to read the pick1 man page for a more thorough understanding. At its simplest level you can do something like + -tempest% pick -search pci +&prompt.user; pick -search pci 15 42 55 @@ -352,6 +366,7 @@ something like 57 + This will tell pick to look through every single line in every message in your current folder and tell you which message numbers it found the word pci in. You can then @@ -359,11 +374,13 @@ numbers it found the word pci in. You can then rmm them. You would have to specify something like show 15 42 55-57 to display them though. A slightly more useful thing to do is this: + -tempest% pick -search pci -seq pick +&prompt.user; pick -search pci -seq pick 5 hits -tempest% show pick +&prompt.user; show pick + This will show you the same messages you just didn't have to work as hard to do it. The option is really an abbreviation of and pick is @@ -377,6 +394,7 @@ will overwrite the old sequence if you use the same name. consuming than just searching for message from someone, or to someone. So pick allows you to use the following predefined search criteria: + @@ -424,15 +442,16 @@ the header) - + This allows you to do things like -tempest% pick -to freebsd-hackers@FreeBSD.org -seq hackers +&prompt.user; pick -to freebsd-hackers@FreeBSD.org -seq hackers to get a list of all the email send to the FreeBSD hackers mailing list. pick also allows you to group these criteria in different ways using the following options: + @@ -452,18 +471,22 @@ different ways using the following options: + These commands allow you to do things like + -tempest% pick -to freebsd-hackers -and -cc freebsd-hackers +&prompt.user; pick -to freebsd-hackers -and -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 + -tempest% pick -lbrace -to freebsd-hackers -and +&prompt.user; pick -lbrace -to freebsd-hackers -and -not -cc freebsd-questions -rbrace -and -subject pci - + Basically this says pick (to freebsd-hackers and not cc'd on freebsd-questions) and the subject is pci. It should look through your @@ -506,6 +529,7 @@ is in each one and so on. This line of stats it displays for all your folders is the same one you get when you change to a folder with folder +foldername. A folders command looks like this: + Folder # of messages ( range ); cur msg (other files) announce has 1 message ( 1- 1). @@ -521,7 +545,7 @@ like this: TOTAL= 199 messages in 13 folders. - + The refile command is what you use to move messages between folders. When you do something like refile 23 @@ -573,13 +597,14 @@ want to use comp -editor /usr/bin/vi/ or comp -editor /usr/local/bin/pico/ instead. Once you have run comp you are in your editor and you see something that looks like this: + To: cc: Subject: -------- - + You need to put the person you are sending the mail to after the To: line. It works the same way for the other headers @@ -589,6 +614,7 @@ message after the dashed lines. It may seem a bit simplistic since a lot of email programs have special requesters that ask you for this information but there really isn't any point to that. Plus this really gives you excellent flexibility. + To:freebsd-rave@FreeBSD.org cc: @@ -596,6 +622,7 @@ Subject:And on the 8th day God created the FreeBSD core team -------- Wow this is an amazing operating system. Thanks! + You can now save this message and exit your editor. You will see the What now? prompt and you can type in send or s and hit @@ -644,6 +671,7 @@ the top, a dashed line and then nothing. The components 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 components file: + To: Fcc: out @@ -653,6 +681,7 @@ X-Home-Page: http://www.FreeBSD.org/ ------- + MH would then copy this components file and throw you into your editor. The components file is fairly simple. If you wanted to have a signature on those messages you would just put your @@ -660,6 +689,7 @@ signature in that components file. The replcomps file is a bit more complex. The default replcomps looks like this: + %(lit)%(formataddr %<{reply-to}%?{from}%?{sender}%?{return-path}%>)\ %<(nonnull)%(void(width))%(putaddr To: )\n%>\ @@ -672,7 +702,7 @@ signature in that components file. %{message-id}%>\n%>\ -------- - + It's in the same basic format as the components file but it contains quite a few extra formatting codes. The @@ -681,13 +711,14 @@ it contains quite a few extra formatting codes. The address. The next part is %< which means if and the {reply-to} means the reply-to field in the original message. So that might be translated this way: + %<if {reply-to} the original message has a reply-to then give that to formataddr, %? else {from} take the from address, %? else {sender} take the sender address, %? else {return-path} take the return-path from the original message, %> endif. - + As you can tell MH formatting can get rather involved. You can probably decipher what most of the other functions and variables diff --git a/en_US.ISO_8859-1/articles/mh/article.sgml b/en_US.ISO_8859-1/articles/mh/article.sgml index f0eb23f863..d395447864 100644 --- a/en_US.ISO_8859-1/articles/mh/article.sgml +++ b/en_US.ISO_8859-1/articles/mh/article.sgml @@ -1,4 +1,4 @@ - + @@ -54,7 +54,7 @@ for that command. installed the MH package on your FreeBSD machine. If you installed from CDROM you should be able to execute the following to load mh: -# pkg_add /cdrom/packages/mh-6.8.3.tgz +&prompt.root; pkg_add /cdrom/packages/mh-6.8.3.tgz You will notice that it created a /usr/local/lib/mh directory for you as well as adding several binaries to the @@ -107,6 +107,7 @@ time you run inc it will setup your account to use all the MH defaults and ask you about creating a Mail 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 30 01/16 "Jordan K. Hubbar Re: FBSD 2.1<<> Do you want a library instead of @@ -114,6 +115,7 @@ like: 32 01/16 "Jordan K. Hubbar Re: video is up<<> Anyway, mrouted won't run, ev 33 01/16 Michael Smith Re: FBSD 2.1<<Nate Williams stands accused of sa + This is the same thing you will see from a scan (see ). If you just run inc with no arguments it will look on your computer for email that is supposed to @@ -122,9 +124,11 @@ be coming to 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. + -tempest% inc -host mail.pop.org -user username -norpop +&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 @@ -149,9 +153,11 @@ Like inc, show is a fairly straightforward command. If you just type show and hit return then it displays the current message. You can also give specific message numbers to show: + -tempest% show 32 45 56 +&prompt.user; show 32 45 56 + This would display message numbers 32, 45 and 56 right after each other. Unless you change the default behavior show basically just does a more on the email message. @@ -169,12 +175,14 @@ message it automatically displays it. scan will display a brief listing of the messages in your current folder. This is an example of what the scan command will give you. + 30+ 01/16 "Jordan K. Hubbar Re: FBSD 2.1<<> Do you want a library instead of 31 01/16 Bruce Evans Re: location of bad144 table<<>> >It would appea 32 01/16 "Jordan K. Hubbar Re: video is up<<> Anyway, mrouted won't run, ev 33 01/16 Michael Smith Re: FBSD 2.1<<Nate Williams stands accused of sa + Like just about everything in MH this display is very configurable. This is the typical default display. It gives you the message number, the date on the email, the sender, the subject line, and a sentence @@ -214,19 +222,22 @@ drive so you should be careful when you use this command. The first thing that you will want to do is inc your new mail. So at a shell prompt just type in inc and hit return. + -tempest% inc +&prompt.user; inc Incorporating new mail into inbox... 36+ 01/19 "Stephen L. Lange Request...<<Please remove me as contact for pind 37 01/19 Matt Thomas Re: kern/950: Two PCI bridge chips fail (multipl 38 01/19 "Amancio Hasty Jr Re: FreeBSD and VAT<<>>> Bill Fenner said: > In -tempest% +&prompt.user; + This shows you the new email that has been added to your mailbox. So the next thing to do is show the email and move around. + -tempest% show +&prompt.user; show Received: by sashimi.wwa.com (Smail3.1.29.1 #2) id m0tdMZ2-001W2UC; Fri, 19 Jan 96 13:33 CST Date: Fri, 19 Jan 1996 13:33:31 -0600 (CST) @@ -240,8 +251,8 @@ Content-Type: TEXT/PLAIN; charset=US-ASCII Please remove me as contact for pindat.com -tempest% rmm -tempest% next +&prompt.user; rmm +&prompt.user; next Received: from localhost (localhost [127.0.0.1]) by whydos.lkg.dec.com (8.6.11/8 .6.9) with SMTP id RAA24416; Fri, 19 Jan 1996 17:56:48 GMT Message-Id: <199601191756.RAA24416@whydos.lkg.dec.com> @@ -262,14 +273,15 @@ Precedence: bulk This is due to a typo in pcireg.h (to which I am probably the guilty party). - + The rmm removed the current message and the next command moved me on to the next message. Now if I wanted to look at ten most recent messages so I could read one of them here is what I would do: + -tempest% scan last:10 +&prompt.user; scan last:10 26 01/16 maddy Re: Testing some stuff<<yeah, well, Trinity has 27 01/17 Automatic digest NET-HAPPENINGS Digest - 16 Jan 1996 to 17 Jan 19 28 01/17 Evans A Criswell Re: Hey dude<<>From matt@tempest.garply.com Tue @@ -280,8 +292,9 @@ one of them here is what I would do: 35 01/19 support@foo.garpl [garply.com #1138] parlor<<Hello. This is the Ne 37+ 01/19 Matt Thomas Re: kern/950: Two PCI bridge chips fail (multipl 38 01/19 "Amancio Hasty Jr Re: FreeBSD and VAT<<>>> Bill Fenner said: > In -tempest% +&prompt.user; + 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 @@ -343,8 +356,9 @@ system. So you might want to read the pick1 man page for a more thorough understanding. At its simplest level you can do something like + -tempest% pick -search pci +&prompt.user; pick -search pci 15 42 55 @@ -352,6 +366,7 @@ something like 57 + This will tell pick to look through every single line in every message in your current folder and tell you which message numbers it found the word pci in. You can then @@ -359,11 +374,13 @@ numbers it found the word pci in. You can then rmm them. You would have to specify something like show 15 42 55-57 to display them though. A slightly more useful thing to do is this: + -tempest% pick -search pci -seq pick +&prompt.user; pick -search pci -seq pick 5 hits -tempest% show pick +&prompt.user; show pick + This will show you the same messages you just didn't have to work as hard to do it. The option is really an abbreviation of and pick is @@ -377,6 +394,7 @@ will overwrite the old sequence if you use the same name. consuming than just searching for message from someone, or to someone. So pick allows you to use the following predefined search criteria: + @@ -424,15 +442,16 @@ the header) - + This allows you to do things like -tempest% pick -to freebsd-hackers@FreeBSD.org -seq hackers +&prompt.user; pick -to freebsd-hackers@FreeBSD.org -seq hackers to get a list of all the email send to the FreeBSD hackers mailing list. pick also allows you to group these criteria in different ways using the following options: + @@ -452,18 +471,22 @@ different ways using the following options: + These commands allow you to do things like + -tempest% pick -to freebsd-hackers -and -cc freebsd-hackers +&prompt.user; pick -to freebsd-hackers -and -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 + -tempest% pick -lbrace -to freebsd-hackers -and +&prompt.user; pick -lbrace -to freebsd-hackers -and -not -cc freebsd-questions -rbrace -and -subject pci - + Basically this says pick (to freebsd-hackers and not cc'd on freebsd-questions) and the subject is pci. It should look through your @@ -506,6 +529,7 @@ is in each one and so on. This line of stats it displays for all your folders is the same one you get when you change to a folder with folder +foldername. A folders command looks like this: + Folder # of messages ( range ); cur msg (other files) announce has 1 message ( 1- 1). @@ -521,7 +545,7 @@ like this: TOTAL= 199 messages in 13 folders. - + The refile command is what you use to move messages between folders. When you do something like refile 23 @@ -573,13 +597,14 @@ want to use comp -editor /usr/bin/vi/ or comp -editor /usr/local/bin/pico/ instead. Once you have run comp you are in your editor and you see something that looks like this: + To: cc: Subject: -------- - + You need to put the person you are sending the mail to after the To: line. It works the same way for the other headers @@ -589,6 +614,7 @@ message after the dashed lines. It may seem a bit simplistic since a lot of email programs have special requesters that ask you for this information but there really isn't any point to that. Plus this really gives you excellent flexibility. + To:freebsd-rave@FreeBSD.org cc: @@ -596,6 +622,7 @@ Subject:And on the 8th day God created the FreeBSD core team -------- Wow this is an amazing operating system. Thanks! + You can now save this message and exit your editor. You will see the What now? prompt and you can type in send or s and hit @@ -644,6 +671,7 @@ the top, a dashed line and then nothing. The components 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 components file: + To: Fcc: out @@ -653,6 +681,7 @@ X-Home-Page: http://www.FreeBSD.org/ ------- + MH would then copy this components file and throw you into your editor. The components file is fairly simple. If you wanted to have a signature on those messages you would just put your @@ -660,6 +689,7 @@ signature in that components file. The replcomps file is a bit more complex. The default replcomps looks like this: + %(lit)%(formataddr %<{reply-to}%?{from}%?{sender}%?{return-path}%>)\ %<(nonnull)%(void(width))%(putaddr To: )\n%>\ @@ -672,7 +702,7 @@ signature in that components file. %{message-id}%>\n%>\ -------- - + It's in the same basic format as the components file but it contains quite a few extra formatting codes. The @@ -681,13 +711,14 @@ it contains quite a few extra formatting codes. The address. The next part is %< which means if and the {reply-to} means the reply-to field in the original message. So that might be translated this way: + %<if {reply-to} the original message has a reply-to then give that to formataddr, %? else {from} take the from address, %? else {sender} take the sender address, %? else {return-path} take the return-path from the original message, %> endif. - + As you can tell MH formatting can get rather involved. You can probably decipher what most of the other functions and variables