  GnuPG for RISC OS
  =================


  Installation
  ------------

  Please copy the !GnuPG application  anywhere you like, but it's  absolutely
necessary that you copy it  to a file system that  is able to cope with  long
file names. That  is an E+ formatted  medium for RISC OS  4 (and later) or  a
raFS or LongFiles partition for older versions of  RISC OS. Please note, that
in order to  use GnuPG without  problems, your !Scrap folder  has to be  on a
file system that is able to cope with long file names as well! Then make sure
that the application  has been seen by  the filer or has been  run before you
use gpg.  Otherwise it can't be found  and you will get an  error message. In
order to let the filer "see" the application during startup of your computer,
do the following:

  RISC OS  4: Open  the root  directory of  your hard  disc. Double-click  on
!Boot. Then  click on "Boot"  and then  on "Look  at". Now you  should see  a
window with a list pane. Drag the !GnuPG application here.  Now close all the
open windows by clicking on the "Set" button.

  Older versions  of RISC  OS: Create  an Obey  file named  "GnuPG" with  the
following content ...

    Filer_Boot <path_where_you_copied_!GnuPG>
    
... and save this Obey file into the Choices:Boot.Tasks directory.

  In the !GnuPGUser application all your user data is stored (e.g. by default
your secret key is  stored there as well!).  So it is your responsibility  to
keep it in a safe place. This application must have been seen by the filer or
been run before  usage as well. If you  want to keep multiple  different user
data sets, then just copy this application into different sub-directories (or
wherever  you like)  and double-click  on  the one  you want  to use,  before
calling GnuPG. If you want it to be  "seen" by the filer at startup, refer to
the paragraph above explaining how to do it with !GnuPG and do the same steps
substituting "GnuPG" with "GnuPGUser".

  In order  to  run  GnuPG  you  need  the 32-bit  Shared  C  Library  and  a
sufficiently recent version of the  Shared Unix Library. On my GnuPG  page at
(http://www.sbellon.de/gnupg.html)  are links  to  both dependencies.  Please
download them from  there if you haven't already  done so. You have  to merge
the  !System directories  of those  downloads with  your copy  of !System.  I
strongly advise using an automated tool to do this merge. On machines running
a new  style boot  sequence run !Boot,  click on  the System icon  and follow
instructions.  For  other machines  use !SysMerge  (or  install the  new boot
sequence).

  NOTE:  With the  standard  binary  distribution  I  include  the  following
algorithms:

  Pubkey: RSA, RSA-E, RSA-S, ELG-E, DSA
  Cipher: 3DES, CAST5, BLOWFISH, AES, AES192, AES256, TWOFISH
  Hash: MD5, SHA1, RIPEMD160, SHA256, SHA384, SHA512, SHA224
  Compression: Uncompressed, ZIP, ZLIB, BZIP2

  PGP 2.x used another algorithm called IDEA which is patented. That's  why I
can't include it in  the distribution as the  GPL doesn't allow this. If  you
have to maintain compatibility with old PGP 2.x keys, then you either have to
download the  source archive and  compile your own  version of  GnuPG (you'll
need Acorn C/C++ and UnixLib for this) or download the partially linked GnuPG
archived and the IDEA archive  and follow the instructions given inside those
archives.


  Usage
  -----

  For details of how to use GnuPG, please refer to the supplied documentation
(in the "orig_docs" directory) or download additional manuals and  help files
from http://www.gnupg.org/docs.html  which are  available  in many  different
languages.

  Especially for people  who have used PGP  2.x in the  past, I recommend  to
read pgp2x/html  which I've included  in the  "orig_docs" directory. Part  of
this file is outdated as it's now easier with the --pgp2  switch, but still I
left the file there for information purposes.

  Please note that this !GnuPG application has no graphical  front-end. GnuPG
is a  command line  utility. The  commercial email/news  readers Pluto  (from
version 2.03e onwards) and Messenger Pro (in version 2.50 in beta quality and
from version 2.60  onwards in release  quality) have GnuPG support  built in.
There's however currently no GnuPG stand-alone front-end.

  Finally I want to give  you a few hints to  start with, so that you're  not
completely lost when facing this port of GnuPG:

  * If you want a quick help of what commands are possible, just type in some
    of the following:

      gpg --help
      gpg -h
    
    This doesn't show  all possible commands.  To see really all of them, but
    without any explanation, do
    
      gpg --dump-options
    
  * If you start gpg without *any* further command line argument,  gpg starts
    in standard input mode. This is useful if you want to pipe things through
    gpg.  If this doesn't make  sense to you, don't worry, you  won't need to
    use this.  Just remember it when  you forgot to specify some command.  In
    this case, just press escape and correct your command line.

  * For maximum interoperability with PGP 2.x and PGP 6.x versions, there are
    now switches --pgp2 and --pgp6 which set all necessary options.

  One final word: Please have a look at the file !GnuPGUser.gpg/conf in which
all your  user  settings and  preferences  are stored.  I have  included  the
default configuration  that comes with  GnuPG apart from  a few changes  that
were necessary  because of  RISC OS  integration. Please  look at every  line
*carefully*  and decide  whether you  need it  or whether  you should  better
comment it out!


  Thanks
  ------

  I want to  thank especially the  following people  (in order of  appearance
during the project):

  * Florian Braun for motivating me to write the port by repeatedly sending
    me PGP 5 encrypted mails! ;-)
  * Werner Koch (the original author of GnuPG) for GnuPG itself and his
    help regarding understanding his code.
  * David Shaw for his help and interest in making a lot of GnuPG code
    work on RISC OS as well.
  * Stewart Brodie. He helped me with some Norcroft C problems I had.
  * Erik Thiele for general assistance with C code nasties.
  * Nick Burrett, who answered a lot of questions concerning UnixLib.
  * Nicholas Clark, who also helped me with UnixLib.
  * Theo Markettos for the permission to use his CryptRandom module.
  * Nat Queen for testing and correcting bugs in the documentation.
  * Vincent Lefevre who spotted a nasty bug when testing.
  * David Pilling for giving me a small, but important hint.
  * Andreas Dehmel for general assistance with C code and linking nasties.
  * Darren Salt for doing some optimized assembler routines.
  * various other peoples for testing.

  Thanks to all of you! :-)


  Licence
  -------

  As GnuPG is placed under  the GPL, please refer to the COPYING  file inside
the "orig_docs" directory.

  Have fun and a good privacy with GnuPG! :-)


-- 
  Stefan Bellon * <mailto:sbellon@sbellon.de> * <http://www.sbellon.de/>
