home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / library / dos / communic / pcmail / readme < prev   
Encoding:
Text File  |  1994-06-05  |  4.1 KB  |  161 lines
  1. @(#) README 2.1 90/01/22 13:26:22
  2.  
  3.  
  4.  
  5. This is the second release of the pc-mail software that original-
  6.  
  7. ly appeared in comp.sources.misc, april 1988.
  8.  
  9.  
  10.  
  11. The pc-mail software provides a single user with  facilities  for
  12.  
  13. creating,  sending  and  receiving  electronic mail messages. The
  14.  
  15. programs were developed under UNIX  but  also  run  with  MS-DOS.
  16.  
  17. Various  transport  mechanisms are supported: UUCP across dial-up
  18.  
  19. links (both GNUUCP support as well as a dedicated UUCP driver are
  20.  
  21. provided),  and  PC/NFS.  Porting  to  other OSes should be rela-
  22.  
  23. tively easy.
  24.  
  25.  
  26.  
  27. In principle, the software can be operated  in  four  ways,  that
  28.  
  29. differ in the location of the user's mail data base, and  in  the
  30.  
  31. mechanism used for message transport:
  32.  
  33.  
  34.  
  35.  - The mail data base is local to the pc. The user does  all  her
  36.  
  37. work  on  the pc. Messages are exchanged with a UNIX host via the
  38.  
  39. UUCP file-transfer program provided with the pc-mail software.
  40.  
  41.  
  42.  
  43.  - Ditto, but GNUUCP is used for message transport  and  routing.
  44.  
  45. The  pc-mail source distribution provides programs that interface
  46.  
  47. between pc-mail and GNUUCP.
  48.  
  49.  
  50.  
  51.  - The mail data base is located on a UNIX file server. The  user
  52.  
  53. does all her work on the pc. Daemon programs, running on the UNIX
  54.  
  55. file server, take care of the actual delivery  of  messages.  The
  56.  
  57. daemon  programs  are part of the pc-mail source distribution and
  58.  
  59. interface with the sendmail program.
  60.  
  61.  
  62.  
  63.  - The mail data base is located on a UNIX host;  the  user  does
  64.  
  65. all  her  work on the UNIX host; daemon programs, also running on
  66.  
  67. the UNIX host, take care of the actual message delivery. Although
  68.  
  69. a bit bizarre, this mode is very useful for software development.
  70.  
  71.  
  72.  
  73. The programs support the sending and receiving of electronic mail
  74.  
  75. only;  no  transfer  of  files by name and no message routing. In
  76.  
  77. fact, the pc side treats  each  incoming  data  file  as  a  mail
  78.  
  79. message,  irrespective  of its actual destination. The reason for
  80.  
  81. these limitations are (besides uucp security problems)  that  all
  82.  
  83. files  can be sent as mail, and that a pc does not provide multi-
  84.  
  85. user support anyway.
  86.  
  87.  
  88.  
  89. For the non-technical user there is a menu-driven shell that  au-
  90.  
  91. tomatically  invokes  various utility programs, e.g. an editor of
  92.  
  93. the user's choice for editing or  creating  messages,  a  program
  94.  
  95. that logs in on a UNIX host to exchange files and so on. Any edi-
  96.  
  97. tor that produces clean ASCII files can be used  (wordstar  files
  98.  
  99. are  also  handled correctly). Other facilities: alias data base,
  100.  
  101. batch-mode operation, a reply command, selective  suppression  of
  102.  
  103. mail header lines, and message templates.
  104.  
  105.  
  106.  
  107. More technically oriented users will want to avoid  the  interac-
  108.  
  109. tive  shell  and  use  the  mail  data  base and utility programs
  110.  
  111. directly. The necessary information can be found in the implemen-
  112.  
  113. tation documentation. In addition, almost every source file has a
  114.  
  115. built-in  manual  page.  The  latter  can  be  extracted with the
  116.  
  117. srctoman.sh shell script which uses the detab.c program; both are
  118.  
  119. provided with the pc-mail source distribution.
  120.  
  121.  
  122.  
  123. The programs have been tested with various MS-DOS versions on  XT
  124.  
  125. and  AT  clones  (using  the  MicroSoft  V4.0  C  compiler), with
  126.  
  127. Microport System-V/AT, and with PC/NFS version  3.0.  The  daemon
  128.  
  129. programs were tested under Microport System-V/AT and SunOS 4.0.3.
  130.  
  131.  
  132.  
  133. In order to run the software under UNIX one needs a library  with
  134.  
  135. the  System-V library functions (strtok(), memcpy() et al.).  The
  136.  
  137. source provides BSD-compatible  libraries  for  directory  access
  138.  
  139. within the System-V and MS-DOS environments.
  140.  
  141.  
  142.  
  143. For the interactive shell,  a  tiny  MS-DOS  termcap  library  is
  144.  
  145. provided.  It requires the ANSI.SYS driver or better. 
  146.  
  147.  
  148.  
  149. You can do anything with the source, but not ask  money  for  it,
  150.  
  151. nor  remove  references  to  the  original  authors.  Complaints,
  152.  
  153. feedback and suggestions are welcome. Flames to /dev/null.
  154.  
  155.  
  156.  
  157.     Wietse Venema    domain:    wswietse@lso.win.tue.nl
  158.  
  159.             bitnet:    wswietse@heitue5
  160.  
  161.