MHPATH(1MH)             COMMAND REFERENCE             MHPATH(1MH)



NAME
     mhpath - print full pathnames of MH messages and folders

SYNOPSIS
     mhpath [+folder] [msgs] [-help]

DESCRIPTION
     Mhpath expands and sorts the message list [msgs] and writes
     the full pathnames of the messages to the standard output
     separated by newlines.

     If no ``msgs'' are specified, mhpath outputs the folder
     (directory) pathname (current folder default).

     Contrasted with other MH commands, a message argument to
     mhpath may often be intended for writing.  Because of this:
     1) the name new has been added to mhpath's list of reserved
     message names (the others are first, last, prev, next, cur,
     all).  New is last + 1 (where last is 0 in a messageless
     folder).  New may not be used as part of a message range.
     2) Within a message list, the following designations may
     refer to messages that do not exist:  a single numeric
     message name, the single message name cur, and (obviously)
     the single message name new.  All other message designations
     must refer to at least one existing message.  3) An empty
     folder is not in itself an error.

     Message numbers greater than 999 as part of a range
     designation are replaced with 999. Explicit single message
     numbers greater than 999, or message number 0 in any
     context, are errors.


     Your .mh_profile can contain the following entries:


     Path                     To determine the user's MH
                              directory

     Current-Folder           To find the default current folder

     mhpath has the following defaults:

     +folder defaults to current
     msgs defaults to NULL

     The folder and the current message are unaffected.

OPTIONS
     -help
         Display a synopsis of the mhpath command.




Printed 10/17/86                                                1

MHPATH(1MH)             COMMAND REFERENCE             MHPATH(1MH)



     +folder
         folder becomes the current folder.

EXAMPLES
     The current folder foo contains messages 3 5 6.  Cur is 4.

           % mhpath
           /r/phyl/Mail/foo

           % mhpath all
           /r/phyl/Mail/foo/3
           /r/phyl/Mail/foo/5
           /r/phyl/Mail/foo/6

           % mhpath 1000
           Message 1000 out of range 1-999

           % mhpath 1-1001
           /r/phyl/Mail/foo/3
           /r/phyl/Mail/foo/5
           /r/phyl/Mail/foo/6

           % mhpath new
           /r/phyl/Mail/foo/7

           % mhpath last new
           /r/phyl/Mail/foo/6
           /r/phyl/Mail/foo/7

           % mhpath last-new
           Bad message list "last-new".

           % mhpath cur
           /r/phyl/Mail/foo/4

           % mhpath 1-2
           No messages in range "1-2".

           % mhpath first:2
           /r/phyl/Mail/foo/3
           /r/phyl/Mail/foo/5

           % mhpath 1 2
           /r/phyl/Mail/foo/1
           /r/phyl/Mail/foo/2

           % mhpath 0
           Bad message list "0".

           % mhpath 0-last
           Bad message list "0-last".




Printed 10/17/86                                                2

MHPATH(1MH)             COMMAND REFERENCE             MHPATH(1MH)



           --Backquoted Operations--

           % cd `mhpath +inbox`

          From "e":
           <CMD> run cat `mhpath cur`


FILES
     $HOME/.mh_profile        The user profile

CAVEATS
     Like all MH commands, mhpath expands and sorts [msgs].
     Don't expect
      mv mhpath 501 500
     to move 501 to 500-- the reverse will happen. But
      mv mhpath 501 mhpath 500`
     will do the trick.

     Out of range message 0 is treated far more severely than
     large out of range message numbers.

SEE ALSO
     mh(5mh).































Printed 10/17/86                                                3

%%index%%
na:72,92;
sy:164,227;
de:391,2021;
op:2412,179;2735,112;
ex:2847,1103;4094,131;
fi:4225,112;
ca:4337,764;
se:5101,103;
%%index%%000000000152