General Information
===================

The GNOME Password Manager - GPass for short - is a simple
application, written for the GNOME 2 desktop, that lets you manage a
collection of passwords.  The password collection is stored in an
encrypted file, protected by a master-password.

GPass is released under the GNU GPL2 licence.

Features:

    * Clean and easy-to-use user interface.
    * Quick-search facility.
    * Username and password may easily be copied to the clipboard.
    * Encryption is done using the OpenSSL cryptographics library.
    * The built-in password generator helps you generate secure passwords. 
    * You can launch a website and the associated username/passwords
      direct from GPass

Basic Installation
============

  $ ./configure
  $ make
  # make install

For more information see `INSTALL'.

Usage
============
To run the application open a terminal window and enter gpass as a
command

  $ gpass

The first time the application runs it will ask you to create a master
password. After this everytime you run GPass it will first ask you for
this master password before opening.

CAUTION: There is also the gpasswd command. This is the standard linux
command to change the group password


The part of the GPass application that creates the passwords is the
Attribute editor. You open this by the following way.
* pressing <Ins> on you keyboard
* using the add icon from the toolbar
* using the add submenu in edit menu
 
1. Folders

To manage your passwords you can organize them in folders.  To create
a folder open the Attribute editor. The first element is Type. Here
you can choose between General to create a pasword or Folder to create
a folder.

Select Folder and enter the name of the folder in Name. You can also
add a brief description.  When you want to have this folder expired at
some time, select Yes at Expiration and enter a date and time for this
folder to expire. Click OK to store the folder.

Repeat this to create the folders that you need.

2. Passwords

To create a password open the Attribute editor. Select General as
Type. Enter the name that you want to file this password under and
enter a brief description. When you want this folder to expire at some
time, select Yes at Expiration and enter a date and time for this
password to expire.

The next step is to enter the username and password that you want to
store in GPass. You have the choice to enter the password or have
GPass generate it for you. Click on Generate to open the password
generation window.

Select the length of the password here and the construction details of
the password such as using a mix of numbers, lower and uppercase
charachters ans special characters. Click on generate to create the
password. Click OK to close the Password Generator window. The
generated password is copied to the Attribute editor.

If you want to be able to go to a website or FTP site and have the
username and password entered automatically, please enter the site
details at Hostname. Click OK to store the password.

Repeat this to create all the username/passwords that you need.

3. Moving folders and passwords

(TODO)