Re: [Nmh-workers] relative message numbers?

[Jerrad Pierce]

Documenting @folder is a little tricky since nmh man pages are written as prose.
rather than bulleted lists explaining each of the options like many other 
packages.

My best whack at it would be to:

1) Insert into nmh.1 near:

       Commands which take a message number as an argument ( scan, show, repl,
 
        ...

       Commands which take a range of message numbers ( rmm, scan, show,  ...)
 
  something like the following:

       Commands which take a folder name (inc, refile, scan, sortm, ...)
       will accept the folder name in two formats: '+folder' and '@folder'.
       '+folder' specifies a folder underneath the Path defined in your nmh
       profile e.g; with the default '''Path: Mail''', '+folder' tells nmh to 
use
       ''~/Mail/folder''. '@folder' specifies a path relative to the current 
folder
       specified in your ''context'' file e.g; with '''Current-Folder: inbox''',
       and the same profile, '@folder' tells nmh to use ''~/Mail/inbox/folder''.

It might also be worth insertng into the CONTEXT heading of the relevant
commands (inc, refile. scan, sortm, etc.) a blurb along the lines of:

       The current context is used to expand relative folders supplied with
       the prefix @ instead of +, by prepending it to the specified folders.