summaryrefslogtreecommitdiff
path: root/data
diff options
context:
space:
mode:
authorLogan Rathbone <poprocks@gmail.com>2023-01-19 14:07:34 -0500
committerLogan Rathbone <poprocks@gmail.com>2023-01-23 23:41:38 -0500
commit011783da148ce9c81d042feecd202f6935f7ef71 (patch)
treea21403ebdef8f824e068f7124263d2323e957363 /data
parent7e3cf22aba795935154c25e65e6fe8bc2895f05c (diff)
downloadzenity-011783da148ce9c81d042feecd202f6935f7ef71.tar.gz
Initial port to libadwaita
Diffstat (limited to 'data')
-rw-r--r--data/meson.build23
-rw-r--r--data/zenity.roff (renamed from data/zenity.1)58
2 files changed, 33 insertions, 48 deletions
diff --git a/data/meson.build b/data/meson.build
index 04cfc15..6cdfea5 100644
--- a/data/meson.build
+++ b/data/meson.build
@@ -22,6 +22,25 @@ if desktop_file_validate_prg.found()
)
endif
-# manpage
+# manpage -- generated from help2man
-install_man('zenity.1')
+help2man = find_program('help2man', required: false)
+# help2man has to run zenity to generate the man page, which it can't do if
+# we're cross building. We also can't tell help2man what exe wrapper to use.
+if help2man.found() and not meson.is_cross_build()
+ help2man_opts = [
+ '--no-info',
+ '--section=1',
+ '--help-option=--help-all',
+ '--include=@INPUT@',
+ ]
+
+ custom_target('zenity.1',
+ output: 'zenity.1',
+ input: 'zenity.roff',
+ command: [
+ help2man, help2man_opts, '--output=@OUTPUT@', zenity
+ ],
+ install: true,
+ install_dir: join_paths(zenity_mandir, 'man1'))
+endif
diff --git a/data/zenity.1 b/data/zenity.roff
index 6f7f9bf..36d7596 100644
--- a/data/zenity.1
+++ b/data/zenity.roff
@@ -1,10 +1,5 @@
-.TH ZENITY 1 "January 2022"
-.SH NAME
-zenity \- display GTK+ dialogs
-.SH SYNOPSIS
-.B zenity
-.RI [ options ]
-.SH DESCRIPTION
+[description]
+
\fBzenity\fP is a program that will display GTK+ dialogs, and return
(either in the return code, or on standard output) the users
input. This allows you to present information, and ask for information
@@ -17,40 +12,7 @@ what the user typed into the text entry field.
.PP
Comprehensive documentation is also available in the GNOME Help Browser.
-.SH OPTIONS
-This program follows the usual GNU command line syntax, with long
-options starting with two dashes (`-').
-
-.SS
-Dialog Options
-
-.PP
-Options can be used in various combinations in order to craft many different
-types of dialogs.
-
-.PP
-For a summary of options, run \fBzenity \-\-help\fP. This will display the
-first hierarchy of options available. A separate series of help sub-categories
-for each of these options will be displayed.
-
-.PP
-For a full and complete list of all options for your build and an explanation
-of these options, run \fBzenity \-\-help\-all\fP
-
-.SS
-Miscellaneous options
-
-.TP
-.B \-?, \-\-help
-Show summary of options.
-.TP
-.B \-\-about
-Display an about dialog.
-.TP
-.B \-\-version
-Show version of program.
-
-.SH EXAMPLES
+[examples]
Display a file selector with the title \fISelect a file to
remove\fP. The file selected is returned on standard output.
@@ -85,10 +47,14 @@ zenity \-\-list \-\-checklist \-\-column "Buy" \-\-column "Item" TRUE Apples TRU
Display a progress dialog while searching for all the postscript files in your home directory
.P
find $HOME \-name '*.ps' | zenity \-\-progress \-\-pulsate
-.SH AUTHOR
-\fBZenity\fP was written by Glynn Foster <glynn.foster@sun.com>.
-.P
-This manual page was written by Ross Burton <ross@burtonini.com>.
-.SH SEE ALSO
+[author]
+
+.PP
+\fBZenity\fP was originally written by Glynn Foster <glynn.foster@sun.com>. It has since been maintained by a number of contributors since then.
+.PP
+This manual page was originally written by Ross Burton <ross@burtonini.com>. It currently contains portions which are automatically generated, and other portions written by its original author.
+
+[see also]
+
\fBdialog\fP(1)