home *** CD-ROM | disk | FTP | other *** search
/ The AGA Experience 2 / agavol2.iso / software / utilities / comms / metamail-2.3a / man / mailto.1 < prev    next >
Text File  |  1992-06-14  |  32KB  |  781 lines
  1.  
  2.  
  3.  
  4. MAILTO(1)                USER COMMANDS                  MAILTO(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      mailto - Simple mutlimedia mail sending program
  10.  
  11. SYNOPSIS
  12.      mailto  [-a] [-c] [-s] [recipient name(s)]
  13.  
  14. DESCRIPTION
  15.      The _m_a_i_l_t_o program is a very simple user interface for send-
  16.      ing  multimedia  mail  in MIME format, the proposed standard
  17.      format for multimedia Internet mail.  It  is  modelled  very
  18.      heavily  on  the Berkeley "mail" program.  However it shares
  19.      NO code with that program -- it is a completely  new  imple-
  20.      mentation.
  21.  
  22.      As its name implies, _m_a_i_l_t_o is for  _s_e_n_d_i_n_g  mail,  not  for
  23.      reading it.  None of the mail-reading features of the Berke-
  24.      ley mail program have been implemented in _m_a_i_l_t_o.
  25.  
  26.      Users who are already familiar with using the Berkeley  mail
  27.      command  to  send  mail  should  skip the following section,
  28.      which explains things that are already familiar to you  from
  29.      that  program.   Subsequent  sections  focus on the enhanced
  30.      features that make  this  program  different  than  Berkeley
  31.      mail,  notably  the ability to include rich text, multimedia
  32.      objects, and text in non-ASCII languages such as  Hebrew  or
  33.      Russian.
  34.  
  35. BASIC USE
  36.      [THIS SECTION MAY BE SAFELY SKIPPED BY READERS ALREADY FAMI-
  37.      LIAR WITH THE BERKELEY MAIL PROGRAM.]
  38.  
  39.      The basic operation of mailto is very simple.  If  you  just
  40.      type  "mailto"  you  will  be asked for a list of mail reci-
  41.      pients ("To:") a mail subject ("Subject:")  and  possibly  a
  42.      list  of  people  to  receive  a carbon copy of your message
  43.      ("CC:").  Alternately, you can specify all of  these  things
  44.      on the command line.  The "-s" option be used to specify the
  45.      subject, and the "-c" option can be used to specify the car-
  46.      bon  copy  address.   All  other  command line arguments are
  47.      added to the To list.  Thus the following command sends mail
  48.      to  nsb and jxr, with a subject of "Test message" and a car-
  49.      bon copy to kraut:
  50.  
  51.      mailto nsb jxr -s "Test message" -c kraut
  52.  
  53.      For the convenience of users accustomed to mail  readers  in
  54.      which names are separated by commas, you may optionally fol-
  55.      low each address with a comma, but this is not required.
  56.  
  57.      After these preliminaries are taken care of, you  just  type
  58.      in  the  contents of your message.  Everything you type will
  59.      be included in your message UNLESS  you  type  a  line  that
  60.  
  61.  
  62.  
  63. Bellcore Prototype   Last change: Release 1                     1
  64.  
  65.  
  67.  
  68.  
  69. MAILTO(1)                USER COMMANDS                  MAILTO(1)
  70.  
  71.  
  72.  
  73.      begins with the "~" (tilde) character.  Such a line is known
  74.      as a TILDE ESCAPE, and can be used to give special  commands
  75.      to the mailto program, as will be discussed shortly.
  76.  
  77.      When you are done composing your message, you can  cause  it
  78.      to  be  sent to the intended recipients by simply typing the
  79.      end-of-file character, typically  CONTROL-D.   Depending  on
  80.      your  option settings, you may also be able to send the mail
  81.      by typing "." alone on a line, or by typing "~.".
  82.  
  83.      That's all that you really need to know  in  order  to  send
  84.      mail  with  mailto.  However, in order to use it to its ful-
  85.      lest, you will also want to learn about some  of  the  tilde
  86.      escapes.   In this section, we describe the most basic ones,
  87.      which the mailto program shares in common with the  Berkeley
  88.      mail program.   In subsequent sections, we will describe the
  89.      more interesting tilde escapes which are unique to _m_a_i_l_t_o.
  90.  
  91.      If anything in this section seems cryptic, it might be help-
  92.      ful  to  consult the man page for the mail(1) program, since
  93.      the user interfaces are very similar.
  94.  
  95.      Any line that starts with a tilde is a  tilde  escape.   The
  96.      second  character  on  the  line -- the one that follows the
  97.      tilde -- is then interpreted as a  special  command  to  the
  98.      mailto  program.   The  simple tilde escapes that mailto and
  99.      mail have in common are as follows:
  100.  
  101.          ~? Show help on tilde escapes
  102.          ~! Shell escape (e.g. "~! ls")
  103.          ~~ Enter text line starting with a tilde.  The tilde
  104.              "quotes" itself, allowing you to input a line of
  105.              text that starts with a tilde.
  106.          ~. Send the mail and exit
  107.          ~c Add to CC list (e.g. "~c nsb")
  108.          ~d Read in the contents of "~/dead.letter"
  109.              (or a named file, "~d filename")
  110.          ~e Edit the message being composed using the
  111.              editor named by the EDITOR environment variable.
  112.          ~h Edit the To, Subject, and CC headers
  113.          ~p Print out the message so far
  114.          ~q Quit, copying the draft to ~/dead.letter
  115.          ~r Read the named text file into the message
  116.          ~s Reset the subject header
  117.          ~t Add to the To list
  118.          ~v Edit the message being composed using the
  119.              editor named by the VISUAL environment variable
  120.          ~w Write the message being composed to a named file
  121.              (e.g. "~w filename")
  122.  
  123.      You can also control the behavior of the mailto program to a
  124.      limited  extent  by  putting commands in a file in your home
  125.  
  126.  
  127.  
  128. Bellcore Prototype   Last change: Release 1                     2
  129.  
  130.  
  132.  
  133.  
  134. MAILTO(1)                USER COMMANDS                  MAILTO(1)
  135.  
  136.  
  137.  
  138.      directory called  ".mailrc".   These  commands  include  the
  139.      ability  to define aliases for commonly used mail addresses.
  140.      See the section entitled "SUMMARY OF  MAILRC  FUNCTIONALITY"
  141.      later in this man page.
  142.  
  143.  
  144. ENHANCED FEATURES NOT FOUND IN BERKELEY
  145.      The main difference between mail  and  mailto  is  that  the
  146.      latter can be used to generate enhanced mail in MIME format,
  147.      the proposed standard format for Internet  multimedia  mail.
  148.      However,  mailto  is intended to be a _v_e_r_y _s_i_m_p_l_e multimedia
  149.      mail generator.  There are, accordingly, lots of  things  it
  150.      can't  do.  However,  it  has the virtues of being extremely
  151.      simple, extremely similar to a  well-known  program  (mail),
  152.      and  highly configurable, using the "mailcap" file mechanism
  153.      to be described below.
  154.  
  155.      Basically, mailto can include the following things in mail:
  156.  
  157.      1.    Simple   formatted   text,   using   the   MIME   type
  158.      "text/richtext".   This  allows  you to add emphasis to your
  159.      message using underlining, bold text, italic  (diaplsyed  as
  160.      reverse video), centering, and the like.
  161.  
  162.      2.  Non-text data.  Metamail can include  pictures,  sounds,
  163.      and  other  non-textual  data in the middle of any mail mes-
  164.      sage.  The mailcap configuration  mechanism  can  even  make
  165.      this  process  reasonably  user-friendly, but a knowledgable
  166.      user can include non-textual data even in the absence  of  a
  167.      proper mailcap entry.
  168.  
  169.      3.  Text including non-ASCII characters, such as  Hebrew  or
  170.      Russian.   Currently, mailto directly supports only the ISO-
  171.      8859-* family of character sets, which means  that  it  does
  172.      not  meet the needs of Asian users, in particular.  However,
  173.      languages that can not be expressed in the  ISO-8859  family
  174.      can  still  be included in the same way non-text data can be
  175.      included.
  176.  
  177.      These three mechanisms will be discussed separately  in  the
  178.      three sections that follow.
  179.  
  180.  
  181. ENRICHED TEXT
  182.      Mailto lets you modify the formatting of your text in a  few
  183.      simple  but  useful ways.  As with everything else, this can
  184.      be done using simple tilde escapes, as described by the fol-
  185.      lowing list:
  186.  
  187.          ~b Toggle bold mode (turn bold on or off)
  188.          ~i Toggle italic mode (turn italic/reverse-video  on  or
  189.      off)
  190.  
  191.  
  192.  
  193. Bellcore Prototype   Last change: Release 1                     3
  194.  
  195.  
  197.  
  198.  
  199. MAILTO(1)                USER COMMANDS                  MAILTO(1)
  200.  
  201.  
  202.  
  203.          ~j Alter Justification, in particular:
  204.              ~jc Center subsequent text
  205.              ~jl Make subsequent text flush-left
  206.              ~jr Make subsequent text flush-right
  207.          ~k Toggles whether or not a "blind" copy of the  message
  208.      will be kept.
  209.          ~n Force newline (hard line break)
  210.          ~u Toggle underline mode (turn underline on or off)
  211.          ~> Indent Left Margin
  212.          ~< Unindent Left Margin
  213.          ~<R Indent Right Margin
  214.          ~>R Unindent Right Margin
  215.          ~Q Toggle quotation (excerpt) mode
  216.          ~z Add the contents of ~/.signature as a TEXT signature
  217.  
  218.      Some of these  may  require  a  little  explanation.   Bold,
  219.      italic,  and  underline  modes are toggles in the sense that
  220.      alternate uses of ~b, ~i,  and  ~u  turn  bold,  italic,  or
  221.      underline  mode  on or off.  The justification, on the other
  222.      hand, simply switches between the three justification modes,
  223.      centering, left justified, and right justified.
  224.  
  225.      To understand the "~n" command, it must first be noted  that
  226.      rich  text  is  automatically  justified,  so  that the line
  227.      breaks you type have no more significance than space charac-
  228.      ters.   This  allows the text to be displayed more nicely on
  229.      variable-width windows.  (An exception is when you type mul-
  230.      tiple  blank  lines,  in  which  case the line breaks become
  231.      real.)  The "~n" command may be used to foce a  line  break.
  232.      Remember  that  you can see what your mail looks like at any
  233.      time using the "~p" command.
  234.  
  235.      Quotation mode, as toggled by "~Q", is useful for formatting
  236.      excerpts.   If,  for  example,  you  turn on quotation mode,
  237.      insert a file, and then turn off quotation  mode,  the  con-
  238.      tents  of  the  file  will  be  considered an excerpt.  Most
  239.      viewers will show excerpts as indented and/or preceded  with
  240.      "> " to set them apart from the rest of the text.
  241.  
  242.      Finally, "~z" simply includes your text signature file,  but
  243.      formats  it  as  a  "signature", which many richtext viewers
  244.      will display in a smaller font or otherwise set it off  from
  245.      the rest of your message.
  246.  
  247.  
  248. MULTIMEDIA OBJECT INCLUSION
  249.      The basic command for  inserting  multimedia  objects  in  a
  250.      mailto  message  is  "~*".   When you type this command, you
  251.      will be give a list of options that will vary  depending  on
  252.      your  configuration.   (How  to  configure this list will be
  253.      described below.)   For example,  it  might  look  something
  254.      like this:
  255.  
  256.  
  257.  
  258. Bellcore Prototype   Last change: Release 1                     4
  259.  
  260.  
  262.  
  263.  
  264. MAILTO(1)                USER COMMANDS                  MAILTO(1)
  265.  
  266.  
  267.  
  268.       Please choose which kind of data you wish to insert:
  269.  
  270.       0: Raw data from a file, with you specifying  the  content-
  271.      type by hand.
  272.       1: An audio clip
  273.       2: Data in 'application/andrew-inset' format
  274.       3: An X11 window image dump
  275.       4: An interactive mail-based survey
  276.  
  277.      Of these options, only the first one, option 0, will  appear
  278.      at all sites and in all configurations.
  279.  
  280.      If you choose option 0, you will be asked for the name of  a
  281.      file   containing  non-textual  data  and  for  the  correct
  282.      "content-type" name that describes that type of  data.   The
  283.      content-type  values  are  defined by the MIME standard, and
  284.      are typically type/subtype pairs that describe  the  general
  285.      data  type  and its specific format.  For example, a picture
  286.      in GIF format has a  content-type  of  "image/gif",  and  an
  287.      audio  clip  in  basic  u-law  format  has a content-type of
  288.      "audio/basic".  For complete documentation on  the  content-
  289.      type field, consult the MIME proposed standard.
  290.  
  291.      More commonly, however, at a well-configured site  you  will
  292.      not  need to know anything about content-types,  because you
  293.      will choose one of the non-zero options.  In these cases,  a
  294.      program  will run that will allow you to compose data of the
  295.      given type.  The user interface to this  process  cannot  be
  296.      described   here,  because  it  will  necessarily  be  site-
  297.      dependent, but such programs are generally  designed  to  be
  298.      easy for novice users.
  299.  
  300.      An extra mailto command that is useful  for  including  mul-
  301.      timedia  objects  is  the "~Z" command.  This can be used to
  302.      include a multimedia signature  file.   The  signature  file
  303.      should  be  a complete MIME-format file, with a Content-type
  304.      header field at the top.
  305.  
  306.  
  307. CONFIGURATION VIA MAILCAP FILES
  308.      NOTE:  This section is intended for those who are interested
  309.      in  extending  the  behavior of mailto to easily include new
  310.      types  of  mail.   Users  at  well-administered  sites   are
  311.      unlikely to need to do this very often, as the site adminis-
  312.      trator will have done it for you.
  313.  
  314.      For a more complete explanation of  the  mailcap  mechanism,
  315.      consult  the  man  page  for metamail(1).  Here we summarize
  316.      only those aspects of mailcap files  that  are  relevant  to
  317.      configuring the mailto program.
  318.  
  319.      First of all, mailto uses a search path to find the  mailcap
  320.  
  321.  
  322.  
  323. Bellcore Prototype   Last change: Release 1                     5
  324.  
  325.  
  327.  
  328.  
  329. MAILTO(1)                USER COMMANDS                  MAILTO(1)
  330.  
  331.  
  332.  
  333.      file(s)  to consult.  Unlike many path searches, mailto will
  334.      always read _a_l_l the mailcap files on its path.  That is,  it
  335.      will  keep  reading mailcap files until it runs out of them,
  336.      collecting mailcap entries.   The  default  search  path  is
  337.      equivalent to
  338.  
  339.      $HOME/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
  340.  
  341.      It  can  be  overridden  by setting the MAILCAPS environment
  342.      variable.  Note: mailto does not actually interpret environ-
  343.      ment  variables such as $HOME or the "~" syntax in this path
  344.      search.
  345.  
  346.      The syntax of a mailcap file is quite simple, at least  com-
  347.      pared  to termcap files.  Any line that starts with "#" is a
  348.      comment.  Blank lines are  ignored.   Otherwise,  each  line
  349.      defines  a  single  mailcap entry for a single content type.
  350.      Long lines may be continued by ending them with a  backslash
  351.      character, \.
  352.  
  353.      Each individual mailcap entry  consists  of  a  content-type
  354.      specification,  a  command  to be executed on reading, typi-
  355.      cally by the metamail(1) program, and (possibly)  a  set  of
  356.      optional   "flag"   values.   The  mailto  program  is  only
  357.      interested in mailcap entries that have either  or  both  of
  358.      the optional "compose" or "edit" flags.  The compose flag is
  359.      used to tell mailto about a program that can be used to com-
  360.      pose  data  in  the given format, while the edit flag can be
  361.      used to tell mailto how to edit data in  the  given  format.
  362.      Thus,  for example the following mailcap entry describes how
  363.      to compose and edit audio data:
  364.  
  365.      audio/basic;   showaudio   %s;   compose=audiocompose    %s;
  366.      edit=audiocompose %s; label="An audio clip"
  367.  
  368.      The optional "label" field is used in composing  the  prompt
  369.      that  mailto  prints  in  response to the "~*" command.  The
  370.      compose program is used to compose data in this format,  and
  371.      the  edit  program  is used to edit data in this format.  In
  372.      each of these, any occurrence of "%s" will  be  replaced  by
  373.      the  name of the file to be composed or edited.  If there is
  374.      no "%s" in the compose command, it is equivalent  to  having
  375.      "> %s" appended to the end of the compose command.
  376.  
  377.      Note that the order in which things appear in mailcap  files
  378.      is  highly  critical.   The  metamail program uses the first
  379.      matching mailcap entry to  _d_i_s_p_l_a_y  data.   Mailto,  on  the
  380.      other hand, offers the user an alternative for _e_v_e_r_y mailcap
  381.      entry that has a "compose" command.  However, it  should  be
  382.      noted that mailto will use the content-type from the mailcap
  383.      entry in composing content-type headers.  Therefore, compose
  384.      and  edit  commands  should  NOT  be  specified  on wildcard
  385.  
  386.  
  387.  
  388. Bellcore Prototype   Last change: Release 1                     6
  389.  
  390.  
  392.  
  393.  
  394. MAILTO(1)                USER COMMANDS                  MAILTO(1)
  395.  
  396.  
  397.  
  398.      mailcap entries.  If you have a program can display lots  of
  399.      different  subtypes,  you  should  probably  make a separate
  400.      entry for displaying and  for  composing  the  basic  types,
  401.      e.g.:
  402.  
  403.       image/*; showpicture %s
  404.       image/gif; showpicture %s; compose="xwd -frame | xwdtoppm |
  405.      ppmtogif"; label="An X11 window image dump in GIF format"
  406.       image/x-xwd;   showpicture   %s;   compose="xwd    -frame";
  407.      label="An X11 window image dump in XWD format"
  408.  
  409.      For more information on the mailcap file format and  syntax,
  410.      see the metamail(1) man entry.
  411.  
  412.  
  413. TEXT IN NON-ASCII LANGUAGES
  414.      Mailto provides rudimentary support for the  composition  of
  415.      mail  in  non-ASCII  character sets.  Currently, it supports
  416.      the ISO-8859 family of character sets.  These character sets
  417.      all have the nice property that they are proper supersets of
  418.      ASCII.  That is, all ASCII characters are identical  in  all
  419.      of  the  ISO-8859 character sets.  When you use one of these
  420.      character sets, then, you can still type all  ASCII  charac-
  421.      ters as normal.
  422.  
  423.      By default, however, mailto assumes that you are  using  the
  424.      US-ASCII  character set, and will not allow the inclusion of
  425.      non-ASCII characters.  To tell mailto that you are  using  a
  426.      terminal  or  terminal  window that supports one of the ISO-
  427.      8859 character sets, you  can  use  the  -a  switch  or  the
  428.      MM_CHARSET   environment   variable.   For  example,  typing
  429.      "mailto -a  ISO-8859-8"  tells  mailto  that  your  terminal
  430.      understands  ISO-8859-8,  the  ASCII+Hebrew  character  set.
  431.      This is what you would use if you were on  a  terminal  that
  432.      actually  understood  this character set.  If you're using a
  433.      window system such as X11, you'll also need to be sure  that
  434.      your terminal emulator is using the right font.  Thus if you
  435.      have a font named "heb6x13",  you  can  start  a  compatible
  436.      xterm and mailto to send mixed English/Hebrew mail using the
  437.      command "xterm -fn heb6x13 -e  mailto  -a  iso-8859-8".   In
  438.      general,  having an installed font with the same name as the
  439.      character set is a good idea, particularly if  you're  using
  440.      shownonascii(1).
  441.  
  442.      Once you've got mailto started up using the right  character
  443.      sets, there are two ways to enter non-ASCII characters.  The
  444.      first, and by far the easiest, is to use the keys as marked,
  445.      if  you're  on  a  physical  terminal that uses one of these
  446.      character sets.  However, if you're using a  standard  ASCII
  447.      keyboard,  as  most X11 users do, you need some other way to
  448.      enter non-ASCII characters.  To permit this, mailto  has  an
  449.      "eight   bit  mode".   In  eight  bit  mode,  all  printable
  450.  
  451.  
  452.  
  453. Bellcore Prototype   Last change: Release 1                     7
  454.  
  455.  
  457.  
  458.  
  459. MAILTO(1)                USER COMMANDS                  MAILTO(1)
  460.  
  461.  
  462.  
  463.      characters that you type have the eighth bit turned on, thus
  464.      turning them into non-ASCII characters.  You can enter eight
  465.      bit mode using the tilde escape "~+", and you can  leave  it
  466.      using  "~-".   To  see  the  mapping  from  your keyboard to
  467.      eight-bit-mode characters, just give the command "~?+".
  468.  
  469.      Finally, certain languages that  can  be  expressed  in  the
  470.      ISO-8859 family, notably Hebrew and Arabic, go from right to
  471.      left rather than left to right.  To ease the composition  of
  472.      text  in these languages, mailto has a "right to left" mode.
  473.      This mode is toggled on or off using the "~^" command.   For
  474.      added convenience, the right-to-left mode and eight-bit-mode
  475.      can be toggled on and off together using a  single  command,
  476.      "~S" (Semitic mode).
  477.  
  478.  
  479. COMPLETE SUMMARY OF TILDE ESCAPES
  480.      For easy reference, here is a complete summary of the  tilde
  481.      escapes in the mailto program:
  482.  
  483.          ~? Show help on tilde escapes
  484.          ~! Shell escape
  485.          ~~ Enter text line starting with a tilde
  486.          ~. Send the mail and exit
  487.          ~/ Set maximum size before message is split into
  488.              multiple parts
  489.          ~?+ Show help on extended (eight-bit) characters
  490.          ~> Indent Left Margin
  491.          ~< Unindent Left Margin
  492.          ~<R Indent Right Margin
  493.          ~>R Unindent Right Margin
  494.          ~+ Enter 8-bit mode for non-ASCII characters
  495.          ~- Leave 8-bit mode (return to ASCII)
  496.          ~^ Toggle
  497.          ~* Add non-text data (pictures, sounds, etc.) as a new
  498.              MIME part (try it!)
  499.          ~b Toggle bold mode
  500.          ~c Add to CC list
  501.          ~d Read from dead.letter (or named file, ~d filename)
  502.          ~e Edit message being composed
  503.          ~h Edit the headers
  504.          ~i Toggle italic mode
  505.          ~j Alter Justification (~jc = center, ~jl = flushleft,
  506.              ~jr = flushright.)
  507.          ~n Force newline (hard line break)
  508.          ~p Print out the message so far
  509.          ~q Quit, copying to dead.letter
  510.          ~Q Toggle quotation (excerpt) mode
  511.          ~r Read the named text file into the message
  512.          ~s Reset the subject
  513.          ~S Toggle Semitic mode (right-to-left AND eight-bit)
  514.          ~t Add to To list
  515.  
  516.  
  517.  
  518. Bellcore Prototype   Last change: Release 1                     8
  519.  
  520.  
  522.  
  523.  
  524. MAILTO(1)                USER COMMANDS                  MAILTO(1)
  525.  
  526.  
  527.  
  528.          ~u Toggle underline mode
  529.          ~v Edit using VISUAL editor
  530.          ~w Write message to named file
  531.          ~z Add the contents of ~/.signature as a TEXT signature.
  532.          ~Z Add the contents of ~/.SIGNATURE as a NON-TEXT
  533.              (MIME-format) signature.
  534.  
  535.  
  536. SUMMARY OF MAILRC FUNCTIONALITY
  537.      The .mailrc file in your home directory is used to customize
  538.      the  Berkeley mail program.  The mailto program is sensitive
  539.      to some, though not all, of these customizations.   In  par-
  540.      ticular,  you  can use the .mailrc file to set the following
  541.      variables (via "set variablename" or  "unset  variablename")
  542.      that affect mailto's behavior:
  543.  
  544.         askcc -- controls whether or not you are prompted  for  a
  545.      CC list.
  546.         dot -- controls whether or not a period alone on a line
  547.              should be interpreted as terminating your mail
  548.         ignore -- controls whether or not interrupts are ignored
  549.         verbose  --  controls  the  verbosity  of   output   from
  550.      /usr/lib/sendmail
  551.         quiet -- controls the verbosity of output from the mailto
  552.      program.
  553.         keepblind -- controls whether or not a  'blind'  copy  of
  554.      the mail is kept.
  555.  
  556.      The other functionality implemented by the .mailrc  file  is
  557.      personal  mail  aliases.   If  you have a friend with a long
  558.      horrible mail address, you can put a line  in  your  .mailrc
  559.      file  that  allows  you  to  refer to him by a more friendly
  560.      name:
  561.  
  562.         alias    boygeorge      George.Herbert.Walker.Bush%white-
  563.      house.uucp@nsf-relay.com
  564.  
  565.      Mailto implements the alias feature in a manner that is com-
  566.      patible  with Berkeley mail.  Moreover, it also knows how to
  567.      read ".AMS_aliases" files as used by CMU's Andrew system, so
  568.      that  Andrew  users  do  not  need to maintain two different
  569.      alias files in order to use both Andrew and mailto.
  570.  
  571.  
  572. OTHER KNOWN DIFFERENCES FROM BERKELEY MAIL
  573.      Although this program was modelled  on  Berkeley  mail,  its
  574.      user  interface  is  inevitably not identical with that pro-
  575.      gram.   What follows is a list of major  known  differences,
  576.      beyond the multimedia enhancements, that might confuse users
  577.      accustomed to the Berkeley mail program:
  578.  
  579.      _A_d_d_r_e_s_s  _s_e_p_a_r_a_t_o_r_s:  In  Berkeley   mail,   addresses   are
  580.  
  581.  
  582.  
  583. Bellcore Prototype   Last change: Release 1                     9
  584.  
  585.  
  587.  
  588.  
  589. MAILTO(1)                USER COMMANDS                  MAILTO(1)
  590.  
  591.  
  592.  
  593.      separated  by  spaces,  which  is an abomination to the mail
  594.      gods.   For  backward  compatibility,  this  also  works  in
  595.      mailto, but right-thinking people may use commas instead.
  596.  
  597.      _N_e_w_l_i_n_e _s_e_m_a_n_t_i_c_s: Unlike Berkeley mail,  in  mailto  single
  598.      line  breaks  are  generally regarded as "soft".  This means
  599.      that your message may be filled and/or justified when it  is
  600.      seen  by  the  recipient.  Explicit line breaks can be added
  601.      using the "~n" command.  Multiple  consecutive  line  breaks
  602.      typed  by  the  user  WILL  have the desired effect.  Alter-
  603.      nately, any line that starts with a space or  tab  character
  604.      will be preceded by a line break.
  605.  
  606.      _I_n_c_l_u_s_i_o_n _o_f _d_e_a_d._l_e_t_t_e_r _f_i_l_e_s: The "~d" command is used  to
  607.      include  the  contents  of  the  file  "dead.letter"  in the
  608.      current message.  Mailto's implementation  of  this  feature
  609.      differs  from  Mail's  in  two  ways:  First, the message is
  610.      included as an encapsulated message  rather  than  as  plain
  611.      text.   While  this may sometimes be inconvenient, it allows
  612.      multimedia dead.letter  files   to  be  retrieved  properly.
  613.      Second,  the  "~d"  command  in mailto can take an argument,
  614.      which is the name of a file to use instead  of  the  default
  615.      "~/dead.letter".
  616.  
  617.      _I_n_c_o_m_p_a_t_i_b_i_l_i_t_i_e_s _w_i_t_h _S_u_n'_s _v_e_r_s_i_o_n: Sun Microsystems  (and
  618.      no  doubt  many  other  vendors with whom the author is less
  619.      familiar) have enhanced the Berkeley mail command in several
  620.      ways,  a  few  of  which are not compatible with mailto.  In
  621.      particular, the "~b," "~i,  and "~<" commands, at least, are
  622.      different in mailto than in Sun's version.
  623.  
  624.      _P_o_t_e_n_t_i_a_l _f_o_r _f_a_i_l_u_r_e _i_n ~_p: In the standard  Berkeley  mail
  625.      program,  it is inconceivable that "~p" would ever fail.  In
  626.      mailto, ~p works by calling  the  metamail(1)  program.   If
  627.      metamail is not on the user's search path, ~p will not work.
  628.  
  629.      _E_x_t_e_n_d_e_d _a_l_i_a_s _s_e_a_r_c_h_i_n_g: The mailto program reads both  the
  630.      aliases  in  the  .mailrc  file,  as does Berkeley mail, and
  631.      those in the .AMS_aliases file, as used by CMU's Andrew Mes-
  632.      sage System.
  633.  
  634.      _A_l_t_e_r_e_d _e_d_i_t_i_n_g _b_e_h_a_v_i_o_r: The ~e and ~v commands, which  are
  635.      used  to  edit  the message being composed, will behave dif-
  636.      ferently in mailto if the mail includes  non-text  portions.
  637.      In  such  cases,  each  part  will  be edited separately, in
  638.      sequence, which makes it impossble for the user to  acciden-
  639.      tally  mess  up the inter-part boundaries.  Moreover, if the
  640.      mailcap entry for a  given  data  type  includes  an  "edit"
  641.      field, the user will be given the choice of editing with the
  642.      program named there or editing with his usual (text) editor.
  643.      In  most cases, this will be a choice between using a struc-
  644.      tured editor or editing the raw data stream.
  645.  
  646.  
  647.  
  648. Bellcore Prototype   Last change: Release 1                    10
  649.  
  650.  
  652.  
  653.  
  654. MAILTO(1)                USER COMMANDS                  MAILTO(1)
  655.  
  656.  
  657.  
  658.      _A_l_t_e_r_e_d _b_e_h_a_v_i_o_r _f_o_r _l_a_r_g_e _m_e_s_s_a_g_e_s:  Mailto  delivers  your
  659.      message  using  the  splitmail(1)  program.  This is done so
  660.      that large messages will be split  into  a  set  of  smaller
  661.      parts  in  a  MIME-compliant  way,  so that MIME readers can
  662.      automatically reassemble them upon receipt.  By default  all
  663.      messages  over  100Kbytes  are  split,  but this can be con-
  664.      trolled using the SPLITSIZE environment variable.   See  the
  665.      splitmail(1) man page for more information.
  666.  
  667.      _N_e_w -_r _c_o_m_m_a_n_d-_l_i_n_e _o_p_t_i_o_n The -r comand-line option is  not
  668.      found in standard Berkeley mail.
  669.  
  670.  
  671. SUMMARY OF OPTIONS
  672.      -a <charset> -- specifies an alternate character set in use.
  673.      This  had better be the one your terminal is actually using.
  674.      Currently it must be in the iso-8859 character set family.
  675.  
  676.      -c name -- specifies a name for the CC field.  If  you  want
  677.      to  include  multiple values, you'll need to quote the name,
  678.      as in -c "name1, name2, name3"
  679.  
  680.      -r message-id -- specifies a message-id to be used  in  con-
  681.      structing an In-Reply-To header field.
  682.  
  683.      -s subject -- specifies the subject for  the  mail.   If  it
  684.      includes  spaces,  it  will  need to be surrounded by double
  685.      quotes as well.
  686.  
  687.  
  688. ENVIRONMENT VARIABLES
  689.      MAILCAPS
  690.              This variable can be used to  override  the  default
  691.              path search for mailcap files.
  692.  
  693.      PAGER   If set, this variable overrides "more" as  the  name
  694.              of  the  program  to  run to paginate output from an
  695.              interpreter, when pagination has been requested.
  696.  
  697.      MM_CHARSET
  698.              This variable can be used instead of the  -a  switch
  699.              to  tell mailto that your terminal (or terminal emu-
  700.              lator) implements a character  set  other  than  US-
  701.              ASCII.
  702.  
  703.      TERM    This variable tells mailto what your  terminal  type
  704.              is.  This is used in conjunction with the termcap(5)
  705.              facility to figure out how to  do  bold  characters,
  706.              reverse  video,  underlining, or other neat stuff on
  707.              your terminal.
  708.  
  709.      EDITOR  This variable names the editor mailto will use  when
  710.  
  711.  
  712.  
  713. Bellcore Prototype   Last change: Release 1                    11
  714.  
  715.  
  717.  
  718.  
  719. MAILTO(1)                USER COMMANDS                  MAILTO(1)
  720.  
  721.  
  722.  
  723.              you  ask  (with ~e) to edit the message you are com-
  724.              posing.
  725.  
  726.      VISUAL  This variable names the visual  editor  mailto  will
  727.              use  when  you ask (with ~v) to edit the message you
  728.              are composing.
  729.  
  730. SEE ALSO
  731.      metamail(1), mmencode(1), richtext(1), audiocompose(1), get-
  732.      filename(1), mailto-hebrew(1), splitmail(1), shownonasci(1)
  733.  
  734. BUGS
  735.      Currently, fgets is used to get  each  line  of  input.   An
  736.      intelligent  replacement,  in which the effects of right-to-
  737.      left   mode,   eight-bit-mode,   and   the    margin-    and
  738.      justification-related  commands  were  immediately  evident,
  739.      would be a big improvement.
  740.  
  741.      Although this program was modelled  on  Berkeley  mail,  its
  742.      user  interface  is  inevitably not identical with that pro-
  743.      gram.  The section entitled "OTHER  KNOWN  DIFFERENCES  FROM
  744.      BERKELEY  MAIL," above, might be considered by some to be an
  745.      extension of this "BUGS" section.
  746.  
  747.  
  748. COPYRIGHT
  749.      Copyright  (c)  1992  Bell  Communications  Research,   Inc.
  750.      (Bellcore)
  751.  
  752.      Permission  to  use,  copy,  modify,  and  distribute   this
  753.      material  for any purpose and without fee is hereby granted,
  754.      provided that the above copyright notice and this permission
  755.      notice  appear  in all copies, and that the name of Bellcore
  756.      not be used in advertising or publicity pertaining  to  this
  757.      material  without  the specific, prior written permission of
  758.      an authorized representative of Bellcore.  BELLCORE MAKES NO
  759.      REPRESENTATIONS  ABOUT  THE  ACCURACY OR SUITABILITY OF THIS
  760.      MATERIAL FOR ANY PURPOSE.  IT IS PROVIDED "AS  IS",  WITHOUT
  761.      ANY EXPRESS OR IMPLIED WARRANTIES.
  762.  
  763. AUTHOR
  764.      Nathaniel S. Borenstein
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  775.  
  776.  
  777. Bellcore Prototype   Last change: Release 1                    12
  778.  
  779.  
  780.  
  781.