Thu, 06 Aug 2009 13:21:30 +0200
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>>0 or <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> $ as-gui figo.as</p> |
michael@1 | 182 | <p>Showing lovely blue shades in most widgets: |
michael@1 | 183 | <br> $ as-gui -bg lightblue -fg darkblue</p> |
michael@1 | 184 | <p>Starting with a title bar that reads 'Yours here': |
michael@1 | 185 | <br> $ as-gui -title 'Yours here'</p> |
michael@1 | 186 | <p>Displaying graphics output on the host borchert: |
michael@1 | 187 | <br> $ 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> $ 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> |