~ubuntu-branches/ubuntu/trusty/fluxbox/trusty-proposed

« back to all changes in this revision

Viewing changes to doc/startfluxbox.1.in

  • Committer: Package Import Robot
  • Author(s): Paul Tagliamonte
  • Date: 2010-08-12 21:16:02 UTC
  • mfrom: (0.1.1) (1.1.10)
  • Revision ID: package-import@ubuntu.com-20100812211602-3tsmzl9in5nmwz7z
Tags: 1.1.1+git20100807.0cc08f9-1
* debian/ dir has been cleaned out, complete repackage
  of most files.
* pulled new archive from git.fluxbox.org HEAD, saved as
  tar.gz.
* Added in fluxbox.* files from the old dfsg tree.
* Added in system.fluxbox-menu file from the old dfsg tree
* Added the source/format file to bump package source
  version from 1.0 to 3.0 (quilt). 
* Changed rules file to match the old dfsg setup so that
  fluxbox behaves nicely.
* Removed entries from copyright that no longer apply.
* Added theme based on Denis Brand ( naran )'s old theme.
* Added a background I whipped up.
* Changed compile flags to point to debian theme by default
* Adding a patch to have fluxbox use x-terminal-emulator
  over xterm. Closes: #591694 (LP: #580485)
* Adding a patch to allow titlebar-window dragging.
* Changed the flags in rules to pull from a script. This script
  lets us un-hardcode what theme is default. Be sure there
  is a theme pack!
* Added comments to my patches.
* Removing debian/docs, empty file.
* Fixing fluxbox.desktop to remove all the warnings from
  desktop-file-validate
* Fixing libtool issue by running an update before
  configure in the rules script.
* Added a compile flag script to auto-detect what platform
  we are running on, and apply the correct theme. This
  should solve Ubuntnu issues later on.
* adding in a get-orig-source rule
* fixing the upstream version number to pinpoint
  the commit ( thanks, lfaraone ).
* adding a rule for get-orig-source. ( thanks again,
  lfaraone ).
* Updated rules to actually allow us to do a build from it
* Removed Denis from the uploaders ( as per an email
  conversation )
* Removing madduck from the uploaders ( thanks for asking,
  lfaraone. ). Thanks for your hard work, madduck.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
'\" t
 
2
.\"     Title: startfluxbox
 
3
.\"    Author: [see the "AUTHORS" section]
 
4
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
 
5
.\"      Date: 12/17/2009
 
6
.\"    Manual: Fluxbox Manual
 
7
.\"    Source: startfluxbox.txt
 
8
.\"  Language: English
 
9
.\"
 
10
.TH "STARTFLUXBOX" "1" "12/17/2009" "startfluxbox\&.txt" "Fluxbox Manual"
 
11
.\" -----------------------------------------------------------------
 
12
.\" * set default formatting
 
13
.\" -----------------------------------------------------------------
 
14
.\" disable hyphenation
 
15
.nh
 
16
.\" disable justification (adjust text to left margin only)
 
17
.ad l
 
18
.\" -----------------------------------------------------------------
 
19
.\" * MAIN CONTENT STARTS HERE *
 
20
.\" -----------------------------------------------------------------
 
21
.SH "NAME"
 
22
startfluxbox \- start a fluxbox session
 
23
.SH "SYNOPSIS"
 
24
.sp
 
25
\fBstartfluxbox\fR
 
26
.SH "DESCRIPTION"
 
27
.sp
 
28
\fBstartfluxbox\fR is a script which runs the file \fB\e~/\&.fluxbox/startup\fR If it doesn\(cqt exist it will be generated\&.
 
29
.sp
 
30
\fBstartfluxbox\fR should be started from your \fB~/\&.xinitrc\fR if you use startx, or \fB\e~/\&.xsession\fR if you run a display manager, like xdm\&.
 
31
.SH "FILES"
 
32
.PP
 
33
\fB\e~/\&.fluxbox/startup\fR
 
34
.RS 4
 
35
This file contains all commands that should be executed before fluxbox is started\&. The initial file contains helpful comments for beginners\&. It also starts fluxbox\&.
 
36
.RE
 
37
.SH "EXAMPLES"
 
38
.sp
 
39
The default \fB\e~/\&.fluxbox/startup\fR is as follows:
 
40
.sp
 
41
.if n \{\
 
42
.RS 4
 
43
.\}
 
44
.nf
 
45
#!/bin/sh
 
46
#
 
47
# fluxbox startup\-script:
 
48
#
 
49
# Lines starting with a \'#\' are ignored\&.
 
50
 
 
51
# Change your keymap:
 
52
xmodmap "$HOME/\&.Xmodmap"
 
53
 
 
54
# Applications you want to run with fluxbox\&.
 
55
# MAKE SURE THAT APPS THAT KEEP RUNNING HAVE AN \'\'&\'\' AT THE END\&.
 
56
#
 
57
# unclutter \-idle 2 &
 
58
# wmnd &
 
59
# wmsmixer \-w &
 
60
# idesk &
 
61
 
 
62
# And last but not least we start fluxbox\&.
 
63
# Because it is the last app you have to run it with \'\'exec\'\' before it\&.
 
64
 
 
65
exec fluxbox
 
66
# or if you want to keep a log:
 
67
# exec fluxbox \-log "$fluxdir/log"
 
68
.fi
 
69
.if n \{\
 
70
.RE
 
71
.\}
 
72
.sp
 
73
If you need to start applications after fluxbox, you can change the \fBexec fluxbox\fR line above to something like this:
 
74
.sp
 
75
.if n \{\
 
76
.RS 4
 
77
.\}
 
78
.nf
 
79
exec fluxbox &
 
80
fbpid=$!
 
81
 
 
82
sleep 1
 
83
{
 
84
        xsetroot \-cursor_name left_ptr \-fg white \-bg black &
 
85
        ipager &
 
86
        gkrellm2 &
 
87
} &
 
88
 
 
89
wait $fbpid
 
90
.fi
 
91
.if n \{\
 
92
.RE
 
93
.\}
 
94
.sp
 
95
So xsetroot, ipager, and gkrellm2 will all be started after fluxbox, after giving fluxbox 1 second to startup\&.
 
96
.sp
 
97
For more details on what else you can do in this script, see \fBsh(1p)\fR, or the documentation for your shell\&.
 
98
.SH "ONLINE DOCUMENTATION"
 
99
.PP
 
100
More extensive documentation for \fBstartfluxbox(1)\fR can be found at
 
101
.RS 4
 
102
 
 
103
\m[blue]\fBhttp://www\&.xs4all\&.nl/~hanb/software/fluxbox/startfluxbox\&.html\fR\m[]
 
104
.RE
 
105
.SH "AUTHORS"
 
106
.sp
 
107
The author of \fBstartfluxbox(1)\fR is Han Boetes <han at fluxbox\&.org>
 
108
.sp
 
109
This manpage was converted to asciidoc format by Jim Ramsay <i\&.am at jimramsay\&.com> for fluxbox\-1\&.1\&.2
 
110
.SH "SEE ALSO"
 
111
.sp
 
112
fluxbox(1)