os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Make use of &prompt.user entity for consistency.

Browse source 
De-<para> examples, if possible, to ease indenting.

PR:		docs/14212
Submitted by:	Neil Blakey-Milner <nbm@rucus.ru.ac.za>
This commit is contained in:
John Baldwin 1999-10-10 19:29:59 +00:00
parent 5cfb985349
commit 6f98565226
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=5829
2 changed files with 110 additions and 48 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

79
en_US.ISO8859-1/articles/mh/article.sgml
View file

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

79
en_US.ISO_8859-1/articles/mh/article.sgml
View file

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