head	1.4;
access;
symbols;
locks; strict;
comment	@.\" @;


1.4
date	2003.03.06.22.21.00;	author ms;	state Exp;
branches;
next	1.3;

1.3
date	2003.03.06.17.16.13;	author ms;	state Exp;
branches;
next	1.2;

1.2
date	2003.03.06.17.02.57;	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.4
log
@Fix problem with out of date aclocal and rerelease.
@
text
@.\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` 
.    ds C' 
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "AS-GUI 1"
.TH AS-GUI 1 "as-gui 0.7.2" "06-Mar-2003" "AS Accounting System"
.SH "NAME"
\&\fBas\-gui\fR \- accounting system graphical client
.SH "VERSION"
.IX Header "VERSION"
as-gui \s-10.7.2 (06-Mar-2003)\s0
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBas-gui\fR
[\fIX11_options\fR]
[\fIQt_options\fR]
[file]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \fBas-gui\fR application tracks the time a person spends on a number of
predefined tasks. This is the graphical client to the \fBAccounting System\fR
server (\fB\s-1AS\s0\fR). Although the two can interact through means of interprocess
communication mechanisms, \fBas-gui\fR is a generic stand-alone tool which can be
used with no \fB\s-1AS\s0\fR server.
.PP
When logging to a local file, \fBas-gui\fR 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).
.PP
Logging to a remote \fB\s-1AS\s0\fR server follows a similar input scheme, but at least
one \fB\s-1AS\s0\fR server must be specified in the preferences. A simple 'syncronize
with server' operation does the rest.
.SH "X11 OPTIONS"
.IX Header "X11 OPTIONS"
The following \fIX11 options\fR are passed directly to the X11 subsystem, and
allow for the typical customization of a X11 application.
.IP "\fB\-display display\fR" 4
.IX Item "-display display"
Sets the X display (host:server.screen). The default value is \f(CW$DISPLAY\fR.
.IP "\fB\-geometry geometry\fR" 4
.IX Item "-geometry geometry"
Sets the client geometry (width x height + xoffset + yoffset) of the main widget.
.IP "\fB\-fn font\fR, \fB\-font font\fR" 4
.IX Item "-fn font, -font font"
Defines the application font. The font should be specified using a X logical
font description.
.IP "\fB\-bg color\fR, \fB\-background color\fR" 4
.IX Item "-bg color, -background color"
Sets the default background color and an application palette (light and dark
shades are calculated).
.IP "\fB\-fg color\fR, \fB\-foreground color\fR" 4
.IX Item "-fg color, -foreground color"
Sets the default foreground color.
.IP "\fB\-btn color\fR, \fB\-button color\fR" 4
.IX Item "-btn color, -button color"
Sets the default button color.
.IP "\fB\-name name\fR" 4
.IX Item "-name name"
Sets the application name.
.IP "\fB\-title title\fR" 4
.IX Item "-title title"
Sets the application title (caption).
.IP "\fB\-visual TrueColor\fR" 4
.IX Item "-visual TrueColor"
Forces the application to use a TrueColor visual on an 8\-bit display.
.IP "\fB\-ncols count\fR" 4
.IX Item "-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.
.IP "\fB\-cmap\fR" 4
.IX Item "-cmap"
Causes the application to install a private color map on an 8\-bit display.
.SH "Qt OPTIONS"
.IX Header "Qt OPTIONS"
The following \fIQt options\fR 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.
.IP "\fB\-session session\fR" 4
.IX Item "-session session"
Restores the application from an earlier session.
.IP "\fB\-widgetcount\fR" 4
.IX Item "-widgetcount"
Prints debug message at the end about number of widgets left undestroyed and
maximum number of widgets existed at the same time.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
\&\f(CW\*(C`USER\*(C'\fR The user name to use when accounting.
.PP
\&\f(CW\*(C`HOME\*(C'\fR The full path of the user's home directory.
.SH "RETURN VALUES"
.IX Header "RETURN VALUES"
\&\f(CW0\fR The application exited sucessfully.
.PP
\&\f(CW\*(C`>0 or <0\*(C'\fR At least one error ocurred.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
Try out some of these examples to customize \fBas-gui\fR from the command
line. Remember that options can be mixed.
.PP
Initially editing the document 'figo.as':
.Sp
.RS 4
$ as-gui figo.as
.RE
.PP
Showing lovely blue shades in most widgets:
.Sp
.RS 4
$ as-gui \-bg lightblue \-fg darkblue
.RE
.PP
Starting with a title bar that reads 'Yours here':
.Sp
.RS 4
$ as-gui \-title 'Yours here'
.RE
.PP
Displaying graphics output on the host borchert:
.Sp
.RS 4
$ as-gui \-display borchert:0.0
.RE
.PP
A slim window slightly left of the top right corner:
.Sp
.RS 4
$ as-gui \-geometry 761x347\-120+0
.RE
.SH "FILES"
.IX Header "FILES"
.IP "~/.as\-gui" 4
.IX Item "~/.as-gui"
User preferences file.
.IP "as\-gui.html" 4
.IX Item "as-gui.html"
Help reference.
.SH "BUGS"
.IX Header "BUGS"
Sometimes a click on a widget (like a toolbar button) is seemingly ignored.
.PP
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.
.PP
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.
.PP
Double clicking on column separators should automatically expand or shrink
the corresponding column to the exact size needed. Broken.
.PP
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.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIas\-gui.conf\fR\|(5),
\&\fIas\-events\fR\|(5),
\&\fIas\-accounts\fR\|(5)
.SH "AUTHOR"
.IX Header "AUTHOR"
Michael Schloh von Bennewitz
(michael@@schloh.com)
@


1.3
log
@Bump document versions for release.
@
text
@d132 1
a132 1
.TH AS-GUI 1 "as-gui 0.7.0" "06-Mar-2003" "AS Accounting System"
d137 1
a137 1
as-gui \s-10.7.0 (06-Mar-2003)\s0
@


1.2
log
@Editions resulting from completion of man page texts.
@
text
@d132 1
a132 1
.TH AS-GUI 1 "as-gui 0.6.23" "05-Mar-2003" "AS Accounting System"
d137 1
a137 1
as-gui \s-10.6.23 (05-Mar-2003)\s0
@


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
@a206 5
.IP "\fB\-style style\fR" 4
.IX Item "-style style"
Sets the application \s-1GUI\s0 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.
d284 3
a286 1
\&\fIas\-gui.conf\fR\|(5)
@