As-gui Sources / file comparison
comparison: as-gui.html
as-gui.html
- changeset 1
- d64aaa7d146f
- child 3
- c1941114ca88
equal
deleted
inserted
replaced
| -1:000000000000 | 0:b883ab3a9fcf |
|---|---|
| 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:ms@dt4.dev.de.cw.net" /> | |
| 6 </head> | |
| 7 | |
| 8 <body style="background-color: white"> | |
| 9 | |
| 10 <p><a name="__index__"></a></p> | |
| 11 <!-- INDEX BEGIN --> | |
| 12 | |
| 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 --> | |
| 30 | |
| 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> | |
| 235 | |
| 236 </body> | |
| 237 | |
| 238 </html> |
