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.

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

mercurial