File: 20_manpage.patch

package info (click to toggle)
windowlab 1.40%2Bgit20240604.1cba02c-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 428 kB
  • sloc: ansic: 4,359; makefile: 91; sh: 58
file content (114 lines) | stat: -rw-r--r-- 5,110 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
Description: Enhance the supplied manual page.
 Additions to page header/footer: author, version, and section.
 Proper encoding of hyphens.
 .
 Include a section on the menu subsystem.
 Mention the recent SIGHUP signal handling.
Forwarded: not-needed.
Author: Stan Vasilyev <stan.vasilyev@csun.edu>
        Mats Erik Andersson <mats.andersson@gisladisker.se>
Last-Update: 2010-04-09
--- a/windowlab.1x
+++ b/windowlab.1x
@@ -1,15 +1,15 @@
 .\" WindowLab - an X11 window manager
 .\" by Nick Gravgaard (nick at nick-gravgaard.com)
-.TH WINDOWLAB 1x
+.TH "WINDOWLAB" "1x" "1.40" "Nick Gravgaard" ""
 .SH "NAME"
 windowlab \- a window manager for X11
 .SH "SYNOPSIS"
 .B windowlab \fI[options...]\fP
-.SH DESCRIPTION
+.SH "DESCRIPTION"
 .B windowlab
 is a small and simple window manager of novel design.
 .PP
-It has a click-to-focus but not raise-on-focus policy, a window resizing mechanism that allows one or many edges of a window to be changed in one action, and an innovative menubar that shares the same part of the screen as the taskbar. Window titlebars are prevented from going off the edge of the screen by constraining the mouse pointer, and when appropriate the pointer is also constrained to the taskbar/menubar in order to make target menu items easier to hit.
+It has a click\-to\-focus but not raise\-on\-focus policy, a window resizing mechanism that allows one or many edges of a window to be changed in one action, and an innovative menubar that shares the same part of the screen as the taskbar. Window titlebars are prevented from going off the edge of the screen by constraining the mouse pointer, and when appropriate the pointer is also constrained to the taskbar/menubar in order to make target menu items easier to hit.
 .PP
 WindowLab places a taskbar at the top of the screen and adds a titlebar to the top of each window. These titlebars consist of a draggable area, and three icons on the right hand side. When left clicked, these icons:
 .PP
@@ -39,7 +39,7 @@ Each line in the menurc file should have
 .PP
 The GIMP:gimp
 .PP
-New windows (that don't specify their location) are positioned according to the coordinates of the mouse - the top-left hand corner of a new window is set to the location of the mouse pointer (if necessary the window will be moved to ensure that all of it is on the screen).
+New windows (that don't specify their location) are positioned according to the coordinates of the mouse \- the top\-left hand corner of a new window is set to the location of the mouse pointer (if necessary the window will be moved to ensure that all of it is on the screen).
 .PP
 WindowLab has the following keyboard controls. Hold down alt and press:
 .PP
@@ -58,29 +58,65 @@ to toggle fullscreen mode on and off for
 *
 .B F12
 to toggle the window's depth. This is the same as left clicking a window's middle icon
-.SH OPTIONS
+.SH "OPTIONS"
 .TP
-.B -font \fIfont-spec\fP
+.B \-font \fIfont\-spec\fP
 Draw window titles with the font defined by
-.IR font-spec .
+.IR font\-spec .
 .TP
-.B -border \fIcolor\fP, -text \fIcolor\fP, -active \fIcolor\fP, -inactive \fIcolor\fP, -menu \fIcolor\fP, -selected \fIcolor\fP, -empty \fIcolor\fP
+.B \-border \fIcolor\fP, \-text \fIcolor\fP, \-active \fIcolor\fP, \-inactive \fIcolor\fP, \-menu \fIcolor\fP, \-selected \fIcolor\fP, \-empty \fIcolor\fP
 Use
 .I color
 for the borders, the text, the active background, the inactive background, the menubar, the selected menu item and empty parts of the screen.
 .TP
-.B -about
+.B \-about
 Print information to stdout and exit.
 .TP
-.B -display
+.B \-display
 Sets which X display will be managed by
 .BR windowlab .
-.SH ENVIRONMENT VARIABLES
+.SH "ENVIRONMENT VARIABLES"
 .B DISPLAY
 Sets which X display will be managed by
 .BR windowlab .
+.SH "MENU SYSTEM"
+This version of WindowLab supports the Debian Menu subsystem.
+To update the menus, it suffices to execute the command
+\fIupdate\-menus\fR. If executed as root, the system setting in
+.
+.IP "" 6
+\fB/etc/X11/windowlab/windowlab.menurc\fR
+.
+.P
+will be affected, whereas execution by any underprivileged user
+only effects the private resource file in
+.
+.IP "" 6
+\fB~/.windowlab/windowlab.menurc\fR.
+.
+.P
+The following files tune the compilation of auto\-generated menus:
+.
+.TP
+\fB/etc/X11/windowlab/debian_config\fR, \fB~/.windowlab/debian_config\fR
+Debian\-specific system configuration and user\-specific overrides.
+.
+.TP
+\fB/etc/X11/windowlab/common_menu\fR
+A common tail part, that currently encompasses \fIAbout\fR, \fIReload\fR
+and \fIQuit\fR. All users get these entries included in their menu.
+.
+.TP
+\fB~/.windowlab/user_menu\fR
+Menu entries hand-picked by the individual user.
+.
+.SH "SIGNALS"
+When WindowLab receives a \fBSIGHUP\fR signal, it will reload all relevant
+menu resource files, thus updating the menu bar.
+.
 .SH "SEE ALSO"
 .BR X (7),
-.I The Inter-Client Communication Conventions Manual (from the X11R6 documentation).
+.I The Inter\-Client Communication Conventions Manual (from the X11R6 documentation).
+.
 .SH "AUTHOR"
 Nick Gravgaard (nick at nick-gravgaard.com)