From 469609b9d93654073e2c90acb69f52f68785cc66 Mon Sep 17 00:00:00 2001 From: Dana Jansens Date: Sun, 13 May 2007 19:45:37 +0000 Subject: [PATCH] Add a manage --- Makefile.am | 18 ++++- doc/openbox.1.sgml | 190 +++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 206 insertions(+), 2 deletions(-) create mode 100644 doc/openbox.1.sgml diff --git a/Makefile.am b/Makefile.am index 35eaa47e..a9702054 100644 --- a/Makefile.am +++ b/Makefile.am @@ -364,6 +364,7 @@ dist_rc_DATA = \ edit = $(SED) \ -e 's!@version\@!$(VERSION)!' \ + -e 's!@confdir\@!$(confdir)!' \ -e 's!@bindir\@!$(bindir)!' data/xsession/openbox-gnome-session: Makefile data \ @@ -372,7 +373,7 @@ data/xsession/openbox-gnome-session: Makefile data \ @mkdir data 2>/dev/null || true @mkdir data/xsession 2>/dev/null || true @$(edit) $(srcdir)/data/xsession/openbox-gnome-session.in >$@ - @chmod +x $@ + @chmod a+x $@ data/xsession/openbox-kde-session: Makefile data \ $(srcdir)/data/xsession/openbox-kde-session.in @@ -380,7 +381,17 @@ data/xsession/openbox-kde-session: Makefile data \ @mkdir data 2>/dev/null || true @mkdir data/xsession 2>/dev/null || true @$(edit) $(srcdir)/data/xsession/openbox-kde-session.in >$@ - @chmod +x $@ + @chmod a+x $@ + +doc/openbox.1.in: Makefile doc $(srcdir)/doc/openbox.1.sgml + @echo make: creating $@ + @mkdir doc 2>/dev/null || true + docbook-to-man $(srcdir)/doc/openbox.1.sgml > $@ + +doc/openbox.1: Makefile doc doc/openbox.1.in + @echo make: creating $@ + @mkdir doc 2>/dev/null || true + @$(edit) $(srcdir)/doc/openbox.1.in >$@ dist_gnomewmfiles_DATA = \ data/gnome-wm-properties/openbox.desktop @@ -434,6 +445,9 @@ dist_doc_DATA = \ data/menu.xsd \ data/themerc.xsd +man_MANS = \ + doc/openbox.1 + EXTRA_DIST = \ config.rpath \ mkinstalldirs \ diff --git a/doc/openbox.1.sgml b/doc/openbox.1.sgml new file mode 100644 index 00000000..f5e84ba7 --- /dev/null +++ b/doc/openbox.1.sgml @@ -0,0 +1,190 @@ + manpage.1'. You may view + the manual page with: `docbook-to-man manpage.sgml | nroff -man | + less'. A typical entry in a Makefile or Makefile.am is: + +manpage.1: manpage.sgml + docbook-to-man $< > $@ + + + The docbook-to-man binary is found in the docbook-to-man package. + Please remember that if you create the nroff version in one of the + debian/rules file targets (such as build), you will need to include + docbook-to-man in your Build-Depends control field. + + --> + + Dana"> + Jansens"> + + May 13, 2007"> + 1"> + danakj@orodu.net"> + + OPENBOX"> + + + GNU"> +]> + + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + Next generation window manager + + + + &dhpackage; + + + + + + + + + + + + + DESCRIPTION + + Openbox is a next generation, highly + configurable window manager. Openbox is compliant with the + latest window manager standards. + + You can start Openbox in three ways: + + If you run a display manager such as GDM, you will find 3 entries + in the login session type menu for Openbox: + GNOME/Openbox, KDE/Openbox + and Openbox. 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. + + If you don't want to run Openbox withing a desktop environment, then + it is recommended that you instead set up a ~/.xsession file and + use the Default session type. The ~/.xsession file + should any applications you want to run at startup, and then run + &dhpackage; at the end, such as: + +
+ xsetroot -solid grey & + gnome-settings-daemon & + exec &dhpackage;
+ + Lastly, if you use startx to launch your X + session, you should set up a ~/.xinitrc file, exactly the same as the + above ~/.xsession file. + + You can use the obconf tool to configure Openbox + easily with a graphical interface, however more in-depth configuration + is possible by editing the configuration files by hand. The default + configuration file is installed in @confdir@/xdg/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. + + + + OPTIONS + + These are the possible options that &dhpackage; accepts: + + + + + Show a summary of the options available. + + + + + + Show the version of the program. + + + + + + Replace the currently running window manager. + + + + + + If Openbox is already running on the display, tell it to + reload it's configuration. + + + + + + Do not connect to the session manager. + + + + + + Specify the configuration profile to use. + + + + + + Run in synchronous mode (for debugging). + + + + + + Display debugging output. + + + + + + Display debugging output for focus handling. + + + + + + SEE ALSO + + obconf (1), openbox-gnome-session (1), openbox-kde-session (1). + + + The program's full documentation is available on the website: + http://openbox.org/ + + Please report bugs to: http://bugzilla.icculus.org/ + + + + + + +