home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / pc / source / pcmail2.lzh / pcmail.11 < prev    next >
Encoding:
Text File  |  1990-01-31  |  26.7 KB  |  666 lines

  1.  
  2. #! /bin/sh
  3. # This is a shell archive.  Remove anything before this line, then unpack
  4. # it by saving it into a file and typing "sh file".  To overwrite existing
  5. # files, type "sh file -c".  You can also feed this as standard input via
  6. # unshar, or by typing "sh <file", e.g..  If this archive is complete, you
  7. # will see the following message at the end:
  8. #        "End of archive 11 (of 11)."
  9. # Contents:  main/tutorial.ms
  10. # Wrapped by wswietse@tuewsa on Mon Jan 22 17:27:22 1990
  11. PATH=/bin:/usr/bin:/usr/ucb ; export PATH
  12. if test -f main/tutorial.ms -a "${1}" != "-c" ; then 
  13.   echo shar: Will not over-write existing file \"main/tutorial.ms\"
  14. else
  15. echo shar: Extracting \"main/tutorial.ms\" \(25290 characters\)
  16. sed "s/^X//" >main/tutorial.ms <<'END_OF_main/tutorial.ms'
  17. X\" format with the ms macro library
  18. X.TL
  19. XPC-MAIL tutorial
  20. X.AU
  21. XWietse Z. Venema
  22. XMathematics and Computing Science,
  23. XEindhoven University of Technology
  24. XEindhoven, The Netherlands
  25. X.AE
  26. X.NH
  27. XWhat does this software do for you?
  28. X.LP
  29. XThis software allows you to send and receive electronic mail.  Once the
  30. Xsoftware has been configured, it can be used without any knowledge about
  31. Xcomputer networking.
  32. X.LP
  33. XThe following summarizes a few features:
  34. X.IP o
  35. XMail messages can be edited, printed, replied to, sent, and received, from
  36. Xwithin the mail program.
  37. X.IP o
  38. XMessages can be created with almost every word-processing package.
  39. X.IP o
  40. XAlmost every command can be selected by pressing a single key. There is
  41. Xa "help" facility that gives brief explanations.
  42. X.IP o
  43. XYou can set up an "alias" data base to avoid the use of the usually
  44. Xcryptical electronic mail addresses.  This facility can also be used to
  45. Ximplement small mailing lists.
  46. X.IP o
  47. XThere is a facility for personalized headers and signatures.
  48. X.LP
  49. XThe mail software does not attempt to solve every problem in this world.
  50. XIt is only fair to mention the most important limitations here:
  51. X.IP o
  52. XAny information other than pure text must be converted to text format
  53. Xbefore you can mail it to someone else (for example, programs, pictures
  54. Xand so on).  Fortunately, there exists a lot of software to aid in this
  55. Xtask.  The people that installed the mail software should be able to
  56. Xhelp you out.  
  57. X.IP o
  58. XMost electronic mail systems impose an upper limit to the size of a mail
  59. Xmessage.  This limit varies from about 60 kilobytes to about 100
  60. Xkilobytes per message.  You will have to break up larger messages; the
  61. Xmail software does not do it for you.  Normally, you should not run into
  62. Xthis limit.
  63. X.LP
  64. XInstallation of the mail software is described in various other documents.
  65. XThe remainder of this document gives an introduction to the use of the mail
  66. Xsoftware. The following gives a summary.
  67. X.LP
  68. XChapter 2, "Starting the program",
  69. Xdescribes how to invoke the program, and how to leave it.  Also gives a
  70. Xgeneral introduction to the command structure of the program.
  71. X.LP
  72. XChapter 3, "Reading new mail",
  73. Xdescribes how to take care of new mail, and what happens once you have
  74. Xread a new message.
  75. X.LP
  76. XChapter 4, "Creating a message",
  77. Xdescribes how to compose a message from scratch, and how to specify its
  78. Xdestination.
  79. X.LP
  80. XChapter 5, "Sending and receiving electronic mail",
  81. Xdescribes how to exchange messages between your machine and the rest of
  82. Xthe world.  It does not apply if your machine is connected to a "file
  83. Xserver".
  84. X.LP
  85. XChapter 6, "Alias data base",
  86. Xdescribes the use of the alias data base, and gives an example of a tiny
  87. Xmailing list.
  88. X.LP
  89. XChapter 7, "Replying to a message",
  90. Xdescribes how to compose a reply to message.
  91. X.LP
  92. XChapter 8, "Mailing other files",
  93. Xdescribes how to distribute files via electronic mail.
  94. X.LP
  95. XChapter 9, "Receiving encoded files",
  96. Xdescribes how to decode files that have been encoded with e.g. the
  97. X"\fCuuencode\fR" or "\fCbtoa\fR" programs.
  98. X.NH
  99. XStarting the program
  100. X.LP
  101. XStarting the mail program is easy; just type the command "\fCmail\fR".
  102. XYou should see a screen that looks like the one shown here:
  103. X.DS L
  104. X.ft C
  105. XClose  File  Setup  Alias  Print  Up  Down  Enter  Help ?
  106. X==========================================================
  107. XCreate       Create a new message
  108. XWork       2 Messages in preparation
  109. XNew        0 Unread messages
  110. XIn        30 Messages already read
  111. XOut        7 Messages not-yet sent
  112. XSent      20 Messages already sent
  113. X
  114. X
  115. X==========================================================
  116. XSelect a message category with cursor keys and press ENTER
  117. Xor select one of the commands in the top line.
  118. X.ft R
  119. X.DE
  120. X.LP
  121. XThe screen is divided into three horizontal regions:
  122. X.IP o
  123. XThe \fItop\fR region shows the commands that can be selected by pressing
  124. Xa single key.  Some of these commands are selected by pressing a
  125. Xfunction key with the same name as the command; for example, the
  126. X\fCUp\fR or \fCDown\fR commands are selected by pressing the
  127. Xcorresponding arrow key.  Other commands are selected by typing the
  128. Xfirst letter of that command; for example, the \fCH\fR key selects the
  129. X"\fCHelp\fR" command; it gives a brief description of what the other
  130. Xcommands do.
  131. X.IP o
  132. XThe \fImiddle\fR region shows various categories of mail messages.  You
  133. Xmight think of it as a collection of boxes with letters.  For example,
  134. Xthe "\fCNew\fR" box is for messages that you haven\'t read yet, and the
  135. X"\fCOut\fR" box is for messages that you wrote, but that have not yet been
  136. Xsent away.  The program also shows how many messages there are within a
  137. Xmessage category.
  138. X.sp
  139. XA special case is the "\fCCreate\fR" box; it is for messages you are
  140. Xgoing to write.  Think of it as a box with blank sheets of paper.
  141. X.IP o
  142. XThe \fIbottom\fR region gives an explanation of what you are supposed to
  143. Xdo when you see this screen.  In this particular case, it tells that you
  144. Xcan select one of the message categories by moving the cursor to the
  145. Xappropriate line, and by pressing the "\fCEnter\fR" key, or that you can
  146. Xgive commands by pressing the appropriate key.
  147. X.LP
  148. XYou can leave most screens by pressing the "\fCC\fR" key. In particular,
  149. Xpressing that key while the program displays the first screen is the
  150. Xpreferred way to leave the mail program.
  151. X.NH
  152. XReading new mail
  153. X.LP
  154. XDepending on how the mail software was installed on your system, you may
  155. Xhave seen a message that "\fCYou have new mail\fR" when you started
  156. Xup the machine. This section describes how to deal with new mail.
  157. X.LP
  158. XIn the display that was described above, move the cursor to the
  159. Xline with "\fCNew\fR" and press the "\fCEnter\fR" key. The program
  160. Xwill present an overview of unread messages that looks like the
  161. Xfollowing one:
  162. X.DS L
  163. X.ft C
  164. XClose  File  Setup  Alias  Print  PgUp  PgDn  Up  Down  Enter  Help ?
  165. X=====================================================================
  166. X   90  Dec 15 22:18  Wietse Venema "Re: how do I forward a message?"
  167. X   63  Dec 11 23:18  Jan Kalisvaart "File server cleanup"
  168. X    .
  169. X    .
  170. X    .
  171. X-- end of display --
  172. X
  173. X
  174. X=====================================================================
  175. XSelect a message with the cursor keys and press ENTER
  176. Xor select one of the commands in the top line.
  177. X.ft R
  178. X.DE
  179. X.LP
  180. XThe top line of the screen shows a few more commands than the screen
  181. Xdescribed earlier.  New commands, for example, are the the PgUp and PgDn
  182. Xcommands.  They are useful when information does not fit in the middle
  183. Xscreen region.
  184. X.LP
  185. XThe middle screen region shows summaries of mail messages.  Each message
  186. Xis summarized on a single line, and gives the following information:
  187. X.IP o
  188. XThe message sequence number (e.g. \fC90\fR).  Normally, you do not have
  189. Xto remember message sequence numbers, but the mail program needs them in
  190. Xorder to keep things apart.
  191. X.IP o
  192. XThe date of arrival (e.g. \fCDec 15 22:18\fR).  If a message is very
  193. Xold, the year will be displayed instead of the hours and minutes.
  194. X.IP o
  195. XThe sender of the message (e.g. \fCWietse Venema\fR).  Usually, the mail
  196. Xprogram presents a "human" name.  Every now and then, however, you may
  197. Xsee an ugly electronic mail address.
  198. X.IP o
  199. XThe subject of the message (e.g. "\fCRe:  how do I forward a
  200. Xmessage?\fR").  This allows you to decide if a message is urgent and has
  201. Xto be dealt with right away, or if the message can wait till later.
  202. X.LP
  203. XAfter you have moved the cursor to the message you want to read, and have
  204. Xpressed the "\fCEnter\fR" key, the program displays the selected message.
  205. XThe following example shows what the screen might look like.
  206. X.DS L
  207. X.ft C
  208. XClose  Delete  Mail  Print  Reply  Save  Work  |  PgUp  PgDn  Up  Down  Help ?
  209. X==============================================================================
  210. XSubject: Re: how do I forward a message?
  211. XOrganization: Eindhoven University of Technology, The Netherlands
  212. XFrom: wietse@wzv.win.tue.nl (Wietse Venema)
  213. XTo: you
  214. X
  215. XSelect the message that you wish to forward, and press the "M" (Mail)
  216. Xkey.  The program will ask for a destination. As usual, you can enter 
  217. Xan alias or a real address. This command mails a copy of the message;
  218. Xit does not change or remove the message itself.
  219. X
  220. X        Greetings,
  221. X                                Wietse Venema
  222. X-- end of display --
  223. X
  224. X==============================================================================
  225. X(Reading a mail message)
  226. X.ft R
  227. X.DE
  228. X.LP
  229. XAt this stage you may decide to do nothing with the message; just hit
  230. Xthe "\fCC\fR" key and the program returns to the last message-selection
  231. Xscreen.  Now that the message has been read it will no longer show up in
  232. Xan overview of the "\fCNew\fR" category; once a "\fCNew\fR" message has
  233. Xbeen read it goes to the "\fCIn\fR" category, and remains there until
  234. Xyou explicitly delete it.
  235. X.LP
  236. XHitting the "\fCC\fR" key once more brings us back to the beginning of
  237. Xthe program.
  238. X.NH
  239. XCreating a message
  240. X.LP
  241. XIn order to compose a message, move the cursor to the "\fCCreate a new
  242. Xmessage\fR" line in the first screen of the mail program and press the
  243. X"\fCEnter\fR" key.  After a few seconds you should see the first screens
  244. Xof the same word processor that you probably also use for other
  245. Xactivities.  Please note that the mail program has not terminated; as
  246. Xsoon as you exit from the word processor you will return back to the
  247. Xmail program.
  248. X.LP
  249. XIf all is well, your message should begin with a "\fCSubject: \fR" line.
  250. XDepending on how the mail software was set up on your machine, an
  251. X"empty" message may already contain one or more customized header lines,
  252. Xas well as a customized "signature" at the end of the message.  The
  253. Xfollowing is an "empty" message as produced on my personal system (the
  254. Xtext between square braces is not part of the "empty" message; I just
  255. Xadded it to clarify things).  
  256. X.DS L
  257. X.ft C
  258. XSubject:  [the subject of this message] 
  259. XOrganization:  Eindhoven University of Technology, The Netherlands
  260. X
  261. X[this is where the actual message goes]
  262. X
  263. X                    Wietse Venema
  264. X.ft R
  265. X.DE
  266. X.LP
  267. XIf your "empty" message contains garbage you should contact the people
  268. Xthat installed the mail software on your system.
  269. X.LP
  270. XThe message text that you are about to enter will be only part of the
  271. Xmessage that other people will receive; the mail software automatically
  272. Xprefixes each message with your own electronic mail address, and the
  273. Xcurrent date\(dg.
  274. X.FS
  275. X\(dg Your message will probably be prefixed with several additional rude
  276. Xheader lines while it passes through other machines on the way to its
  277. Xdestination. This happens outside the control of the mail software on
  278. Xyour machine.
  279. X.FE
  280. X.LP
  281. XObviously, further details about the entry of message text depend on the
  282. Xword-processing package that you are using.  Suffice to say that upon
  283. Xexit, the word processor should produce an "ASCII document" file; the
  284. Xpeople that installed the mail software on your machine should be able
  285. Xto provide more details on this topic.
  286. X.LP
  287. XUpon return from the word processor back to the mail program, you will
  288. Xsee the first few lines of your newly-composed message in the middle
  289. Xregion of the screen.  There may be "funny cookies" in your text if you
  290. Xforgot to produce an "ASCII document"; if that is the case you had
  291. Xbetter re-enter the word processor (by pressing the "\fCE\fR" key) and
  292. Xcorrect this mistake.  After this, your screen should be something like:
  293. X.LP
  294. X.DS L
  295. X.ft C
  296. XClose  Delete  Edit  Mail  Print  PgUp  PgDn  Up  Down  Help ?
  297. X==============================================================
  298. XSubject: your subject
  299. Xoptional header lines
  300. X
  301. Xyour message
  302. X-- end of display --
  303. X
  304. X
  305. X==============================================================
  306. X(Reading a message in preparation)
  307. X.ft R
  308. X.DE
  309. X.LP
  310. XWhat you see on the screen is a close approximation of what other people
  311. Xwill receive.  If this is the first time you use electronic mail you may
  312. Xwish to use the "\fCPgUp\fR" and "\fCPgDn\fR" keys to check things out.
  313. X.LP
  314. XNormally, the next step will be to mail the message to its destination,
  315. Xbut you may choose any of the other commands shown in the upper line of
  316. Xthe screen.  For example, you could choose the \"fCClose\fR" command to
  317. Xput the message "on hold"; the mail program will ask you to give a
  318. Xone-line description so that you can easily find it back at a later
  319. Xtime (it will be stored in the category "\fCMessages in preparation\fR").
  320. X.LP
  321. XIf you choose the "\fCMail\fR" command, the program will respond with:
  322. X.DS
  323. X.ft C
  324. XPress ESC to cancel. Send message to:
  325. X? 
  326. X.ft R
  327. X.DE
  328. X.LP
  329. XYou should enter one or more electronic mail addresses or aliases.  If
  330. Xwhat you wrote was just a "test" message, you might want to mail it to
  331. Xyourself.  There is nothing crazy about sending mail to yourself; many
  332. Xpeople do that instead of littering their rooms with notes on small
  333. Xpieces of paper.  Aliases are described later on, and are more easily
  334. Xremembered than real electronic mail addresses.  Your input should be
  335. Xterminated by pressing the "\fCEnter\fR" key.
  336. X.LP
  337. XAfter this, the program returns to the first screen.  The message you
  338. Xjust "mailed" will temporarily live in the category "\fCNot-yet
  339. Xsent\fR".  If your machine is connected to a "file server", it will
  340. Xautomatically be moved to the category "\fCAlready sent\fR" within a
  341. Xshort period of time. Otherwise, you should read the next section.
  342. X.NH
  343. XSending and receiving mail
  344. X.LP
  345. XThis section describes how to exchange mail messages between your
  346. Xmachine and the rest of the world. This is automatically taken
  347. Xcare of if your machine has a direct connection to a "file server". 
  348. X.LP
  349. XIf you are not connected to a "file server", most of the mail-program
  350. Xscreens will provide a "\fCNetwork\fR" command (for example, the first
  351. Xscreen).  All messages that you produce will stay on your machine, in
  352. Xthe message category "\fCNot-yet sent"\fR", until the mail software has
  353. Xsent them away through the network.  Also, messages, having your machine
  354. Xas their destination, will not arrive on your machine until the mail
  355. Xsoftware has picked them up through the network.
  356. X.LP
  357. XThe mail software may have been installed such that it, as soon as the
  358. Xmachine is turned on, automatically makes contact with the network.  In
  359. Xthat case, you do not need to invoke the "\fCNetwork\fR" command by
  360. Xhand.  It can, however, be useful if you are expecting urgent mail, or
  361. Xif you wrote a letter that should be sent away right now.
  362. X.LP
  363. XThe "\fCNetwork\fR" command is activated by pressing the "\fCN\fR" key.
  364. XThe mail program will ask for a network password (the one given to you
  365. Xby the people that installed the mail software on your machine).
  366. XTransferring mail across the network may take a few minutes.  If all
  367. Xgoes well, all messages in the message category "\fCOut\fR" will have
  368. Xmoved to the category "\fCSent\fR"; in addition, you may have received
  369. Xnew mail that will show up in the "\fCNew\fR" message category.
  370. X.NH
  371. XAlias data base
  372. X.LP
  373. XThe addresses used in electronic mail are often ugly, and hard to
  374. Xremember.  To alleviate this problem, the mail program provides an alias
  375. Xdata base facility.  This allows you to use easily-remembered names
  376. Xinstead of mail addresses; the mail program will automatically replace
  377. Xaliases by the actual mail addresses that you have specified in the
  378. Xalias data base.
  379. X.LP
  380. XThe following is an example of an alias data base:
  381. X.DS
  382. X.ft C
  383. Xwietse    wswietse@lso.win.tue.nl
  384. Xjan    wsbujank@win.tue.nl
  385. Xstaff    wietse jan
  386. X.ft R
  387. X.DE
  388. X.LP
  389. XAn alias data base has a very simple format:  each alias definition
  390. Xconsists of a single line of text with two or more words.  Words may be
  391. Xseparated by blanks or commas.  The first word is the alias; it will be
  392. Xreplaced (by the words in the remainder of the line) if the mail program
  393. Xfinds the alias in the destination of a mail message.  With the alias
  394. Xdata base shown above, the message destination "\fCwietse\fR" will be
  395. Xautomatically replaced by the destination
  396. X"\fCwswietse@lso.win.tue.nl\fR".
  397. X.LP
  398. XAn interesting property is that an alias may be defined in terms of
  399. Xother aliases; an alias may, however, not be defined in terms of itself!
  400. XIn the above example, the third line illustrates the definition of an
  401. Xalias in terms of other aliases.  The same line also is an example of
  402. Xhow to implement a small mailing list; all messages sent to
  403. X"\fCstaff\fR" will be sent to "\fCwswietse@lso.win.tue.nl\fR" and to
  404. X"\fCwsbujank@win.tue.nl\fR".  Typing the word "\fCstaff\fR" certainly is
  405. Xeasier.
  406. X.LP
  407. XThe mail program is smart enough to eliminate, after alias replacement,
  408. Xmultiple occurrances of the same destination.  Thus, you do not have to
  409. Xworry about duplicate destinations if you combine several mailing lists
  410. Xinto a bigger one.
  411. X.LP
  412. XMost mail-program screens provide the "\fCAlias\fR" command.  This
  413. Xallows you to look at the contents of your alias data base, and to
  414. Xinvoke a word processor to make changes.  The word processor should save
  415. Xthe alias data base in "ASCII document" format, just like ordinary mail
  416. Xmessages.
  417. X.LP
  418. XIt is worth noting that aliases can be defined in any order.  The above
  419. Xexample would have worked just as well if the last entry had been the
  420. Xfirst one.  Thus, you may wish to keep the alias data base in sorted
  421. Xorder.
  422. X.LP
  423. XFinally, a few caveats are in order.  If an alias is defined more than
  424. Xonce, only the last definition will be used.  Although the mail program
  425. Xdoes not care whether an alias is defined in upper case or in lower
  426. Xcase, it is wise to keep electronic mail addresses in lower case.
  427. X.NH
  428. XReplying to a message
  429. X.LP
  430. XReplying to a mail message is almost the same as creating a mail message
  431. Xfrom scratch; the main difference is that you must specify which message
  432. Xyou are replying to.
  433. X.LP
  434. XIn order to reply to a message, select it with the cursor keys and the
  435. X"\fCEnter\fR" key, so that the contents of the message become visible
  436. Xon the screen.  Pressing the "\fCR\fR" key executes the reply command. 
  437. X.LP
  438. XThe program will ask you if the reply should include a copy of the
  439. Xmessage being replied to.  Including a copy of the original message is
  440. Xconvenient if the sender asked several questions; both you and the
  441. Xrecipient of the message can see what questions you are actually
  442. Xreplying to.  In order to distinguish the text that you write from what
  443. Xthe other person wrote, the latter text will be prefixed with a ">"
  444. Xcharacter at the beginning of each line.
  445. X.LP
  446. XAfter you answered the question, the mail program will invoke a word
  447. Xprocessing program.  Most of what follows is the same as when you create
  448. Xan electronic mail message:  the mail program has not terminated, but is
  449. Xjust waiting for you to finish editing; upon exit, the word processing
  450. Xpackage should produce an "ASCII document" file; after leaving the word
  451. Xprocessing program you will return to the mail program.
  452. X.LP
  453. XAt this point, your screen should look like this:
  454. X.DS L
  455. X.ft C
  456. XClose  Delete  Edit  Mail  Print  PgUp  PgDn  Up  Down  Help ?
  457. X==============================================================
  458. XSubject: Re: The subject of the original message
  459. XOther customized header lines may go here
  460. X
  461. X>Text taken from the original message is prefixed
  462. X>to distinguished it from the text that you wrote.
  463. X
  464. XYour text
  465. X-- end of display --
  466. X
  467. X
  468. X==============================================================
  469. X(Reading a message in preparation)
  470. X.ft R
  471. X.DE
  472. X.LP
  473. XIn order to send the message, press the "\fCM\fR" key. The program will
  474. Xrespond with:
  475. X.DS
  476. X.ft C
  477. XPress ESC to cancel. Send message to:
  478. X? some-mail-address
  479. X.ft R
  480. X.DE
  481. X.LP
  482. XThe mail address shown by the program was taken from the original
  483. Xmessage and should usually be correct.  If you wish to use that address,
  484. Xjust press the "\fCEnter\fR" key.  Otherwise, the address can be changed
  485. Xin the usual way; you can specify one or more aliases or electronic mail
  486. Xaddresses.
  487. X.LP
  488. XAfter this, the message that you wrote will temporarily live in the
  489. Xmessage category "\fCNot-yet sent\fR"; if your machine is connected to a
  490. X"file server" the message will automatically be moved to the message
  491. Xcategory "\fCAlready sent\fR".  If your machine is not connected to a
  492. X"file server", read the section "Sending and receiving mail".
  493. X.NH
  494. XMailing other files
  495. X.LP
  496. XIn addition to sending files created with your word processor, the mail
  497. Xprogram provides a facility to distribute copies of other files as well.
  498. XThis feature is of limited use, however, since it only works well with
  499. Xpure text files; a file that contains non-textual data, such as a
  500. Xprogram or a picture, will have to be converted to textual form before
  501. Xthe mail program can handle it.  The mail program can, however, help you
  502. Xto find out whether a file is suitable for mailing.
  503. X.LP
  504. XMost screens of the mail program provide a "\fCFile\fR" command that can
  505. Xbe executed by pressing the "\fCF\fR" key.  After a few seconds the
  506. Xmiddle region of the screen should show a listing of the current
  507. Xdirectory.  The top region of the screen lists the commands that you can
  508. Xexecute; the bottom region of the screen shows the name of the directory
  509. Xbeing listed.  
  510. X.DS L
  511. X.ft C
  512. XClose  Print  Save  PgUp  PgDn  Up  Down  Enter  Help ?
  513. X===================================================================
  514. X\&.                        <dir> Dec 28 18:10
  515. X\&..                       <dir> Dec 27 16:36
  516. Xalias.c                   3295 Dec 12 22:41
  517. Xascf.c                    5315 Dec 23 21:16
  518. Xcall.c                    2282 Nov 30 22:08
  519. Xcmail.c                   3748 Dec 17 21:22
  520. Xcreate.c                  2176 Dec 27 18:28
  521. Xdesk.c                   12435 Dec 27 14:04
  522. Xdeskutil.c                7180 Dec 27 15:29
  523. X .
  524. X .
  525. X .
  526. X===================================================================
  527. XTo display a file, select it with the cursor keys, then press ENTER
  528. X(showing directory: "/usr2/wietse/src/pc-mail/mail")
  529. X.ft R
  530. X.DE
  531. X.LP
  532. XYou can leave the "\fCFile\fR" command at any time by
  533. Xpressing the "\fCC\fR" key once or twice.
  534. X.LP
  535. XWith the cursor keys and the PgUP and PgDn keys you can "walk" through
  536. Xthe directory listing.  Pressing the "\fCEnter\fR" key causes the
  537. Xprogram to "open" the thing being selected.  If you select a directory,
  538. Xthe program will display the contents of that directory; if you select a
  539. Xfile, the program will display the contents of that file.
  540. X.LP
  541. XIn order to mail a copy of a file, select that file with the cursor and
  542. X"\fCEnter\fR" keys so that its contents are shown on the screen.  Only
  543. Xif you see a clean text, without "funny cookies", the file is suitable
  544. Xfor mailing.  Pressing the "\fCM\fR" key executes the "\fCMail\fR"
  545. Xcommand.  It will ask for a destination, which may be one or more
  546. Xaliases or an electronic mail addresses.  Pressing "\fCEnter\fR" finishes
  547. Xthe "\fCMail\fR" command.  As usual, the message will temporarily live
  548. Xin the message category "\fCNot-yet sent\fR"; if your machine is
  549. Xconnected to a "file server" the message will automatically be moved to
  550. Xthe message category "\fCAlready sent\fR".  If your machine is not
  551. Xconnected to a "file server", read the section "Sending and receiving
  552. Xmail".
  553. X.LP
  554. XIn order to leave the "\fCFile\fR" command you may have to press the
  555. X"\fCC\fR" key once or twice.
  556. X.NH
  557. XReceiving encoded files
  558. X.LP
  559. XSometimes people send "encoded" files if they contain data that cannot
  560. Xbe sent directly as an electronic mail message. Encoded files must be
  561. Xprocessed by a "decoding" program in order to restore the original data.
  562. X.LP
  563. XThere exist various encoding methods.  Usually, the sender will provide
  564. Xsome information about the encoding method used.  In case of doubt, you
  565. Xwill have to consult a technical person.
  566. X.LP
  567. XIf a message was encoded with the "\fCuuencode\fR" program it usually
  568. Xlooks like
  569. X.DS L
  570. X.ft C
  571. Xbegin 644 tutorial.ms
  572. XM7"(@9F]R;6%T('=I=&@@=&AE(&US(&UA8W)O(&QI8G)A<GD*+E1,"E!#+4U!;
  573. XM24P@='5T;W)I86P*+D%5"E=I971S92!:+B!696YE;6$*36%T:&5M871I8W,@P
  574. XM86YD($-O;7!U=&EN9R!38VEE;F-E+`I%:6YD:&]V96X@56YI=F5R<VET>2!OJ
  575. X .
  576. X .
  577. X .
  578. X.ft
  579. X.DE
  580. X.LP
  581. XIn order to restore the original file, select the message such that
  582. Xits contents appear on the screen, and press the "\fC|\fR" key.
  583. XThe program will ask for the name of a command:
  584. X.DS L
  585. X.ft C
  586. X    Press ESC to cancel. Filter through command:
  587. X    ?
  588. X.ft
  589. X.DE
  590. X.LP
  591. XAt this point, specify the "\fCuudecode\fR" command and press the
  592. X"\fCENTER\fR" key.
  593. X.DS L
  594. X.ft C
  595. X    Press ESC to cancel. Filter through command:
  596. X    ? uudecode
  597. X.ft
  598. X.DE
  599. X.LP
  600. XThis produces, in the current working directory, a decoded file with
  601. Xthe same name as shown in the "\fCbegin\fR" line in the message (in
  602. Xthis particular example, the name would be "\fCtutorial.ms\fR").
  603. X.LP
  604. XAnother popular encoding program is "\fCbtoa\fR". If that program
  605. Xhas been used, the message looks somewhat like:
  606. X.DS L
  607. X.ft C
  608. Xxbtoa Begin
  609. X>Tt;&DfT]'F<GdAFD)e=BOr<'F!,=.@rcK1Ch[@!@<-W#/lYLO:dZg/5tO`m
  610. XqQFE;"9=tUpuASu'r@1#_;FD,6&@<?3nF!+n/A0=6XD/aW>Bl7Q+;e'NQDI[
  611. XJ=9*EcYr:Gp%$;+B2o^BPqa)DeF>&7;6XMBQ&'*DCco0BOr;]ATVTsEbo0%A
  612. X .
  613. X .
  614. X .
  615. X.ft
  616. X.DE
  617. X.LP
  618. XIn order to restore the original file, select the message such that
  619. Xits contents appear on the screen, and press the "\fC|\fR" key.
  620. XThe program will ask for the name of a command:
  621. X.DS L
  622. X.ft C
  623. X    Press ESC to cancel. Filter through command:
  624. X    ?
  625. X.ft
  626. X.DE
  627. X.LP
  628. XAt this point, specify the "\fCatob\fR" command and a file name, and
  629. Xpress the "\fCENTER\fR" key.  For example,
  630. X.DE L
  631. X.ft C
  632. X    Press ESC to cancel. Filter through command:
  633. X    ? atob >abc.def
  634. X.ft
  635. X.DE
  636. X.LP
  637. XThe "\fC>\fR" is needed or you will get the decoded data on your screen.
  638. XIf all goes well, you should now have a decoded file in your current
  639. Xworking directory (in this example, the name of the file would be
  640. X"\fCabc.def\fR").
  641. END_OF_main/tutorial.ms
  642. if test 25290 -ne `wc -c <main/tutorial.ms`; then
  643.     echo shar: \"main/tutorial.ms\" unpacked with wrong size!
  644. fi
  645. # end of overwriting check
  646. fi
  647. echo shar: End of archive 11 \(of 11\).
  648. cp /dev/null ark11isdone
  649. MISSING=""
  650. for I in 1 2 3 4 5 6 7 8 9 10 11 ; do
  651.     if test ! -f ark${I}isdone ; then
  652.     MISSING="${MISSING} ${I}"
  653.     fi
  654. done
  655. if test "${MISSING}" = "" ; then
  656.     echo You have unpacked all 11 archives.
  657.     rm -f ark[1-9]isdone ark[1-9][0-9]isdone
  658. else
  659.     echo You still need to unpack the following archives:
  660.     echo "        " ${MISSING}
  661. fi
  662. ##  End of shell archive.
  663. exit 0
  664.  
  665.  
  666.