Create manpage from markdown file.

doc/README

@@ -0,0 +1,4 @@
+Update manpage using md2man
+
+
+  md2man-roff rofi-manpage.markdown > rofi.1

doc/rofi-manpage.markdown

@@ -0,0 +1,228 @@
+ROFI 1 rofi
+===========
+
+NAME
+----
+
+rofi - A window switcher, run dialog and dmenu replacement
+
+SYNOPSIS
+--------
+
+`rofi` [ -width *pct_scr* ] [ -lines *lines* ] [ -columns *columns* ] [ -font *xftfont* ] [ -fg *color* ]
+[ -bg *color* ] [ -hlfg *color* ] [ -hlbg *color* ] [ -key *combo* ] [ -dkey *comdo* ] [ -rkey *comdo* ]
+[ -terminal *terminal* ] [ -loc *position* ] [ -hmode ] [ -fixed-num-lines ] [ -padding *padding* ]
+[ -opacity *opacity%* ] [ -display *display* ] [ -bc *color* ] [ -bw *width* ] [ -dmenu [ -p *prompt* ] ]
+[ -ssh-set-title *true|false* ] [ -now ] [ -rnow ] [ -snow ] [ -version ] [ -help] [ -dump ]
+
+DESCRIPTION
+-----------
+`rofi` is an X11 popup window switcher. A list is displayed center-screen showing open window titles, WM_CLASS, and desktop number. 
+The user may filter the list by typing, navigate with Up/Down or Tab keys, and select a window with Return (Enter). Escape cancels.
+
+License
+-------
+
+MIT/X11
+
+USAGE
+-----
+
+`rofi` can be used in two ways, single-shot; executes once and directly exits when done or as
+daemon listening to specific key-combinations.
+
+The default key combinations are:
+
+* `F12`
+
+   Show all windows on all desktops.
+
+* `mod1-F2`
+
+   Show run-dialog.
+
+* `mod1-F3`
+
+   Show run-dialog.
+
+
+OPTIONS
+-------
+`-key`
+
+    Change the key combination to display all windows (default: F12).
+
+        rofi -key F12
+        rofi -key control+shift+s
+        rofi -key mod1+Tab
+
+
+`-rkey`
+
+    Change the key combination to display the run dialog (default: mod1-F2).
+
+
+        rofi -rkey F11
+        rofi -rkey control+shift+d
+        rofi -rkey mod1+grave (grave=backtick)
+
+
+`-skey`
+
+    Change the key combination to display the ssh dialog (default: Alt-F3).
+
+
+        rofi -skey F10
+        rofi -skey control+shift+s
+        rofi -skey mod1+grave (grave=backtick)
+
+
+`-now`
+
+    Run rofi in all-windows mode once then exit. Does not bind any keys.
+
+`-rnow`
+
+    Run rofi in run-dialog mode once then exit. Does not bind any keys.
+
+`-snow`
+
+    Run rofi in ssh mode once then exit. Does not bind any keys.
+
+`-bg`
+
+    Set the background text color (X11 named color or hex #rrggbb) for the menu (default: #222222).
+
+        rofi -fg "#222222"
+
+
+`-bc`
+
+    Set the border color (X11 named color or hex #rrggbb) for the menu (default: #000000).
+
+        rofi -bc black
+
+
+`-bw`
+
+    Set the border width in pixels (default: 1).
+
+        rofi -bw 1
+
+
+`-fg`
+
+    Set the foreground text color (X11 named color or hex #rrggbb) for the menu (default: #cccccc).
+
+        rofi -fg "#cccccc"
+
+`-font`
+
+    Xft font name for use by the menu (default: mono-14).
+
+
+        rofi -font monospace-14:medium
+
+
+`-hlbg`
+
+    Set the background text color (X11 named color or hex #rrggbb) for the highlighted item in the
+    menu (default: #005577).
+
+        rofi -fg "#005577"
+
+
+`-hlfg`
+
+    Set the foreground text color (X11 named color or hex #rrggbb) for the highlighted item in the
+    menu (default: #ffffff).
+
+        rofi -fg "#ffffff"
+
+
+`-opacity`
+
+    Set the window opacity (0-100).
+
+        rofi -opacity "75"
+
+`-lines`
+
+    Maximum number of lines the menu may show before scrolling (default: 25).
+
+        rofi -lines 25
+
+`-columns`
+
+    The number of columns the menu may show before scrolling (default: 25).
+
+        rofi -columns 2
+
+`-width`
+
+    Set the width of the menu as a percentage of the screen width (default: 60).
+
+        rofi -width 60
+
+`-terminal`
+
+    Specify what terminal to start (default x-terminal-emulator)
+
+        rofi -terminal xterm
+
+`-loc`
+
+    Specify where the window should be located. The numbers map to the following location on the
+    monitor:
+
+        1 2 3
+        8 0 4
+        7 6 5
+
+`-hmode`
+
+  Switch to horizontal mode (ala dmenu). The number of elements is the number of `lines` times the
+  number of `columns`.
+
+`-fixed-num-lines`
+
+   Keep a fixed number of visible lines (See the `-lines` option.)
+
+`-padding`
+
+    Define the inner margin of the window. Default is 5 pixels.
+
+    To make rofi look like dmenu:
+
+        rofi -hmode -padding 0
+
+`-dmenu`
+
+  Run rofi in dmenu mode. Allowing it to be used for user interaction in scripts.
+
+`-dump`
+
+  Dump the current active configuration to the command-line.
+
+`-ssh-set-title` *true|false*
+
+  SSH dialogs tries to set 'ssh hostname' of the spawned terminal.
+  Not all terminals support this.
+  Default value is true.
+
+
+Switch between modi
+-------------------
+
+Type '?' *enter* to switch between window list, run and ssh mode.
+
+WEBSITE
+-------
+
+`rofi` website can be found at [here](https://davedavenport.github.io/rofi/)
+
+AUTHOR
+------
+Qball Cow <qball@gmpclient.org>
+
+Original code based on work by: Sean Pringle <sean.pringle@gmail.com>

doc/rofi.1

@@ -1,254 +1,272 @@
 .TH ROFI 1 rofi
 .SH NAME
-rofi \- a simple EWMH window switcher
+.PP
+rofi \- A window switcher, run dialog and dmenu replacement
 .SH SYNOPSIS
-.B rofi
+.PP
-.RB [ \-width
+\fB\fCrofi\fR [ \-width \fIpct_scr\fP ] [ \-lines \fIlines\fP ] [ \-columns \fIcolumns\fP ] [ \-font \fIxftfont\fP ] [ \-fg \fIcolor\fP ]
-.IR pct_scr ]
+[ \-bg \fIcolor\fP ] [ \-hlfg \fIcolor\fP ] [ \-hlbg \fIcolor\fP ] [ \-key \fIcombo\fP ] [ \-dkey \fIcomdo\fP ] [ \-rkey \fIcomdo\fP ]
-.RB [ \-lines
+[ \-terminal \fIterminal\fP ] [ \-loc \fIposition\fP ] [ \-hmode ] [ \-fixed\-num\-lines ] [ \-padding \fIpadding\fP ]
-.IR lines ]
+[ \-opacity \fIopacity%\fP ] [ \-display \fIdisplay\fP ] [ \-bc \fIcolor\fP ] [ \-bw \fIwidth\fP ] [ \-dmenu [ \-p \fIprompt\fP ] ]
-.RB [ \-columns
+[ \-ssh\-set\-title \fItrue|false\fP ] [ \-now ] [ \-rnow ] [ \-snow ] [ \-version ] [ \-help] [ \-dump ]
-.IR columns ]
-.RB [ \-font
-.IR xftfont ]
-.RB [ \-fg
-.IR color ]
-.RB [ \-bg
-.IR color ]
-.RB [ \-hlfg
-.IR color ]
-.RB [ \-hlbg
-.IR color ]
-.RB [ \-key
-.IR combo ]
-.RB [ \-dkey
-.IR comdo ]
-.RB [ \-rkey
-.IR comdo ]
-.RB [ \-now ]
-.RB [ \-rnow ]
-.RB [ \-snow ]
-.RB [ \-terminal
-.IR terminal
-]
-.RB [ \-loc
-.IR position ]
-.RB [ \-hmode ]
-.RB [ \-fixed\-num\-lines ]
-.RB [ \-padding
-.IR padding
-]
-.RB [ \-opacity
-.IR opacity %
-]
-.RB [ \-version ]
-.RB [ \-help]
-.RB [ \-display
-.IR display ]
-.RB [ \-bc
-.IR color ]
-.RB [ \-bw
-.IR width ]
-.RB [ \-dmenu
-.RB [ \-p
-.IR prompt
-]
-.RB [ \-dump ]
-.RB [ \-ssh\-set\-title
-true|false
-]
-
 .SH DESCRIPTION
-.I rofi
+.PP
-is an X11 popup window switcher. A list is displayed center-screen showing open window titles, WM_CLASS, and desktop number. The user may filter the list by typing, navigate with Up/Down or Tab keys, and select a window with Return (Enter). Escape cancels.
+\fB\fCrofi\fR is an X11 popup window switcher. A list is displayed center\-screen showing open window titles, WM_CLASS, and desktop number. 
-.P
+The user may filter the list by typing, navigate with Up/Down or Tab keys, and select a window with Return (Enter). Escape cancels.
-License: MIT/X11
+.SH License
+.PP
+MIT/X11
 .SH USAGE
-See options below for custom key combinations. These are the defaults.
+.PP
-.TP
+\fB\fCrofi\fR can be used in two ways, single\-shot; executes once and directly exits when done or as
-.B F12
+daemon listening to specific key\-combinations.
+.PP
+The default key combinations are:
+.RS
+.IP \(bu 2
+\fB\fCF12\fR
+.RE
+.PP
    Show all windows on all desktops.
-.TP
+.RS
-.B mod1-F2
+.IP \(bu 2
-Show run-dialog.
+\fB\fCmod1\-F2\fR
+.RE
+.PP
+   Show run\-dialog.
+.RS
+.IP \(bu 2
+\fB\fCmod1\-F3\fR
+.RE
+.PP
+   Show run\-dialog.
 .SH OPTIONS
-.TP
+.PP
-.B -key
+\fB\fC\-key\fR
+.PP
+.RS
+.nf
 Change the key combination to display all windows (default: F12).
-.P
+    rofi \-key F12
-.RS
+    rofi \-key control+shift+s
-rofi -key F12
+    rofi \-key mod1+Tab
-.br
+.fi
-rofi -key control+shift+s
-.br
-rofi -key mod1+Tab
 .RE
-.TP
+.PP
-.B -rkey
+\fB\fC\-rkey\fR
-Change the key combination to display the run dialog (default: mod1-F2).
+.PP
-.P
 .RS
-rofi -rkey F11
+.nf
-.br
+Change the key combination to display the run dialog (default: mod1\-F2).
-rofi -rkey control+shift+d
+    rofi \-rkey F11
-.br
+    rofi \-rkey control+shift+d
-rofi -rkey mod1+grave (grave=backtick)
+    rofi \-rkey mod1+grave (grave=backtick)
+.fi
 .RE
-.TP
+.PP
-.B -skey
+\fB\fC\-skey\fR
-Change the key combination to display the ssh dialog (default: Alt-F3).
+.PP
-.P
 .RS
-rofi -skey F10
+.nf
-.br
+Change the key combination to display the ssh dialog (default: Alt\-F3).
-rofi -skey control+shift+s
+    rofi \-skey F10
-.br
+    rofi \-skey control+shift+s
-rofi -skey mod1+grave (grave=backtick)
+    rofi \-skey mod1+grave (grave=backtick)
+.fi
 .RE
-.TP
+.PP
-.B -now
+\fB\fC\-now\fR
-Run rofi in all-windows mode once then exit. Does not bind any keys.
+.PP
-.TP
+.RS
-.B -rnow
+.nf
-Run rofi in run-dialog mode once then exit. Does not bind any keys.
+Run rofi in all\-windows mode once then exit. Does not bind any keys.
-.TP
+.fi
-.B -snow
+.RE
+.PP
+\fB\fC\-rnow\fR
+.PP
+.RS
+.nf
+Run rofi in run\-dialog mode once then exit. Does not bind any keys.
+.fi
+.RE
+.PP
+\fB\fC\-snow\fR
+.PP
+.RS
+.nf
 Run rofi in ssh mode once then exit. Does not bind any keys.
-.TP
+.fi
-.B -bg
+.RE
+.PP
+\fB\fC\-bg\fR
+.PP
+.RS
+.nf
 Set the background text color (X11 named color or hex #rrggbb) for the menu (default: #222222).
-.P
+    rofi \-fg "#222222"
-.RS
+.fi
-rofi -fg "#222222"
 .RE
-.TP
+.PP
-.B -bc
+\fB\fC\-bc\fR
+.PP
+.RS
+.nf
 Set the border color (X11 named color or hex #rrggbb) for the menu (default: #000000).
-.P
+    rofi \-bc black
-.RS
+.fi
-rofi -bc black
 .RE
-.TP
+.PP
-.B -bw
+\fB\fC\-bw\fR
+.PP
+.RS
+.nf
 Set the border width in pixels (default: 1).
-.P
+    rofi \-bw 1
-.RS
+.fi
-rofi -bw 1
 .RE
-.TP
+.PP
-.B -fg
+\fB\fC\-fg\fR
+.PP
+.RS
+.nf
 Set the foreground text color (X11 named color or hex #rrggbb) for the menu (default: #cccccc).
-.P
+    rofi \-fg "#cccccc"
-.RS
+.fi
-rofi -fg "#cccccc"
 .RE
-.TP
+.PP
-.B -font
+\fB\fC\-font\fR
-Xft font name for use by the menu (default: mono-14).
+.PP
-.P
 .RS
-rofi -font monospace-14:medium
+.nf
+Xft font name for use by the menu (default: mono\-14).
+    rofi \-font monospace\-14:medium
+.fi
 .RE
-.TP
+.PP
-.B -hlbg
+\fB\fC\-hlbg\fR
-Set the background text color (X11 named color or hex #rrggbb) for the highlighted item in the menu (default: #005577).
+.PP
-.P
 .RS
-rofi -fg "#005577"
+.nf
+Set the background text color (X11 named color or hex #rrggbb) for the highlighted item in the
+menu (default: #005577).
+    rofi \-fg "#005577"
+.fi
 .RE
-.TP
+.PP
-.B -hlfg
+\fB\fC\-hlfg\fR
-Set the foreground text color (X11 named color or hex #rrggbb) for the highlighted item in the menu (default: #ffffff).
+.PP
-.P
 .RS
-rofi -fg "#ffffff"
+.nf
+Set the foreground text color (X11 named color or hex #rrggbb) for the highlighted item in the
+menu (default: #ffffff).
+    rofi \-fg "#ffffff"
+.fi
 .RE
-.TP
+.PP
-.B -opacity
+\fB\fC\-opacity\fR
-Set the window opacity (0-100).
+.PP
-.P
 .RS
-rofi -opacity "75"
+.nf
+Set the window opacity (0\-100).
+    rofi \-opacity "75"
+.fi
 .RE
-.TP
+.PP
-.B -lines
+\fB\fC\-lines\fR
+.PP
+.RS
+.nf
 Maximum number of lines the menu may show before scrolling (default: 25).
-.P
+    rofi \-lines 25
-.RS
+.fi
-rofi -lines 25
 .RE
-.TP
+.PP
-.B -columns
+\fB\fC\-columns\fR
+.PP
+.RS
+.nf
 The number of columns the menu may show before scrolling (default: 25).
-.P
+    rofi \-columns 2
-.RS
+.fi
-rofi -columns 2
 .RE
-.TP
+.PP
-.B -width
+\fB\fC\-width\fR
+.PP
+.RS
+.nf
 Set the width of the menu as a percentage of the screen width (default: 60).
-.P
+    rofi \-width 60
-.RS
+.fi
-rofi -width 60
 .RE
-.TP
+.PP
-.B -terminal
+\fB\fC\-terminal\fR
-Specify what terminal to start (default x-terminal-emulator)
+.PP
-.P
 .RS
-rofi -terminal xterm
+.nf
+Specify what terminal to start (default x\-terminal\-emulator)
+    rofi \-terminal xterm
+.fi
 .RE
-.TP
+.PP
-.B -loc
+\fB\fC\-loc\fR
+.PP
+.RS
+.nf
 Specify where the window should be located. The numbers map to the following location on the
 monitor:
-.RS
-.TP
     1 2 3
-.TP
     8 0 4
-.TP
     7 6 5
+.fi
 .RE
-.TP
+.PP
-.B -hmode
+\fB\fC\-hmode\fR
-Switch to horizontal mode (ala dmenu). The number of elements is the number of
+.IP
-.IR lines
+Switch to horizontal mode (ala dmenu). The number of elements is the number of \fB\fClines\fR times the
-times the number of
+number of \fB\fCcolumns\fR\&.
-.IR columns
+.PP
-.
+\fB\fC\-fixed\-num\-lines\fR
-.TP
+.PP
-.B -fixed-num-lines
+   Keep a fixed number of visible lines (See the \fB\fC\-lines\fR option.)
-Keep a fixed number of visible lines (See the
+.PP
-.IR -lines
+\fB\fC\-padding\fR
-option.)
+.PP
-.TP
-.B -padding
-Define the inner margin of the window. Default is 5 pixels.
 .RS
+.nf
+Define the inner margin of the window. Default is 5 pixels.
 To make rofi look like dmenu:
-.TP
+    rofi \-hmode \-padding 0
-rofi -hmode -padding 0
+.fi
 .RE
-.TP
+.PP
-.B -dmenu
+\fB\fC\-dmenu\fR
+.IP
 Run rofi in dmenu mode. Allowing it to be used for user interaction in scripts.
-.RE
+.PP
-.TP
+\fB\fC\-dump\fR
-.B -dump
+.IP
-Dump the current active configuration to the command-line.
+Dump the current active configuration to the command\-line.
-.RE
+.PP
-.TP
+\fB\fC\-ssh\-set\-title\fR \fItrue|false\fP
-.B -ssh-set-title true|false
+.IP
-SSH dialogs tries to set 'ssh <hostname>' of the spawned terminal.
+SSH dialogs tries to set 'ssh hostname' of the spawned terminal.
 Not all terminals support this.
 Default value is true.
-.RS
 .SH Switch between modi
-Type '?'<enter> to switch between window list, run and ssh mode.
+.PP
-.SH SEE ALSO
+Type '?' \fIenter\fP to switch between window list, run and ssh mode.
-.BR rofi (1)
+.SH WEBSITE
+.PP
+\fB\fCrofi\fR website can be found at here
+.UR https://davedavenport.github.io/rofi/
+.UE
 .SH AUTHOR
-Qball Cow <qball@gmpclient.org>
+.PP
-.br
+Qball Cow 
-Original code based on work by: Sean Pringle <sean.pringle@gmail.com>
+.MT qball@gmpclient.org
+.ME
+.PP
+Original code based on work by: Sean Pringle 
+.MT sean.pringle@gmail.com
+.ME