[-dev] Add sympa_wizard(1) manpage.

Now manpages will be generated from Perl sources without intermediate *.pod.


git-svn-id: https://subversion.renater.fr/sympa/branches/sympa-6.2-branch@9007 05aa8bb8-cd2b-0410-b1d7-8918dfa770ce

doc/Makefile.am

@@ -19,9 +19,40 @@
 # along with this program; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 
-SUBDIRS = man8 sample
+SUBDIRS = sample
 
 ## pdf_DATA requires autoconf 2.60; not available yet
 #pdf_DATA = sympa.pdf
 
 EXTRA_DIST = $(pdf_DATA)
+
+man1_MANS = sympa_wizard.1
+man8_MANS = archived.8 bounced.8 alias_manager.8 bulk.8 spooler.8 sympa.8 
+
+CLEANFILES = $(man1_MANS) $(man8_MANS)
+
+.pl.1:
+.pl.8:
+
+sympa_wizard.1: Makefile
+	rm -f $@
+	$(AM_V_GEN)$(POD2MAN) --section=1 --center="sympa $(VERSION)" \
+		--lax --release="$(VERSION)" $(srcdir)/../src/$*.pl $@
+
+archived.8 bounced.8: Makefile
+	rm -f $@
+	$(AM_V_GEN)$(POD2MAN) --section=8 --center="sympa $(VERSION)" \
+		--lax --release="$(VERSION)" $(srcdir)/../wwsympa/$*.pl $@
+
+alias_manager.8 bulk.8 spooler.8 sympa.8: Makefile
+	rm -f $@
+	$(AM_V_GEN)$(POD2MAN) --section=8 --center="sympa $(VERSION)" \
+		--lax --release="$(VERSION)" $(srcdir)/../src/$*.pl $@
+
+sympa_wizard.1: $(srcdir)/../src/sympa_wizard.pl
+archived.8: $(srcdir)/../wwsympa/archived.pl
+bounced.8: $(srcdir)/../wwsympa/bounced.pl
+alias_manager.8: $(srcdir)/../src/alias_manager.pl
+bulk.8: $(srcdir)/../src/bulk.pl
+spooler.8: $(srcdir)/../src/spooler.pl
+sympa.8: $(srcdir)/../src/sympa.pl

src/bulk.pl.in

@@ -25,7 +25,7 @@
 ##         :  d		-> debug -d is equiv to -dF
 ## Now, it is impossible to use -dF but you have to write it -d -F
 
-=pod 
+=encoding utf-8
 
 =head1 NAME 
 
@@ -37,6 +37,8 @@ This script must be run along with Sympa. It regularly checks the bulkmailer_tab
 
 =head1 OPTIONS
 
+=over 4
+
 =item B<-d>, B<--debug>
 
 Sets the debug mode
@@ -53,6 +55,8 @@ Set log level.
 
 Logs every sendmail calls.
 
+=back
+
 =cut 
 
 use lib '--modulesdir--';

src/sympa.pl.in

@@ -289,11 +289,13 @@ See L<http://www.sympa.org/tracking>.
 
 =head1 SEE ALSO
 
-L<sympa.conf(5)>.
+L<sympa.conf(5)>, L<sympa_wizard(1)>.
 
 L<archived(8)>, L<bulk(8)>, L<bounced(8)>, L<spooler(8)>, L<task_manager(8)>.
 
-L<sendmail(8)>, L<alias_manager(8)>
+L<sendmail(8)>, L<alias_manager(8)>.
+
+L<wwsympa(8)>, L<sympa_soap_server(8)>.
 
 =cut
 

src/sympa_wizard.pl.in

@@ -25,23 +25,31 @@ sympa_wizard, sympa_wizard.pl - help performing Sympa initial setup
     
 =head1 SYNOPSIS
 
-=over
+S<B<sympa_wizard.pl>>
+    S<[B<--check>]>
+    S<[B<--create> [B<--target=>I<file>]]>
+    S<[B<-h, --help>]>
+    S<[B<-v, --version>]>
+
+=head1 OPTIONS
+
+=over 4
 
 =item sympa_wizard.pl
 
-Edit current Sympa configuration
+Edit current Sympa configuration.
 
 =item sympa_wizard.pl --check
 
-Check CPAN modules needed for running Sympa
+Check CPAN modules needed for running Sympa.
 
-=item sympa_wizard.pl [--target file] --create
+=item sympa_wizard.pl --create [--target file]
 
-Creates a new sympa.conf configuration file
+Creates a new F<sympa.conf> configuration file.
 
 =item sympa_wizard.pl --help
 
-Display usage instructions
+Display usage instructions.
 
 =item sympa_wizard.pl --version
 
@@ -51,7 +59,7 @@ Print version number.
 
 =head1 AUTHORS
 
-=over
+=over 4
 
 =item Serge Aumont <sa@cru.fr>
 
@@ -91,8 +99,8 @@ GetOptions(
     'target=s',
     'create:s', # parameter is optional
     'check',
-    'help',
-    'version'
+    'help|h',
+    'version|v'
 );
 
 if ($options{help}) {