wmacpi: Bump to version 2.0rc1.
[dockapps.git] / wmweather+ / HINTS
blobb3f55b358864f940767fb7cc5767b48df2d2e612
1 Hints for wmweather+
3 (blatantly copied from the Hints for WMPPP ;)
5 Generic
6 --------------------------------------------------------------
7 wmweather+ supports various commandline options, 'wmweather+ -h' prints
8 help about them. Actually, any unrecognized option will print the same help.
10 WindowMaker
11 --------------------------------------------------------------
12 WindowMaker users simply drag and drop the wmweather+ dock.app on
13 the WindowMaker Dock (preferred) or the Clip.
15 Now press the rightmouse button on wmweather+'s outer edges and
16 select "Settings..." from the popup menu that appears.
18 Enable the 'Start when WindowMaker is started' option, then 
19 click on the 'OK' button in the Docked Applications Panel.
21 Afterstep
22 --------------------------------------------------------------
23 Afterstep users put something like this in their .steprc
24 "Wharf wmweather+ - MaxSwallow "wmweather+" wmweather+ &"
26 Other WindowManagers
27 --------------------------------------------------------------
28 For other windowmanagers, wmweather+ runs nicely as a 64x64
29 pixel shaped icon on your desktop.
31 BTW, FVWM can swallow it too, so we've heard ;-)
33 Dragging wmweather+
34 --------------------------------------------------------------
35 Be sure to drag wmweather+ on it's outer edges, wmweather+ is a bit
36 picky due to the large gfx pixmap it keeps ;-)
38 Network Usage
39 --------------------------------------------------------------
40 wmweather+ is really rather useless without network access, since it
41 has to download everything it wants to display...
43 Command Line
44 --------------------------------------------------------------
45 Remember to quote your arguments properly. For example, this command:
46   wmweather+ -s KORD -location 48N 78W
47 Will be interpreted as passing the value "48N" to the "-location" option.
48 wmweather+ will then complain that the location is badly formed. Instead, try
49 quoting any options containing spaces like this:
50   wmweather+ -s KORD -location "48N 78W"
52 Config File
53 --------------------------------------------------------------
54 You may have noticed wmweather+ has an insane number of command line
55 options. You may also have noticed the comment in the manpage along the
56 lines of "The configuration file is simply one option (with value if
57 necessary) per line, leading dashes optional. Empty lines and lines
58 beginning with the '#' character are ignored." This means just what it says:
59 your configuration file should contain your command line options, with one
60 option per line.
62 See the file example.conf for a sample configuration file.
64 Font Size
65 --------------------------------------------------------------
66 If you think the fonts are too small, you are welcome to redesign the
67 display and the font. Please keep in mind the following constraints:
68  * The window size is limited to 64x64. Taking off the border, that means
69    you get about 54x54 pixels to work with.
70  * I require the app to display at least the station ID, the effective
71    date and time of the observarion/forecast, the weather graphic, the
72    temperature (and high and low for forecasts), the relative humidity, and
73    the wind speed+direction. At least one extra line is needed for
74    pressure/heat index/wind chill/precip amount as appropriate.