diff -r 27e940e8e5f3 -r d64aaa7d146f as-gui.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/as-gui.html Fri Nov 28 11:21:08 2008 +0100 @@ -0,0 +1,238 @@ + + + +as-gui help reference + + + + + +

+ + +

AS-GUI

NAME
VERSION
SYNOPSIS
DESCRIPTION
X11 OPTIONS
Qt OPTIONS
ENVIRONMENT
RETURN VALUES
EXAMPLES
FILES
BUGS
SEE ALSO
AUTHOR

+ + +

NAME

as-gui - accounting system graphical client

VERSION

as-gui 0.7.2 (06-Mar-2003)

SYNOPSIS

as-gui +[X11_options] +[Qt_options] +[file]

DESCRIPTION

The as-gui application tracks the time a person spends on a number of +predefined tasks. This is the graphical client to the Accounting System +server (AS). Although the two can interact through means of interprocess +communication mechanisms, as-gui is a generic stand-alone tool which can be +used with no AS server.

When logging to a local file, as-gui takes input and waits until receiving +a save request from the user. Then, the time sheet will save its data entries +to the associated file name (as shown in the title bar).

Logging to a remote AS server follows a similar input scheme, but at least +one AS server must be specified in the preferences. A simple 'syncronize +with server' operation does the rest.

X11 OPTIONS

The following X11 options are passed directly to the X11 subsystem, and +allow for the typical customization of a X11 application.

-display display
+: +Sets the X display (host:server.screen). The default value is $DISPLAY. +
-geometry geometry
+: +Sets the client geometry (width x height + xoffset + yoffset) of the main widget. +
-fn font, -font font
+: +Defines the application font. The font should be specified using a X logical +font description. +
-bg color, -background color
+: +Sets the default background color and an application palette (light and dark +shades are calculated). +
-fg color, -foreground color
+: +Sets the default foreground color. +
-btn color, -button color
+: +Sets the default button color. +
-name name
+: +Sets the application name. +
-title title
+: +Sets the application title (caption). +
-visual TrueColor
+: +Forces the application to use a TrueColor visual on an 8-bit display. +
-ncols count
+: +Limits the number of colors allocated in the color cube on an 8-bit display, +if the application is using the QApplication::ManyColor color specification. +If count is 216 then a 6x6x6 color cube is used (i.e. 6 levels of red, 6 of +green, and 6 of blue). For other values, a cube approximately proportional to +a 2x3x1 cube is used. +
-cmap
+: +Causes the application to install a private color map on an 8-bit display. +

Qt OPTIONS

The following Qt options are used when rendering the graphics of the Qt +widget library. They are not compatible with other X11 or Win32 applications, +unless they were first linked with the Qt widget library.

-session session
+: +Restores the application from an earlier session. +
-widgetcount
+: +Prints debug message at the end about number of widgets left undestroyed and +maximum number of widgets existed at the same time. +

ENVIRONMENT

USER The user name to use when accounting.

HOME The full path of the user's home directory.

RETURN VALUES

0 The application exited sucessfully.

>0 or <0 At least one error ocurred.

EXAMPLES

Try out some of these examples to customize as-gui from the command +line. Remember that options can be mixed.

Initially editing the document 'figo.as': +
$ as-gui figo.as

Showing lovely blue shades in most widgets: +
$ as-gui -bg lightblue -fg darkblue

Starting with a title bar that reads 'Yours here': +
$ as-gui -title 'Yours here'

Displaying graphics output on the host borchert: +
$ as-gui -display borchert:0.0

A slim window slightly left of the top right corner: +
$ as-gui -geometry 761x347-120+0

FILES

~/.as-gui
+: +User preferences file. +
as-gui.html
+: +Help reference. +

BUGS

Sometimes a click on a widget (like a toolbar button) is seemingly ignored.

Consistent row shading is not always maintained. This means that the sharp +colour difference between one row and the next may not correctly follow the +chosen sort order. Press 'refresh' to work around this problem.

The row highlight may be wrong after resorting the entire time sheet. Press +the arrow keys a few times to find the currently selected row if this happens.

Double clicking on column separators should automatically expand or shrink +the corresponding column to the exact size needed. Broken.

Local reports only take datewise sorting into account. Attention! This is not +a bug, and local reports are almost always only useful when sorted by date.

AUTHOR

Michael Schloh von Bennewitz +
michael@schloh.com

+ + + +