From b434e3e02e896c76e91452b8f3d10d4e80f101be Mon Sep 17 00:00:00 2001 From: Dave Davenport Date: Sat, 19 Sep 2020 16:49:50 +0200 Subject: [PATCH] [Man] update-rofi-sensible-terminal.1 manpage * Source from markdown * Update list. Fixes: #897 #850 --- Makefile.am | 4 +- doc/rofi-sensible-terminal.1 | 188 ++++++++------------------ doc/rofi-sensible-terminal.1.markdown | 50 +++++++ doc/rofi-theme.5 | 14 +- meson.build | 1 + 5 files changed, 116 insertions(+), 141 deletions(-) create mode 100644 doc/rofi-sensible-terminal.1.markdown diff --git a/Makefile.am b/Makefile.am index 42f0b8d9..c2cea4e2 100644 --- a/Makefile.am +++ b/Makefile.am @@ -184,6 +184,7 @@ EXTRA_DIST += \ doc/rofi-theme.5.markdown \ doc/rofi-script.5.markdown \ doc/rofi-theme-selector.1.markdown \ + doc/rofi-sensible-terminal.1.markdown \ doc/rofi.1.markdown @@ -260,11 +261,12 @@ EXTRA_DIST+=\ ## -update-manpage: $(top_srcdir)/doc/rofi-theme-selector.1.markdown $(top_srcdir)/doc/rofi.1.markdown $(top_srcdir)/doc/rofi-theme.5.markdown $(top_srcdir)/doc/rofi-script.5.markdown +update-manpage: $(top_srcdir)/doc/rofi-theme-selector.1.markdown $(top_srcdir)/doc/rofi.1.markdown $(top_srcdir)/doc/rofi-theme.5.markdown $(top_srcdir)/doc/rofi-script.5.markdown ${top_srcdir}/doc/rofi-sensible-terminal.1.markdown go-md2man -in $(top_srcdir)/doc/rofi.1.markdown -out $(top_srcdir)/doc/rofi.1 go-md2man -in $(top_srcdir)/doc/rofi-theme-selector.1.markdown -out $(top_srcdir)/doc/rofi-theme-selector.1 go-md2man -in $(top_srcdir)/doc/rofi-theme.5.markdown -out $(top_srcdir)/doc/rofi-theme.5 go-md2man -in $(top_srcdir)/doc/rofi-script.5.markdown -out $(top_srcdir)/doc/rofi-script.5 + go-md2man -in $(top_srcdir)/doc/rofi-sensible-terminal.1.markdown -out $(top_srcdir)/doc/rofi-sensible-terminal.1 ## # Rofi test program diff --git a/doc/rofi-sensible-terminal.1 b/doc/rofi-sensible-terminal.1 index b03a7a65..6d10df97 100644 --- a/doc/rofi-sensible-terminal.1 +++ b/doc/rofi-sensible-terminal.1 @@ -1,148 +1,66 @@ -.TH "ROFI\-SENSIBLE\-TERMIN" "1" -.ie \n(.g .ds Aq \(aq -.el .ds Aq ' -.nh -.ad l -.SH "NAME" -rofi-sensible-terminal \- launches $TERMINAL with fallbacks -.SH "SYNOPSIS" -.sp +.TH rofi\-sensible\-terminal 1 rofi\-sensible\-terminal +.SH NAME +.PP +\fBrofi\-sensible\-terminal\fP \- launches $TERMINAL with fallbacks + +.SH SYNOPSIS +.PP rofi\-sensible\-terminal [arguments] -.SH "DESCRIPTION" -.sp -rofi\-sensible\-terminal is invoked in the rofi default config to start a terminal\&. This wrapper script is necessary since there is no distribution\-independent terminal launcher (but for example Debian has x\-terminal\-emulator)\&. Distribution packagers are responsible for shipping this script in a way which is appropriate for the distribution\&. -.sp + +.SH DESCRIPTION +.PP +rofi\-sensible\-terminal is invoked in the rofi default config to start a terminal. This +wrapper script is necessary since there is no distribution\-independent terminal launcher +(but for example Debian has x\-terminal\-emulator). Distribution packagers are responsible for +shipping this script in a way which is appropriate for the distribution. + +.PP It tries to start one of the following (in that order): -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -$TERMINAL (this is a non\-standard variable) -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} +.IP \(bu 2 +\fB\fC$TERMINAL\fR (this is a non\-standard variable) +.IP \(bu 2 x\-terminal\-emulator -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -termite -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} +.IP \(bu 2 urxvt -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} +.IP \(bu 2 rxvt -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -terminator -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} +.IP \(bu 2 +st +.IP \(bu 2 +terminology +.IP \(bu 2 +qterminal +.IP \(bu 2 Eterm -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} +.IP \(bu 2 aterm -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} +.IP \(bu 2 +uxterm +.IP \(bu 2 xterm -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} +.IP \(bu 2 roxterm -.RE -.sp -.RS 4 -.ie n \{\ -\h'-04'\(bu\h'+03'\c -.\} -.el \{\ -.sp -1 -.IP \(bu 2.3 -.\} -xfce4\-terminal -.RE -.sp -Please don\(cqt complain about the order: If the user has any preference, she will have $TERMINAL set or modified her rofi configuration file\&. -.SH "SEE ALSO" -.sp +.IP \(bu 2 +xfce4\-terminal.wrapper +.IP \(bu 2 +mate\-terminal +.IP \(bu 2 +lxterminal +.IP \(bu 2 +konsole +.IP \(bu 2 +alacritty +.IP \(bu 2 +kitty + +.SH SEE ALSO +.PP rofi(1) -.SH "AUTHOR" -.sp + +.SH AUTHORS +.PP Dave Davenport and contributors -.sp + +.PP Copied script from i3: -.br Michael Stapelberg and contributors diff --git a/doc/rofi-sensible-terminal.1.markdown b/doc/rofi-sensible-terminal.1.markdown new file mode 100644 index 00000000..48140142 --- /dev/null +++ b/doc/rofi-sensible-terminal.1.markdown @@ -0,0 +1,50 @@ +# rofi-sensible-terminal 1 rofi-sensible-terminal + +## NAME + +**rofi-sensible-terminal** - launches $TERMINAL with fallbacks + +## SYNOPSIS + +rofi-sensible-terminal [arguments] + +## DESCRIPTION + +rofi-sensible-terminal is invoked in the rofi default config to start a terminal. This +wrapper script is necessary since there is no distribution-independent terminal launcher +(but for example Debian has x-terminal-emulator). Distribution packagers are responsible for +shipping this script in a way which is appropriate for the distribution. + +It tries to start one of the following (in that order): + +* `$TERMINAL` (this is a non-standard variable) +* x-terminal-emulator +* urxvt +* rxvt +* st +* terminology +* qterminal +* Eterm +* aterm +* uxterm +* xterm +* roxterm +* xfce4-terminal.wrapper +* mate-terminal +* lxterminal +* konsole +* alacritty +* kitty + + +## SEE ALSO + +rofi(1) + +## AUTHORS + +Dave Davenport and contributors + +Copied script from i3: +Michael Stapelberg and contributors + diff --git a/doc/rofi-theme.5 b/doc/rofi-theme.5 index cf16ab6d..44be7055 100644 --- a/doc/rofi-theme.5 +++ b/doc/rofi-theme.5 @@ -531,15 +531,19 @@ width: calc( 100% \- 37px ); .PP It supports the following operations: .IP \(bu 2 -\fB\fC+\fR: Add +\fB\fC+\fR : Add .IP \(bu 2 -\fB\fC\-\fR: Subtract +\fB\fC\-\fR : Subtract .IP \(bu 2 -\fB\fC/\fR: Divide +\fB\fC/\fR : Divide .IP \(bu 2 -\fB\fC*\fR: Multiply +\fB\fC*\fR : Multiply .IP \(bu 2 -\fB\fC%\fR: Multiply +\fB\fC%\fR : Multiply +.IP \(bu 2 +\fB\fCmin\fR : Minimum of l or rvalue; +.IP \(bu 2 +\fB\fCmax\fR : Maximum of l or rvalue; .PP It uses the C precedence ordering. diff --git a/meson.build b/meson.build index 9e893842..279648ca 100644 --- a/meson.build +++ b/meson.build @@ -226,6 +226,7 @@ install_man( 'doc/rofi.1', 'doc/rofi-theme-selector.1', 'doc/rofi-sensible-terminal.1', + 'doc/rofi-script.5', 'doc/rofi-theme.5', )