home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume10 / pcmail2 / part11 < prev    next >
Text File  |  1990-01-24  |  28KB  |  673 lines

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