godzil/wmfs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix man

Browse Source
This commit is contained in:
arnault 2012-04-20 17:11:47 +02:00
parent 4e2c6125ca
commit da97ee762c
1 changed files with 154 additions and 74 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

228
wmfs.1
View File

@ -2,7 +2,7 @@
.\" dev: xorg62 .\" dev: xorg62
.\" man: arpinux .\" man: arpinux
.\" .\"
.TH "WMFS" "1" "2012/02/08" "wmfs" "manual of wmfs" .TH "WMFS" "1" "2012/04/20" "wmfs" "manual of wmfs"
.\" disable hyphenation .\" disable hyphenation
.nh .nh
.\" disable justification (adjust text to left margin only) .\" disable justification (adjust text to left margin only)
@ -265,7 +265,7 @@ Restore next layout
.PP .PP
\fBSuper + p\fR \fBSuper + p\fR
.RS 4 .RS 4
Make a launcher in the statusbar to run an unix command\fR Display a launcher in the statusbar to run an unix command\fR
.RE .RE
.PP .PP
\fBSuper + F[1\&.\&.9]\fR \fBSuper + F[1\&.\&.9]\fR
@ -291,7 +291,7 @@ Add current tag\fR
WMFS is configured by \fI$HOME/\&.config/wmfs/wmfsrc\fR\&. WMFS is configured by \fI$HOME/\&.config/wmfs/wmfsrc\fR\&.
.RE .RE
.PP .PP
\fB\ include\fR \fB\ include:\fR
wmfsrc supports ”@include” to split configuration file by section\&. wmfsrc supports ”@include” to split configuration file by section\&.
.RS 2 .RS 2
\fB\ Usage:\fR "@include ~/.config/wmfs/wmfs_themes"\&. \fB\ Usage:\fR "@include ~/.config/wmfs/wmfs_themes"\&.
@ -302,121 +302,124 @@ wmfsrc supports themes for client and statusbar\&.
.RS 2 .RS 2
\fB Misc\fR \fB Misc\fR
.RS 2 .RS 2
\fB\ name\fR \fB\ name:\fR
theme name: will be used in next sections\&. theme name, will be used in next sections\&.
.PP .PP
\fB\ font\fR \fB\ font:\fR
theme font: in XLFD format\&. theme font in XLFD format\&.
.PP .PP
.RE .RE
\fB\ Bars\fR \fB\ Bars\fR
.RS 2 .RS 2
\fB\ bars_width\fR \fB\ bars_width:\fR
bar height in pixels\&. bar height in pixels\&.
.PP .PP
\fB\ bars_fg/bg\fR \fB\ bars_fg/bg:\fR
statusbar text/background color\&. statusbar text/background color\&.
.PP .PP
.RE .RE
\fB\ Tags\fR \fB\ Tags\fR
.RS 2 .RS 2
\fB\ tags_normal_fg/bg\fR \fB\ tags_normal_fg/bg:\fR
normal tag text/button color\&. normal tag text/button color\&.
.PP .PP
\fB\ tags_normal_statusline\fR \fB\ tags_normal_statusline:\fR
normal tag statusline\&. normal tag statusline\&.
.PP .PP
\fB\ tags_sel_fg/bg\fR \fB\ tags_sel_fg/bg:\fR
selected tag text/button color\&. selected tag text/button color\&.
.PP .PP
\fB\ tags_sel_statusline\fR \fB\ tags_sel_statusline:\fR
selected tag statusline\&. selected tag statusline\&.
.PP .PP
\fB\ tags_occupied_fg/bg\fR \fB\ tags_occupied_fg/bg:\fR
occupied tag text/button color\&. occupied tag text/button color\&.
.PP .PP
\fB\ tags_occupied_statusline\fR \fB\ tags_occupied_statusline:\fR
occupied tag statusline\&. occupied tag statusline\&.
.PP .PP
\fB\ tags_urgent_fg/bg\fR \fB\ tags_urgent_fg/bg:\fR
urgent tag text/button color\&. urgent tag text/button color\&.
.PP .PP
\fB\ tags_urgent_statusline\fR \fB\ tags_urgent_statusline:\fR
urgent tag statusline\&. urgent tag statusline\&.
.PP .PP
\fB\ tags_border_color\fR \fB\ tags_border_color:\fR
tag button border color\&. tag button border color\&.
.PP .PP
\fB\ tags_border_width\fR \fB\ tags_border_width:\fR
tag button border width\&. tag button border width\&.
.PP .PP
.RE .RE
\fB\ Clients\fR \fB\ Clients\fR
.RS 2 .RS 2
\fB\ client_normal_fg/bg\fR \fB\ client_normal_fg/bg:\fR
normal client titlebar text/background color\&. normal client titlebar text/background color\&.
.PP .PP
\fB\ client_normal_statusline\fR \fB\ client_normal_statusline:\fR
normal client statusline\&. normal client statusline\&.
.PP .PP
\fB\ client_sel_fg/bg\fR \fB\ client_sel_fg/bg:\fR
selected client titlebar text/background color\&. selected client titlebar text/background color\&.
.PP .PP
\fB\ client_sel_statusline\fR \fB\ client_sel_statusline:\fR
selected client statusline\&. selected client statusline\&.
.PP .PP
\fB\ frame_bg\fR \fB\ frame_bg:\fR
client border color\&. client border color\&.
.PP .PP
\fB\ client_titlebar_width\fR \fB\ client_titlebar_width:\fR
client titlebar height in pixels\&. client titlebar height in pixels\&.
.PP .PP
\fB\ client_border_width\fR \fB\ client_border_width:\fR
client border height in pixels\&. client border height in pixels\&.
.RE .RE
.PP .PP
.RE .RE
\fB\ [bars]\fR \fB\ [bars]\fR
.RS 2 .RS 2
\fB\ position\fR \fB\ position:\fR
statusbar position on screen: 0=Top; 1=Bottom, 2=Hide\&. statusbar position on screen (0=Top; 1=Bottom, 2=Hide)\&.
.PP .PP
\fB\ screen\fR \fB\ screen:\fR
screen to display statusbar(start ar 0), set to\fB -1\fR to display on every screen\&. screen to display statusbar (start ar 0), set to\fB -1\fR to display on every screen\&.
.PP .PP
\fB\ elements\fR \fB\ elements:\fR
t=Tags, s=Statustext, y=Systray, l=Launcher\&. ordered statusbar elements t=Tags, s=Statustext, y=Systray, l=Launcher\&.
.PP .PP
\fB\ theme\fR \fB\ theme:\fR
names of the statusbar theme\&. names of the statusbar theme\&.
.RE .RE
.PP .PP
.RE .RE
\fB\ [tags]\fR \fB\ [tags]\fR
.RS 2 .RS 2
\fB\ screen\fR \fB\ screen:\fR
screen to display tag. use no screen option or screen =\fB -1\fR to set tag on each screen\&. screen to display tag. use no screen option or screen =\fB -1\fR to set tag on each screen\&.
.PP .PP
\fB\ name\fR \fB\ name:\fR
display tagname\&. display tagname\&.
.PP .PP
\fB\ statusline\fR \fB\ statusline:\fR
draw a custom statusline in the specific tag (can display any sequences)\&. draw a custom statusline in the specific tag (can display any sequences)\&.
.PP .PP
\fB\ mousebinds\fR \fB\ mousebinds:\fR
mouse actions on the tag buttons\&. mouse actions on the tag buttons\&.
.RE .RE
.PP .PP
.RE .RE
\fB\ [client]\fR \fB\ [client]\fR
.RS 2 .RS 2
\fB\ theme\fR \fB\ theme:\fR
apply theme to client by default\&. apply theme to client by default\&.
.PP .PP
\fB\ key_modifier\fR \fB\ key_modifier:\fR
key modifier to perform actions on clients\&. key modifier to perform actions on clients\&.
.PP .PP
\fB\ mousebinds\fR \fB\ focus:\fR
select the focus mouse options; enter=focus follow mouse, click=click to focus, everything-else=disable focus mouse support\&.
.PP
\fB\ mousebinds:\fR
mouse actions on client\&. mouse actions on client\&.
.RE .RE
.PP .PP
@ -424,44 +427,47 @@ mouse actions on client\&.
\fB\ [rules]\fR \fB\ [rules]\fR
specific rules for clients: to identify an application, use xprop\&. specific rules for clients: to identify an application, use xprop\&.
.RS 2 .RS 2
\fB\ instance\fR \fB\ instance:\fR
first part of WM_CLASS\&. first part of WM_CLASS\&.
.PP .PP
\fB\ class\fR \fB\ class:\fR
second part of WM_CLASS\&. second part of WM_CLASS\&.
.PP .PP
\fB\ role\fR \fB\ role:\fR
WM_WINDOW_ROLE\&. WM_WINDOW_ROLE\&.
.PP .PP
\fB\ name\fR \fB\ name:\fR
_NET_WM_NAME\&. _NET_WM_NAME\&.
.PP .PP
\fB\ theme\fR \fB\ theme:\fR
apply theme to client\&. apply theme to client\&.
.PP .PP
\fB\ tag\fR \fB\ tag:\fR
set tag to client(start at 0)\&. specify a tag to display client (start at 0)\&.
.PP .PP
\fB\ screen\fR \fB\ screen:\fR
display client on a specific screen\&. display client on a specific screen\&.
.PP .PP
\fB\ free\fR \fB\ free:\fR
client in auto-free mode (true/false)\&. client in auto-free mode (true/false)\&.
.PP .PP
\fB\ tab\fR \fB\ tab:\fR
open client in a tab (true/false)\&. open client in a tab (true/false)\&.
.PP
\fB\ ignore_tag:\fR
specify to client to ignore tags (client is displayed on every tag)\&.
.RE .RE
.PP .PP
.RE .RE
\fB\ [launchers]\fR \fB\ [launchers]\fR
.RS 2 .RS 2
\fB\ name\fR \fB\ name:\fR
launcher-name, will be used in the [keys] section\&. launcher-name, will be used in the [keys] section\&.
.PP .PP
\fB\ prompt\fR \fB\ prompt:\fR
display text at the beginning of the prompt\&. display text at the beginning of the prompt\&.
.PP .PP
\fB\ command\fR \fB\ command:\fR
command used by the launcher. can be an uicb function or an uicb function + extension\&. command used by the launcher. can be an uicb function or an uicb function + extension\&.
.RE .RE
.PP .PP
@ -470,16 +476,16 @@ command used by the launcher. can be an uicb function or an uicb function + exte
.RS 2 .RS 2
each line is contained within\fB\ [key]...[/key]\fR each line is contained within\fB\ [key]...[/key]\fR
.PP .PP
\fB\ mod\fR \fB\ mod:\fR
key modifier (Alt, Control, Shift, Super)\&. key modifier (Alt, Control, Shift, Super)\&.
.PP .PP
\fB\ key\fR \fB\ key:\fR
key to press\&. key to press, you can identify it with "xev"\&.
.PP .PP
\fB\ func\fR \fB\ func:\fR
uicb function to launch\&. uicb function to launch\&.
.PP .PP
\fB\ cmd\fR \fB\ cmd:\fR
if\fB\ func = "spawn"\fR set the external command to launch\&. if\fB\ func = "spawn"\fR set the external command to launch\&.
.sp .sp
.SH "STATUS" .SH "STATUS"
@ -505,33 +511,33 @@ statusbars, tags, surfaces and titlebars support sequences to display text, imag
\fB\ valuemax:\fR maximum value of the ‘value’ used in the progressbar\&. \fB\ valuemax:\fR maximum value of the ‘value’ used in the progressbar\&.
.RE .RE
.PP .PP
\fB\ basic usage\fR \fB\ basic usage:\fR
wmfs -c status "<barname> TEXT visible on 'barname'"\&. wmfs -c status "<barname> TEXT visible on 'barname'"\&.
.PP .PP
\fB\ display colors\fR \fB\ display colors:\fR
wmfs -c status "<barname> ^s[<position>;<color>;<text>]"\&. wmfs -c status "<barname> ^s[<position>;<color>;<text>]"\&.
.PP .PP
\fB\ display rectangles\fR \fB\ display rectangles:\fR
wmfs -c status "<barname> ^R[<position>;<dimensions>;<color>]"\&. wmfs -c status "<barname> ^R[<position>;<dimensions>;<color>]"\&.
.PP .PP
\fB\ display images\fR \fB\ display images:\fR
wmfs -c status "<barname> ^i[<position>;<dimensions>;<imagepath>]"\&. wmfs -c status "<barname> ^i[<position>;<dimensions>;<imagepath>]"\&.
.PP .PP
\fB\ display progressbars\fR \fB\ display progressbars:\fR
wmfs -c status "<barname> ^p[<position>;<dimensions>;<border>;<value>;<valuemax>;<bgcolor>;<fgcolor>]"\&. wmfs -c status "<barname> ^p[<position>;<dimensions>;<border>;<value>;<valuemax>;<bgcolor>;<fgcolor>]"\&.
.PP .PP
\fB\ display positionbars\fR \fB\ display positionbars:\fR
wmfs -c status "<barname> ^P[<position>;<dimensions>;<curser>;<value>;<valuemax>;<bgcolor>;<fgcolor>]"\&. wmfs -c status "<barname> ^P[<position>;<dimensions>;<curser>;<value>;<valuemax>;<bgcolor>;<fgcolor>]"\&.
.PP .PP
\fB\ display graph\fR \fB\ display graph:\fR
wmfs -c status "<barname> ^g[<position>;<dimensions>;<value>;<valuemax>;<bgcolor>;<fgcolor>;<name>]"\&. wmfs -c status "<barname> ^g[<position>;<dimensions>;<value>;<valuemax>;<bgcolor>;<fgcolor>;<name>]"\&.
.RE .RE
.PP .PP
\fB\ mousebinds\fR \fB\ mousebinds:\fR
sequences supports mousebinds with format\fB\ (<key>;<uicb-function>)\fR or\fB\ (<key>;<spawn>;<command>)\fR sequences supports mousebinds with format\fB\ (<key>;<uicb-function>)\fR or\fB\ (<key>;<spawn>;<command>)\fR
.RE .RE
.PP .PP
\fB\ surfaces\fR \fB\ surfaces:\fR
you can display popups from the statusbar with the mousebind\fB\ (<key>;status_surface;<position>,<dimension>,<color> <datas>)\fR you can display popups from the statusbar with the mousebind\fB\ (<key>;status_surface;<position>,<dimension>,<color> <datas>)\fR
.PP .PP
.sp .sp
@ -545,122 +551,202 @@ UICB functions list. for “User Interface Call Backs”\&.
\fB\ usage in your terminal:\fR wmfs -c tag_next\&. \fB\ usage in your terminal:\fR wmfs -c tag_next\&.
.PP .PP
\fB\ spawn\fR \fB\ spawn\fR
.RS 4
launch a command. ex: func = "spawn" cmd = "urxvtc -e screen irssi"\&. launch a command. ex: func = "spawn" cmd = "urxvtc -e screen irssi"\&.
.RE
.PP .PP
\fB\ quit\fR \fB\ quit\fR
.RS 4
quit wmfs\&. quit wmfs\&.
.RE
.PP .PP
\fB\ reload\fR \fB\ reload\fR
.RS 4
reload wmfs\&. reload wmfs\&.
.RE
.PP .PP
\fB\ tag_set\fR \fB\ tag_set\fR
.RS 4
set tag by number\&. set tag by number\&.
.RE
.PP .PP
\fB\ tag\fR \fB\ tag\fR
.RS 4
set tag by name\&. set tag by name\&.
.RE
.PP .PP
\fB\ tag_next/prev\fR \fB\ tag_next/prev\fR
.RS 4
set next/previous tag\&. set next/previous tag\&.
.RE
.PP .PP
\fB\ tag_client\fR \fB\ tag_client\fR
.RS 4
tag the client\&. tag the client\&.
.RE
.PP .PP
\fB\ tag_client_and_set\fR \fB\ tag_client_and_set\fR
.RS 4
teg the client and set the tag\&. teg the client and set the tag\&.
.RE
.PP .PP
\fB\ tag_move_client_next/prev\fR \fB\ tag_move_client_next/prev\fR
.RS 4
tag the client with next/previous tag\&. tag the client with next/previous tag\&.
.RE
.PP .PP
\fB\ tag_click\fR \fB\ tag_click\fR
.RS 4
display tag with a clic on tag button\&. display tag with a clic on tag button\&.
.RE
.PP .PP
\fB\ tag_new/del\fR \fB\ tag_new/del\fR
.RS 4
add/delete a tag\&. add/delete a tag\&.
.RE
.PP .PP
\fB\ layout_vmirror\fR \fB\ layout_vmirror\fR
.RS 4
vertical mirror tiling\&. vertical mirror tiling\&.
.RE
.PP .PP
\fB\ layout_hmirror\fR \fB\ layout_hmirror\fR
.RS 4
horizontal mirror tiling\&. horizontal mirror tiling\&.
.RE
.PP .PP
\fB\ layout_rotate_left\fR \fB\ layout_rotate_left\fR
.RS 4
tiling rotate anti/clockwise\&. tiling rotate anti/clockwise\&.
.RE
.PP .PP
\fB\ layout_prev_set\fR \fB\ layout_prev_set\fR
.RS 4
back to previous set layout\&. back to previous set layout\&.
.RE
.PP .PP
\fB\ layout_next_set\fR \fB\ layout_next_set\fR
.RS 4
go to next set layout\&. go to next set layout\&.
.RE
.PP .PP
\fB\ layout_integrate_left/right/top/bottom\fR \fB\ layout_integrate_left/right/top/bottom\fR
.RS 4
client integration in the client zone by direction\&. client integration in the client zone by direction\&.
.RE
.PP .PP
\fB\ client_close\fR \fB\ client_close\fR
.RS 4
close the client\&. close the client\&.
.RE
.PP .PP
\fB\ client_resize_right/left/top/bottom\fR \fB\ client_resize_right/left/top/bottom\fR
.RS 4
resize client with direction\&. resize client with direction\&.
.RE
.PP .PP
\fB\ client_focus_right/left/top/bottom\fR \fB\ client_focus_right/left/top/bottom\fR
.RS 4
focus client with direction\&. focus client with direction\&.
.RE
.PP .PP
\fB\ client_tab_right/left/top/bottom\fR \fB\ client_tab_right/left/top/bottom\fR
.RS 4
tab client with direction\&. tab client with direction\&.
.RE
.PP .PP
\fB\ client_swap_right/left/top/bottom\fR \fB\ client_swap_right/left/top/bottom\fR
.RS 4
swap client with direction\&. swap client with direction\&.
.RE
.PP .PP
\fB\ client_focus_next/prev\fR \fB\ client_focus_next/prev\fR
.RS 4
move focus to the next/previous client\&. move focus to the next/previous client\&.
.RE
.PP .PP
\fB\ client_swap_next/prev\fR \fB\ client_swap_next/prev\fR
.RS 4
swap with the next/previous client\&. swap with the next/previous client\&.
.RE
.PP .PP
\fB\ client_untab\fR \fB\ client_untab\fR
.RS 4
untab the client\&. untab the client\&.
.RE
.PP .PP
\fB\ client_focus_next_tab\fR \fB\ client_focus_next_tab\fR
.RS 4
move focus to next tab-client\&. move focus to next tab-client\&.
.RE
.PP .PP
\fB\ client_focus_prev_tab\fR \fB\ client_focus_prev_tab\fR
.RS 4
move focus to previous tab-client\&. move focus to previous tab-client\&.
.RE
.PP .PP
\fB\ client_focus_click\fR \fB\ client_focus_click\fR
.RS 4
give focus to client with a clic\&. give focus to client with a clic\&.
.RE
.PP .PP
\fB\ client_toggle_free\fR \fB\ client_toggle_free\fR
.RS 4
toggle free the selected client\&. toggle free the selected client\&.
.RE
.PP .PP
\fB\ client_toggle_ignore_tag\fR \fB\ client_toggle_ignore_tag\fR
.RS 4
toggle ignore_tag the selected client\&. toggle ignore_tag the selected client\&.
.RE
.PP
\fB\ client_tab_next_opened\fR \fB\ client_tab_next_opened\fR
.RS 4
open the client in a tab\&. open the client in a tab\&.
.RE
.PP .PP
\fB\ status\fR \fB\ status\fR
.RS 4
display the argument text in the statusbar\&. display the argument text in the statusbar\&.
.RE
.PP .PP
\fB\ status_surface\fR \fB\ status_surface\fR
.RS 4
display a surface. can contain sequences\&. display a surface. can contain sequences\&.
.RE
.PP .PP
\fB\ mouse_resize\fR \fB\ mouse_resize\fR
.RS 4
resize the client\&. resize the client\&.
.RE
.PP .PP
\fB\ mouse_move\fR \fB\ mouse_move\fR
.RS 4
move the client\&. move the client\&.
.RE
.PP .PP
\fB\ mouse_swap\fR \fB\ mouse_swap\fR
.RS 4
swap the client\&. swap the client\&.
.RE
.PP .PP
\fB\ mouse_tab\fR \fB\ mouse_tab\fR
.RS 4
tab the client\&. tab the client\&.
.RE
.PP .PP
\fB\ screen_next/prev\fR \fB\ screen_next/prev\fR
.RS 4
go to next/previous screen\&. go to next/previous screen\&.
.RE
.PP .PP
\fB\ screen_move_client_next/prev\fR \fB\ screen_move_client_next/prev\fR
.RS 4
move the client to next/previous screen\&. move the client to next/previous screen\&.
.RE
.PP .PP
\fB\ launcher\fR \fB\ launcher\fR
.RS 4
native prompt. ex:\fB\ func = "launcher" cmd = "exec"\fR display the “exec” launcher\&. native prompt. ex:\fB\ func = "launcher" cmd = "exec"\fR display the “exec” launcher\&.
.RE .RE
.PP .PP
@ -668,7 +754,7 @@ native prompt. ex:\fB\ func = "launcher" cmd = "exec"\fR display the “exec”
.SH "BUGS" .SH "BUGS"
WMFS isn\'t stable for now\&. So it certainly contains some bugs\&. WMFS isn\'t stable for now\&. So it certainly contains some bugs\&.
.sp .sp
.SH "AUTHORS" .SH "AUTHOR"
Martin Duquesnoy <\fIxorg62@gmail\&.com\fR\&[1]>\&. Martin Duquesnoy <\fIxorg62@gmail\&.com\fR\&[1]>\&.
.sp .sp
.SH "WWW" .SH "WWW"
@ -680,10 +766,4 @@ Bug tracker: \fIhttps://github\&.com/xorg62/wmfs/issues\fR
.sp .sp
.SH "COPYING" .SH "COPYING"
WMFS is under the BSD license\&. See COPYING for more information\&. WMFS is under the BSD license\&. See COPYING for more information\&.
.sp
.SH "NOTES"
.IP " 1." 4
xorg62@gmail.com
.RS 4
\%mailto:xorg62@gmail.com
.RE .RE