[patch] Small updates to man pages
Hello
Attached is a proposal.
:)
commit 486c816ef4443914886c83967224df302f2ff517
Author: Jean-Michel Vourgère <jmv_deb@nirgal.com>
Date: Sun Jul 21 23:51:06 2013 +0200
Update a2(en|dis)* man pages
* Added --maintmode --purge [--force] in synopsis.
* Documents --force for a2dismod.
* Sanitize the see also sections.
diff --git a/debian/manpages/a2enconf.8 b/debian/manpages/a2enconf.8
index 8106ab7..80a00e6 100644
--- a/debian/manpages/a2enconf.8
+++ b/debian/manpages/a2enconf.8
@@ -19,12 +19,14 @@
a2enconf, a2disconf \- enable or disable an apache2 configuration file
.SH SYNOPSIS
.B a2enconf
-[ [\-q|\-\-quiet]
-.IR configuration ]
+[\-q|\-\-quiet] [ \-m|\-\-maintmode ] [
+.IR configuration
+]
.PP
.B a2disconf
-[ [\-q|\-\-quiet]
-.IR configuration ]
+[\-q|\-\-quiet] [ \-m|\-\-maintmode ] [\-p|\-\-purge] [
+.IR configuration
+]
.SH DESCRIPTION
This manual page documents briefly the
.B a2enconf
@@ -56,6 +58,7 @@ Don't show informative messages.
Enables the maintainer mode, that is the program invocation is effectuated
automatically by a maintainer script. This switch should not be used by end
users.
+.TP
.B \-p, \-\-purge
When disabling a module, purge all traces of the module in the internal state
data base.
@@ -90,7 +93,9 @@ for enabled configuration files.
.SH "SEE ALSO"
.BR apache2ctl (8),
.BR a2enmod (8),
-.BR a2dismod (8).
+.BR a2dismod (8),
+.BR a2ensite (8),
+.BR a2dissite (8).
.SH AUTHOR
This manual page was written by Arno Toell <debian@toell.net> for the Debian
GNU/Linux distribution, as it is a Debian-specific script with the package.
diff --git a/debian/manpages/a2enmod.8 b/debian/manpages/a2enmod.8
index 4e35c84..c98733a 100644
--- a/debian/manpages/a2enmod.8
+++ b/debian/manpages/a2enmod.8
@@ -19,12 +19,14 @@
a2enmod, a2dismod \- enable or disable an apache2 module
.SH SYNOPSIS
.B a2enmod
-[ [\-q|\-\-quiet]
-.IR module ]
+[\-q|\-\-quiet] [ \-m|\-\-maintmode ] [
+.IR module
+]
.PP
.B a2dismod
-[ [\-q|\-\-quiet]
-.IR module ]
+[\-q|\-\-quiet] [\-f|\-\-force] [ \-m|\-\-maintmode ] [\-p|\-\-purge] [
+.IR module
+]
.SH DESCRIPTION
This manual page documents briefly the
.B a2enmod
@@ -52,10 +54,14 @@ directives in the .conf file as directives into the main server context of
.B \-q, \-\-quiet
Don't show informative messages.
.TP
+.B \-f, \-\-force
+When disabling a module, also cascade disables all modules that depends on it.
+.TP
.B \-m, \-\-maintmode
Enables the maintainer mode, that is the program invocation is effectuated
automatically by a maintainer script. This switch should not be used by end
users.
+.TP
.B \-p, \-\-purge
When disabling a module, purge all traces of the module in the internal state
data base.
@@ -90,7 +96,9 @@ for enabled modules.
.SH "SEE ALSO"
.BR apache2ctl (8),
.BR a2enconf (8),
-.BR a2disconf (8).
+.BR a2disconf (8),
+.BR a2ensite (8),
+.BR a2dissite (8).
.SH AUTHOR
This manual page was written by Daniel Stone <daniel@sfarc.net> for the Debian
GNU/Linux distribution, as it is a Debian-specific script with the package.
diff --git a/debian/manpages/a2ensite.8 b/debian/manpages/a2ensite.8
index c2e21d0..7e2c815 100644
--- a/debian/manpages/a2ensite.8
+++ b/debian/manpages/a2ensite.8
@@ -19,12 +19,14 @@
a2ensite, a2dissite \- enable or disable an apache2 site / virtual host
.SH SYNOPSIS
.B a2ensite
-[ [\-q|\-\-quiet]
-.IR site ]
+[\-q|\-\-quiet] [ \-m|\-\-maintmode ] [
+.IR site
+]
.PP
.B a2dissite
-[ [\-q|\-\-quiet]
-.IR site ]
+[\-q|\-\-quiet] [ \-m|\-\-maintmode ] [\-p|\-\-purge] [
+.IR site
+]
.SH DESCRIPTION
This manual page documents briefly the
.B a2ensite
@@ -56,6 +58,7 @@ Don't show informative messages.
Enables the maintainer mode, that is the program invocation is effectuated
automatically by a maintainer script. This switch should not be used by end
users.
+.TP
.B \-p, \-\-purge
When disabling a module, purge all traces of the module in the internal state
data base.
@@ -84,7 +87,11 @@ Directory with links to the files in
.B sites-available
for enabled sites.
.SH "SEE ALSO"
-.BR apache2ctl (8).
+.BR apache2ctl (8),
+.BR a2enmod (8),
+.BR a2dismod (8),
+.BR a2enconf (8),
+.BR a2disconf (8).
.SH AUTHOR
This manual page was written by Stefan Fritsch <sf@debian.org> (based on the a2enmod manual
page by Daniel Stone <daniel@sfarc.net>) for the Debian GNU/Linux distribution.
Reply to: