
                             ============
                               GnuPG wimp
                             Version 1.01
                             ============

                          Harriet Bazley, 2007

                    Reverse-engineered from PGPwimp
                          Peter Gaunt, 1993

                     ----------------------------
    This application is in the Public Domain and may be freely
    distributed provided

      a) no charge is made other than to cover the cost of the medium
      b) all files, including this !Help file, are included
      c) both the original authors' credits are retained


               Copyright remains with the authors at all times.
                     ----------------------------

This application provides a wimp front end to the GnuPG program converted for
RISC OS by Stefan Bellon. Access is provided to what are probably
the most commonly used aspects of the program. Commands which cannot be
explicitly set up by the program can also be entered.

Once GnuPG issues a command GnuPG will run it in either a command window or in
a task window (you decide which). Until someone converts GnuPG for the
wimp properly then this sort of program will have to suffice...

GnuPGwimp has been tested with GnuPG version 1.4.3.

    **** This program can only be run under RISC OS 3.10 or later. ****


Setting up the computer
=======================

Before the program can be used the following situation must apply -

  (i)  the original !GnuPG application must have been "seen" by the wimp

  (ii) the !GnuPGUser application must have been "seen" by the wimp

  (iii) the computer's Next slot (in the Task manager) must have been
  increased from its factory default of 640K up to around 1000K - GnuPG
  commands require more memory than some of us are used to!

Using GnuPG wimp
==============

Running !GnuPGwimp opens a window containing a number of buttons.

All commands are issued to GnuPG wimp via an intermediate file containing
a GnuPG command. This is stored within !GnuPGwimp and deleted when it's
finished with.

The command can be run either within a command window or withing a task
window. Running in a command window is quicker but doesn't multitask and
sometimes text scrolls off the top before it can be read. Which one to use
can be set via the "Task" option button at the top right of the window.

We'll deal with the window first.

Dropping a file into the window enters its leaf name into the "file" icon.

The "Action" icon determines what will be done with the file. Click the arrow
icon next to the Action icon to open a small menu of options -

"Encrypt" - the file will be encrypted. The other options in the window
determine the recipient's user ID (as stored in your public key file), whether
the file will be signed, whether it will be signed with one of your secret
keys, whether it will be converted into an "ASCII Armour" file and its file
name.

"Decrypt" - the program will ask GnuPG to attempt to decrypt the file.

"Sign" - allows you to sign an existing file. You can choose whether the
output file will be binary, an "ASCII Armour" file or a "Text file". If
"Text file" is selected then the output file will be unchanged except for
the addition of the signature and a header provided the input file is pure
text. If the input file is not pure text when "Text file" is selected then
GnuPG notices this and saves an ASCII Armour file instead.

"Armour" - allows you to convert an existing file to ASCII Armour format.
Note that if you wish to both sign an existing file and convert it to ASCII
Armour format you should choose the "Sign" option and set the output file
type to "Armour"

"Add keys" - asks GnuPG to add any keys contained in the file to your keyring.

Menu options
============

Click "menu" anywhere over the window to open the menu.

File action
-----------
This option leads to a menu which simply duplicates the menu available via
the arrow icon next to the Action icon.


Edit
----
Edit key    - type the name of the key you want to edit into the writeable icon.
              This option is useful both for editing your own keys and the trust
              parameters of the keys in your public keyring. Using this option
              will take you to a ">Command" prompt, which expects you to type
              a command to indicate what you want to do to this key: type
              "help" to display the 'menu' of GnuPG options for manipulating
              your keyring.

Remove key  - type the name of the key you want to delete into the writeable
              icon.

Certify key - Use this option to certify one of the keys on your public key
              ring. Type the name of the key you want to certify into the
              User ID icon. If you want to certify the key with anything
              other than your default signature, select the radio button next
              to the writeable icon in the Signature box and type in the
              signature name.

Make key    - Allows you to generate a new key.


View
----
View key    - Type the name of the key you want to look at into the box

View all keys-Lists all the keys on your keyring

Fingerprint - To look at a key's fingerprint, type the ID into the box

All fingerprints - List the fingerprints of all the keys on your keyring


Extract
-------
Allows you to extract a key as either a binary or ASCII Armour file, so that
it can be given to someone else. Type the Key ID into the Key ID box and a file
name into the filename box.


Command
-------
Allows you to issue any GnuPG command not available elsewhere in the program.
Type the command into the box. There is no need to start the command with
"gpg" (though it doesn't matter if you do).


Help
----
Runs GnuPG's "Help" file listing all the commands.



The program can be set up so that it always defaults to either "command window"
or "task window" mode. This is done by altering a parameter in the !Run file.
The line which runs "!RunImage" can take a final parameter of "-Task" or
"-Command". Like this ----

either
  RUN <GnuPGFE$Dir>.!RunImage -Task
or
  RUN <GnuPGFE$Dir>.!RunImage -Command




If you experience any problems with this application please feel free
to contact me via email:   harriet@bazleyfamily.co.uk

