[Nmh-commits] CVS: nmh/man anno.man,1.6,1.7 send.man,1.7,1.8 whatnow.man,1.6,1.7

[Jon Steinhart <address@hidden>]

Update of /cvsroot/nmh/nmh/man
In directory subversions:/tmp/cvs-serv29623/nmh/man

Modified Files:
        anno.man send.man whatnow.man 
Log Message:
Added an improved user interface for sending messages with attachments.


Index: anno.man
===================================================================
RCS file: /cvsroot/nmh/nmh/man/anno.man,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -r1.6 -r1.7
*** anno.man    25 Jan 2001 21:15:52 -0000      1.6
--- anno.man    19 Aug 2002 20:50:42 -0000      1.7
***************
*** 16,19 ****
--- 16,25 ----
  .RB [ \-inplace " | " \-noinplace ]
  .RB [ \-date " | " \-nodate ]
+ .RB [ \-draft ]
+ .RB [ \-append ]
+ .RB [ \-list ]
+ .RB [ \-delete ]
+ .RB [ \-number
+ .IR [ num ]]
  .RB [ \-version ]
  .RB [ \-help ]
***************
*** 23,28 ****
  .SH DESCRIPTION
  .B Anno
! annotates the specified messages in the named folder using
! the field and body.
  .PP
  Usually, annotation is performed by the commands
--- 29,48 ----
  .SH DESCRIPTION
  .B Anno
! manipulates header fields or
! .I annotations
! in messages.
! Header fields consist of a field name and an optional field body
! as defined by RFC-2822.
! The
! .B -component
! option specifies the field name, and the
! .B -text
! option specifies the field body.
! .PP
! The messages are either the
! .I msgs
! in the named folder, or the draft if invoked with the
! .B -draft
! option.
  .PP
  Usually, annotation is performed by the commands
***************
*** 49,52 ****
--- 69,79 ----
  body annotation.
  .PP
+ By default,
+ .B anno
+ prepends the annotations to the message.
+ Annotations are instead appended if the
+ .B -append
+ option is specified.
+ .PP
  If a
  .B \-component
***************
*** 58,63 ****
  will prompt the user for the name of field for the annotation.
  .PP
! The field specified should be a valid 822-style message field name,
! which means that it should consist of alphanumerics (or dashes) only.
  The body specified is arbitrary text.
  .PP
--- 85,90 ----
  will prompt the user for the name of field for the annotation.
  .PP
! The field specified must be a valid 2822-style message field name,
! which means that it may only consist of alphanumerics and dashes,
  The body specified is arbitrary text.
  .PP
***************
*** 68,72 ****
  .B \-noinplace
  switch.
! 
  .SH FILES
  .fc ^ ~
--- 95,137 ----
  .B \-noinplace
  switch.
! .PP
! The
! .B -list
! option produces a listing of the field bodies for header fields with
! names matching the specified component, one per line.
! The listing is numbered, starting at 1, if the
! .B -number
! option is also used.
! A tab character separates the number and the field body.
! The field body is treated as if it is a file name, and only the final
! path name component is listed.
! The complete field body is listed if the
! .B -text
! option is used, the contents of the text are ignored.
! .PP
! The
! .B -delete
! option removes header fields from messages.
! The first header field whose name matches the component is deleted if
! no other options are specified.
! If the
! .B -text
! option is used in conjunction with the
! .B -delete
! option, the first header field whose name matches the component and
! whose body matches the text is deleted.
! The text is treated as if it was a file name; if it begins with a
! slash, the entire field body must match the text, otherwise just the
! last path name component of the field body must match.
! If the
! .B -number
! option is used in conjuction with the
! .B -delete
! option, header field
! .I num
! whose name matches the component is deleted.
! The number matches that which is produced by the
! .B -list
! option.
  .SH FILES
  .fc ^ ~

Index: send.man
===================================================================
RCS file: /cvsroot/nmh/nmh/man/send.man,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -r1.7 -r1.8
*** send.man    25 Jan 2001 21:15:59 -0000      1.7
--- send.man    19 Aug 2002 20:50:42 -0000      1.8
***************
*** 41,44 ****
--- 41,46 ----
  .RB [ \-version ]
  .RB [ \-help ]
+ .RB [ \-attach
+ .IR header-field-name ]
  .ad
  .SH DESCRIPTION
***************
*** 64,67 ****
--- 66,104 ----
  are actually performed by
  .BR post .
+ 
+ .PP
+ If a
+ .I header-field-name
+ is supplied using the
+ .B -attach
+ option, the draft is scanned for a header whose field name matches the
+ supplied
+ .IR header-field-name .
+ The draft is converted to a MIME message if one or more matches are found.
+ This conversion occurs before all other processing.
+ .PP
+ The first part of the MIME message is the draft body if that body contains
+ any non-blank characters.
+ The body of each header field whose name matches the
+ .I header-field-name
+ is interpreted as a file name, and each file named is included as a separate
+ part in the MIME message.
+ .PP
+ For file names with dot suffixes, the context is scanned for a
+ .I mhshow-suffix-
+ entry for that suffix.
+ The content-type for the part is taken from that context entry if a match is
+ found.
+ If no match is found or the file does not have a dot suffix, the content-type
+ is text/plain if the file contains only ASCII characters or 
application/octet-stream
+ if it contains characters outside of the ASCII range.
+ .PP
+ Each part contains a name attribute that is the last component of the path 
name.
+ A
+ .I x-unix-mode
+ attribute containing the file mode accompanies each part.
+ Finally, a description attribute is generated by running the
+ .I file
+ command on the file.
  .PP
  If

Index: whatnow.man
===================================================================
RCS file: /cvsroot/nmh/nmh/man/whatnow.man,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -r1.6 -r1.7
*** whatnow.man 25 Jan 2001 21:16:00 -0000      1.6
--- whatnow.man 19 Aug 2002 20:50:42 -0000      1.7
***************
*** 23,26 ****
--- 23,28 ----
  .RB [ \-version ]
  .RB [ \-help ]
+ .RB [ \-attach
+ .IR header-field-name ]
  .ad
  .SH DESCRIPTION
***************
*** 46,61 ****
  .PP
  .RS 5
! .TP \w'refilezzfolderz'u
  .B edit
  re\-edit using the same editor that was used on the
  preceding round unless a profile entry
  \*(lq<lasteditor>\-next: <editor>\*(rq names an alternate editor
! .TP \w'refilezzfolderz'u
  .B edit <editor>
  invoke <editor> for further editing
! .TP \w'refilezzfolderz'u
  .B refile +folder
  refile the draft into the given folder
! .TP \w'refilezzfolderz'u
  .B mime
  process the draft as MIME composition file using
--- 48,63 ----
  .PP
  .RS 5
! .TP \w'refilezzzzfolderz'u
  .B edit
  re\-edit using the same editor that was used on the
  preceding round unless a profile entry
  \*(lq<lasteditor>\-next: <editor>\*(rq names an alternate editor
! .TP \w'refilezzzzfolderz'u
  .B edit <editor>
  invoke <editor> for further editing
! .TP \w'refilezzzzfolderz'u
  .B refile +folder
  refile the draft into the given folder
! .TP \w'refilezzzzfolderz'u
  .B mime
  process the draft as MIME composition file using
***************
*** 65,100 ****
  .RB ( mhbuild
  by default)
! .TP \w'refilezzfolderz'u
  .B display
  list the message being distributed/replied\-to
  on the terminal
! .TP \w'refilezzfolderz'u
  .B list
  list the draft on the terminal
! .TP \w'refilezzfolderz'u
  .B send
  send the message
! .TP \w'refilezzfolderz'u
  .B send \-watch
  send the message and monitor the delivery process
! .TP \w'refilezzfolderz'u
  .B push
  send the message in the background
! .TP \w'refilezzfolderz'u
  .B whom
  list the addresses that the message will go to
! .TP \w'refilezzfolderz'u
  .B whom \-check
  list the addresses and verify that they are
  acceptable to the transport service
! .TP \w'refilezzfolderz'u
  .B quit
  preserve the draft and exit
! .TP \w'refilezzfolderz'u
  .B quit \-delete
  delete the draft and exit
! .TP \w'refilezzfolderz'u
  .B delete
  delete the draft and exit
  .RE
  .PP
--- 67,120 ----
  .RB ( mhbuild
  by default)
! .TP \w'refilezzzzfolderz'u
  .B display
  list the message being distributed/replied\-to
  on the terminal
! .TP \w'refilezzzzfolderz'u
  .B list
  list the draft on the terminal
! .TP \w'refilezzzzfolderz'u
  .B send
  send the message
! .TP \w'refilezzzzfolderz'u
  .B send \-watch
  send the message and monitor the delivery process
! .TP \w'refilezzzzfolderz'u
  .B push
  send the message in the background
! .TP \w'refilezzzzfolderz'u
  .B whom
  list the addresses that the message will go to
! .TP \w'refilezzzzfolderz'u
  .B whom \-check
  list the addresses and verify that they are
  acceptable to the transport service
! .TP \w'refilezzzzfolderz'u
  .B quit
  preserve the draft and exit
! .TP \w'refilezzzzfolderz'u
  .B quit \-delete
  delete the draft and exit
! .TP \w'refilezzzzfolderz'u
  .B delete
  delete the draft and exit
+ .TP \w'refilezzzzfolderz'u
+ .B cd directory
+ use the directory when interpreting attachment file names
+ .TP \w'refilezzzzfolderz'u
+ .B pwd
+ print the working directory for attachment files
+ .TP \w'refilezzzzfolderz'u
+ .B ls [ls-options]
+ list files in the attachment working directory using the ls command
+ .TP \w'refilezzzzfolderz'u
+ .B attach files
+ add the named files to the draft as MIME attachments
+ .TP \w'refilezzzzfolderz'u
+ .B alist [-ln]
+ list the MIME attachments, either short, long [-l] or numbered [-n]
+ .TP \w'refilezzzzfolderz'u
+ .B detach [-n] files-or-numbers
+ remove MIME attachments, either by file name or by number with -n
  .RE
  .PP