[Nmh-workers] Documenting @folder WAS Re: relative message numbers?

[Jerrad Pierce]

>Is `scan +/tmp/foo' documented anywhere, i.e. the ability to treat any
>directory as a folder, not just one under Path?  And address@hidden' after 
>that..
Doh. Was planned but slipped my mind. Here are revised versions.

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''.
       If folder begins with ''.'' or ''/'' when using ''@folder', the folder
       is interpeted as a specific path to a directory on the filesystem rather
       than a relative folder location e.g; scan @.` scans the current 
directory,
       and `refile @/tmp` refiles into the temp directory.

2) 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; unless folder begins with ''.'' or ''/'' in which case the
       argument is interpreated as a specific path to a directory.