Implemented workarounds for Pod::Html bugs.
[macros.git] / AutoGen.pm
index 0a533f6..4fd02a9 100644 (file)
@@ -646,20 +646,12 @@ B<automake>(1) and similiar tools. This project has some additional features:
 
 =over
 
 
 =over
 
-=item
-
 Clean the checkout directory without B<Makefile>s for 'make clean'.
 
 Clean the checkout directory without B<Makefile>s for 'make clean'.
 
-=item
-
 Maintain B<.cvsignore> files containing the files being cleaned.
 
 Maintain B<.cvsignore> files containing the files being cleaned.
 
-=item
-
 Single-command package building of B<.rpm>/B<.deb> out of CVS checkout.
 
 Single-command package building of B<.rpm>/B<.deb> out of CVS checkout.
 
-=item
-
 Supports: B<gettext>, B<glib-gettext>, B<libtool>, B<autoconf>, B<automake>.
 
 =back
 Supports: B<gettext>, B<glib-gettext>, B<libtool>, B<autoconf>, B<automake>.
 
 =back
@@ -757,9 +749,7 @@ B<DISTCLEANFILES> or B<MAINTAINERCLEANFILES> variables of B<Makefile.am>s.
 
 There are several formats of B<clean> field possible entries:
 
 
 There are several formats of B<clean> field possible entries:
 
-=over
-
-=item B<./path/to/file.c>
+=item B<clean> entry: B<./path/to/file.c>
 
 Full project-basedir relative path to the deleted file. Rule applies only to
 the one specified directory. Although B<path/to/file.c> would be also possible
 
 Full project-basedir relative path to the deleted file. Rule applies only to
 the one specified directory. Although B<path/to/file.c> would be also possible
@@ -767,18 +757,16 @@ it is not recommended to have unified format with B<./only_basedir.c> entries
 to delete file just in the root directory (as B<only_basedir.c> would delete
 it in ALL subdirectories incl. the root one).
 
 to delete file just in the root directory (as B<only_basedir.c> would delete
 it in ALL subdirectories incl. the root one).
 
-=item B<basename.c>
+=item B<clean> entry: B<basename.c>
 
 Delete B<basename_generated.c> found in any subdirectory of the project.
 It has the same effect as B<./*/basename_generated.c> entry.
 
 
 Delete B<basename_generated.c> found in any subdirectory of the project.
 It has the same effect as B<./*/basename_generated.c> entry.
 
-=item B<./subdir/*/name.c>
+=item B<clean> entry: B<./subdir/*/name.c>
 
 Delete B<name.c> in B<./subdir> and all of its subdirector descendants.
 Entry B<subdir/*/name.c> would have the same effect.
 
 
 Delete B<name.c> in B<./subdir> and all of its subdirector descendants.
 Entry B<subdir/*/name.c> would have the same effect.
 
-=back
-
 
 =item B<prep>
 
 
 =item B<prep>
 
@@ -825,7 +813,7 @@ This section applies to projects where you patch foreign existing packages.
 
 =over
 
 
 =over
 
-=item
+=item Prolog
 
 Use the following alternate B<autogen.pl> prolog if your branch does not belong
 to the B<MAIN> CVS branch:
 
 Use the following alternate B<autogen.pl> prolog if your branch does not belong
 to the B<MAIN> CVS branch:
@@ -838,12 +826,12 @@ to the B<MAIN> CVS branch:
  use lib "./macros/";
  use AutoGen;
 
  use lib "./macros/";
  use AutoGen;
 
-=item
+=item Original archive
 
 Put B<fooproject-1.2.3.tar.gz> archive to the project root directory
 as B<orig-fooproject-1.2.3.tar.gz>.
 
 
 Put B<fooproject-1.2.3.tar.gz> archive to the project root directory
 as B<orig-fooproject-1.2.3.tar.gz>.
 
-=item
+=item Versioning
 
 Set B<$VERSION> in B<configure.ac> file with you vendor prefix such as
 B<1.2.3joe1>. Set B<$VERSION_BASE> to B<1.2.3> and B<$VERSION_EXT> to B<joe1>.
 
 Set B<$VERSION> in B<configure.ac> file with you vendor prefix such as
 B<1.2.3joe1>. Set B<$VERSION_BASE> to B<1.2.3> and B<$VERSION_EXT> to B<joe1>.
@@ -851,55 +839,31 @@ B<AC_SUBST>() them both.
 
 =item B<.spec> file changes
 
 
 =item B<.spec> file changes
 
-=over
-
-=item
-
 Change B<Version: @VERSION@> to B<Version: @VERSION_BASE@>.
 
 Change B<Version: @VERSION@> to B<Version: @VERSION_BASE@>.
 
-=item
-
 Change (expected) line B<Release: 1> to B<Release: 1@VERSION_EXT@>.
 
 Change (expected) line B<Release: 1> to B<Release: 1@VERSION_EXT@>.
 
-=item
-
 Change B<Source: ...@VERSION@.tar.gz> to B<Source: ...@VERSION_BASE@.tar.gz>.
 
 Change B<Source: ...@VERSION@.tar.gz> to B<Source: ...@VERSION_BASE@.tar.gz>.
 
-=item
-
 Add line B<Patch1: @PACKAGE@-@VERSION_BASE@-@VERSION_EXT@.patch>.
 This patch file name is not mandatory.
 
 Add line B<Patch1: @PACKAGE@-@VERSION_BASE@-@VERSION_EXT@.patch>.
 This patch file name is not mandatory.
 
-=item
-
 Remember to call B<autotools> commands manually in the B<%build>
 section if their source files were modified in your vendor branch.
 
 Remember to call B<autotools> commands manually in the B<%build>
 section if their source files were modified in your vendor branch.
 
-=back
-
 =item B<debian>-specific changes
 
 =item B<debian>-specific changes
 
-=over
-
-=item
-
 Include both B<debian/changelog.in> and B<debian/changelog> to B<Makefile.am>.
 
 Include both B<debian/changelog.in> and B<debian/changelog> to B<Makefile.am>.
 
-=item
-
 Include B<debian/changelog> to B<clean> field in B<autogen.pl>.
 
 Include B<debian/changelog> to B<clean> field in B<autogen.pl>.
 
-=item
-
 Use B<@VERSION@> in B<debian/changelog.in>. Package will be built as
 Debian-native package (no I<.diff> file) as the patches are not just for Debian
 packages, it is a new package (read: dpkg does not support branch patches).
 
 =back
 
 Use B<@VERSION@> in B<debian/changelog.in>. Package will be built as
 Debian-native package (no I<.diff> file) as the patches are not just for Debian
 packages, it is a new package (read: dpkg does not support branch patches).
 
 =back
 
-=back
-
 =head1 AUTHOR
 
 Jan Kratochvil <B<project-macros@jankratochvil.net>>,
 =head1 AUTHOR
 
 Jan Kratochvil <B<project-macros@jankratochvil.net>>,
-               I<http://www.jankratochvil.net/>
+I<http://www.jankratochvil.net/>