changes to the manual pages.
authorDana Jansens <danakj@orodu.net>
Tue, 15 May 2007 02:02:40 +0000 (02:02 +0000)
committerDana Jansens <danakj@orodu.net>
Tue, 15 May 2007 02:02:40 +0000 (02:02 +0000)
adding openbox-session.

add paths to the xsession .desktop files

12 files changed:
Makefile.am
data/autostart.sh [new file with mode: 0644]
data/xsession/openbox-gnome.desktop.in [moved from data/xsession/openbox-gnome.desktop with 83% similarity]
data/xsession/openbox-kde.desktop.in [moved from data/xsession/openbox-kde.desktop with 83% similarity]
data/xsession/openbox-session.in
data/xsession/openbox.desktop.in [moved from data/xsession/openbox.desktop with 82% similarity]
doc/openbox-gnome-session.1
doc/openbox-gnome-session.1.sgml
doc/openbox-kde-session.1
doc/openbox-kde-session.1.sgml
doc/openbox.1.in [deleted file]
doc/openbox.1.sgml

index 6cbf0cc..8073705 100644 (file)
@@ -360,6 +360,7 @@ dist_pixmap_DATA = \
        data/openbox.png
 
 dist_rc_DATA = \
+       data/autostart.sh \
        data/rc.xml \
        data/menu.xml
 
@@ -368,6 +369,30 @@ edit = $(SED) \
        -e 's!@configdir\@!$(configdir)!' \
        -e 's!@bindir\@!$(bindir)!'
 
+data/xsession/openbox-gnome.desktop: \
+               $(srcdir)/data/xsession/openbox-gnome.desktop.in
+       @echo make: creating $@
+       @mkdir data 2>/dev/null || true
+       @mkdir data/xsession 2>/dev/null || true
+       @$(edit) $< >$@
+       @chmod a+x $@
+
+data/xsession/openbox-kde.desktop: \
+               $(srcdir)/data/xsession/openbox-kde.desktop.in
+       @echo make: creating $@
+       @mkdir data 2>/dev/null || true
+       @mkdir data/xsession 2>/dev/null || true
+       @$(edit) $< >$@
+       @chmod a+x $@
+
+data/xsession/openbox.desktop: \
+               $(srcdir)/data/xsession/openbox.desktop.in
+       @echo make: creating $@
+       @mkdir data 2>/dev/null || true
+       @mkdir data/xsession 2>/dev/null || true
+       @$(edit) $< >$@
+       @chmod a+x $@
+
 data/xsession/openbox-gnome-session: \
                $(srcdir)/data/xsession/openbox-gnome-session.in
        @echo make: creating $@
@@ -392,25 +417,25 @@ data/xsession/openbox-session: \
        @$(edit) $< >$@
        @chmod a+x $@
 
-doc/openbox.1.in: $(srcdir)/doc/openbox.1.sgml
+doc/openbox.1: $(srcdir)/doc/openbox.1.sgml
        @echo make: creating $@
        @mkdir doc 2>/dev/null || true
-       @docbook-to-man $< > $@
+       @$(edit) $< | docbook-to-man - >$@
 
-doc/openbox.1: doc/openbox.1.in
+doc/openbox-session.1: $(srcdir)/doc/openbox-session.1.sgml
        @echo make: creating $@
        @mkdir doc 2>/dev/null || true
-       @$(edit) $< >$@
+       @$(edit) $< | docbook-to-man - >$@
 
 doc/openbox-gnome-session.1: $(srcdir)/doc/openbox-gnome-session.1.sgml
        @echo make: creating $@
        @mkdir doc 2>/dev/null || true
-       @docbook-to-man $< > $@
+       @$(edit) $< | docbook-to-man - >$@
 
 doc/openbox-kde-session.1: $(srcdir)/doc/openbox-kde-session.1.sgml
        @echo make: creating $@
        @mkdir doc 2>/dev/null || true
-       @docbook-to-man $< > $@
+       @$(edit) $< | docbook-to-man - >$@
 
 dist_gnomewmfiles_DATA = \
        data/gnome-wm-properties/openbox.desktop
@@ -434,6 +459,9 @@ dist_noinst_DATA = \
        data/rc.xsd \
        data/menu.xsd \
        data/themerc.xsd \
+       data/xsession/openbox.desktop.in \
+       data/xsession/openbox-gnome.desktop.in \
+       data/xsession/openbox-kde.desktop.in \
        data/xsession/openbox-session.in \
        data/xsession/openbox-gnome-session.in \
        data/xsession/openbox-kde-session.in \
@@ -468,6 +496,7 @@ dist_doc_DATA = \
 
 dist_man_MANS = \
        doc/openbox.1 \
+       doc/openbox-session.1 \
        doc/openbox-gnome-session.1 \
        doc/openbox-kde-session.1
 
diff --git a/data/autostart.sh b/data/autostart.sh
new file mode 100644 (file)
index 0000000..962cae0
--- /dev/null
@@ -0,0 +1,31 @@
+#!/bin/sh
+
+# Set a background color
+BG=""
+if which hsetroot >/dev/null; then
+    BG=hsetroot
+else
+    if which esetroot >/dev/null; then
+       BG=esetroot
+    else
+       if which xsetroot >/dev/null; then
+           BG=xsetroot
+       fi
+    fi
+fi
+test -z $BG || $BG -solid "#303030"
+
+# D-bus
+if which dbus-launch >/dev/null && test -z "$DBUS_SESSION_BUS_ADDRESS"; then
+       eval `dbus-launch --sh-syntax --exit-with-session`
+fi
+
+# Make GTK apps look and behave how they were set up in the gnome config tools
+if which gnome-settings-daemon >/dev/null; then
+  gnome-settings-daemon &
+fi
+
+# Preload stuff for KDE apps
+if which start_kdeinit >/dev/null; then
+  LD_BIND_NOW=true start_kdeinit --new-startup +kcminit_startup &
+fi
similarity index 83%
rename from data/xsession/openbox-gnome.desktop
rename to data/xsession/openbox-gnome.desktop.in
index da15d1f..19ae82e 100644 (file)
@@ -2,7 +2,7 @@
 Encoding=UTF-8
 Name=GNOME/Openbox
 Comment=Use the Openbox window manager inside of the GNOME desktop environment
-Exec=openbox-gnome-session
+Exec=@bindir@/openbox-gnome-session
 TryExec=gnome-session
 Icon=openbox.png
 Type=XSession
similarity index 83%
rename from data/xsession/openbox-kde.desktop
rename to data/xsession/openbox-kde.desktop.in
index 1244d8d..ddfc72d 100644 (file)
@@ -2,7 +2,7 @@
 Encoding=UTF-8
 Name=KDE/Openbox
 Comment=Use the Openbox window manager inside of the K Desktop Environment
-Exec=openbox-kde-session
+Exec=@bindir@/openbox-kde-session
 TryExec=startkde
 Icon=openbox.png
 Type=XSession
index e76d320..c466f17 100644 (file)
@@ -1,10 +1,16 @@
 #!/bin/sh
 
-AUTOSTART="$HOME/.config/openbox/autostart"
+AUTOSTART="$HOME/.config/openbox/autostart.sh"
+GLOBALAUTOSTART="@configdir@/openbox/autostart.sh"
 
 if test -e $AUTOSTART; then
     # sleep for 1 second so Openbox is there before anything else
     (sleep 1 && . $AUTOSTART) &
+else
+    if test -e $GLOBALAUTOSTART; then
+        # sleep for 1 second so Openbox is there before anything else
+        (sleep 1 && . $GLOBALAUTOSTART) &
+    fi
 fi
 
 exec @bindir@/openbox "$@"
similarity index 82%
rename from data/xsession/openbox.desktop
rename to data/xsession/openbox.desktop.in
index b162f09..f8cb9f3 100644 (file)
@@ -2,7 +2,7 @@
 Encoding=UTF-8
 Name=Openbox
 Comment=Log in using the Openbox window manager (without a session manager)
-Exec=openbox-session
-TryExec=openbox-session
+Exec=@bindir@/openbox-session
+TryExec=@bidir@/openbox-session
 Icon=openbox.png
 Type=XSession
index 1aca9a2..68e29f7 100644 (file)
@@ -6,12 +6,9 @@ openbox-gnome-session \(em Run a GNOME session with Openbox as the window manage
 .PP 
 \fBopenbox-gnome-session\fR runs a GNOME session with 
 Openbox as the window manager. 
-.PP 
-When running inside GNOME like this, Openbox will use the 
-\fBrc-gnome.xml\fP configuration file. 
 .SH "SEE ALSO" 
 .PP 
-openbox(1), openbox-kde-session (1). 
+openbox(1), openbox-kde-session (1), openbox-session(1)
  
 .PP 
 The program's full documentation is available on the website: 
@@ -19,4 +16,4 @@ The program's full documentation is available on the website:
 .PP 
 Please report bugs to: \fBhttp://bugzilla.icculus.org/ 
 \fP 
-.\" created by instant / docbook-to-man, Sun 13 May 2007, 19:01 
+.\" created by instant / docbook-to-man, Mon 14 May 2007, 21:59 
index 702fab7..01236af 100644 (file)
@@ -38,14 +38,11 @@ manpage.1: manpage.sgml
 
     <para><command>&dhpackage;</command> runs a GNOME session with
       Openbox as the window manager.</para>
-
-    <para>When running inside GNOME like this, Openbox will use the
-      <literal>rc-gnome.xml</literal> configuration file.</para>
   </refsect1>
   <refsect1>
     <title>SEE ALSO</title>
 
-    <para>openbox(1), openbox-kde-session (1).
+    <para>openbox(1), openbox-kde-session (1), openbox-session(1).
       </para>
 
     <para>The program's full documentation is available on the website:
index b76c1bd..e877cb0 100644 (file)
@@ -6,12 +6,9 @@ openbox-kde-session \(em Run a KDE session with Openbox as the window manager
 .PP 
 \fBopenbox-kde-session\fR runs a KDE session with 
 Openbox as the window manager. 
-.PP 
-When running inside KDE like this, Openbox will use the 
-\fBrc-kde.xml\fP configuration file. 
 .SH "SEE ALSO" 
 .PP 
-openbox(1), openbox-gnome-session (1). 
+openbox(1), openbox-gnome-session (1), openbox-session (1)
  
 .PP 
 The program's full documentation is available on the website: 
@@ -19,4 +16,4 @@ The program's full documentation is available on the website:
 .PP 
 Please report bugs to: \fBhttp://bugzilla.icculus.org/ 
 \fP 
-.\" created by instant / docbook-to-man, Sun 13 May 2007, 19:01 
+.\" created by instant / docbook-to-man, Mon 14 May 2007, 21:59 
index d481ff0..aeb114a 100644 (file)
@@ -38,14 +38,11 @@ manpage.1: manpage.sgml
 
     <para><command>&dhpackage;</command> runs a KDE session with
       Openbox as the window manager.</para>
-
-    <para>When running inside KDE like this, Openbox will use the
-      <literal>rc-kde.xml</literal> configuration file.</para>
   </refsect1>
   <refsect1>
     <title>SEE ALSO</title>
 
-    <para>openbox(1), openbox-gnome-session (1).
+    <para>openbox(1), openbox-gnome-session (1), openbox-session (1).
       </para>
 
     <para>The program's full documentation is available on the website:
diff --git a/doc/openbox.1.in b/doc/openbox.1.in
deleted file mode 100644 (file)
index 1e6f2fe..0000000
+++ /dev/null
@@ -1,85 +0,0 @@
-.TH "OPENBOX" "1" 
-.SH "NAME" 
-openbox \(em Next generation, highly configurable window manager 
-.SH "SYNOPSIS" 
-.PP 
-\fBopenbox\fR [\fB\-\-help\fP]  [\fB\-\-version\fP]  [\fB\-\-replace\fP]  [\fB\-\-reconfigure\fP]  [\fB\-\-sm-disable\fP]  [\fB\-\-sync\fP]  [\fB\-\-debug\fP]  [\fB\-\-debug-focus\fP]  [\fB\-\-debug-xinerama\fP]  
-.SH "DESCRIPTION" 
-.PP 
-Openbox is a next generation, highly 
-configurable window manager. Openbox is compliant with the 
-latest window manager standards. 
-.PP 
-You can start Openbox in three ways: 
-.PP 
-If you run a display manager such as GDM, you will find 3 entries 
-in the login session type menu for Openbox: 
-\fBGNOME/Openbox\fR, \fBKDE/Openbox\fR       and \fBOpenbox\fR. If you want to use Openbox 
-within GNOME or KDE, you can choose the appropriate entry, and it will 
-launch GNOME or KDE with Openbox as the window manager. 
-.PP 
-If you don't want to run Openbox within a desktop environment, then 
-it is recommended that you instead set up a ~/.xsession file and 
-use the \fBDefault\fR session type. The ~/.xsession file 
-should start any applications you want to run at startup, and then run 
-\fBopenbox\fR at the end, such as: 
-.PP 
-.RS 
-.PP 
-.nf 
-xsetroot \-solid grey & 
-gnome-settings-daemon & 
-exec \fBopenbox\fR 
-.fi 
-.RE 
-.PP 
-Lastly, if you use \fBstartx\fR to launch your X 
-session, you should set up a ~/.xinitrc file, exactly the same as the 
-above ~/.xsession file. 
-.PP 
-You can use the \fBobconf\fR tool to configure Openbox 
-easily with a graphical interface, however more in-depth configuration 
-is possible by editing the configuration files by hand. Please note that 
-\fBobconf\fR older than version 2.0 may not work at all 
-for you. 
-.PP 
-The default configuration files are installed in 
-@configdir@/openbox/rc.xml, and the user configuration is placed in 
-~/.config/openbox/rc.xml. You can copy the default configuration 
-to ~/.config/openbox and edit it to your liking. 
-.SH "OPTIONS" 
-.PP 
-These are the possible options that \fBopenbox\fR accepts: 
-.IP "\fB\-\-help\fP" 10 
-Show a summary of the options available. 
-.IP "\fB\-\-version\fP" 10 
-Show the version of the program. 
-.IP "\fB\-\-replace\fP" 10 
-Replace the currently running window manager. 
-.IP "\fB\-\-reconfigure\fP" 10 
-If Openbox is already running on the display, tell it to 
-reload its configuration. 
-.IP "\fB\-\-sm-disable\fP" 10 
-Do not connect to the session manager. 
-.IP "\fB\-\-sync\fP" 10 
-Run in synchronous mode (for debugging). 
-.IP "\fB\-\-debug\fP" 10 
-Display debugging output. 
-.IP "\fB\-\-debug-focus\fP" 10 
-Display debugging output for focus handling. 
-.IP "\fB\-\-debug-xinerama\fP" 10 
-Split the display into two fake xinerama regions, if 
-xinerama is not already enabled. This is for debugging 
-xinerama support. 
-.SH "SEE ALSO" 
-.PP 
-obconf (1), openbox-gnome-session (1), openbox-kde-session (1). 
-.PP 
-The program's full documentation is available on the website: 
-\fBhttp://openbox.org/\fP 
-.PP 
-Please report bugs to: \fBhttp://bugzilla.icculus.org/ 
-\fP 
-.\" created by instant / docbook-to-man, Mon 14 May 2007, 17:39 
index 1cce554..70766ba 100644 (file)
@@ -63,20 +63,31 @@ manpage.1: manpage.sgml
       within GNOME or KDE, you can choose the appropriate entry, and it will
       launch GNOME or KDE with Openbox as the window manager.</para>
 
-    <para>If you don't want to run Openbox within a desktop environment, then
-      it is recommended that you instead set up a ~/.xsession file and
-      use the <command>Default</command> session type. The ~/.xsession file
-      should start any applications you want to run at startup, and then run
-      <command>&dhpackage;</command> at the end, such as:</para>
+    <para>The third option at log in, which is <command>Openbox</command>
+      without a session manager, uses the <command>openbox-session</command>
+      command to start Openbox. On log in, <command>&dhpackage;</command> will
+      run the ~/.config/openbox/autostart.sh script if it exists, and will run
+      the system-wide script @configdir@/openbox/autostart.sh otherwise. You
+      may place anything you want to run automatically in those files, for
+      example:
+      </para>
 
-      <blockquote><literallayout>
+    <blockquote><literallayout>
       xsetroot -solid grey &
-      gnome-settings-daemon &
-      exec <command>&dhpackage;</command></literallayout></blockquote>
+      gnome-settings-daemon &</literallayout></blockquote>
+
+    <para>Make sure that each line is followed by a "&" or else the script will
+      stop there and further commands will not be executed. You can use the
+      @configdir@/openbox/autostart.sh file as an example for creating your
+      own.</para>
+
+    <para>The default @configdir@/openbox/autostart.sh runs a number of things
+      with Openbox.</para>
 
     <para>Lastly, if you use <command>startx</command> to launch your X
-      session, you should set up a ~/.xinitrc file, exactly the same as the
-      above ~/.xsession file.</para>
+      session, you can set up a ~/.xinitrc file to run
+      <command>openbox-session</command> and follow the same directions as
+      above regarding the autostart.sh file.</para>
 
     <para>You can use the <command>obconf</command> tool to configure Openbox
       easily with a graphical interface, however more in-depth configuration
@@ -84,9 +95,9 @@ manpage.1: manpage.sgml
       <command>obconf</command> older than version 2.0 may not work at all
       for you.</para>
 
-    <para>The default configuration files are installed in
-      @configdir@/openbox/rc.xml, and the user configuration is placed in
-      ~/.config/openbox/rc.xml. You can copy the default configuration
+    <para>The default configuration and menu files are installed in
+      @configdir@/openbox/, and the user configuration is placed in
+      ~/.config/openbox/. You can copy the default configuration and menus
       to ~/.config/openbox and edit it to your liking.</para>
   </refsect1>
   <refsect1>