head 1.7; access; symbols; locks; strict; comment @# @; 1.7 date 2003.03.06.22.21.00; author ms; state Exp; branches; next 1.6; 1.6 date 2003.03.06.17.29.53; author ms; state Exp; branches; next 1.5; 1.5 date 2003.03.06.17.27.48; author ms; state Exp; branches; next 1.4; 1.4 date 2003.03.06.17.16.13; author ms; state Exp; branches; next 1.3; 1.3 date 2003.03.06.17.02.57; author ms; state Exp; branches; next 1.2; 1.2 date 2003.03.06.16.25.24; author ms; state Exp; branches; next 1.1; 1.1 date 2003.03.05.20.24.52; author ms; state Exp; branches; next ; desc @@ 1.7 log @Fix problem with out of date aclocal and rerelease. @ text @ as-gui help reference

AS-GUI

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.

SEE ALSO

as-gui(1),
as-events(5),
as-accounts(5),
as-gui.conf(5)

AUTHOR

Michael Schloh von Bennewitz
michael@@schloh.com

@ 1.6 log @Do the release really right this time. @ text @d38 1 a38 1

as-gui 0.7.1 (06-Mar-2003)

@ 1.5 log @Remove whitespace and add commas. @ text @d38 1 a38 1

as-gui 0.7.0 (06-Mar-2003)

@ 1.4 log @Bump document versions for release. @ text @d225 4 a228 4

as-gui(1)

as-events(5)

as-accounts(5)

as-gui.conf(5)

@ 1.3 log @Editions resulting from completion of man page texts. @ text @d38 1 a38 1

as-gui 0.6.23 (05-Mar-2003)

@ 1.2 log @Add as-events.5 manpage to 'see also' text, and remove '-style' Qt option, because it is not working. @ text @d227 1 @ 1.1 log @Wrote help content and other documentation, modify buildconf to install it properly, and additionally glue it into the help panel class to be accessible during runtime. @ text @a148 8
-style style
Sets the application GUI style. Possible values are motif, windows, and platinum. If you compiled Qt with additional styles or have additional styles as plugins these will be available to the -style command line option.

d226 1 @