[hackers] [dmenu][PATCH] Converted dmenu.1 and stest.1 to mdoc

From: Philip K <philip_AT_warpmail.net>
Date: Tue, 5 Jun 2018 08:37:08 +0200

---
 dmenu.1 | 268 +++++++++++++++++++++++---------------------------------
 stest.1 | 117 +++++++++++--------------
 2 files changed, 161 insertions(+), 224 deletions(-)
diff --git a/dmenu.1 b/dmenu.1
index fbb3f76..7084490 100644
--- a/dmenu.1
+++ b/dmenu.1
_AT_@ -1,194 +1,148 @@
-.TH DMENU 1 dmenu\-VERSION
-.SH NAME
-dmenu \- dynamic menu
-.SH SYNOPSIS
-.B dmenu
-.RB [ \-bfiv ]
-.RB [ \-l
-.IR lines ]
-.RB [ \-m
-.IR monitor ]
-.RB [ \-p
-.IR prompt ]
-.RB [ \-fn
-.IR font ]
-.RB [ \-nb
-.IR color ]
-.RB [ \-nf
-.IR color ]
-.RB [ \-sb
-.IR color ]
-.RB [ \-sf
-.IR color ]
-.RB [ \-w
-.IR windowid ]
-.P
-.BR dmenu_run " ..."
-.SH DESCRIPTION
-.B dmenu
-is a dynamic menu for X, which reads a list of newline\-separated items from
-stdin.  When the user selects an item and presses Return, their choice is printed
-to stdout and dmenu terminates.  Entering text will narrow the items to those
-matching the tokens in the input.
-.P
-.B dmenu_run
+.Dd March 15, 2018
+.Dt DMENU 1
+.Os
+.Sh NAME
+.Nm dmenu
+.Nd dynamic menu
+.Sh SYNOPSIS
+.Nm
+.Op Fl bfiv
+.Op Fl l Ar lines
+.Op Fl p Ar monitor
+.Op Fl fn Ar font
+.Op Fl nb Ar color
+.Op Fl nf Ar color
+.Op Fl sb Ar color
+.Op Fl sf Ar color
+.Op Fl w Ar windowid
+.Pp
+.Nm dmenu_run
+.Op ...
+.Sh DESCRIPTION
+.Nm
+is a dynamic menu for X, which reads a list of newline-separated items from stdin.
+When the user selects an item and presses Return, their choice is printed to stdout and dmenu terminates.
+Entering text will narrow the items to those matching the tokens in the input.
+.Pp
+.Nm dmenu_run
 is a script used by
-.IR dwm (1)
-which lists programs in the user's $PATH and runs the result in their $SHELL.
-.SH OPTIONS
-.TP
-.B \-b
+.Xr dwm 1
+which lists programs in the user's
+.Li $PATH
+and runs the result in their
+.Li $SHELL .
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl b
 dmenu appears at the bottom of the screen.
-.TP
-.B \-f
-dmenu grabs the keyboard before reading stdin.  This is faster, but will lock up
-X until stdin reaches end\-of\-file.
-.TP
-.B \-i
+.It Fl f
+dmenu grabs the keyboard before reading stdin.
+This is faster, but will lock up X until stdin reaches end-of-file.
+.It Fl i
 dmenu matches menu items case insensitively.
-.TP
-.BI \-l " lines"
+.It Fl l Ar lines
 dmenu lists items vertically, with the given number of lines.
-.TP
-.BI \-m " monitor"
-dmenu is displayed on the monitor number supplied. Monitor numbers are starting
-from 0.
-.TP
-.BI \-p " prompt"
+.It Fl m Ar monitor
+dmenu is displayed on the monitor number supplied.
+Monitor numbers are starting from 0.
+.It Fl p Ar prompt
 defines the prompt to be displayed to the left of the input field.
-.TP
-.BI \-fn " font"
+.It Fl fn Ar font
 defines the font or font set used.
-.TP
-.BI \-nb " color"
+.It Fl nb Ar color
 defines the normal background color.
-.IR #RGB ,
-.IR #RRGGBB ,
+.Li #RGB ,
+.Li #RRGGBB ,
 and X color names are supported.
-.TP
-.BI \-nf " color"
+.It Fl nf Ar color
 defines the normal foreground color.
-.TP
-.BI \-sb " color"
+.It Fl sb Ar color
 defines the selected background color.
-.TP
-.BI \-sf " color"
+.It Fl sf Ar color
 defines the selected foreground color.
-.TP
-.B \-v
+.It Fl v
 prints version information to stdout, then exits.
-.TP
-.BI \-w " windowid"
+.It Fl w Ar windowid
 embed into windowid.
-.SH USAGE
-dmenu is completely controlled by the keyboard.  Items are selected using the
-arrow keys, page up, page down, home, and end.
-.TP
-.B Tab
+.El
+.Sh USAGE
+dmenu is completely controlled by the keyboard.
+Items are selected using the arrow keys, page up, page down, home, and end.
+.Bl -tag -width Ds
+.It Tab
 Copy the selected item to the input field.
-.TP
-.B Return
-Confirm selection.  Prints the selected item to stdout and exits, returning
-success.
-.TP
-.B Ctrl-Return
-Confirm selection.  Prints the selected item to stdout and continues.
-.TP
-.B Shift\-Return
-Confirm input.  Prints the input text to stdout and exits, returning success.
-.TP
-.B Escape
+.It Return
+Confirm selection.
+Prints the selected item to stdout and exits, returning success.
+.It Ctrl-Return
+Confirm selection.
+Prints the selected item to stdout and continues.
+.It Shift-Return
+Confirm input.
+Prints the input text to stdout and exits, returning success.
+.Sy Escape
 Exit without selecting an item, returning failure.
-.TP
-.B Ctrl-Left
-Move cursor to the start of the current word
-.TP
-.B Ctrl-Right
-Move cursor to the end of the current word
-.TP
-C\-a
+.It Ctrl-Left
+Move cursor to the start of the current word.
+.It Ctrl-Right
+Move cursor to the end of the current word.
+.It Ctrl-a
 Home
-.TP
-C\-b
+.It Ctrl-b
 Left
-.TP
-C\-c
+.It Ctrl-c
 Escape
-.TP
-C\-d
+.It Ctrl-d
 Delete
-.TP
-C\-e
+.It Ctrl-e
 End
-.TP
-C\-f
+.It Ctrl-f
 Right
-.TP
-C\-g
+.It Ctrl-g
 Escape
-.TP
-C\-h
+.It Ctrl-h
 Backspace
-.TP
-C\-i
+.It Ctrl-i
 Tab
-.TP
-C\-j
+.It Ctrl-j
 Return
-.TP
-C\-J
+.It Ctrl-J
 Shift-Return
-.TP
-C\-k
+.It Ctrl-k
 Delete line right
-.TP
-C\-m
+.It Ctrl-m
 Return
-.TP
-C\-M
+.It Ctrl-M
 Shift-Return
-.TP
-C\-n
+.It Ctrl-n
 Down
-.TP
-C\-p
+.It Ctrl-p
 Up
-.TP
-C\-u
-Delete line left
-.TP
-C\-w
-Delete word left
-.TP
-C\-y
-Paste from primary X selection
-.TP
-C\-Y
-Paste from X clipboard
-.TP
-M\-b
-Move cursor to the start of the current word
-.TP
-M\-f
-Move cursor to the end of the current word
-.TP
-M\-g
+.It Ctrl-u
+Delete line left.
+.It Ctrl-w
+Delete word left.
+.It Ctrl-y
+Paste from primary X selection.
+.It Ctrl-Y
+Paste from X clipboard.
+.It Alt-b
+Move cursor to the start of the current word.
+.It Alt-f
+Move cursor to the end of the current word.
+.It Alt-g
 Home
-.TP
-M\-G
+.It Alt-G
 End
-.TP
-M\-h
+.It Alt-h
 Up
-.TP
-M\-j
+.It Alt-j
 Page down
-.TP
-M\-k
+.It Alt-k
 Page up
-.TP
-M\-l
+.It Alt-l
 Down
-.SH SEE ALSO
-.IR dwm (1),
-.IR stest (1)
+.El
+.Sh SEE ALSO
+.Xr dwm 1 ,
+.Xr stest 1
\ No newline at end of file
diff --git a/stest.1 b/stest.1
index 2667d8a..69b7866 100644
--- a/stest.1
+++ b/stest.1
_AT_@ -1,90 +1,73 @@
-.TH STEST 1 dmenu\-VERSION
-.SH NAME
-stest \- filter a list of files by properties
-.SH SYNOPSIS
-.B stest
-.RB [ -abcdefghlpqrsuwx ]
-.RB [ -n
-.IR file ]
-.RB [ -o
-.IR file ]
-.RI [ file ...]
-.SH DESCRIPTION
-.B stest
+.Dd August 13, 2013
+.Dt STEST 1
+.Os
+.Sh NAME
+.Nm stest
+.Nd filter a list of files by properties
+.Sh SYNOPSIS
+.Nm
+.Op Fl -abcdefghlpqrsuwx
+.Op Fl n Ar file
+.Op Fl o Ar file
+.Op Ar
+.Sh DESCRIPTION
+.Nm
 takes a list of files and filters by the files' properties, analogous to
-.IR test (1).
-Files which pass all tests are printed to stdout. If no files are given, stest
-reads files from stdin.
-.SH OPTIONS
-.TP
-.B \-a
+.Xr test 1 .
+Files which pass all tests are printed to stdout.
+If no files are given, stest reads files from stdin.
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl a
 Test hidden files.
-.TP
-.B \-b
+.It Fl b
 Test that files are block specials.
-.TP
-.B \-c
+.It Fl c
 Test that files are character specials.
-.TP
-.B \-d
+.It Fl d
 Test that files are directories.
-.TP
-.B \-e
+.It Fl e
 Test that files exist.
-.TP
-.B \-f
+.It Fl f
 Test that files are regular files.
-.TP
-.B \-g
+.It Fl g
 Test that files have their set-group-ID flag set.
-.TP
-.B \-h
+.It Fl h
 Test that files are symbolic links.
-.TP
-.B \-l
+.It Fl l
 Test the contents of a directory given as an argument.
-.TP
-.BI \-n " file"
+.It Fl n Op file
 Test that files are newer than
-.IR file .
-.TP
-.BI \-o " file"
+.Em file .
+.It Fl o Op file
 Test that files are older than
-.IR file .
-.TP
-.B \-p
+.Em file .
+.It Fl p
 Test that files are named pipes.
-.TP
-.B \-q
+.It Fl q
 No files are printed, only the exit status is returned.
-.TP
-.B \-r
+.It Fl r
 Test that files are readable.
-.TP
-.B \-s
+.It Fl s
 Test that files are not empty.
-.TP
-.B \-u
+.It Fl u
 Test that files have their set-user-ID flag set.
-.TP
-.B \-v
+.It Fl v
 Invert the sense of tests, only failing files pass.
-.TP
-.B \-w
+.It Fl w
 Test that files are writable.
-.TP
-.B \-x
+.It Fl x
 Test that files are executable.
-.SH EXIT STATUS
-.TP
-.B 0
+.El
+.Sh EXIT STATUS
+.Bl -tag -width Ds -compact
+.It 0
 At least one file passed all tests.
-.TP
-.B 1
+.It 1
 No files passed all tests.
-.TP
-.B 2
+.It 2
 An error occurred.
-.SH SEE ALSO
-.IR dmenu (1),
-.IR test (1)
+.El
+.Sh SEE ALSO
+.Xr dmenu 1 ,
+.Xr test 1
\ No newline at end of file
-- 
2.17.1
Received on Tue Jun 05 2018 - 08:37:08 CEST

This archive was generated by hypermail 2.3.0 : Tue Jun 05 2018 - 08:48:19 CEST