as-gui.html@0e0eb7c91312
as-gui.html
Thu, 06 Aug 2009 13:21:30 +0200
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Thu, 06 Aug 2009 13:21:30 +0200
- changeset 15
- 0e0eb7c91312
- parent 1
- d64aaa7d146f
- permissions
- -rw-r--r--
Remove seemingly declarations unnecessary according to Qt 4.5.2 headers.
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml">
3 <head>
4 <title>as-gui help reference</title>
5 <link rev="made" href="mailto:michael@schloh.com" />
6 </head>
8 <body style="background-color: white">
10 <p><a name="__index__"></a></p>
11 <!-- INDEX BEGIN -->
13 <h1><a name="top">AS-GUI</a></h1>
14 <ul>
15 <li><a href="#name">NAME</a></li>
16 <li><a href="#version">VERSION</a></li>
17 <li><a href="#synopsis">SYNOPSIS</a></li>
18 <li><a href="#description">DESCRIPTION</a></li>
19 <li><a href="#x11_options">X11 OPTIONS</a></li>
20 <li><a href="#qt_options">Qt OPTIONS</a></li>
21 <li><a href="#environment">ENVIRONMENT</a></li>
22 <li><a href="#return_values">RETURN VALUES</a></li>
23 <li><a href="#examples">EXAMPLES</a></li>
24 <li><a href="#files">FILES</a></li>
25 <li><a href="#bugs">BUGS</a></li>
26 <li><a href="#see_also">SEE ALSO</a></li>
27 <li><a href="#author">AUTHOR</a></li>
28 </ul>
29 <!-- INDEX END -->
31 <hr /><hr />
32 <h2><a name="name">NAME</a></h2>
33 <p><strong>as-gui</strong> - accounting system graphical client</p>
34 <p>
35 </p>
36 <hr />
37 <h2><a name="version">VERSION</a></h2>
38 <p>as-gui 0.7.2 (06-Mar-2003)</p>
39 <p>
40 </p>
41 <hr />
42 <h2><a name="synopsis">SYNOPSIS</a></h2>
43 <p><strong>as-gui</strong>
44 [<em>X11_options</em>]
45 [<em>Qt_options</em>]
46 [file]</p>
47 <p>
48 </p>
49 <hr />
50 <h2><a name="description">DESCRIPTION</a></h2>
51 <p>The <strong>as-gui</strong> application tracks the time a person spends on a number of
52 predefined tasks. This is the graphical client to the <strong>Accounting System</strong>
53 server (<strong>AS</strong>). Although the two can interact through means of interprocess
54 communication mechanisms, <strong>as-gui</strong> is a generic stand-alone tool which can be
55 used with no <strong>AS</strong> server.</p>
56 <p>When logging to a local file, <strong>as-gui</strong> takes input and waits until receiving
57 a save request from the user. Then, the time sheet will save its data entries
58 to the associated file name (as shown in the title bar).</p>
59 <p>Logging to a remote <strong>AS</strong> server follows a similar input scheme, but at least
60 one <strong>AS</strong> server must be specified in the preferences. A simple 'syncronize
61 with server' operation does the rest.</p>
62 <p>
63 </p>
64 <hr />
65 <h2><a name="x11_options">X11 OPTIONS</a></h2>
66 <p>The following <em>X11 options</em> are passed directly to the X11 subsystem, and
67 allow for the typical customization of a X11 application.</p>
68 <dl>
69 <dt><strong><a name="item_%2ddisplay_display"><strong>-display display</strong></a></strong><br />
70 </dt>
71 <dd>
72 Sets the X display (host:server.screen). The default value is $DISPLAY.
73 </dd>
74 <br>
75 <dt><strong><a name="item_%2dgeometry_geometry"><strong>-geometry geometry</strong></a></strong><br />
76 </dt>
77 <dd>
78 Sets the client geometry (width x height + xoffset + yoffset) of the main widget.
79 </dd>
80 <br>
81 <dt><strong><a name="item_%2dfn_font%2c_%2dfont_font"><strong>-fn font</strong>, <strong>-font font</strong></a></strong><br />
82 </dt>
83 <dd>
84 Defines the application font. The font should be specified using a X logical
85 font description.
86 </dd>
87 <br>
88 <dt><strong><a name="item_%2dbg_color%2c_%2dbackground_color"><strong>-bg color</strong>, <strong>-background color</strong></a></strong><br />
89 </dt>
90 <dd>
91 Sets the default background color and an application palette (light and dark
92 shades are calculated).
93 </dd>
94 <br>
95 <dt><strong><a name="item_%2dfg_color%2c_%2dforeground_color"><strong>-fg color</strong>, <strong>-foreground color</strong></a></strong><br />
96 </dt>
97 <dd>
98 Sets the default foreground color.
99 </dd>
100 <br>
101 <dt><strong><a name="item_%2dbtn_color%2c_%2dbutton_color"><strong>-btn color</strong>, <strong>-button color</strong></a></strong><br />
102 </dt>
103 <dd>
104 Sets the default button color.
105 </dd>
106 <br>
107 <dt><strong><a name="item_%2dname_name"><strong>-name name</strong></a></strong><br />
108 </dt>
109 <dd>
110 Sets the application name.
111 </dd>
112 <br>
113 <dt><strong><a name="item_%2dtitle_title"><strong>-title title</strong></a></strong><br />
114 </dt>
115 <dd>
116 Sets the application title (caption).
117 </dd>
118 <br>
119 <dt><strong><a name="item_%2dvisual_truecolor"><strong>-visual TrueColor</strong></a></strong><br />
120 </dt>
121 <dd>
122 Forces the application to use a TrueColor visual on an 8-bit display.
123 </dd>
124 <br>
125 <dt><strong><a name="item_%2dncols_count"><strong>-ncols count</strong></a></strong><br />
126 </dt>
127 <dd>
128 Limits the number of colors allocated in the color cube on an 8-bit display,
129 if the application is using the QApplication::ManyColor color specification.
130 If count is 216 then a 6x6x6 color cube is used (i.e. 6 levels of red, 6 of
131 green, and 6 of blue). For other values, a cube approximately proportional to
132 a 2x3x1 cube is used.
133 </dd>
134 <br>
135 <dt><strong><a name="item_%2dcmap"><strong>-cmap</strong></a></strong><br />
136 </dt>
137 <dd>
138 Causes the application to install a private color map on an 8-bit display.
139 </dd>
140 <br></dl>
141 <p>
142 </p>
143 <hr />
144 <h2><a name="qt_options">Qt OPTIONS</a></h2>
145 <p>The following <em>Qt options</em> are used when rendering the graphics of the Qt
146 widget library. They are not compatible with other X11 or Win32 applications,
147 unless they were first linked with the Qt widget library.</p>
148 <dl>
149 <dt><strong><a name="item_%2dsession_session"><strong>-session session</strong></a></strong><br />
150 </dt>
151 <dd>
152 Restores the application from an earlier session.
153 </dd>
154 <br>
155 <dt><strong><a name="item_%2dwidgetcount"><strong>-widgetcount</strong></a></strong><br />
156 </dt>
157 <dd>
158 Prints debug message at the end about number of widgets left undestroyed and
159 maximum number of widgets existed at the same time.
160 </dd>
161 <br></dl>
162 <p>
163 </p>
164 <hr />
165 <h2><a name="environment">ENVIRONMENT</a></h2>
166 <p><code>USER</code> The user name to use when accounting.</p>
167 <p><code>HOME</code> The full path of the user's home directory.</p>
168 <p>
169 </p>
170 <hr />
171 <h2><a name="return_values">RETURN VALUES</a></h2>
172 <p><code>0</code> The application exited sucessfully.</p>
173 <p><code>>0 or <0</code> At least one error ocurred.</p>
174 <p>
175 </p>
176 <hr />
177 <h2><a name="examples">EXAMPLES</a></h2>
178 <p>Try out some of these examples to customize <strong>as-gui</strong> from the command
179 line. Remember that options can be mixed.</p>
180 <p>Initially editing the document 'figo.as':
181 <br> $ as-gui figo.as</p>
182 <p>Showing lovely blue shades in most widgets:
183 <br> $ as-gui -bg lightblue -fg darkblue</p>
184 <p>Starting with a title bar that reads 'Yours here':
185 <br> $ as-gui -title 'Yours here'</p>
186 <p>Displaying graphics output on the host borchert:
187 <br> $ as-gui -display borchert:0.0</p>
188 <p>A slim window slightly left of the top right corner:
189 <br> $ as-gui -geometry 761x347-120+0</p>
190 <p>
191 </p>
192 <hr />
193 <h2><a name="files">FILES</a></h2>
194 <dl>
195 <dt><strong><a name="item_%7e%2f%2eas%2dgui">~/.as-gui</a></strong><br />
196 </dt>
197 <dd>
198 User preferences file.
199 </dd>
200 <br>
201 <dt><strong><a name="item_as%2dgui%2ehtml">as-gui.html</a></strong><br />
202 </dt>
203 <dd>
204 Help reference.
205 </dd>
206 <p></p></dl>
207 <p>
208 </p>
209 <hr />
210 <h2><a name="bugs">BUGS</a></h2>
211 <p>Sometimes a click on a widget (like a toolbar button) is seemingly ignored.</p>
212 <p>Consistent row shading is not always maintained. This means that the sharp
213 colour difference between one row and the next may not correctly follow the
214 chosen sort order. Press 'refresh' to work around this problem.</p>
215 <p>The row highlight may be wrong after resorting the entire time sheet. Press
216 the arrow keys a few times to find the currently selected row if this happens.</p>
217 <p>Double clicking on column separators should automatically expand or shrink
218 the corresponding column to the exact size needed. Broken.</p>
219 <p>Local reports only take datewise sorting into account. Attention! This is not
220 a bug, and local reports are almost always only useful when sorted by date.</p>
221 <p>
222 </p>
223 <hr />
224 <h2><a name="see_also">SEE ALSO</a></h2>
225 <p>as-gui(1),
226 <br>as-events(5),
227 <br>as-accounts(5),
228 <br>as-gui.conf(5)
229 <p>
230 </p>
231 <hr />
232 <h2><a name="author">AUTHOR</a></h2>
233 <p>Michael Schloh von Bennewitz
234 <br>michael@schloh.com</p>
236 </body>
238 </html>
