* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2009-01-29 17:50 Xavier Neys (neysx)
0 siblings, 0 replies; 14+ messages in thread
From: Xavier Neys (neysx) @ 2009-01-29 17:50 UTC (permalink / raw
To: gentoo-commits
neysx 09/01/29 17:50:21
Added: openbox.xml
Log:
#256693 initial commit
Revision Changes Path
1.1 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.1&content-type=text/plain
Index: openbox.xml
===================================================================
<?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.1 2009/01/29 17:50:20 neysx Exp $ -->
<guide disclaimer="draft">
<title>The Openbox Configuration HOWTO</title>
<author title="Author">
<mail link="kalos"/>
</author>
<abstract>
This guide shows you how to install the Openbox window manager, and references
many potential programs to be used in conjunction with an Openbox session.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>1</version>
<date>2009-01-29</date>
<chapter>
<title>Introduction</title>
<section>
<title>What is Openbox?</title>
<body>
<p>
So, you've installed <uri link="/doc/en/xorg-config.xml">The X Server</uri> and
realised that TWM just isn't going to cut it for your needs. You may have also
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.
</p>
</body>
</section>
<section>
<title>Why should I use it?</title>
<body>
<p>
Openbox, unlike the larger desktop environments, depends on very few libraries.
For that reason, it can provide a lightweight graphic environment that runs
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!
</p>
</body>
</section>
</chapter>
<chapter>
<title>Installation and configuration</title>
<section>
<title>Initial installation</title>
<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:
</p>
<pre caption="Installing Openbox">
<comment>(Use <i>emerge -av openbox</i> to preview which packages will be installed)</comment>
# <i>emerge openbox</i>
</pre>
<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>.
</p>
<pre caption="Adding Openbox to your .xinitrc">
# <i>echo "exec openbox-session" >> ~/.xinitrc</i>
</pre>
<p>
This will automatically start your Openbox session when you type <c>startx</c>
at the terminal.
</p>
<impo>
As each user has his or her own <path>.xinitrc</path>, you need to make sure to
issue that command as <e>your user</e>, not as root.
</impo>
<note>
You can also replace the KDE, GNOME, or Xfce default window manager with
Openbox by following the <uri link="#inside-desktop-env">Openbox inside desktop
environments</uri> directions.
</note>
<p>
Now that you have emerged Openbox and added it to your <path>.xinitrc</path>,
go ahead and issue the <c>startx</c> command to see Openbox in action. As you
can see, the desktop is simply a cluttered mess! In following with the Openbox
philosophy, what you will see is a barebones environment from which you can
build your desktop completely to your liking.
</p>
<p>
Since you're looking at nothing more than a black screen, you may be wondering
where the menu is. If you click your right mouse button, you will notice that a
menu pops up in the location of your cursor. This menu is nothing more than an
example to illustrate the style of an Openbox menu. Since it <e>is</e> just an
example, none of the items in the menu will work unless you have actually
emerged those programs. In the next section, you will see how to create your
own menu that contains links to <e>your</e> programs.
</p>
</body>
</section>
<section>
<title>Menu configuration</title>
<body>
<p>
Since the default Openbox menu is essentially useless to you for the reasons
mentioned above, it's time that we create one that will work. Everything in the
Openbox menu is written in the appropriately named <path>menu.xml</path> file,
which can be in the user-specific location of
<path>~/.config/openbox/menu.xml</path>, or in the system-wide location of
<path>/etc/xdg/openbox/menu.xml</path>. By default, the only
<path>menu.xml</path> file that is created is the system-wide one which applies
to all users on the system.
</p>
<p>
An easy way to get a basic menu file which you can modify is to use MenuMaker,
which will generate a <path>menu.xml</path> file based on the programs which
you currently have installed on your system. To do so, you must firstly emerge
it:
</p>
<pre caption="Installing MenuMaker">
# <i>emerge menumaker</i>
</pre>
<p>
Once it is installed, you need to tell it that you want a menu specifically
using the Openbox XML syntax:
</p>
<pre caption="Using MenuMaker to generate a basic Openbox menu.xml">
# <i>mmaker -v OpenBox3</i>
</pre>
<p>
The generated menu will be located at
<path>/root/.config/openbox/menu.xml</path>. You can then copy the file, and
overwrite either your user-specific <path>menu.xml</path> or the system-wide
one (both mentioned above):
</p>
<pre caption="Overwriting the default menu.xml files">
<comment>(Creating or overwriting your user-specific menu)</comment>
# <i>mv /root/.config/openbox/menu.xml /home/$USER/.config/openbox/menu.xml</i>
OR
<comment>(Overwriting your system-wide menu)</comment>
# <i>mv /root/.config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i>
</pre>
<impo>
It is a good idea to use MenuMaker to generate a default menu, as it will have
the Openbox root-menu items. These items include a virtual desktop switcher,
and the commands to restart and exit your Openbox session.
</impo>
<p>
When you open up the <path>menu.xml</path> file in your favourite editor (nano,
for example), you will notice that the XML tags used are very human-readable
and easily understandable. You may choose to modify the default file to fit
your needs, or you may want to write it from scratch (don't worry, it's really
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="<i>NAME_OF_SEPARATOR</i>">
<menu id="<i>IDENTIFIER</i>" label="<i>NAME_OF_MENU</i>">
<item label="<i>NAME_OF_PROGRAM</i>">
<action name="execute"><execute><i>/LOCATION/OF/BINARY</i></execute></action>
</item>
</menu>
</openbox_menu>
]]></pre>
<p>
Simply replace anything in <c>BLUE CAPS</c> with your information.
</p>
</body>
</section>
<section>
<title>Openbox theme and behaviour configuration</title>
<body>
<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.
</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
<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
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.
</p>
<pre caption="Installing ObConf">
# <i>emerge obconf</i>
</pre>
<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.
</p>
</body>
</section>
<section>
<title>Autostart configuration</title>
<body>
<p>
As mentioned above, you don't see a whole lot when you issue the <c>startx</c>
command for the first time after installing Openbox. In addition to customising
your menus and changing the behaviour of the window manager, you will probably
want to have some programs automatically start with your Openbox session. There
is an easily-editable <path>autostart.sh</path> script that allows you to do
just that. Just like with the <path>menu.xml</path> file, there are two
different locations of the <path>autostart.sh</path> script--the system-wide
(<path>/etc/xdg/openbox/autostart.sh</path>), and the user-defined
(<path>~/.config/openbox/autostart.sh</path>).
</p>
<p>
In the default <path>autostart.sh</path>, you will notice a bunch of lines
calling for programs like the gnome-settings-daemon, XDG, and others. These
lines will generate errors upon logout if you don't have the programs installed
and configured. The easiest thing to do when getting started with Openbox is to
just comment out these lines by using the # symbol.</p>
<pre caption="Commenting out lines in autostart.sh">
# Run XDG autostart things. By default don't run anything desktop-specific
# DESKTOP_ENV=""
# if which /usr/lib/openbox/xdg-autostart >/dev/null; then
# /usr/lib/openbox/xdg-autostart $DESKTOP_ENV
# fi
</pre>
<p>
In the above example, the comment symbol (#) was added before each line. The
commenting method is preferred to just deleting the lines because you may want
to add support for some of those startup items at a later time. Thus, leaving
the default lines in place could ease that process.
</p>
<p>
Adding your own programs to the <path>autostart.sh</path> script is as easy as
writing in the program name for many applications. For instance, if you have
Conky (a lightweight system monitor) installed, and want it to start
automatically with your Openbox session, you simply add the following line to
your <path>autostart.sh</path>:
</p>
<pre caption="Adding Conky to your autostart.sh">
conky &
</pre>
<p>
The ampersand (&) after the command allows that application to load up in
the background. You will most likely want to load all the applications in your
<path>autostart.sh</path> script in the background because doing so will let
Openbox and other programs load without the previous one finishing.
</p>
</body>
</section>
<section>
<title>Setting the background</title>
<body>
<p>
Some things that you might take for granted in bigger desktop environments are
not included by default in Openbox. One such thing is setting your desktop
background. In order to place an image as your wallpaper, you will need to
emerge a program like feh or nitrogen. Feh is a simple image viewer that can
also set the background, <e>and</e> it can easily be put into the autostart
script. Once you have emerged feh, you can issue the following command to set
the background:
</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>
$ <i>feh --bg-scale /path/to/image.jpg</i>
</pre>
<p>
Once you have set the background manually, a file called <path>.fehbg</path>
will be created in your home directory. This file simply contains the above
command that you just entered in the terminal, and is automatically updated
when you issue a different background command. Now, to set your background
automatically upon login, you can add the following line to your
<path>autostart.sh</path> script:
</p>
<pre caption="Using feh to set the background image">
source $HOME/.fehbg &
</pre>
</body>
</section>
</chapter>
<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.
</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>
</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>
</ul>
</body>
</section>
<section>
<title>Panels</title>
<body>
<ul>
<li>
Currently not in the official tree, <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>
</ul>
</body>
</section>
<section>
<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>
</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/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>
</ul>
</body>
</section>
</chapter>
<chapter id="inside-desktop-env">
<title>Openbox inside desktop environments</title>
<section>
<title>LXDE (default)</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).
</p>
</body>
</section>
<section>
<title>Openbox inside GNOME</title>
<body>
<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
<path>~/.xinitrc</path> file, and put the following command inside it:
</p>
<pre caption="Adding an Openbox-GNOME session to your .xinitrc">
exec openbox-gnome-session
</pre>
<p>
If you use GDM or another graphic 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>
<note>
This method of using Openbox with GNOME has been tested with the GNOME 2.22
release. While it seems highly likely that it will work with GNOME 2.24 and
above, it has not been thoroughly tested as of yet.
</note>
</body>
</section>
<section>
<title>Openbox inside KDE</title>
<body>
<p>
Say you have KDE installed and like it, but you want more flexibility with your
window management than KWin offers. You can use Openbox as your window manager
inside of KDE by simply editing your <path>~/.xinitrc</path> file, and
replacing your current exec command with the following:
</p>
<pre caption="Adding an Openbox-KDE session to your .xinitrc">
exec openbox-kde-session
</pre>
<p>
Now when you issue <c>startx</c> you will see KDE, but instead of KWin, you
will have the customisability of the Openbox window manager.
</p>
<p>
If you use KDM or another graphic login manager, you will see a new
"KDE/Openbox" option in your session menu. You can simply select that option
instead of manually editing your <path>~/.xinitrc</path>.
</p>
<note>
This method of using Openbox with KDE has been tested with the KDE 3.x
releases. While it seems highly likely that it will work with the KDE 4.x
series, it has not been thoroughly tested as of yet.
</note>
</body>
</section>
<section>
<title>Openbox inside Xfce</title>
<body>
<p>
If you use Xfce4 and would like to replace xfwm4 with Openbox, you will need to
go about it a little differently than with KDE or GNOME. Firstly, you need to
start your normal Xfce session, and open up a terminal. From the terminal,
issue the following command:
</p>
<pre caption="Killing xfwm4 and replacing it with Openbox">
$ <i>killall xfwm4 ; openbox & exit</i>
</pre>
<p>
Secondly, you need to exit out of your Xfce session, and make sure to tick the
checkbox that says "Save session for future login." This will keep Openbox as
your default window manager. Thirdly, you will notice that you can't logout
properly when using the default menu action. To fix this problem, open up your
<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="Replacing the exit action in menu.xml">
<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
Openbox root-menu.
</note>
</body>
</section>
</chapter>
<chapter>
<title>Further documentation</title>
<section>
<title>External resources</title>
<body>
<p>
While this document will easily take you through the inital installation and
customisation of Openbox, it is by no means the only reference on the topic.
There are several other resources that will aid you in creating your perfect
Openbox setup. Some of them are listed below:
</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>
</ul>
</body>
</section>
</chapter>
</guide>
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2009-04-27 20:18 Xavier Neys (neysx)
0 siblings, 0 replies; 14+ messages in thread
From: Xavier Neys (neysx) @ 2009-04-27 20:18 UTC (permalink / raw
To: gentoo-commits
neysx 09/04/27 20:18:50
Modified: openbox.xml
Log:
New draft from #256693
Revision Changes Path
1.2 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.2&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.2&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.1&r2=1.2
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- openbox.xml 29 Jan 2009 17:50:20 -0000 1.1
+++ openbox.xml 27 Apr 2009 20:18:50 -0000 1.2
@@ -1,6 +1,6 @@
<?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.1 2009/01/29 17:50:20 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.2 2009/04/27 20:18:50 neysx Exp $ -->
<guide disclaimer="draft">
<title>The Openbox Configuration HOWTO</title>
@@ -18,8 +18,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1</version>
-<date>2009-01-29</date>
+<version>1.1</version>
+<date>2009-04-27</date>
<chapter>
<title>Introduction</title>
@@ -151,29 +151,24 @@
</pre>
<p>
-Once it is installed, you need to tell it that you want a menu specifically
-using the Openbox XML syntax:
+Once it is installed, make sure to logout of root, and back into your user account.
+You then instruct MenuMaker to create a menu specifically using the Openbox XML
+syntax:
</p>
<pre caption="Using MenuMaker to generate a basic Openbox menu.xml">
-# <i>mmaker -v OpenBox3</i>
+$ <i>mmaker -v OpenBox3</i>
</pre>
<p>
The generated menu will be located at
-<path>/root/.config/openbox/menu.xml</path>. You can then copy the file, and
-overwrite either your user-specific <path>menu.xml</path> or the system-wide
-one (both mentioned above):
+<path>~/.config/openbox/menu.xml</path>. You can then choose to leave it as
+your user-specific <path>menu.xml</path>, or to additionally copy it to the
+system-wide menu configuration as well:
</p>
-<pre caption="Overwriting the default menu.xml files">
-<comment>(Creating or overwriting your user-specific menu)</comment>
-# <i>mv /root/.config/openbox/menu.xml /home/$USER/.config/openbox/menu.xml</i>
-
-OR
-
-<comment>(Overwriting your system-wide menu)</comment>
-# <i>mv /root/.config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i>
+<pre caption="Overwriting the default system-wide menu.xml files">
+$ <i>mv .config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i>
</pre>
<impo>
@@ -193,17 +188,24 @@
<pre caption="Editing the menu.xml file"><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<openbox_menu>
-<separator label="<i>NAME_OF_SEPARATOR</i>">
-<menu id="<i>IDENTIFIER</i>" label="<i>NAME_OF_MENU</i>">
- <item label="<i>NAME_OF_PROGRAM</i>">
- <action name="execute"><execute><i>/LOCATION/OF/BINARY</i></execute></action>
+<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 <c>BLUE CAPS</c> with your information.
+Simply replace anything in CAPS with your information.
+</p>
+
+<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
+nice amount of customisation without typing any XML.
</p>
</body>
@@ -327,8 +329,8 @@
</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>
@@ -345,6 +347,41 @@
source $HOME/.fehbg &
</pre>
+<p>
+If you don't particularly care for the idea of having to issue a command in the
+terminal in order to set your background, you can alternatively use nitrogen. It
+will allow you to set a folder for your background images, view thumbnails of
+those images, and fit, stretch, or tile them to your desktop.
+</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
+backgrounds folder appended:
+</p>
+
+<pre caption="Starting nitrogen with your image folder">
+nitrogen /path/to/your/backgrounds/folder
+</pre>
+
+<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
+<path>autostart.sh</path> script to have the following line:
+</p>
+
+<pre caption="Restoring your background with nitrogen">
+nitrogen --restore &
+</pre>
+
+<p>
+This will cause nitrogen to load automatically when you start your Openbox session,
+and that can lead to a slightly slower load time than using feh.
+</p>
+
</body>
</section>
</chapter>
@@ -410,6 +447,52 @@
</section>
<section>
+<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>
+</ul>
+</body>
+</section>
+
+<section>
<title>Desktop management</title>
<body>
@@ -432,14 +515,14 @@
</body>
</section>
+
<section>
<title>Panels</title>
<body>
<ul>
<li>
-Currently not in the official tree, <uri
-link="http://code.google.com/p/tint2/">Tint2</uri> is a simple panel and
+<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
@@ -469,51 +552,87 @@
</body>
</section>
+
<section>
-<title>File Managers</title>
+<title>Pagers / Systrays</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).
+<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/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).
+<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/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.
+<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/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.
+<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>
+<body>
+
+<ul>
<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.
+<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>
+</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>
</ul>
+
</body>
</section>
+
<section>
<title>Miscellaneous</title>
<body>
@@ -527,12 +646,28 @@
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>
</ul>
</body>
@@ -709,3 +844,4 @@
</section>
</chapter>
</guide>
+
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2009-08-13 19:54 Robin H. Johnson (robbat2)
0 siblings, 0 replies; 14+ messages in thread
From: Robin H. Johnson (robbat2) @ 2009-08-13 19:54 UTC (permalink / raw
To: gentoo-commits
robbat2 09/08/13 19:54:27
Modified: openbox.xml
Log:
Kalos has renamed to NathanZachary.
Revision Changes Path
1.4 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.4&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.4&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.3&r2=1.4
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -p -w -b -B -u -u -r1.3 -r1.4
--- openbox.xml 28 Jun 2009 03:42:02 -0000 1.3
+++ openbox.xml 13 Aug 2009 19:54:27 -0000 1.4
@@ -1,12 +1,12 @@
<?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.3 2009/06/28 03:42:02 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.4 2009/08/13 19:54:27 robbat2 Exp $ -->
<guide>
<title>The Openbox Configuration HOWTO</title>
<author title="Author">
- <mail link="kalos"/>
+ <mail link="nathanzachary"/>
</author>
<author title="Author">
<mail link="nightmorph"/>
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2009-11-12 22:55 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 14+ messages in thread
From: Joshua Saddler (nightmorph) @ 2009-11-12 22:55 UTC (permalink / raw
To: gentoo-commits
nightmorph 09/11/12 22:55:44
Modified: openbox.xml
Log:
now using the kde4 guide
Revision Changes Path
1.5 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.5&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.5&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.4&r2=1.5
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- openbox.xml 13 Aug 2009 19:54:27 -0000 1.4
+++ openbox.xml 12 Nov 2009 22:55:43 -0000 1.5
@@ -1,6 +1,6 @@
<?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.4 2009/08/13 19:54:27 robbat2 Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.5 2009/11/12 22:55:43 nightmorph Exp $ -->
<guide>
<title>The Openbox Configuration HOWTO</title>
@@ -21,8 +21,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.2</version>
-<date>2009-06-27</date>
+<version>1.3</version>
+<date>2009-11-12</date>
<chapter>
<title>Introduction</title>
@@ -35,7 +35,7 @@
So, you've installed <uri link="/doc/en/xorg-config.xml">The X Server</uri> and
realised that TWM just isn't going to cut it for your needs. You may have also
had some experience with big desktop environments like <uri
-link="/proj/en/desktop/kde/kde-config.xml">KDE</uri>, <uri
+link="/proj/en/desktop/kde/kde4-guide.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
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2009-12-29 19:23 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 14+ messages in thread
From: Joshua Saddler (nightmorph) @ 2009-12-29 19:23 UTC (permalink / raw
To: gentoo-commits
nightmorph 09/12/29 19:23:09
Modified: openbox.xml
Log:
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.
Revision Changes Path
1.6 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.6&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.6&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.5&r2=1.6
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- openbox.xml 12 Nov 2009 22:55:43 -0000 1.5
+++ openbox.xml 29 Dec 2009 19:23:08 -0000 1.6
@@ -1,6 +1,6 @@
<?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.5 2009/11/12 22:55:43 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.6 2009/12/29 19:23:08 nightmorph Exp $ -->
<guide>
<title>The Openbox Configuration HOWTO</title>
@@ -21,8 +21,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.3</version>
-<date>2009-11-12</date>
+<version>1.4</version>
+<date>2009-12-29</date>
<chapter>
<title>Introduction</title>
@@ -56,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, those choices are yours!
+or any other program, those choices are yours to make!
</p>
</body>
@@ -170,7 +170,7 @@
</p>
<pre caption="Overwriting the default system-wide menu.xml files">
-$ <i>cp .config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i>
+# <i>cp .config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i>
</pre>
<impo>
@@ -188,13 +188,12 @@
</p>
<pre caption="Editing the menu.xml file">
-<?xml version="1.0" encoding="UTF-8"?7gt;
+<?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>
+ <action name="execute"><execute>/LOCATION/OF/BINARY</execute></action>
</item>
</menu>
</openbox_menu>
@@ -261,11 +260,11 @@
<?xml version="1.0" encoding="UTF-8"?>
<openbox_menu>
<menu id="1" label="Configuration">
- <item label="OpenBox Config>
+ <item label="OpenBox Config">
<action name="execute"><execute>/usr/bin/obconf</execute></action>
</item>
</menu>
-</openbox_menu>>
+</openbox_menu>
</pre>
</body>
@@ -311,9 +310,10 @@
<p>
Adding your own programs to the <path>autostart.sh</path> script is as easy as
writing in the program name for many applications. For instance, if you have
-Conky (a lightweight system monitor) installed, and want it to start
-automatically with your Openbox session, you simply add the following line to
-your <path>autostart.sh</path>:
+<uri link="http://packages.gentoo.org/package/app-admin/conky">Conky</uri> (a
+lightweight system monitor) installed, and want it to start automatically with
+your Openbox session, you simply add the following line to your
+<path>autostart.sh</path>:
</p>
<pre caption="Adding Conky to your autostart.sh">
@@ -338,10 +338,12 @@
Some things that you might take for granted in bigger desktop environments are
not included by default in Openbox. One such thing is setting your desktop
background. In order to place an image as your wallpaper, you will need to
-emerge a program like feh or nitrogen. Feh is a simple image viewer that can
-also set the background, <e>and</e> it can easily be put into the autostart
-script. Once you have emerged feh, you can issue the following command to set
-the background:
+emerge a program like <uri
+link="http://packages.gentoo.org/package/media-gfx/feh">feh</uri> or <uri
+link="http://packages.gentoo.org/package/x11-misc/nitrogen">nitrogen</uri>.
+<c>feh</c> is a simple image viewer that can also set the background, <e>and</e>
+it can easily be put into the autostart script. Once you have emerged
+<c>feh</c>, you can issue the following command to set the background:
</p>
<pre caption="Using feh to set the background image">
@@ -365,30 +367,27 @@
</pre>
<p>
-If you don't particularly care for the idea of having to issue a command in the
-terminal in order to set your background, you can alternatively use nitrogen. It
-will allow you to set a folder for your background images, view thumbnails of
-those images, and fit, stretch, or tile them to your desktop.
+If you don't particularly care for the idea of having to issue a command in the
+terminal in order to set your background, you can alternatively use
+<c>nitrogen</c>. It will allow you to set a folder for your background images,
+view thumbnails of those images, and fit, stretch, or tile them to your
+desktop.
</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
-<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:
+Installing <c>nitrogen</c> and getting it into your Openbox menu requires a few
+more steps than are readily apparent. First, you need to <c>emerge nitrogen</c>.
+Second, you need to run <c>nitrogen</c> with your backgrounds folder appended:
</p>
<pre caption="Starting nitrogen with your image folder">
-nitrogen /path/to/your/backgrounds/folder
+$ <i>nitrogen /path/to/your/backgrounds/folder</i>
</pre>
<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
-<path>autostart.sh</path> script to have the following line:
+Third, you can set your background image, but it will not be there after you
+logout. Just as with <c>feh</c>, you need to restore your background by editing
+your <path>autostart.sh</path> script to have the following line:
</p>
<pre caption="Restoring your background with nitrogen">
@@ -424,16 +423,14 @@
<body>
<ul>
-<!-- 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).
+ 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
@@ -468,28 +465,25 @@
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.
+ supports transparency and is easily customised.
</li>
</ul>
</body>
</section>
-
<section>
<title>File managers</title>
<body>
<ul>
-<!-- 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
+ 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,
@@ -504,7 +498,8 @@
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.
+ function, it can seem a bit heavy compared to some of the other file
+ managers.
</li>
<li>
<uri link="http://packages.gentoo.org/package/app-misc/gentoo">Gentoo</uri>
@@ -531,16 +526,15 @@
<body>
<ul>
-<!-- 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.
+ background (instead of using <c>feh</c> or <c>nitrogen</c>) and draw
+ desktop icons. It should be noted that with the current release (0.5.x), 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
@@ -556,14 +550,11 @@
<body>
<ul>
-<!-- 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.
+ and taskbar (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
@@ -571,7 +562,6 @@
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
@@ -579,7 +569,6 @@
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>
@@ -638,7 +627,6 @@
<body>
<ul>
-<!-- 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
@@ -646,7 +634,6 @@
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
@@ -668,7 +655,6 @@
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>
@@ -676,7 +662,6 @@
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>
@@ -718,14 +703,12 @@
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.
+ is a GUI-based image viewer. Though it has more dependencies than
+ <c>feh</c>, 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
@@ -777,12 +760,6 @@
instead of manually editing your <path>~/.xinitrc</path>.
</p>
-<note>
-This method of using Openbox with GNOME has been tested with the GNOME 2.22
-release. While it seems highly likely that it will work with GNOME 2.24 and
-above, it has not been thoroughly tested as of yet.
-</note>
-
</body>
</section>
<section>
@@ -825,7 +802,7 @@
<p>
If you use Xfce4 and would like to replace xfwm4 with Openbox, you will need to
-go about it a little differently than with KDE or GNOME. Firstly, you need to
+go about it a little differently than with KDE or GNOME. First, you need to
start your normal Xfce session, and open up a terminal. From the terminal,
issue the following command:
</p>
@@ -835,9 +812,9 @@
</pre>
<p>
-Secondly, you need to exit out of your Xfce session, and make sure to tick the
+Second, you need to exit out of your Xfce session, and make sure to tick the
checkbox that says "Save session for future login." This will keep Openbox as
-your default window manager. Thirdly, you will notice that you can't logout
+your default window manager. Third, you will notice that you can't logout
properly when using the default menu action. To fix this problem, open up your
<path>menu.xml</path>, and locate this line:
</p>
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2010-02-14 20:34 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 14+ messages in thread
From: Joshua Saddler (nightmorph) @ 2010-02-14 20:34 UTC (permalink / raw
To: gentoo-commits
nightmorph 10/02/14 20:34:49
Modified: openbox.xml
Log:
Updates from bug 256693
Revision Changes Path
1.7 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.7&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.7&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.6&r2=1.7
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- openbox.xml 29 Dec 2009 19:23:08 -0000 1.6
+++ openbox.xml 14 Feb 2010 20:34:48 -0000 1.7
@@ -1,6 +1,6 @@
<?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.6 2009/12/29 19:23:08 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.7 2010/02/14 20:34:48 nightmorph Exp $ -->
<guide>
<title>The Openbox Configuration HOWTO</title>
@@ -21,8 +21,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.4</version>
-<date>2009-12-29</date>
+<version>1.5</version>
+<date>2010-02-14</date>
<chapter>
<title>Introduction</title>
@@ -124,6 +124,12 @@
own menu that contains links to <e>your</e> programs.
</p>
+<impo>
+If you click to view the menu and notice that there is nothing legible, you need
+to install some fonts. Two common choices are <c>media-fonts/corefonts</c> and
+<c>media-fonts/ttf-bitstream-vera</c>.
+</impo>
+
</body>
</section>
<section>
@@ -153,9 +159,9 @@
</pre>
<p>
-Once it is installed, make sure to logout of root, and back into your user account.
-You then instruct MenuMaker to create a menu specifically using the Openbox XML
-syntax:
+Once it is installed, make sure to logout of root, and back into your user
+account. You then instruct MenuMaker to create a menu specifically using the
+Openbox XML syntax:
</p>
<pre caption="Using MenuMaker to generate a basic Openbox menu.xml">
@@ -200,10 +206,26 @@
</pre>
<p>
-Simply replace anything in CAPS with your information.
+The above example will work for any applications that launch with standard
+options in their own windows, but what if you need to append options to
+the program at launch time? That is no problem either, but the syntax of
+the menu item is slightly different.
</p>
+<pre caption="Editing the menu.xml file">
+<?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"><command>/LOCATION/OF/BINARY --OPTION1 --OPTION2</command></action>
+ </item>
+</menu>
+</openbox_menu>
+</pre>
+
<p>
+Simply replace anything in CAPS in the above two examples with your information.
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
@@ -267,6 +289,22 @@
</openbox_menu>
</pre>
+<p>
+While ObConf is a great GUI tool for editing many behaviour-related settings
+for Openbox, it doesn't allow one to manipulate nearly as many settings as
+are presented in the <path>rc.xml</path> file itself. If you are having
+trouble finding a particular setting which you would like to change, please
+consult the <uri link="http://openbox.org/wiki/Configuration">Openbox Wiki</uri>
+for more information.
+</p>
+
+<note>
+In recent versions of Openbox (namely >3.4.7.2), one may experience a delay
+in the submenu opening. This setting was introduced into the rc.xml file, and
+is listed as <submenuShowDelay>100</submenuShowDelay>. Simply
+choose a lower number that suits your needs.
+</note>
+
</body>
</section>
<section>
@@ -861,11 +899,11 @@
<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.
+ On <uri link="http://openbox.org/">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
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2010-05-17 19:36 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 14+ messages in thread
From: Joshua Saddler (nightmorph) @ 2010-05-17 19:36 UTC (permalink / raw
To: gentoo-commits
nightmorph 10/05/17 19:36:05
Modified: openbox.xml
Log:
Update openbox guide with a tip on troubleshooting consolekit/dbus, bug 256693
Revision Changes Path
1.8 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.8&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.8&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.7&r2=1.8
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- openbox.xml 14 Feb 2010 20:34:48 -0000 1.7
+++ openbox.xml 17 May 2010 19:36:04 -0000 1.8
@@ -1,6 +1,6 @@
<?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.7 2010/02/14 20:34:48 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.8 2010/05/17 19:36:04 nightmorph Exp $ -->
<guide>
<title>The Openbox Configuration HOWTO</title>
@@ -21,8 +21,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.5</version>
-<date>2010-02-14</date>
+<version>2</version>
+<date>2010-05-17</date>
<chapter>
<title>Introduction</title>
@@ -101,6 +101,12 @@
</impo>
<note>
+If you experience problems with automounting, or if you use dbus and ConsoleKit,
+you may want to put <c>exec ck-launch-session dbus-launch openbox-session</c> in
+your <path>.xinitrc</path> instead of the default mentioned above.
+</note>
+
+<note>
You can also replace the KDE, GNOME, or Xfce default window manager with
Openbox by following the <uri link="#inside-desktop-env">Openbox inside desktop
environments</uri> directions.
@@ -109,7 +115,7 @@
<p>
Now that you have emerged Openbox and added it to your <path>.xinitrc</path>,
go ahead and issue the <c>startx</c> command to see Openbox in action. As you
-can see, the desktop is simply a cluttered mess! In following with the Openbox
+can see, the desktop is simply a cluttered mess! In following with the Openbox
philosophy, what you will see is a barebones environment from which you can
build your desktop completely to your liking.
</p>
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2010-09-02 8:19 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 14+ messages in thread
From: Joshua Saddler (nightmorph) @ 2010-09-02 8:19 UTC (permalink / raw
To: gentoo-commits
nightmorph 10/09/02 08:19:28
Modified: openbox.xml
Log:
update openbox guide: fix a few guideXML mistakes, smarter openbox install command, remove pcmanfm note on desktop icons, expand tint2 description for new features in the latest stable version
Revision Changes Path
1.9 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.9&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.9&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.8&r2=1.9
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- openbox.xml 17 May 2010 19:36:04 -0000 1.8
+++ openbox.xml 2 Sep 2010 08:19:27 -0000 1.9
@@ -1,6 +1,6 @@
<?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.8 2010/05/17 19:36:04 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.9 2010/09/02 08:19:27 nightmorph Exp $ -->
<guide>
<title>The Openbox Configuration HOWTO</title>
@@ -65,7 +65,6 @@
<chapter>
<title>Installation and configuration</title>
-
<section>
<title>Initial installation</title>
<body>
@@ -76,8 +75,7 @@
</p>
<pre caption="Installing Openbox">
-<comment>(Use <i>emerge -av openbox</i> to preview which packages will be installed)</comment>
-# <i>emerge openbox</i>
+# <i>emerge -av openbox</i>
</pre>
<p>
@@ -240,7 +238,6 @@
</body>
</section>
-
<section>
<title>Openbox theme and behaviour configuration</title>
<body>
@@ -373,7 +370,6 @@
</body>
</section>
-
<section>
<title>Setting the background</title>
<body>
@@ -439,8 +435,8 @@
</pre>
<p>
-This will cause nitrogen to load automatically when you start your Openbox session,
-and that can lead to a slightly slower load time than using feh.
+This will cause nitrogen to load automatically when you start your Openbox
+session, and that can lead to a slightly slower load time than using feh.
</p>
</body>
@@ -575,9 +571,7 @@
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 <c>feh</c> or <c>nitrogen</c>) and draw
- desktop icons. It should be noted that with the current release (0.5.x), it
- is not readily possible to get rid of the default "My Documents" icon on the
- desktop.
+ desktop icons.
</li>
<li>
<uri link="http://packages.gentoo.org/package/x11-misc/idesk">iDesk</uri> is
@@ -595,9 +589,11 @@
<ul>
<li>
- <uri link="http://code.google.com/p/tint2/">Tint2</uri> is a simple panel
- and taskbar (based on the ttm code). It supports color/transparency, a
- clock, and drag and drop between virtual desktops.
+ <uri link="http://code.google.com/p/tint2/">Tint2</uri> is a simple,
+ lightweight panel and taskbar. It supports color, transparency, a clock,
+ drag and drop between virtual desktops, a system tray, and comes with a
+ battery monitor. You can even add a button to display the applications menu
+ from your window manager.
</li>
<li>
<uri
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2010-09-02 8:20 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 14+ messages in thread
From: Joshua Saddler (nightmorph) @ 2010-09-02 8:20 UTC (permalink / raw
To: gentoo-commits
nightmorph 10/09/02 08:20:43
Modified: openbox.xml
Log:
bah, revbump for previous commit. i was so excited about updating the doc with new features that i forgot to version it.
Revision Changes Path
1.10 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.10&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.10&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.9&r2=1.10
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- openbox.xml 2 Sep 2010 08:19:27 -0000 1.9
+++ openbox.xml 2 Sep 2010 08:20:43 -0000 1.10
@@ -1,6 +1,6 @@
<?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.9 2010/09/02 08:19:27 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.10 2010/09/02 08:20:43 nightmorph Exp $ -->
<guide>
<title>The Openbox Configuration HOWTO</title>
@@ -21,8 +21,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>2</version>
-<date>2010-05-17</date>
+<version>3</version>
+<date>2010-09-02</date>
<chapter>
<title>Introduction</title>
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2010-12-24 8:39 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 14+ messages in thread
From: Joshua Saddler (nightmorph) @ 2010-12-24 8:39 UTC (permalink / raw
To: gentoo-commits
nightmorph 10/12/24 08:39:52
Modified: openbox.xml
Log:
add policykit stuff, bug 349480
Revision Changes Path
1.11 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.11&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.11&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.10&r2=1.11
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- openbox.xml 2 Sep 2010 08:20:43 -0000 1.10
+++ openbox.xml 24 Dec 2010 08:39:51 -0000 1.11
@@ -1,6 +1,6 @@
<?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.10 2010/09/02 08:20:43 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.11 2010/12/24 08:39:51 nightmorph Exp $ -->
<guide>
<title>The Openbox Configuration HOWTO</title>
@@ -21,8 +21,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>3</version>
-<date>2010-09-02</date>
+<version>4</version>
+<date>2010-12-24</date>
<chapter>
<title>Introduction</title>
@@ -100,8 +100,9 @@
<note>
If you experience problems with automounting, or if you use dbus and ConsoleKit,
-you may want to put <c>exec ck-launch-session dbus-launch openbox-session</c> in
-your <path>.xinitrc</path> instead of the default mentioned above.
+you may want to put <c>exec ck-launch-session dbus-launch --sh-syntax
+--exit-with-session openbox-session</c> in your <path>.xinitrc</path> instead of
+the default mentioned above.
</note>
<note>
@@ -371,6 +372,37 @@
</body>
</section>
<section>
+<title>Configuring PolicyKit</title>
+<body>
+
+<p>
+Many applications depend on the <uri
+link="http://hal.freedesktop.org/docs/PolicyKit">PolicyKit</uri> authentication
+framework. You may need a PolicyKit agent, such as <c>polkit-gnome</c>, running
+in your Openbox session.
+</p>
+
+<p>
+First, install the agent:
+</p>
+
+<pre caption="Installing PolicyKit">
+# <i>emerge polkit-gnome</i>
+</pre>
+
+<p>
+Now configure PolicyKit to start automatically when you login to Openbox. Add
+the following line to <path>~/.config/openbox/autostart</path> (for a single
+user) or <path>/etc/xdg/openbox/autostart.sh</path> (for all users):
+</p>
+
+<pre caption="Start PolicyKit automatically">
+sleep 1 && /usr/libexec/polkit-gnome-authentication-agent-1 &
+</pre>
+
+</body>
+</section>
+<section>
<title>Setting the background</title>
<body>
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2010-12-25 18:12 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 14+ messages in thread
From: Joshua Saddler (nightmorph) @ 2010-12-25 18:12 UTC (permalink / raw
To: gentoo-commits
nightmorph 10/12/25 18:12:57
Modified: openbox.xml
Log:
Correct PolKit references, bug 349480
Revision Changes Path
1.12 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.12&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.12&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.11&r2=1.12
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- openbox.xml 24 Dec 2010 08:39:51 -0000 1.11
+++ openbox.xml 25 Dec 2010 18:12:57 -0000 1.12
@@ -1,6 +1,6 @@
<?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.11 2010/12/24 08:39:51 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.12 2010/12/25 18:12:57 nightmorph Exp $ -->
<guide>
<title>The Openbox Configuration HOWTO</title>
@@ -21,8 +21,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>4</version>
-<date>2010-12-24</date>
+<version>5</version>
+<date>2010-12-25</date>
<chapter>
<title>Introduction</title>
@@ -377,8 +377,8 @@
<p>
Many applications depend on the <uri
-link="http://hal.freedesktop.org/docs/PolicyKit">PolicyKit</uri> authentication
-framework. You may need a PolicyKit agent, such as <c>polkit-gnome</c>, running
+link="http://hal.freedesktop.org/docs/PolicyKit">PolKit</uri> authentication
+framework. You may need a PolKit agent, such as <c>polkit-gnome</c>, running
in your Openbox session.
</p>
@@ -386,17 +386,17 @@
First, install the agent:
</p>
-<pre caption="Installing PolicyKit">
+<pre caption="Installing PolKit">
# <i>emerge polkit-gnome</i>
</pre>
<p>
-Now configure PolicyKit to start automatically when you login to Openbox. Add
+Now configure PolKit to start automatically when you login to Openbox. Add
the following line to <path>~/.config/openbox/autostart</path> (for a single
user) or <path>/etc/xdg/openbox/autostart.sh</path> (for all users):
</p>
-<pre caption="Start PolicyKit automatically">
+<pre caption="Start PolKit automatically">
sleep 1 && /usr/libexec/polkit-gnome-authentication-agent-1 &
</pre>
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2010-12-25 23:31 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 14+ messages in thread
From: Joshua Saddler (nightmorph) @ 2010-12-25 23:31 UTC (permalink / raw
To: gentoo-commits
nightmorph 10/12/25 23:31:25
Modified: openbox.xml
Log:
Add polkit-qt reference, bug 349480
Revision Changes Path
1.13 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.13&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.13&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.12&r2=1.13
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- openbox.xml 25 Dec 2010 18:12:57 -0000 1.12
+++ openbox.xml 25 Dec 2010 23:31:25 -0000 1.13
@@ -1,6 +1,6 @@
<?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.12 2010/12/25 18:12:57 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.13 2010/12/25 23:31:25 nightmorph Exp $ -->
<guide>
<title>The Openbox Configuration HOWTO</title>
@@ -21,7 +21,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>5</version>
+<version>6</version>
<date>2010-12-25</date>
<chapter>
@@ -372,7 +372,7 @@
</body>
</section>
<section>
-<title>Configuring PolicyKit</title>
+<title>Configuring PolKit</title>
<body>
<p>
@@ -390,6 +390,11 @@
# <i>emerge polkit-gnome</i>
</pre>
+<note>
+If you mostly use Qt-based applications with Openbox (rather than gtk-based),
+you may want to emerge <c>polkit-qt</c> instead of <c>polkit-gnome</c>.
+</note>
+
<p>
Now configure PolKit to start automatically when you login to Openbox. Add
the following line to <path>~/.config/openbox/autostart</path> (for a single
@@ -400,6 +405,12 @@
sleep 1 && /usr/libexec/polkit-gnome-authentication-agent-1 &
</pre>
+<note>
+If you installed <c>polkit-qt</c> instead of <c>polkit-gnome</c>, change
+<path>polkit-gnome-authentication-agent-1</path> to
+<path>polkit-qt-authentication-agent-1</path>.
+</note>
+
</body>
</section>
<section>
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2010-12-26 2:15 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 14+ messages in thread
From: Joshua Saddler (nightmorph) @ 2010-12-26 2:15 UTC (permalink / raw
To: gentoo-commits
nightmorph 10/12/26 02:15:42
Modified: openbox.xml
Log:
remove polkit-qt reference entirely. it should have been polkit-kde per bug 349480 comment #5. it turns out that polkit-kde requires pretty much all of the base kde-* packages, which negates building the lightweight Openbox environment laid out in the guide. polkit-gnome has no such requirements for gtk apps.
Revision Changes Path
1.14 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.14&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.14&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.13&r2=1.14
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- openbox.xml 25 Dec 2010 23:31:25 -0000 1.13
+++ openbox.xml 26 Dec 2010 02:15:42 -0000 1.14
@@ -1,6 +1,6 @@
<?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.13 2010/12/25 23:31:25 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.14 2010/12/26 02:15:42 nightmorph Exp $ -->
<guide>
<title>The Openbox Configuration HOWTO</title>
@@ -21,7 +21,7 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>6</version>
+<version>7</version>
<date>2010-12-25</date>
<chapter>
@@ -390,11 +390,6 @@
# <i>emerge polkit-gnome</i>
</pre>
-<note>
-If you mostly use Qt-based applications with Openbox (rather than gtk-based),
-you may want to emerge <c>polkit-qt</c> instead of <c>polkit-gnome</c>.
-</note>
-
<p>
Now configure PolKit to start automatically when you login to Openbox. Add
the following line to <path>~/.config/openbox/autostart</path> (for a single
@@ -405,12 +400,6 @@
sleep 1 && /usr/libexec/polkit-gnome-authentication-agent-1 &
</pre>
-<note>
-If you installed <c>polkit-qt</c> instead of <c>polkit-gnome</c>, change
-<path>polkit-gnome-authentication-agent-1</path> to
-<path>polkit-qt-authentication-agent-1</path>.
-</note>
-
</body>
</section>
<section>
^ permalink raw reply [flat|nested] 14+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml
@ 2011-03-21 20:19 Joshua Saddler (nightmorph)
0 siblings, 0 replies; 14+ messages in thread
From: Joshua Saddler (nightmorph) @ 2011-03-21 20:19 UTC (permalink / raw
To: gentoo-commits
nightmorph 11/03/21 20:19:03
Modified: openbox.xml
Log:
typo fix, no content change, #359749
Revision Changes Path
1.15 xml/htdocs/doc/en/openbox.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.15&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.15&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.14&r2=1.15
Index: openbox.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- openbox.xml 26 Dec 2010 02:15:42 -0000 1.14
+++ openbox.xml 21 Mar 2011 20:19:03 -0000 1.15
@@ -1,6 +1,6 @@
<?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.14 2010/12/26 02:15:42 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.15 2011/03/21 20:19:03 nightmorph Exp $ -->
<guide>
<title>The Openbox Configuration HOWTO</title>
@@ -552,7 +552,7 @@
<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
+ drop, thumbnails for images, bookmarks, volume management, searching, and
more. It also provides supports for managing the desktop background and
drawing desktop icons (both optionally).
</li>
^ permalink raw reply [flat|nested] 14+ messages in thread
end of thread, other threads:[~2011-03-21 20:19 UTC | newest]
Thread overview: 14+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2010-09-02 8:20 [gentoo-commits] gentoo commit in xml/htdocs/doc/en: openbox.xml Joshua Saddler (nightmorph)
-- strict thread matches above, loose matches on Subject: below --
2011-03-21 20:19 Joshua Saddler (nightmorph)
2010-12-26 2:15 Joshua Saddler (nightmorph)
2010-12-25 23:31 Joshua Saddler (nightmorph)
2010-12-25 18:12 Joshua Saddler (nightmorph)
2010-12-24 8:39 Joshua Saddler (nightmorph)
2010-09-02 8:19 Joshua Saddler (nightmorph)
2010-05-17 19:36 Joshua Saddler (nightmorph)
2010-02-14 20:34 Joshua Saddler (nightmorph)
2009-12-29 19:23 Joshua Saddler (nightmorph)
2009-11-12 22:55 Joshua Saddler (nightmorph)
2009-08-13 19:54 Robin H. Johnson (robbat2)
2009-04-27 20:18 Xavier Neys (neysx)
2009-01-29 17:50 Xavier Neys (neysx)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox