pwman3/docs/source/configuration.rst

Configuring Pwman3
================== 

By default Pwman3 will read the configuration file from the following path::

    ~/.pwman/config 

This is the ``PWMAN_CONFIG`` following. 

You can override this by giving the ``-c <Config File>`` at the commnad line 
when starting Pwman3. 

The configuration file has the following structure::

    [Section]
    Option = Value

The following is an example default config file::
    
    [Readline]
    history = <PWMAN_CONFIG>/history

    [Global]
    save = True
    colors = yes
    cp_timeout = 5
    umask = 0100
    cls_timeout = 10
    xsel = /usr/bin/xsel

    [Database]
    type = SQLite
    filename = <PWMAN_CONFIG>/pwman.db
    

Following is a table describing the parameters and their meaning:


    ===========   ===========
    **Section**   *Readline* 
    -----------   -----------
                  *Global*
    history       path to the file containing history of commands typed
    -----------   -----------
    **Section**   *Global* 
    -----------   -----------
    save          True or False - whether the Configuring file should be saved
    -----------   -----------
    colors        yes or no - If set to *no*, no colors used in output. This is useful for breil terminals. 
    -----------   -----------
    cp_timeout    Number of seconds before the clipboard is erased.
    -----------   -----------
    cls_timeout   Number of seconds before the screen is clean after a print.
    -----------   -----------
    umask         The umask in which database files are written.
    -----------   -----------
    xsel          path to the xsel binary (Linux\BSD only) 
    -----------   -----------
    **Section**   *Database* 
    -----------   -----------
    type          SQLite (future versions will re-include support for MySQL and PostGRESQL)
    -----------   -----------
    filename      path to the SQLite Database file 
    ===========   ===========