home *** CD-ROM | disk | FTP | other *** search
/ The AGA Experience 2 / agavol2.iso / software / utilities / comms / metamail-2.3a / man / mmencode.1 < prev    next >
Text File  |  1992-06-14  |  3KB  |  131 lines
  1.  
  2.  
  3.  
  4. MMENCODE(1)              USER COMMANDS                MMENCODE(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      mmencode - Translate to and from mail-oriented encoding for-
  10.      mats
  11.  
  12. SYNOPSIS
  13.      mmencode[-u] [-b] [-q] [-p] [file name]
  14.  
  15. DESCRIPTION
  16.      The _m_m_e_n_c_o_d_e program simply converts a byte stream into  (or
  17.      out of) one of the standard mail encoding formats defined by
  18.      MIME, the proposed standard  for  internet  multimedia  mail
  19.      formats.   Such an encoding is necessary because binary data
  20.      cannot be sent through the mail.  The  encodings  understood
  21.      by   mmencode   are   preferable   to   the   use   of   the
  22.      uuencode/uudecode programs, for  use  in  mail,  in  several
  23.      respects that were important to the authors of MIME.
  24.  
  25.      By default, mmencode  reads  standard  input,  and  sends  a
  26.      "base64" encoded version of the input to standard output.
  27.  
  28.      The (really not necessary) "-b" option tells mmencode to use
  29.      the "base64" encoding.
  30.  
  31.      The "-q" option tells mmencode to use the "quoted-printable"
  32.      encoding instead of base64.
  33.  
  34.      The "-u" option tells mmencode to _d_e_c_o_d_e the standard  input
  35.      rather than encode it.
  36.  
  37.      If a file name argument is given, input is  read  from  that
  38.      file rather than from standard input.
  39.  
  40. RATIONALE
  41.      _M_m_e_n_c_o_d_e is intended to be a replacement  for  _u_u_e_n_c_o_d_e  for
  42.      mail  and news use.  The reason is simple:  uuencode doesn't
  43.      work very well in a number of circumstances  and  ways.   In
  44.      particular,  uuencode  uses  characters that don't translate
  45.      well across all mail gateways (particularly ASCII <-> EBCDIC
  46.      gateways).   Also,  uuencode  is  not  standard -- there are
  47.      several variants  floating  around,  encoding  and  decoding
  48.      things  in  different  and incompatible ways, with no "stan-
  49.      dard" on which to base an implementation.  Finally, uuencode
  50.      does  not generally work well in a pipe, although some vari-
  51.      ants have been modified to do so.  Mmencode  implements  the
  52.      encodings  which  were defined for MIME as uuencode replace-
  53.      ments, and should be considerably more robust for email use.
  54.  
  55. SEE ALSO
  56.      metamail(1), mailto(1)
  57.  
  58.  
  60.  
  61.  
  62. Bellcore Prototype   Last change: Release 1                     1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. MMENCODE(1)              USER COMMANDS                MMENCODE(1)
  70.  
  71.  
  72.  
  73. BUGS
  74.      Nope.
  75.  
  76. COPYRIGHT
  77.      Copyright  (c)  1991  Bell  Communications  Research,   Inc.
  78.      (Bellcore)
  79.  
  80.      Permission  to  use,  copy,  modify,  and  distribute   this
  81.      material  for any purpose and without fee is hereby granted,
  82.      provided that the above copyright notice and this permission
  83.      notice  appear  in all copies, and that the name of Bellcore
  84.      not be used in advertising or publicity pertaining  to  this
  85.      material  without  the specific, prior written permission of
  86.      an authorized representative of Bellcore.  BELLCORE MAKES NO
  87.      REPRESENTATIONS  ABOUT  THE  ACCURACY OR SUITABILITY OF THIS
  88.      MATERIAL FOR ANY PURPOSE.  IT IS PROVIDED "AS  IS",  WITHOUT
  89.      ANY EXPRESS OR IMPLIED WARRANTIES.
  90.  
  91. AUTHOR
  92.      Nathaniel S. Borenstein
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  125.  
  126.  
  127. Bellcore Prototype   Last change: Release 1                     2
  128.  
  129.  
  130.  
  131.