Gentoo Archives: gentoo-commits

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
Date: Tue, 29 Dec 2009 19:23:14
Message-Id: E1NPhev-0004PW-H5@stork.gentoo.org
1 nightmorph 09/12/29 19:23:09
2
3 Modified: openbox.xml
4 Log:
5 Lots of updates for bug 256693. I also went through the guide and made several other changes, including adding packages that are finally marked stable, such as all the LXDE applications, to the recommended packages lists.
6
7 Revision Changes Path
8 1.6 xml/htdocs/doc/en/openbox.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.6&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.6&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.5&r2=1.6
13
14 Index: openbox.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
17 retrieving revision 1.5
18 retrieving revision 1.6
19 diff -u -r1.5 -r1.6
20 --- openbox.xml 12 Nov 2009 22:55:43 -0000 1.5
21 +++ openbox.xml 29 Dec 2009 19:23:08 -0000 1.6
22 @@ -1,6 +1,6 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.5 2009/11/12 22:55:43 nightmorph Exp $ -->
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.6 2009/12/29 19:23:08 nightmorph Exp $ -->
27
28 <guide>
29 <title>The Openbox Configuration HOWTO</title>
30 @@ -21,8 +21,8 @@
31 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
32 <license/>
33
34 -<version>1.3</version>
35 -<date>2009-11-12</date>
36 +<version>1.4</version>
37 +<date>2009-12-29</date>
38
39 <chapter>
40 <title>Introduction</title>
41 @@ -56,7 +56,7 @@
42 very quickly, even on older hardware. Whether your hardware is old or new,
43 Openbox also provides a highly customisable and unobtrusive working
44 environment. That means that if you don't want or need a panel, taskbar, clock,
45 -or any other program, those choices are yours!
46 +or any other program, those choices are yours to make!
47 </p>
48
49 </body>
50 @@ -170,7 +170,7 @@
51 </p>
52
53 <pre caption="Overwriting the default system-wide menu.xml files">
54 -$ <i>cp .config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i>
55 +# <i>cp .config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i>
56 </pre>
57
58 <impo>
59 @@ -188,13 +188,12 @@
60 </p>
61
62 <pre caption="Editing the menu.xml file">
63 -&lt;?xml version="1.0" encoding="UTF-8"?7gt;
64 +&lt;?xml version="1.0" encoding="UTF-8"?&gt;
65 &lt;openbox_menu&gt;
66 &lt;separator label="NAME_OF_SEPARATOR" /&gt;
67 &lt;menu id="IDENTIFIER" label="NAME_OF_MENU"&gt;
68 &lt;item label="NAME_OF_PROGRAM"&gt;
69 - &lt;action
70 - name="execute"&gt;&lt;execute&gt;/LOCATION/OF/BINARY&lt;/execute&gt;&lt;/action&gt;
71 + &lt;action name="execute"&gt;&lt;execute&gt;/LOCATION/OF/BINARY&lt;/execute&gt;&lt;/action&gt;
72 &lt;/item&gt;
73 &lt;/menu&gt;
74 &lt;/openbox_menu&gt;
75 @@ -261,11 +260,11 @@
76 &lt;?xml version="1.0" encoding="UTF-8"?&gt;
77 &lt;openbox_menu&gt;
78 &lt;menu id="1" label="Configuration"&gt;
79 - &lt;item label="OpenBox Config&gt;
80 + &lt;item label="OpenBox Config"&gt;
81 &lt;action name="execute"&gt;&lt;execute&gt;/usr/bin/obconf&lt;/execute&gt;&lt;/action&gt;
82 &lt;/item&gt;
83 &lt;/menu&gt;
84 -&lt;/openbox_menu>&gt;
85 +&lt;/openbox_menu&gt;
86 </pre>
87
88 </body>
89 @@ -311,9 +310,10 @@
90 <p>
91 Adding your own programs to the <path>autostart.sh</path> script is as easy as
92 writing in the program name for many applications. For instance, if you have
93 -Conky (a lightweight system monitor) installed, and want it to start
94 -automatically with your Openbox session, you simply add the following line to
95 -your <path>autostart.sh</path>:
96 +<uri link="http://packages.gentoo.org/package/app-admin/conky">Conky</uri> (a
97 +lightweight system monitor) installed, and want it to start automatically with
98 +your Openbox session, you simply add the following line to your
99 +<path>autostart.sh</path>:
100 </p>
101
102 <pre caption="Adding Conky to your autostart.sh">
103 @@ -338,10 +338,12 @@
104 Some things that you might take for granted in bigger desktop environments are
105 not included by default in Openbox. One such thing is setting your desktop
106 background. In order to place an image as your wallpaper, you will need to
107 -emerge a program like feh or nitrogen. Feh is a simple image viewer that can
108 -also set the background, <e>and</e> it can easily be put into the autostart
109 -script. Once you have emerged feh, you can issue the following command to set
110 -the background:
111 +emerge a program like <uri
112 +link="http://packages.gentoo.org/package/media-gfx/feh">feh</uri> or <uri
113 +link="http://packages.gentoo.org/package/x11-misc/nitrogen">nitrogen</uri>.
114 +<c>feh</c> is a simple image viewer that can also set the background, <e>and</e>
115 +it can easily be put into the autostart script. Once you have emerged
116 +<c>feh</c>, you can issue the following command to set the background:
117 </p>
118
119 <pre caption="Using feh to set the background image">
120 @@ -365,30 +367,27 @@
121 </pre>
122
123 <p>
124 -If you don't particularly care for the idea of having to issue a command in the
125 -terminal in order to set your background, you can alternatively use nitrogen. It
126 -will allow you to set a folder for your background images, view thumbnails of
127 -those images, and fit, stretch, or tile them to your desktop.
128 +If you don't particularly care for the idea of having to issue a command in the
129 +terminal in order to set your background, you can alternatively use
130 +<c>nitrogen</c>. It will allow you to set a folder for your background images,
131 +view thumbnails of those images, and fit, stretch, or tile them to your
132 +desktop.
133 </p>
134
135 <p>
136 -Installing nitrogen and getting it into your Openbox menu requires a few more
137 -steps than are readily apparent. Firstly, and most obviously, you need to
138 -<c>emerge nitrogen</c>. Due to <uri
139 -link="http://bugs.gentoo.org/show_bug.cgi?id=267231">this library dependency
140 -bug</uri>, you may also need to <c>emerge --oneshot librsvg</c> to avoid a
141 -runtime termination error. Secondly, you need to run nitrogen with your
142 -backgrounds folder appended:
143 +Installing <c>nitrogen</c> and getting it into your Openbox menu requires a few
144 +more steps than are readily apparent. First, you need to <c>emerge nitrogen</c>.
145 +Second, you need to run <c>nitrogen</c> with your backgrounds folder appended:
146 </p>
147
148 <pre caption="Starting nitrogen with your image folder">
149 -nitrogen /path/to/your/backgrounds/folder
150 +$ <i>nitrogen /path/to/your/backgrounds/folder</i>
151 </pre>
152
153 <p>
154 -Thirdly, you can set your background image, but it will not be there after you
155 -logout. Just as with feh, you need to restore your background by editing your
156 -<path>autostart.sh</path> script to have the following line:
157 +Third, you can set your background image, but it will not be there after you
158 +logout. Just as with <c>feh</c>, you need to restore your background by editing
159 +your <path>autostart.sh</path> script to have the following line:
160 </p>
161
162 <pre caption="Restoring your background with nitrogen">
163 @@ -424,16 +423,14 @@
164 <body>
165
166 <ul>
167 -<!-- still ~arch
168 <li>
169 <uri
170 link="http://packages.gentoo.org/package/lxde-base/lxterminal">LXterminal</uri>
171 - is the default terminal emulator for LXDE. It is very lightweight, and
172 - based on VTE. While EvilVTE offers many more customisation options
173 - (including transparency), LXterminal has a graphical interface for some of the
174 - more common options (font, colors, et cetera).
175 + is the default terminal emulator for LXDE. It is very lightweight, and based
176 + on VTE. While EvilVTE offers many more customisation options (including
177 + transparency), LXterminal has a graphical interface for some of the more
178 + common options (font, colors, et cetera).
179 </li>
180 --->
181 <li>
182 <uri
183 link="http://packages.gentoo.org/package/x11-terms/evilvte">EvilVTE</uri> is
184 @@ -468,28 +465,25 @@
185 link="http://packages.gentoo.org/package/x11-terms/terminal">Terminal</uri>
186 is the VTE-based default for the Xfce desktop environment, so it does
187 require some Xfce libraries to run. However, it is still fairly speedy, and
188 - supports transparency and is easily customized.
189 + supports transparency and is easily customised.
190 </li>
191 </ul>
192
193 </body>
194 </section>
195 -
196 <section>
197 <title>File managers</title>
198 <body>
199
200 <ul>
201 -<!-- still ~arch
202 <li>
203 <uri
204 link="http://packages.gentoo.org/package/x11-misc/pcmanfm">PCManFM</uri> is
205 the lightweight filemanager from LXDE. It supports tabbed browsing, drag and
206 drop, thumnails for images, bookmarks, volume management, searching, and
207 - more. It also provides supports for managing the desktop background and
208 + more. It also provides supports for managing the desktop background and
209 drawing desktop icons (both optionally).
210 </li>
211 --->
212 <li>
213 <uri link="http://packages.gentoo.org/package/xfce-base/thunar">Thunar</uri>
214 is the standard file manager from Xfce. It features a bulk renamer,
215 @@ -504,7 +498,8 @@
216 is the powerful file manager from the GNOME desktop environment. It features
217 volume management, thumbnails for images, searching, and some system
218 configuration. As it depends on many of the GNOME libraries for proper
219 - function, it can seem a heavy compared to some of the other file managers.
220 + function, it can seem a bit heavy compared to some of the other file
221 + managers.
222 </li>
223 <li>
224 <uri link="http://packages.gentoo.org/package/app-misc/gentoo">Gentoo</uri>
225 @@ -531,16 +526,15 @@
226 <body>
227
228 <ul>
229 -<!-- still ~arch
230 <li>
231 Though <uri
232 link="http://packages.gentoo.org/package/x11-misc/pcmanfm">PCManFM</uri> is
233 mainly a file manager, it also gives you the option to manage the desktop
234 - background (instead of using feh or nitrogen) and draw desktop icons. It
235 - should be noted that with the current release (0.5), it is not readily
236 - possible to get rid of the default "My Documents" icon on the desktop.
237 + background (instead of using <c>feh</c> or <c>nitrogen</c>) and draw
238 + desktop icons. It should be noted that with the current release (0.5.x), it
239 + is not readily possible to get rid of the default "My Documents" icon on the
240 + desktop.
241 </li>
242 --->
243 <li>
244 <uri link="http://packages.gentoo.org/package/x11-misc/idesk">iDesk</uri> is
245 a simple program used to draw desktop icons. It supports shadowed and
246 @@ -556,14 +550,11 @@
247 <body>
248
249 <ul>
250 -<!-- still ~arch
251 <li>
252 <uri link="http://code.google.com/p/tint2/">Tint2</uri> is a simple panel
253 - and taskbar specifically made for Openbox3 (based on the ttm code). It
254 - supports color/transparency, a clock, and drag and drop between virtual
255 - desktops.
256 + and taskbar (based on the ttm code). It supports color/transparency, a
257 + clock, and drag and drop between virtual desktops.
258 </li>
259 --->
260 <li>
261 <uri
262 link="http://packages.gentoo.org/package/x11-misc/pypanel">PyPanel</uri> is
263 @@ -571,7 +562,6 @@
264 transparency, shading, tinting, location and layout configuration, font
265 type, autohiding, application launcher, clock, and more.
266 </li>
267 -<!-- still ~arch
268 <li>
269 <uri
270 link="http://packages.gentoo.org/package/lxde-base/lxpanel">LXPanel</uri> is
271 @@ -579,7 +569,6 @@
272 clock, and a GUI-based configurator. It is feature-rich while depending on
273 very few packages, making it a good choice for a lean system.
274 </li>
275 --->
276 <li>
277 <uri
278 link="http://packages.gentoo.org/package/xfce-base/xfce4-panel">Xfce4-panel</uri>
279 @@ -638,7 +627,6 @@
280 <body>
281
282 <ul>
283 -<!-- still ~arch
284 <li>
285 <uri link="http://packages.gentoo.org/package/lxde-base/lxsession">
286 LXsession</uri> is the stripped down session manager from LXDE. It is
287 @@ -646,7 +634,6 @@
288 logout, and to automatically restart those programs. It also supports the
289 HAL daemon.
290 </li>
291 --->
292 <li>
293 <uri link="http://packages.gentoo.org/package/xfce-base/xfce4-session">
294 Xfce4-session</uri> is the session manager from, you guessed it, Xfce. It
295 @@ -668,7 +655,6 @@
296 is a GUI application allowing you to customise the Openbox window manager
297 without manually editing <path>~/.config/openbox/rc.conf</path>.
298 </li>
299 -<!-- still ~arch
300 <li>
301 <uri
302 link="http://packages.gentoo.org/package/lxde-base/lxappearance">LXappearance</uri>
303 @@ -676,7 +662,6 @@
304 graphical interface for setting the theme and icons, while depending on very
305 few extra libraries.
306 </li>
307 --->
308 <li>
309 <uri
310 link="http://packages.gentoo.org/package/x11-themes/gtk-chtheme">GTK-ChTheme</uri>
311 @@ -718,14 +703,12 @@
312 dynamically zoom, and set the desktop background (detailed instructions
313 above).
314 </li>
315 -<!-- still ~arch
316 <li>
317 <uri
318 link="http://packages.gentoo.org/package/media-gfx/gpicview">GPicView</uri>
319 - is a GUI-based image viewer. Though it has more dependencies than feh, it
320 - is incredibly quick to load and run.
321 + is a GUI-based image viewer. Though it has more dependencies than
322 + <c>feh</c>, it is incredibly quick to load and run.
323 </li>
324 --->
325 <li>
326 <uri link="http://packages.gentoo.org/package/x11-misc/slim">SLiM</uri> is
327 the Simple Login Manager, which allows you to login to your Openbox session
328 @@ -777,12 +760,6 @@
329 instead of manually editing your <path>~/.xinitrc</path>.
330 </p>
331
332 -<note>
333 -This method of using Openbox with GNOME has been tested with the GNOME 2.22
334 -release. While it seems highly likely that it will work with GNOME 2.24 and
335 -above, it has not been thoroughly tested as of yet.
336 -</note>
337 -
338 </body>
339 </section>
340 <section>
341 @@ -825,7 +802,7 @@
342
343 <p>
344 If you use Xfce4 and would like to replace xfwm4 with Openbox, you will need to
345 -go about it a little differently than with KDE or GNOME. Firstly, you need to
346 +go about it a little differently than with KDE or GNOME. First, you need to
347 start your normal Xfce session, and open up a terminal. From the terminal,
348 issue the following command:
349 </p>
350 @@ -835,9 +812,9 @@
351 </pre>
352
353 <p>
354 -Secondly, you need to exit out of your Xfce session, and make sure to tick the
355 +Second, you need to exit out of your Xfce session, and make sure to tick the
356 checkbox that says "Save session for future login." This will keep Openbox as
357 -your default window manager. Thirdly, you will notice that you can't logout
358 +your default window manager. Third, you will notice that you can't logout
359 properly when using the default menu action. To fix this problem, open up your
360 <path>menu.xml</path>, and locate this line:
361 </p>