* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml metadoc.xml
@ 2009-06-28 3:42 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 2+ messages in thread
From: Joshua Saddler (nightmorph) @ 2009-06-28 3:42 UTC (permalink / raw
To: gentoo-commits
nightmorph 09/06/28 03:42:03
Modified: openbox.xml metadoc.xml
Log:
thorough overhaul of the openbox guide. i started with Nate's latest draft in bug #256693. more or less completely rewrote it, editing as i went. also added sections on other applications. left the ~arch stuff commented out for now, as we aren't supposed to document anything but the stable tree. this may change upon review, arch team stabilization, rainy weather, etc. also added the doc to our index and took it out of draft status. it's official!
Revision Changes Path
1.3 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.3&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.3&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.2&r2=1.3
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- openbox.xml 27 Apr 2009 20:18:50 -0000 1.2
+++ openbox.xml 28 Jun 2009 03:42:02 -0000 1.3
@@ -1,13 +1,16 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.2 2009/04/27 20:18:50 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.3 2009/06/28 03:42:02 nightmorph Exp $ -->
-<guide disclaimer="draft">
+<guide>
<title>The Openbox Configuration HOWTO</title>
<author title="Author">
<mail link="kalos"/>
</author>
+<author title="Author">
+ <mail link="nightmorph"/>
+</author>
<abstract>
This guide shows you how to install the Openbox window manager, and references
@@ -18,8 +21,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.1</version>
-<date>2009-04-27</date>
+<version>1.2</version>
+<date>2009-06-27</date>
<chapter>
<title>Introduction</title>
@@ -34,11 +37,11 @@
had some experience with big desktop environments like <uri
link="/proj/en/desktop/kde/kde-config.xml">KDE</uri>, <uri
link="/doc/en/gnome-config.xml">GNOME</uri>, and <uri
-link="/doc/en/xfce-config.xml">Xfce</uri>. One component of those larger
-desktop suites is called the window manager (or WM for short). A window manager
-is responsible for the appearance and placement of the containers (or
-"windows") inside which programs run. Openbox is a minimalistic,
-no-frills-attached window manager.
+link="/doc/en/xfce-config.xml">Xfce</uri>. One component of those larger desktop
+suites is called the window manager (or WM for short). A window manager is
+responsible for the appearance and placement of the containers (or "windows")
+inside which programs run. Openbox is a minimalistic, no-frills-attached window
+manager.
</p>
</body>
@@ -53,7 +56,7 @@
very quickly, even on older hardware. Whether your hardware is old or new,
Openbox also provides a highly customisable and unobtrusive working
environment. That means that if you don't want or need a panel, taskbar, clock,
-or any other program, that choice is yours!
+or any other program, those choices are yours!
</p>
</body>
@@ -68,9 +71,8 @@
<body>
<p>
-After you have emerged xorg-x11 and configured all of your
-<path>xorg.conf</path> settings, installing Openbox can be done in one simple
-command:
+After you have emerged and configured <c>xorg-server</c>, installing Openbox can
+be done in one simple command:
</p>
<pre caption="Installing Openbox">
@@ -81,11 +83,11 @@
<p>
Just like with other window managers and desktop environments, you will need to
tell the X Server to load Openbox automatically, by adding it to your
-<path>.xinitrc</path>.
+<path>~/.xinitrc</path>.
</p>
<pre caption="Adding Openbox to your .xinitrc">
-# <i>echo "exec openbox-session" >> ~/.xinitrc</i>
+$ <i>echo "exec openbox-session" >> ~/.xinitrc</i>
</pre>
<p>
@@ -168,7 +170,7 @@
</p>
<pre caption="Overwriting the default system-wide menu.xml files">
-$ <i>mv .config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i>
+$ <i>cp .config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i>
</pre>
<impo>
@@ -185,17 +187,18 @@
not that difficult). The basic syntax for the menu XML is as follows:
</p>
-<pre caption="Editing the menu.xml file"><![CDATA[
-<?xml version="1.0" encoding="UTF-8"?>
-<openbox_menu>
-<separator label="NAME_OF_SEPARATOR" />
-<menu id="IDENTIFIER" label="NAME_OF_MENU">
- <item label="NAME_OF_PROGRAM">
- <action name="execute"><execute>/LOCATION/OF/BINARY</execute></action>
- </item>
-</menu>
-</openbox_menu>
-]]></pre>
+<pre caption="Editing the menu.xml file">
+<?xml version="1.0" encoding="UTF-8"?7gt;
+<openbox_menu>
+<separator label="NAME_OF_SEPARATOR" />
+<menu id="IDENTIFIER" label="NAME_OF_MENU">
+ <item label="NAME_OF_PROGRAM">
+ <action
+ name="execute"><execute>/LOCATION/OF/BINARY</execute></action>
+ </item>
+</menu>
+</openbox_menu>
+</pre>
<p>
Simply replace anything in CAPS with your information.
@@ -204,7 +207,7 @@
<p>
Alternatively, you can <c>emerge obmenu</c>, which is a graphical interface
allowing you to create your menus without having to manually edit the
-<path>menu.xml</path> file. It is a very small application and offers a
+<path>menu.xml</path> file. It is a very small application and offers a
nice amount of customisation without typing any XML.
</p>
@@ -218,28 +221,28 @@
<p>
Aside from being minimalistic and lightweight, Openbox is also surprisingly
customisable and flexible. As a user, you can easily change various settings
-related to theme, appearance, window placement, docking, and more. There are
-two options for configuring these settings within Openbox. You may either
-manually edit the <path>~/.config/openbox/rc.xml</path> file, or you may want a
-GUI to help you quickly change settings.
+related to theme, appearance, window placement, docking, and more. There are two
+options for configuring these settings within Openbox. You may either manually
+edit <path>~/.config/openbox/rc.xml</path>, or you may want a GUI to help you
+quickly change settings.
</p>
<p>
-If you want to manually edit the <path>rc.xml</path> file, you simply open up
-your favourite text editor and start making changes. You might want to make a
-backup of the original file just in case, and store it in a location like
+If you want to manually edit <path>rc.xml</path>, you simply open up your
+favourite text editor and start making changes. You might want to make a backup
+of the original file just in case, and store it in a location like
<path>~/.config/openbox/rc.xml.default</path>. There are plenty of comments
-within the document itself that should help you with editing. Alternatively,
-you may want to look at the <uri
+within the document itself that should help you with editing. Alternatively, you
+may want to look at the <uri
link="http://icculus.org/openbox/index.php/Help:Contents#Configuration">Openbox
configuration guides</uri>.
</p>
<p>
-If manually editing the <path>rc.xml</path> file doesn't sound like your cup of
-tea, you may want to use the GTK+ application to manage your themes and
-behaviours in Openbox. The application that you will use is called ObConf, and
-can be installed on your system just as easily as was Openbox itself.
+If manually editing <path>rc.xml</path> doesn't sound like your cup of tea, you
+may want to use the GTK+ application to manage your themes and behaviours in
+Openbox. The application that you will use is called ObConf, and can be
+installed on your system just as easily as was Openbox itself.
</p>
<pre caption="Installing ObConf">
@@ -249,9 +252,22 @@
<p>
You can then open the configurator by typing <c>obconf</c> in your terminal.
Next, you can go and add an entry for ObConf into your <path>menu.xml</path> so
-it will show up in your Openbox menu.
+it will show up in your Openbox menu. If the "editing the menu.xml file" code
+listing above seemed too vague to be helpful, we'll use ObConf as an example of
+a menu entry:
</p>
+<pre caption="Editing the menu.xml file">
+<?xml version="1.0" encoding="UTF-8"?>
+<openbox_menu>
+<menu id="1" label="Configuration">
+ <item label="OpenBox Config>
+ <action name="execute"><execute>/usr/bin/obconf</execute></action>
+ </item>
+</menu>
+</openbox_menu>>
+</pre>
+
</body>
</section>
<section>
@@ -329,8 +345,9 @@
</p>
<pre caption="Using feh to set the background image">
-<comment>(feh has many other options instead of --bg-scale [which will scale the image
-to the screen dimensions]. Consult the feh documentation.)</comment>
+<comment>(feh has many other options instead of --bg-scale,
+which will scale the image to the screen dimensions.
+Consult the feh documentation.)</comment>
$ <i>feh --bg-scale /path/to/image.jpg</i>
</pre>
@@ -355,11 +372,12 @@
</p>
<p>
-Installing nitrogen and getting it into your Openbox menu requires a few more
-steps than are readily apparent. Firstly, and most obviously, you need to emerge
-nitrogen. Due to <uri link="http://bugs.gentoo.org/show_bug.cgi?id=267231">this
-library dependency bug</uri>, you will also need to <c>emerge librsvg</c> to avoid
-a runtime termination error. Secondly, you need to run nitrogen with your
+Installing nitrogen and getting it into your Openbox menu requires a few more
+steps than are readily apparent. Firstly, and most obviously, you need to
+<c>emerge nitrogen</c>. Due to <uri
+link="http://bugs.gentoo.org/show_bug.cgi?id=267231">this library dependency
+bug</uri>, you may also need to <c>emerge --oneshot librsvg</c> to avoid a
+runtime termination error. Secondly, you need to run nitrogen with your
backgrounds folder appended:
</p>
@@ -369,7 +387,7 @@
<p>
Thirdly, you can set your background image, but it will not be there after you
-logout. Just as with feh, you need to restore your background by editing your
+logout. Just as with feh, you need to restore your background by editing your
<path>autostart.sh</path> script to have the following line:
</p>
@@ -389,285 +407,332 @@
<chapter>
<title>Programs to use with Openbox</title>
<section>
-<title>This list</title>
<body>
<p>
-The following is a list of some programs which you might want to use within
-your Openbox environment. While the list contains numerous terminal emulators,
-file managers, panels, and more, it should by no means be considered
-exhaustive. If none of the programs listed fit your needs, please check the
-appropriate categories in Portage for more options.
+The following is a list of some programs which you might want to use within your
+Openbox environment. While the list contains numerous terminal emulators, file
+managers, panels, and more, it should by no means be considered exhaustive. If
+none of the programs listed fit your needs, please check the appropriate
+categories in Portage for more options.
</p>
</body>
</section>
<section>
-
<title>Terminal emulators</title>
<body>
<ul>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-terms/evilvte"> EvilVTE</uri>
-is an extremely lightweight terminal emulator based on (you guessed it) VTE. It
-supports tabs, multiple encodings, as well as an easy and extensible
-configuration file.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-terms/mrxvt">Mrxvt</uri> is a
-multi-tabbed rxvt clone with XFT, transparent background and CJK support. It
-also features session support for each tab.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-terms/aterm">Aterm</uri>
-supports transparency and backwards compatibility with rxvt. It was originally
-designed for the AfterStep window manager, but easily integrates with other
-environments.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-terms/eterm">Eterm</uri> is a
-terminal based on vt102 and designed to be a more feature-rich replacement for
-xterm.
-</li>
-<li>
-<uri
-link="http://packages.gentoo.org/package/x11-terms/rxvt-unicode">Rxvt-unicode</uri>
-is a clone of rxvt that supports Unicode, daemons, embedded perl, and multiple
-fonts simultaneously.
-</li>
-<li>
-<uri
-link="http://packages.gentoo.org/package/x11-terms/terminal">Terminal</uri> is
-the VTE-based default for the Xfce desktop environment. It is a little on the
-bloated side for use with Openbox, as it pulls in many libraries for Xfce.
-</li>
+<!-- still ~arch
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/lxde-base/lxterminal">LXterminal</uri>
+ is the default terminal emulator for LXDE. It is very lightweight, and
+ based on VTE. While EvilVTE offers many more customisation options
+ (including transparency), LXterminal has a graphical interface for some of the
+ more common options (font, colors, et cetera).
+ </li>
+-->
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/x11-terms/evilvte">EvilVTE</uri> is
+ an extremely lightweight terminal emulator based on (you guessed it) VTE. It
+ supports tabs, multiple encodings, as well as an easy and extensible
+ configuration file.
+ </li>
+ <li>
+ <uri link="http://packages.gentoo.org/package/x11-terms/mrxvt">Mrxvt</uri>
+ is a multi-tabbed rxvt clone with XFT, transparent background and CJK
+ support. It also features session support for each tab.
+ </li>
+ <li>
+ <uri link="http://packages.gentoo.org/package/x11-terms/aterm">Aterm</uri>
+ supports transparency and backwards compatibility with rxvt. It was
+ originally designed for the AfterStep window manager, but easily integrates
+ with other environments.
+ </li>
+ <li>
+ <uri link="http://packages.gentoo.org/package/x11-terms/eterm">Eterm</uri>
+ is a terminal based on vt102 and designed to be a more feature-rich
+ replacement for xterm.
+ </li>
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/x11-terms/rxvt-unicode">Rxvt-unicode</uri>
+ is a clone of rxvt that supports Unicode, daemons, embedded perl, and
+ multiple fonts simultaneously.
+ </li>
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/x11-terms/terminal">Terminal</uri>
+ is the VTE-based default for the Xfce desktop environment, so it does
+ require some Xfce libraries to run. However, it is still fairly speedy, and
+ supports transparency and is easily customized.
+ </li>
</ul>
+
</body>
</section>
<section>
-<title>File Managers</title>
+<title>File managers</title>
<body>
<ul>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-misc/pcmanfm">PCManFM</uri>
-is the lightweight filemanager from LXDE. It supports tabbed browsing, drag and
-drop, thumnails for images, bookmarks, volume management, searching, and more.
-It also provides supports for managing the desktop background and drawing
-desktop icons (both optionally).
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/xfce-base/thunar">Thunar</uri> is
-the standard file manager from Xfce. It features a bulk renamer,
-user-customisable actions, and an extension framework. Since it depends on many
-Xfce libraries, it isn't as lightweight as PCManFM, but it's still slimmed down
-by comparison to other file managers like Nautilus (from GNOME), and Konqueror
-(from KDE).
-</li>
-<li>
-<uri
-link="http://packages.gentoo.org/package/gnome-base/nautilus">Nautilus</uri> is
-the powerful file manager from the GNOME desktop environment. It features
-volume management, thumbnails for images, searching, and some system
-configuration. As it depends on many of the GNOME libraries for proper
-function, it can seem a heavy compared to some of the other file managers.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/app-misc/gentoo">Gentoo</uri> (no
-relation to this glorious Linux distribution) is a two-pane style file manager
-based on GTK+ 1.x. It is incredibly lightweight, but lacks a majority of the
-features now prominent in modern file managers. It should definitely be
-considered for older hardware, or if you are wanting a barebones setup.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/app-misc/emelfm2">emelFM2</uri>
-is another file manager in the vein of Midnight Commander. It features a
-three-pane window, and is requires GTK+ 2.6.x or higher. As with the Gentoo
-file manager (listed above), it is barebones and does not include many features
-prevalent in newer file managers.
-</li>
+<!-- still ~arch
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/x11-misc/pcmanfm">PCManFM</uri> is
+ the lightweight filemanager from LXDE. It supports tabbed browsing, drag and
+ drop, thumnails for images, bookmarks, volume management, searching, and
+ more. It also provides supports for managing the desktop background and
+ drawing desktop icons (both optionally).
+ </li>
+-->
+ <li>
+ <uri link="http://packages.gentoo.org/package/xfce-base/thunar">Thunar</uri>
+ is the standard file manager from Xfce. It features a bulk renamer,
+ user-customisable actions, and an extension framework, along with many
+ optional plugins, such as media tag editing. It depends on several Xfce
+ libraries, but it's still slimmed down compared to other file managers like
+ Nautilus (from GNOME), and Konqueror (from KDE).
+ </li>
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/gnome-base/nautilus">Nautilus</uri>
+ is the powerful file manager from the GNOME desktop environment. It features
+ volume management, thumbnails for images, searching, and some system
+ configuration. As it depends on many of the GNOME libraries for proper
+ function, it can seem a heavy compared to some of the other file managers.
+ </li>
+ <li>
+ <uri link="http://packages.gentoo.org/package/app-misc/gentoo">Gentoo</uri>
+ (no relation to this glorious Linux distribution) is a two-pane style file
+ manager. It is incredibly lightweight, but lacks a some features now
+ prominent in modern file managers. It should definitely be considered for
+ older hardware, or if you are wanting a barebones setup.
+ </li>
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/app-misc/emelfm2">emelFM2</uri> is
+ another file manager in the vein of Midnight Commander. It features a
+ two-pane window. As with the Gentoo file manager (listed above), it is
+ barebones and does not include many features prevalent in newer file
+ managers. However, it also offers a few features not found in other file
+ managers, such as a built-in commandline in a separate pane.
+ </li>
</ul>
+
</body>
</section>
-
<section>
<title>Desktop management</title>
<body>
<ul>
-<li>
-Though <uri
-link="http://packages.gentoo.org/package/x11-misc/pcmanfm">PCManFM</uri> is
-mainly a file manager, it also gives you the option to manage the desktop
-background (instead of using feh or nitrogen) and draw desktop icons. It should
-be noted that with the current release (0.5), it is not readily possible to get
-rid of the default "My Documents" icon on the desktop.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-misc/idesk">iDesk</uri> is a
-simple program used to draw desktop icons. It supports shadowed and
-anti-aliased fonts, PNG images, "snap-to-grid" placement, and changing the
-desktop background.
-</li>
+<!-- still ~arch
+ <li>
+ Though <uri
+ link="http://packages.gentoo.org/package/x11-misc/pcmanfm">PCManFM</uri> is
+ mainly a file manager, it also gives you the option to manage the desktop
+ background (instead of using feh or nitrogen) and draw desktop icons. It
+ should be noted that with the current release (0.5), it is not readily
+ possible to get rid of the default "My Documents" icon on the desktop.
+ </li>
+-->
+ <li>
+ <uri link="http://packages.gentoo.org/package/x11-misc/idesk">iDesk</uri> is
+ a simple program used to draw desktop icons. It supports shadowed and
+ anti-aliased fonts, PNG images, "snap-to-grid" placement, and changing the
+ desktop background.
+ </li>
</ul>
</body>
</section>
-
<section>
<title>Panels</title>
<body>
<ul>
-<li>
-<uri link="http://code.google.com/p/tint2/">Tint2</uri> is a simple panel and
-taskbar specifically made for Openbox3 (based on the ttm code). It supports
-colour/transparency, a clock, and drag and drop between virtual desktops.
-Currently, it is not available in the official Portage tree, but is available
-in overlays.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-misc/pypanel">PyPanel</uri>
-is an easily customised panel written in Python and C. It features
-transparency, shading, tinting, location and layout configuration, font type,
-autohiding, application launcher, clock, and more.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/lxde-base/lxpanel">LXPanel</uri>
-is the default panel and taskbar from LXDE. It features a launcher, menu,
-clock, and a GUI-based configurator. It is feature-rich while depending on very
-few packages, making it a good choice for a lean system.
-</li>
-<li>
-<uri
-link="http://packages.gentoo.org/package/xfce-base/xfce4-panel">Xfce4-panel</uri>
-is the default panel from the Xfce desktop environment. It supports application
-launchers, detachable menus, a pager, tasklist, clock, and more. It does,
-however, require a few of the Xfce libraries which are not dependencies of some
-other panels.
-</li>
+<!-- still ~arch
+ <li>
+ <uri link="http://code.google.com/p/tint2/">Tint2</uri> is a simple panel
+ and taskbar specifically made for Openbox3 (based on the ttm code). It
+ supports color/transparency, a clock, and drag and drop between virtual
+ desktops.
+ </li>
+-->
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/x11-misc/pypanel">PyPanel</uri> is
+ an easily customised panel written in Python and C. It features
+ transparency, shading, tinting, location and layout configuration, font
+ type, autohiding, application launcher, clock, and more.
+ </li>
+<!-- still ~arch
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/lxde-base/lxpanel">LXPanel</uri> is
+ the default panel and taskbar from LXDE. It features a launcher, menu,
+ clock, and a GUI-based configurator. It is feature-rich while depending on
+ very few packages, making it a good choice for a lean system.
+ </li>
+-->
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/xfce-base/xfce4-panel">Xfce4-panel</uri>
+ is the default panel from the Xfce desktop environment. It supports
+ application launchers, detachable menus, a pager, tasklist, clock, applets,
+ and more. It does, however, require a few of the Xfce libraries which are
+ not dependencies of some other panels.
+ </li>
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/x11-misc/fbpanel">FBpanel</uri> is
+ a simple, extremely lightweight panel that supports window lists, launchers,
+ a clock, and a few other goodies. It's not the most featureful panel, and it
+ can be cumbersome to configure, but it needs only GTK+ to run.
+ </li>
</ul>
</body>
</section>
-
<section>
-<title>Pagers / Systrays</title>
+<title>Pagers and systrays</title>
<body>
<ul>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-misc/netwmpager">NetWMpager</uri> is
-an EWMH-compliant pager that integrates nicely into any of the *box environments. It
-is not as obtrusive, and is much more readily customisable than many of the other
-available pagers.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-misc/bbpager">BBpager</uri> is a
-desktop pager that was originally written for BlackBox, but works nicely with Openbox
-as well. It does have some BlackBox dependencies though.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-plugins/docker">Docker</uri> is the
-system tray that is made especially for Openbox. It has no extra dependencies, and
-gives you the ability to view and use tray icons for supported GTK and QT-based
-applications.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-misc/trayer">Trayer</uri> is a system
-tray that was modified from the FBpanel code, and is often used with FVWM. One of its
-perks is that it supports transparency.
-</li>
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/x11-misc/netwmpager">NetWMpager</uri>
+ is an EWMH-compliant pager that integrates nicely into any of the *box
+ environments. It is not as obtrusive, and is much more readily customisable
+ than many of the other available pagers.
+ </li>
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/x11-misc/bbpager">BBpager</uri> is
+ a desktop pager that was originally written for BlackBox, but works nicely
+ with Openbox as well. It does have some BlackBox dependencies though.
+ </li>
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/x11-plugins/docker">Docker</uri> is
+ the system tray that is made especially for Openbox. It has no extra
+ dependencies, and gives you the ability to view and use tray icons for
+ supported GTK and QT-based applications.
+ </li>
+ <li>
+ <uri link="http://packages.gentoo.org/package/x11-misc/trayer">Trayer</uri>
+ is a system tray that was modified from the FBpanel code, and is often used
+ with FVWM. One of its perks is that it supports transparency.
+ </li>
</ul>
</body>
</section>
-
<section>
-<title>Session Management</title>
+<title>Session management</title>
<body>
<ul>
-<li>
-<uri link="http://packages.gentoo.org/package/lxde-base/lxsession-lite">
-LXsession-Lite</uri> is the stripped down session manager from LXDE. It is
-designed to remember applications that the user was running at the last logout,
-and to automatically restart those programs. It also supports the HAL daemon.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/xfce-base/xfce4-session">
-XFCE4-session</uri> is the session manager from, you guessed it, XFCE. It is
-capable of saving several sessions, and provides methods for logging out, rebooting,
-and suspending your computer. It does, however, have many XFCE and other library
-dependencies.
-</li>
+<!-- still ~arch
+ <li>
+ <uri link="http://packages.gentoo.org/package/lxde-base/lxsession">
+ LXsession</uri> is the stripped down session manager from LXDE. It is
+ designed to remember applications that the user was running at the last
+ logout, and to automatically restart those programs. It also supports the
+ HAL daemon.
+ </li>
+-->
+ <li>
+ <uri link="http://packages.gentoo.org/package/xfce-base/xfce4-session">
+ Xfce4-session</uri> is the session manager from, you guessed it, Xfce. It
+ is capable of saving several sessions, and provides methods for logging out,
+ rebooting, and suspending your computer. It does, however, have many Xfce
+ dependencies.
+ </li>
</ul>
</body>
</section>
-
<section>
<title>Configuration tools</title>
<body>
<ul>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-misc/obconf">ObConf</uri> is a GUI
-application allowing you to customise the Openbox window manager without manually
-editing <path>.config/openbox/rc.conf</path>.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/lxde-base/lxappearance">LXappearance</uri> is
-a GTK theme and icon configurator used with LXDE. It provides a nice graphical interface
-for setting the theme and icons, while depending on very few extra libraries.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-themes/gtk-chtheme">GTK-ChTheme</uri> is
-a simple application allowing for easier switching of GTK themes. Currently, it does not
-allow for the switching of icon themes.
-</li>
+ <li>
+ <uri link="http://packages.gentoo.org/package/x11-misc/obconf">ObConf</uri>
+ is a GUI application allowing you to customise the Openbox window manager
+ without manually editing <path>~/.config/openbox/rc.conf</path>.
+ </li>
+<!-- still ~arch
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/lxde-base/lxappearance">LXappearance</uri>
+ is a GTK theme and icon configurator used with LXDE. It provides a nice
+ graphical interface for setting the theme and icons, while depending on very
+ few extra libraries.
+ </li>
+-->
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/x11-themes/gtk-chtheme">GTK-ChTheme</uri>
+ is a simple application allowing for easier switching of GTK themes and your
+ font. Currently, it does not allow for the switching of icon themes.
+ </li>
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/x11-themes/gtk-theme-switch">GTK-theme-switch</uri>
+ is another simple application that lets you change your GTK theme.
+ </li>
</ul>
</body>
</section>
-
<section>
<title>Miscellaneous</title>
<body>
<ul>
-<li>
-<uri link="http://packages.gentoo.org/package/app-admin/conky">Conky</uri> is a
-lightweight system monitor that can natively display over 250 objects,
-including date and time, CPU usage, memory usage, IMAP/POP3 email, top
-processes, and even info from your music player. It is highly customisable both
-in appearance and data display.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/app-editors/leafpad">Leafpad</uri> is
-the default text editor from LXDE. It is very lightweight, but includes features
-like codeset options, and the ability to undo/redo without limits.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/media-gfx/feh">feh</uri> is a
-simple image viewer that runs from the terminal, but it also has many other
-features. It can display a slideshow of images, create an index print,
-dynamically zoom, and set the desktop background (detailed instructions
-above).
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/media-gfx/gpicview">GPicView</uri> is
-a GUI-based image viewer. Though it has more dependencies than feh, it is incredibly
-quick to load and run. This is the default image viewer from LXDE.
-</li>
-<li>
-<uri link="http://packages.gentoo.org/package/x11-misc/slim">SLiM</uri> is the Simple
-Login Manager, which allows you to login to your Openbox session via a graphical
-interface instead of the terminal. It has very few dependencies, and supports many
-external themes, but should not be used on machines that require remote logins.
-</li>
+ <li>
+ <uri link="http://packages.gentoo.org/package/app-admin/conky">Conky</uri>
+ is a lightweight system monitor that can display over 250 objects, including
+ date and time, CPU usage, memory usage, IMAP/POP3 email, top processes,
+ hardware sensor data, and even info from your music player. It is highly
+ customisable both in appearance and data display. We also have a <uri
+ link="/doc/en/conky-howto.xml">Conky configuration guide</uri> available.
+ </li>
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/app-editors/leafpad">Leafpad</uri>
+ is a simple text editor. It is very lightweight, but includes features like
+ codeset options, and the ability to undo/redo without limits.
+ </li>
+ <li>
+ <uri link="http://packages.gentoo.org/package/media-gfx/feh">feh</uri> is a
+ simple image viewer that runs from the terminal, but it also has many other
+ features. It can display a slideshow of images, create an index print,
+ dynamically zoom, and set the desktop background (detailed instructions
+ above).
+ </li>
+<!-- still ~arch
+ <li>
+ <uri
+ link="http://packages.gentoo.org/package/media-gfx/gpicview">GPicView</uri>
+ is a GUI-based image viewer. Though it has more dependencies than feh, it
+ is incredibly quick to load and run.
+ </li>
+-->
+ <li>
+ <uri link="http://packages.gentoo.org/package/x11-misc/slim">SLiM</uri> is
+ the Simple Login Manager, which allows you to login to your Openbox session
+ via a graphical interface instead of the terminal. It has very few
+ dependencies, and supports many themes, but should not be used on machines
+ that require remote logins.
+ </li>
</ul>
</body>
@@ -677,17 +742,16 @@
<chapter id="inside-desktop-env">
<title>Openbox inside desktop environments</title>
<section>
-<title>LXDE (default)</title>
+<title>LXDE</title>
<body>
<p>
If installing each component of a working environment sounds like a little
<e>too</e> much customisation, but you still want the flexibility of Openbox,
-you may want to look into a desktop environment that uses Openbox as its
-default window manager. That environment is <uri
-link="http://www.lxde.org/">LXDE</uri>, the Lightweight X Desktop Environment.
-Designed to require even less system resources than Xfce, it is built around
-Openbox and some of the packages mentioned above (like PCManFM and LXpanel).
+you may want to look into a desktop environment that uses Openbox as its default
+window manager. That environment is <uri link="http://www.lxde.org/">LXDE</uri>,
+the Lightweight X Desktop Environment. Designed to require even fewer system
+resources than Xfce, it is built around Openbox.
</p>
</body>
@@ -699,7 +763,7 @@
<p>
If you already have a GNOME environment installed, you may just want to replace
the Metacity window manager with Openbox. Fortunately, this is quite a simple
-task! You will need to fire up your favourite editor, open your
+task! You will need to fire up your favourite editor, open your
<path>~/.xinitrc</path> file, and put the following command inside it:
</p>
@@ -708,7 +772,7 @@
</pre>
<p>
-If you use GDM or another graphic login manager, you will see a new
+If you use GDM or another graphical login manager, you will see a new
"GNOME/Openbox" option in your session menu. You can simply select that option
instead of manually editing your <path>~/.xinitrc</path>.
</p>
@@ -778,21 +842,23 @@
<path>menu.xml</path>, and locate this line:
</p>
-<pre caption="Finding the exit action in menu.xml"><![CDATA[
-<item label="Exit">
- <action name="Exit"/>
-</item>
-</pre>
-<br />
-and change it to this:
-<br />
+<pre caption="Finding the exit action in menu.xml">
+<item label="Exit">
+ <action name="Exit"/>
+</item>
+</pre>
+
+<p>
+Change it to this:
+</p>
+
<pre caption="Replacing the exit action in menu.xml">
-<item label="Exit">
- <action name="Execute">
- <command>xfce4-session-logout</command>
- </action>
-</item>
-]]></pre>
+<item label="Exit">
+ <action name="Execute">
+ <command>xfce4-session-logout</command>
+ </action>
+</item>
+</pre>
<note>
With Xfce4, the root-menu provided by Xfdesktop will be used instead of the
@@ -805,7 +871,6 @@
<chapter>
<title>Further documentation</title>
-
<section>
<title>External resources</title>
<body>
@@ -818,30 +883,29 @@
</p>
<ul>
-<li>
-On <uri link="http://icculus.org/openbox/index.php/Main_Page">The Official
-Openbox website</uri> you will find more detailed information regarding
-theming, creating menus (including pipe menus), autostart scripting, and much
-more. This site also has information regarding new releases, upgrades, and
-instructions on how you can contribute to development.
-</li>
-<li>
-The <uri link="http://urukrama.wordpress.com/openbox-guide/">Urukrama's Guide
-to Openbox</uri> blog contains a plethora of information about switching GTK+
-themes, setting up keybindings, desktop effects, and other programs to use in
-conjunction with Openbox. Though the tutorial was originally written for use
-with Ubuntu, everything should be applicable to Gentoo (and other Linux
-distributions for that matter).
-</li>
-<li>
-<uri link="http://www.box-look.org/">Box-Look</uri> provides numerous themes,
-icons, wallpapers, fonts, and tools to be used with Openbox (as well as the
-other *box window managers like Fluxbox, Blackbox, PekWM, etc.)
-</li>
+ <li>
+ On <uri link="http://icculus.org/openbox/index.php/Main_Page">The Official
+ Openbox website</uri> you will find more detailed information regarding
+ theming, creating menus (including pipe menus), autostart scripting, and
+ much more. This site also has information regarding new releases, upgrades,
+ and instructions on how you can contribute to development.
+ </li>
+ <li>
+ The <uri link="http://urukrama.wordpress.com/openbox-guide/">Urukrama's
+ Guide to Openbox</uri> blog contains a plethora of information about
+ switching GTK+ themes, setting up keybindings, desktop effects, and other
+ programs to use in conjunction with Openbox. Though the tutorial was
+ originally written for use with Ubuntu, everything is applicable to Gentoo
+ (and other Linux distributions for that matter).
+ </li>
+ <li>
+ <uri link="http://www.box-look.org/">Box-Look</uri> provides numerous
+ themes, icons, wallpapers, fonts, and tools to be used with Openbox (as well
+ as the other *box window managers like Fluxbox, Blackbox, PekWM, etc.)
+ </li>
</ul>
</body>
</section>
</chapter>
</guide>
-
1.221 xml/htdocs/doc/en/metadoc.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/metadoc.xml?rev=1.221&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/metadoc.xml?rev=1.221&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/metadoc.xml?r1=1.220&r2=1.221
Index: metadoc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v
retrieving revision 1.220
retrieving revision 1.221
diff -u -r1.220 -r1.221
--- metadoc.xml 14 Jun 2009 15:05:14 -0000 1.220
+++ metadoc.xml 28 Jun 2009 03:42:02 -0000 1.221
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE metadoc SYSTEM "/dtd/metadoc.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.220 2009/06/14 15:05:14 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.221 2009/06/28 03:42:02 nightmorph Exp $ -->
<metadoc lang="en">
- <version>1.142</version>
+ <version>1.143</version>
<members>
<lead>neysx</lead>
<member>cam</member>
@@ -362,6 +362,7 @@
<file id="zsh">/doc/en/zsh.xml</file>
<file id="change-chost">/doc/en/change-chost.xml</file>
<file id="xfce-config">/doc/en/xfce-config.xml</file>
+ <file id="openbox">/doc/en/openbox.xml</file>
<file id="gcc-optimization">/doc/en/gcc-optimization.xml</file>
<file id="vpnc-howto">/doc/en/vpnc-howto.xml</file>
<file id="qa-autofailure">/proj/en/qa/autofailure.xml</file>
@@ -788,6 +789,9 @@
<doc fileid="xfce-config">
<memberof>desktop_install</memberof>
</doc>
+ <doc fileid="openbox">
+ <memberof>desktop_install</memberof>
+ </doc>
<doc fileid="vserver-howto">
<memberof>sysadmin_specific</memberof>
</doc>
^ permalink raw reply [flat|nested] 2+ messages in thread* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml metadoc.xml
@ 2013-12-09 14:28 Sven Vermeulen (swift)
0 siblings, 0 replies; 2+ messages in thread
From: Sven Vermeulen (swift) @ 2013-12-09 14:28 UTC (permalink / raw
To: gentoo-commits
swift 13/12/09 14:28:46
Modified: openbox.xml metadoc.xml
Log:
Moved to https://wiki.gentoo.org/wiki/Openbox/HOWTO
Revision Changes Path
1.18 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.18&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.18&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.17&r2=1.18
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- openbox.xml 27 Jul 2013 21:06:37 -0000 1.17
+++ openbox.xml 9 Dec 2013 14:28:46 -0000 1.18
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.17 2013/07/27 21:06:37 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.18 2013/12/09 14:28:46 swift Exp $ -->
-<guide>
+<guide disclaimer="obsolete" redirect="https://wiki.gentoo.org/wiki/Openbox/HOWTO">
<title>The Openbox Configuration HOWTO</title>
<author title="Author">
1.318 xml/htdocs/doc/en/metadoc.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/metadoc.xml?rev=1.318&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/metadoc.xml?rev=1.318&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/metadoc.xml?r1=1.317&r2=1.318
Index: metadoc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v
retrieving revision 1.317
retrieving revision 1.318
diff -u -r1.317 -r1.318
--- metadoc.xml 9 Dec 2013 14:19:43 -0000 1.317
+++ metadoc.xml 9 Dec 2013 14:28:46 -0000 1.318
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE metadoc SYSTEM "/dtd/metadoc.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.317 2013/12/09 14:19:43 swift Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.318 2013/12/09 14:28:46 swift Exp $ -->
<metadoc lang="en">
- <version>1.232</version>
+ <version>1.233</version>
<members>
<lead>nightmorph</lead>
<member>flammie</member>
@@ -290,7 +290,6 @@
<file id="x86-at-faq">/proj/en/base/x86/arch-testers-faq.xml</file>
<file id="java-upgrade">/proj/en/java/java-upgrade.xml</file>
<file id="xfce-config">/doc/en/xfce-config.xml</file>
- <file id="openbox">/doc/en/openbox.xml</file>
<file id="vpnc-howto">/doc/en/vpnc-howto.xml</file>
<file id="qa-autofailure">/proj/en/qa/autofailure.xml</file>
<file id="qa-automagic">/proj/en/qa/automagic.xml</file>
@@ -595,9 +594,6 @@
<doc fileid="xfce-config">
<memberof>desktop_install</memberof>
</doc>
- <doc fileid="openbox">
- <memberof>desktop_install</memberof>
- </doc>
<doc fileid="vserver-howto">
<memberof>sysadmin_specific</memberof>
</doc>
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2013-12-09 14:28 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2009-06-28 3:42 [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml metadoc.xml Joshua Saddler (nightmorph)
-- strict thread matches above, loose matches on Subject: below --
2013-12-09 14:28 Sven Vermeulen (swift)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox