diff -r 27e940e8e5f3 -r d64aaa7d146f as-gui.conf.pod
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/as-gui.conf.pod	Fri Nov 28 11:21:08 2008 +0100
@@ -0,0 +1,105 @@
+##
+##  OSSP asgui - Accounting system graphical user interface
+##  Copyright (c) 2002-2004 The OSSP Project (http://www.ossp.org/)
+##  Copyright (c) 2002-2004 Ralf S. Engelschall <rse@engelschall.com>
+##  Copyright (c) 2002-2004 Michael Schloh von Bennewitz <michael@schloh.com>
+##  Copyright (c) 2002-2004 Cable & Wireless Telecommunications Services GmbH
+##
+##  This file is part of OSSP asgui, an accounting system graphical user
+##  interface which can be found at http://www.ossp.org/pkg/tool/asgui/.
+##
+##  Permission to use, copy, modify, and distribute this software for
+##  any purpose with or without fee is hereby granted, provided that
+##  the above copyright notice and this permission notice appear in all
+##  copies.
+##
+##  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+##  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+##  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+##  IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+##  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+##  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+##  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+##  USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+##  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+##  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+##  OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+##  SUCH DAMAGE.
+##
+##  as-gui.conf.pod: Plain old documentation file
+##
+
+=pod
+
+=head1 NAME
+
+B<as-gui.conf> - as-gui configuration file
+
+=head1 DESCRIPTION
+
+The B<as-gui> accounting system graphical client allows for easy yet flexible
+accounting of time and tasks. It caters to a variety of user interface tastes
+by offering a variety of parameterized options.
+
+Many such options influence direct rendering of the graphical representation
+of all data and the controls which operate on the data. However, other options
+control communication with the B<AS> server, local report formatting, or
+backup storage.
+
+Features such as macro processing, rulesets, account aliases, and session
+tuning will be stored as well (when these future preferences are finally
+implemented).
+
+Because of the many possibilities offered, there exists a system to manage the
+preferences involved. The system depends on the preferences file F<~/.as-gui>,
+reading data from it when starting and running B<as-gui>, and storing data to
+it when finally terminating.
+
+The file F<~/.as-gui> is stored in XML format, and is parsed internally by
+B<as-gui>. There is no need to edit this file, although there is also no harm
+in doing so. Please remember that all parameters may change during runtime, so
+it is wisest to edit after quitting the B<as-gui> application.
+
+Attenzione! During runtime, all parameters are user-defined and are accessible
+by selecting the 'Preferences...' subitem under the 'Edit' menu.
+
+=head1 EXAMPLES
+
+Entries taken from a preferences file:
+
+=over 4
+
+=item B<Location of events file>
+
+<option key="asfile" value="~/.as/events" />
+
+=item B<Location of accounts file>
+
+<option key="accounts" value="~/.as/accounts" />
+
+=item B<Visibility indicator of the amount column>
+
+<option key="amountcolshow" value="true" />
+
+=item B<Width in pixels of the amount column>
+
+<option key="amountcolwidth" value="60" />
+
+=item B<Flag to enable automatic file backups>
+
+<option key="autobackup" value="true" />
+
+=back
+
+=head1 SEE ALSO
+
+as-gui(1),
+as-events(5),
+as-accounts(5)
+
+=head1 AUTHOR
+
+Michael Schloh von Bennewitz
+(michael@schloh.com)
+
+=cut