home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 26 / CD_ASCQ_26_1295.iso / vrac / pgpw121a.zip / PGPWAVE.DOC < prev    next >
Text File  |  1995-08-15  |  17KB  |  372 lines
  1.  
  2. ▄████████▄  ▄██████▄ ▄████████▄    ▄█▄   ▄█▄  ▄█████▄  ▄██▄  ▄██▄ ▄███████▄
  3. ███▀   ▀██ ███▀   ▀▀ ███▀   ▀██    ███   ███ ███▀▀▀███ ████  ████ ███    ▀▀
  4. ███▄   ▄██ ███  ▄▄▄  ███▄   ▄██    ███   ███ ███▄▄▄███ ████  ████ ███▄▄▄▄▄
  5. █████████▀ ███  ▀▀██ █████████▀    ███▄█▄███ █████████ ▀███▄▄███▀ ███▀▀▀▀▀
  6. ████       ████▄▄▄██ ████          █████████ ███   ███  ▀██████▀  ███    ▄▄
  7. ▀██▀        ▀██████▀ ▀██▀           ▀█▀ ▀█▀  ▀█▀   ▀█▀    ▀██▀    ▀███████▀
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                                     by John Stephenson
  20.                                                     v1.21a Gamma
  21.                                                     Copyright 1994-95
  22.  
  23.  
  24.  
  25. Licence:
  26.  
  27.   Use at your own risk. This software is conditional freeware. There is 
  28.   absolutely no charge on it for NONCOMMERCIAL uses, the unregistered 
  29.   COMMERCIAL use of this program is strictly disallowed except for
  30.   evaluation of up to and NOT EXCEEDING 30 days. After 30 days the usage
  31.   of this program for COMMERCIAL purposes violates this licence, and
  32.   therefore your right to use this program.
  33.   
  34.   You are a NONCOMMERCIAL user only if you are using PGPWave as a 
  35.   private individual with no "sponsors", "backers", and only if your 
  36.   use is not making (helping to make, or intended to make) you or any 
  37.   affiliates a profit.
  38.  
  39.   You are a COMMERCIAL user if PGPWave is run by (or for) any 
  40.   corporation, government, foundation, company, or any other 
  41.   organization.
  42.   
  43.   If you qualify as a COMMERCIAL user please see ORDER.FRM detailing
  44.   the cost of registration.
  45.   
  46.     Once I receive the letter with the correct funds, I will then send you 
  47.     a small notice stating you are a registered user, along with a 
  48.     registration code that changes PGPWave to clearly state it is the 
  49.     commercial version. The license you receive is a SITE licence,
  50.     meaning you can run as many copies as you wish on as many machines
  51.     as you wish as so long as all machines are running under your
  52.     same organization.
  53.  
  54. Requirements:
  55.  
  56.   You will require a 8086 or above processor. A color video card is highly
  57.   recommended, monochrome is supported. PGPWave requires XMS, EMS, or enough 
  58.   available disk space to swap to disk. In memory PGPWave should take in 
  59.   between 120k and 150k of memory. (PGPWave accolates the memory on the fly, 
  60.   so it can change quite quickly, eg reading in your tagline file can steal 
  61.   quite a lot of memory for other processes)  PGPWave requires your DOS to 
  62.   be compatible with MS-DOS 3.3x+. You must also have the DOS environmental 
  63.   variables "TEMP" or "TMP", "TZ", and "PGPPATH" set correctly.
  64.  
  65. Features:
  66.  
  67.  o Smart setup program searches PATH for commonly used programs like Q-Edit,
  68.    DOS's Edit, IBM-DOS's E.EXE, Share Spell, etc and will auto-setup the
  69.    programs in PGPWave.
  70.  o Mouse support is used throughout the program
  71.  o Allows you to seamlessly add signature files to your messages! Allows
  72.    tokens. See token list for more detail.
  73.  o PGPWave will allow you to sign messages
  74.  o PGPWave will enable you to encrypt messages
  75.  o PGPWave will sign & encrypt
  76.  o PGPWave will enable you armour files and messages to a general audience 
  77.  o Will take the ___--- and turn that into a proper ------ and -!- into
  78.    --- before sending it onto PGP. That way you need not change it. (plus
  79.    remove the quote headers)
  80.  o Features a global shell to dos
  81.  o Spell Checker option
  82.  o Simple to use, easily tailored interface
  83.  o Ability to change colors to suit the environment of the calling program
  84.  o Exploding windows (what? You say that isn't a feature?!)
  85.  o PGPWave will wipe temporary files so they can't be simply unerased,
  86.    even with Nortons Unerase.
  87.  o Allows you to wipe messages if you're not satisfied with it.
  88.  o Allows you to change the message after editing, etc.
  89.  o Will allow you to simply interface with the program when possible instead
  90.    of PGP's slightly archaic interface. (eg, typing in the name to encrypt
  91.    from the interface (capitalizing as you go))
  92.  o Nice configuration (all completely menu driven)
  93.  o Swapping to disk, XMS and EMS memory (whatever's up for grabs)
  94.  o Tagline support, supports comments in tagline file using semicolons as first
  95.    characters! Plus allows you to "steal" a tagline (from view message) Also
  96.    allows you to use automatic tagline features. Plus there's alternate
  97.    tagline file support, along with tokenized support!
  98.  o View the message before you send it out to the calling application.
  99.  o Screen saver
  100.  o Export a key, or your entire key ring to the end of the message. Very
  101.    simple to use.
  102.  o Encrypt, and sign and encrypt to multiple people with ease using easy
  103.    to setup and maintain group encryptions or manually!
  104.  o Use multiple private keys.
  105.  o Nice extended info screen.
  106.  o Hot key support in the menu interface.
  107.  o 50 column mode aware. (in fact it's also 25, 28, 43, 58 & 60 column
  108.    mode aware, plus any other "standard" modes)
  109.  o You can edit your taglines, and save them easily.. when you're picking
  110.    them. So you can write & save a custom tagline.
  111.  o Key management utilities
  112.  o Much much more.
  113.  o It's fun! It's *free*!
  114.  o It's got a nice feel, and nice default colour choices :)
  115.  o It's Canadian! (what? You say that isn't a feature?!)
  116.  
  117. Tokens
  118. ~~~~~~
  119. Tokens are little markers saying for PGPWave to replace the tokens
  120. with special text. Tokens will work when passing filenames, or in your
  121. signature file, or taglines. They are simply an @ symbol followed by
  122. a single letter. Here is a listing of the tokens:
  123.  
  124.  @F - Message filename
  125.  @T - Current time
  126.  @D - Current date
  127.  @P - Product name (in the case of a COMMERCIAL version it will report
  128.       "PGPWave/commercial")
  129.  @U - Will return your name
  130.  @V - Current version of PGPWave
  131.  @R - Current release of PGPWave
  132.  @A - Current author of PGPWave
  133.  @@ - One at sign (@)
  134.  
  135. Taglines
  136. ~~~~~~~~
  137. The tagline file consists a list of single-lined taglines without the
  138. three dots that PGPWave will insert.  There are two special tokens,
  139. [altlist] and [comment] that can be used in your tagline list. If
  140. you use [comment] pgpwave will highlight the text following the tagline
  141. token, and not allow it to be selected as a tagline. If you use [altlist]
  142. PGPWave will highlight that (with a different color) and when you select
  143. it, it will will load that file, if you do not wish the file name to
  144. be displayed, but rather a name that describes what's in the file, then
  145. simply put after the end of the line the comment.
  146.  
  147. Eg:
  148.  
  149. [comment]Alternate tagline lists
  150. [altlist]C:\Bwave\Sex.Tag Sex taglines
  151. [altlist]C:\Bwave\Tom.Tag Tom Swift taglines
  152. [altlist]C:\Bwave\Oxymoron.Tag Oxymoron taglines
  153. [altlist]C:\Bwave\Blondes.Tag Blonde joke taglines
  154. [altlist]C:\Bwave\Confucius.tag Confucius sayings taglines
  155.  
  156. And instead of the path being shown, only the comment will. With BlueWave
  157. it will still be able to utilize this, but the path will be shown along
  158. with the comment. In a few regards, PGPWave's tagline ability is much
  159. stronger and easier to use than Bluewave's.
  160.  
  161. There are also many other commands to manipulate your taglines, see the
  162. help from the tagline selection box for more detail.
  163.  
  164. The tokens listed in the section entitled "Tokens" will work with the
  165. taglines themselves, and will be translated and written to your message.
  166.  
  167. Signatures
  168. ~~~~~~~~~~
  169. Signatures in PGPWave are exceedingly easy to use. A signature is a 
  170. small amount of text that is automatically added to each of your 
  171. messages you write. The signature is simply a small text file, but
  172. with PGPWave this can get a little bit more confusing because it
  173. has a lot of power in it.
  174.  
  175. An example signature would be:
  176.  
  177. -------------------------- C:\PGP\PGPWAVE\MY.SIG -----------------------------
  178.  
  179.                                                                   - DarkFire
  180.  
  181. [@U (DarkFire), Fingerprint: 66BE3A3B6EEE9A5B-48001A32901ECA21]
  182. [Composed at @T on @D using @P v@V @R]
  183. ------------------------------------------------------------------------------
  184.  
  185. Notice the tokens? They are translated when the signature is put on to
  186. the message (see "Tokens" in this manual for further information). (The
  187. signature must contain one line without a token! This is quite important,
  188. or PGPWave will not be able to autodetect if there is a signature already
  189. there!)
  190.  
  191. Now, go into the setup, and switch on "Add signature to every message",
  192. and also setup the signature filename.
  193.  
  194. Now that's the most simple way to use signatures, however, if at different
  195. times you need different signatures here is what you do:
  196.  
  197. In your signature file you can have it setup like this:
  198.  
  199. [comment]These are my signatures:
  200. [altsig]C:\PGP\PGPWAVE\NIN.SIG Nine Inch Nails conference
  201. [altsig]C:\PGP\PGPWAVE\TAGLINE.SIG Tagline conference signature
  202. [altsig]C:\PGP\PGPWAVE\NORMAL.SIG Normal signature
  203. [altsig]C:\PGP\PGPWAVE\OTHER.SIG Other signature file
  204.  
  205. The [comment] token works just like the tagline area comment token, and
  206. so does the [altsig] work in the same manner as [altlist]. The text
  207. after the filename is optional, and it's only purpose is to replace
  208. the filename as a description.  Now when you exit, you'll receive a popup
  209. menu to select which of the possible signature is the one you wish to use.
  210. If you don't wish to use any of them, hit escape, if you do, go to it
  211. and hit enter.
  212.  
  213. Questions & Answers:
  214.  
  215. Q: How Do I use it?
  216.  
  217. A: Simple. Install it into C:\PGP\PGPWAVE\, or a similar directory
  218.    In your offline reader configuration where you have your normal editor
  219.    (eg "C:\DOS\EDIT.COM @F") replace with: "C:\PGP\PGPWAVE\PGPWAVE.EXE @F"
  220.  
  221.    Also you might have to have swapping enabled for the editor (in the setup
  222.    under "swapping"), since PGP requires a *lot* of memory to correctly
  223.    operate. But, try without swapping first.  (Generally if you have 600k of
  224.    ram free you won't need to swap)  Also note that you may have to toy
  225.    around with the paths in the setup options, but PGPWave makes the
  226.    best efforts to automatically find the applications it requires.
  227.  
  228.    NOTE: If you're not using the PGPPATH and TEMP (or TMP) environmental
  229.          variables you must set them.
  230.  
  231.    Examples are: Set TEMP=C:\TEMP
  232.                  Set TEMP=D:\
  233.                  Set PGPPATH=C:\PGP
  234.                  Set PGPPATH=C:\UTILS\PGP
  235.  
  236.    You of course must set it to the correct directories.
  237.  
  238. Q: Then what do I do?
  239. A: Download a Qwk packet (or Bluewave<tm> packet) and enter some mail where
  240.    ever you wish. Hit "E" for enter or "R" for reply. Now the PGPWave will
  241.    appear, choose either post a key, or use the editor. You can use the arrow
  242.    keys, home, end, page down, and page up or your mouse.
  243.  
  244. Q: Okay, I've written my message in my editor (or chosen post a key, or
  245.    some other choice), now what should I do?
  246. A: Save it, then (if you wish) spell check it. Then if you feel appropriate
  247.    go to Sign, Encrypt, or Sign & Encrypt. Or simply save it if you don't want
  248.    to use any pgp features on the message.  To view the message that you've
  249.    signed (or key that you've posted) choose Editor again, and maybe add some
  250.    text to it if you feel that you should explain it some more (eg whether
  251.    it's a key etc)
  252.  
  253. Q: Now..?
  254. A: Choose save and exit (or abort and exit. Note: Abort will wipe the
  255.    message file, and will not be entered in your application, nor will
  256.    it be able to be possibly recovered)
  257.  
  258. Q: Is this software really free when I see other shareware marked as high
  259.    as $35 (and above)?
  260. A: Yes. You can use (and abuse) this software for any NONCOMMERCIAL
  261.    purpose. If you wish to see any customizations for yourself (eg new
  262.    features (that would not be suitable for every ones use), different
  263.    options, different handling) see ORDER.FRM for the form to send me,
  264.    and in the additional information detail the specific aspects for
  265.    you. I may not be able to design the features you may require, so I
  266.    recommend you send me netmail or a voice phone call telling me about
  267.    what you wish to see added for your specific purpose. Once the changes
  268.    are complete, I will send the finished program to you ASAP.
  269.  
  270. Q: Is the source code available, if so, is it available for free?
  271. A: Yes, no. Full source code is available for a small amount of money.
  272.    (see ORDER.FRM) I believe in not charging for the use of this work,
  273.    in the spirit of PGP, but I can't justify releasing the source code
  274.    to the application. In case you're wondering, PGPWave is written
  275.    using Borland Pascal v7.0.
  276.  
  277. Q: I'm sick of typing yes to save etc, is there a better way?
  278. A: Yes. Hit escape twice at the main menu. This will exit, then go with the
  279.    default answer to quitting (yes).
  280.  
  281. Q: Okay, I know that I can steal a tagline from Bluewave while reading the
  282.    message, but what if I see a tagline inside of the encrypted message, or
  283.    I just realize that it's actually worth stealing?
  284. A: After decrypting, or any time in fact, go to view a message then press
  285.    Alt A. Please note that there's a help screen from the view a message
  286.    in case you get stuck.
  287.  
  288. Q: My offline reader, or message reader doesn't support taglines or nice
  289.    signatures, and I really think they're neat. What should I do?
  290. A: Simple. PGPWave supports automatic tagline adding, and signatures.
  291.    Simply set the Tagline path to a file that lists one-liner taglines
  292.    without the "..." part, and then enable the "auto add tagline" in 
  293.    the setup menu to "yes". When you're finished with a message you simply 
  294.    exit as usual and it will come up with a tagline prompt. If you do 
  295.    not wish to use taglines, then hit escape, else move to the tagline
  296.    you wish using your arrow keys, then select with enter, or space. 
  297.    If you wish to randomly choose a tagline, then use F8, or F9. F9
  298.    will randomly choose a tagline for you without confirmation. F8
  299.    will just jump to a random tagline, but not select it. F10 allows
  300.    you to make up your own tagline, the default for F10 will be the
  301.    current tagline, ie if you just wish to modify it.
  302.     
  303. Q: I get to a string prompt, and there's a default there. I don't wish
  304.    to hold down my backspace key because that time will be time lost off
  305.    of my life. What can I possibly do?
  306. A: With all input fields, Control Y will clear the field instantly.
  307.  
  308. Q: Can PGPWave be used with anything other than Bluewave?
  309. A: Yes. I've personally seen it work with other msg utilities, eg GoldEd and
  310.    the BBS Maximus (in fact I run it with Maximus for local logins), and every
  311.    offline reader that allows an external text editor can use this.  Plus it
  312.    will allow you to add taglines etc if the offline read you're using doesn't
  313.    support them. The colours are also customizable.
  314.  
  315. Q: Okay, this is great software, I understand that it's freeware, but is there
  316.    anything I can do to help you out if I'm not a COMMERCIAL user?
  317. A: Actually no, but next Christmas if you see a salvation army donation pot
  318.    please drop in a dollar. Consider it a donation of good faith, and no..
  319.    I don't believe in God, but I think it's an excellent charity.
  320.  
  321. Q: So now what?
  322. A: Enjoy it you fool! :-)
  323.  
  324.    My support BBS is:
  325.  
  326.        Systematic Decline
  327.        1:249/126.0
  328.        613-354-4295
  329.        Napanee, Ontario
  330.        Canada.
  331.  
  332.    The latest version of PGPWave is also usually available from this BBS:
  333.  
  334.      Rights On!
  335.      1:374/14.0
  336.      407-383-1372
  337.      Titusville, Florida
  338.      USA.
  339.  
  340.    PGPWave on all three systems can be file requested as "PGPWAVE". The
  341.    filenaming convention is: "PGPWxxxy.ZIP" (where xxx is the version, y
  342.    is the release) All three systems either have Guest accounts, or
  343.    first time downloads. Please read over the intro screens of each BBS
  344.    to see if a Guest account is setup.
  345.  
  346.    To reach me, send me Netmail to Systematic Decline, if that's not an
  347.    option you can call directly and leave mail to me.
  348.  
  349.    If it's an emergency (note the word just before the left bracket again),
  350.    you can give me a ring at 613-542-1239 (houseline) I will not accept 
  351.    collect calls (just remember this is a freeware product..), and if it's 
  352.    a serious enough bug I should be able to have a bug fix available within 
  353.    a week, possibly sooner. Commercial users will have precedence over 
  354.    freeware users.
  355.  
  356.    I also have a mailing address:
  357.  
  358.      John Stephenson
  359.      Po Box 1573
  360.      Kingston, Ont
  361.      Canada, K7L 5C8
  362.  
  363. Due recognition: To Ralf Brown for writing Spawno (Pascal implementation)
  364.  
  365. Copyright 1994,1995.
  366.  
  367. Revisions dating from Sunday August 21st 1994 to Saturday July 8th 1995.
  368.  
  369.                                                                   - DarkFire
  370.  
  371. John Stephenson (DarkFire), Fingerprint: 66BE3A3B6EEE9A5B-48001A32901ECA21
  372.