home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / files / k / pgp / ReadNews / ReadMe
Encoding:
PGP Message  |  1993-05-05  |  4.3 KB  |  114 lines
  1. -----BEGIN PGP SIGNED MESSAGE-----
  2.  
  3. The contents of this archive integrate PGP with ReadNews.
  4.  
  5. Version 1.1, 05-Mar-1993.
  6.  
  7.  
  8. This file, the scripts and the BASIC program are copyright Paul L. Allen,
  9. 1993, all rights reserved.  You may copy this archive and pass it on provided
  10. that no changes are made, and that you do not charge any money for doing so.
  11.  
  12.  
  13. Installation
  14. ============
  15.  
  16. Copy the scripts in !NewsDir.Scripts.  Note that if ReadNews is already
  17. installed it won't be able to find them - you'll have to quit and restart it.
  18.  
  19. Copy Library.split_msg to wherever you put the library files that came with
  20. ReadNews (uud, uue and uux).
  21.  
  22.  
  23. Scripts available
  24. =================
  25.  
  26.     PGPaddkey   Adds the public key in the current article to your public
  27.                 keyring
  28.     PGPchk-sig  Checks the signature on the current article
  29.     PGPdecrypt  Decrypts the current article, and appends the cleartext to
  30.                 the end of the article
  31.     PGPencrypt  Signs and encrypts a message
  32.     PGPsign     Signs a cleartext message
  33.     PGPview     Decrypts the current article and shows the cleartext in an
  34.                 edit window.
  35.  
  36.  
  37. Usage
  38. =====
  39.  
  40. Make sure that !PGP has been seen by the filer before you try and use any
  41. of these scripts, or the script will complain that the !PGP application
  42. has not been seen.
  43.  
  44. Bring up the ReadNews main menu, and you will see a Script entry - follow
  45. the arrow and click on the appropriate entry.  Note that PGP is run in a
  46. CLI window, so there is no multitasking.
  47.  
  48. PGPaddkey, PGPchk-sig, PGPdecrypt and PGPview all apply to the current
  49. article - when you select them, the article is processed without further
  50. intervention (other than asking for your passphrase where necessary).
  51.  
  52. PGPencrypt and PGPsign apply to a message that you are about to mail or post
  53. (usually you sign news and either sign or encrypt mail).  Create a message
  54. (mail or news, original or reply) in the normal way.  When you are satisfied
  55. with your message, click on the appropriate script entry.  A dialogue box
  56. will appear: bring up the save box on your edit window and save the message
  57. to the script's dialogue box.  If you're encrypting, you must then enter
  58. the recipient(s) by hand (see below).  Then click on the `OK' button and the
  59. message will be encrypted and sent.
  60.  
  61.  
  62. Notes
  63. =====
  64.  
  65. Temporary files are used for decrypted text, so even though they're
  66. deleted after use, PGPview will still leave sensitive data on your disc
  67. which may be recoverable with a disc editor until the filing system re-uses
  68. the relevant sectors.  You have been warned.
  69.  
  70. The reason PGPencrypt wants you to enter the recipient(s) yourself is because
  71. mail expects a comma-separated list of recipients and PGP can't cope with
  72. that.  Although it would be possible to take the recipients from the mail
  73. header and convert the format with an external program, there appears to be
  74. no way to pass this information back to the ReadNews script so it can invoke
  75. PGP automatically.  Yes, I know ReadNews scripts can handle environmental
  76. variables, but not if you want to display the contents in a dialogue box
  77. (which is vital so the user can tweak the list if necessary).
  78.  
  79. PGPdecrypt appends the cleartext to the current article rather than replacing
  80. the encrypted text for a number of reasons:
  81.   1) If something goes wrong, you don't lose the original.
  82.   2) The original may consist of an encrypted portion and an unencrypted
  83.      portion.
  84.   3) You may want to retain the original so you can later prove its validity
  85.      to a third party from the digital signature.
  86.  
  87. PGPencrypt and PGPsign will not complain about !PGP not having been seen
  88. until *after* you click on OK button of the dialogue box - this is due to
  89. an annoying misfeature of the script language.
  90.  
  91.  
  92. Revision History
  93. ================
  94.  
  95. Version 1, 11-Apr-1993
  96.     Initial release.
  97.  
  98. Version 1.1, 05-Mar-1993
  99.     Scripts modified to check if PGPpath variable has been seen, and abort
  100.     with an error message if not - this avoids having PGP fire up only to
  101.     complain that it cannot find the public key file.
  102.  
  103.     Consequential changes to this ReadMe file.
  104.  
  105. -----BEGIN PGP SIGNATURE-----
  106. Version: 2.2
  107.  
  108. iQCVAgUBK+f6LGv14aSAK9PNAQENtgP9FYZ2Yr5NbejNF7IZ6Iz+9ScPXQ1wNNJa
  109. /2a0HLOtaUhQXks+8rQAD/RplL9Egfd2cdGIpSQTi7LAYgIue6eKTv8P2UTWrYzQ
  110. NwT3R3OKdnMrsyC74SnExPx4te9RkJWE7pFsyANl4216FId/mgrMWYO6Mwx2q70Y
  111. VMUTiDQ+Dno=
  112. =3et6
  113. -----END PGP SIGNATURE-----
  114.