=over 4
-=item How do I keep my $VERSION up to date without resetting it manually?
+=item
+
+How do I keep my $VERSION up to date without resetting it manually?
Often you want to manually set the $VERSION in the main module
distribution because this is the version that everybody sees on CPAN
# must be all on one line or MakeMaker will get confused.
$VERSION = do { my @r = (q$Revision$ =~ /\d+/g); sprintf "%d."."%03d" x $#r, @r };
-=item What's this F<META.yml> thing and how did it get in my F<MANIFEST>?!
+=item
+
+What's this F<META.yml> thing and how did it get in my F<MANIFEST>?!
F<META.yml> is a module meta-data file pioneered by Module::Build and
automatically generated as part of the 'distdir' target (and thus
=over 4
-=item How to I prevent "object version X.XX does not match bootstrap parameter Y.YY" errors?
+=item
+
+How to I prevent "object version X.XX does not match bootstrap parameter Y.YY"
+errors?
XS code is very sensitive to the module version number and will
complain if the version number in your Perl module doesn't match. If
depend => { '$(FIRST_MAKEFILE)' => '$(VERSION_FROM)' }
-=item How do I make two or more XS files coexist in the same directory?
+=item
+
+How do I make two or more XS files coexist in the same directory?
Sometimes you need to have two and more XS files in the same package.
One way to go is to put them into separate directories, but sometimes
=over 4
-=item chmod, chmod, chown, chroot, exec, link, mkdir, rename, rmdir, stat, symlink, truncate, unlink, utime
+=item *
+
+chmod, chmod, chown, chroot, exec, link, mkdir
+rename, rmdir stat, symlink, truncate, unlink, utime
+
+=item *
+
+%ENV
+
+=item *
+
+glob (aka the <*>)
+
+=item *
-=item %ENV
+open, opendir, sysopen
-=item glob (aka the <*>)
+=item *
-=item open, opendir, sysopen
+qx (aka the backtick operator), system
-=item qx (aka the backtick operator), system
+=item *
-=item readdir, readlink
+readdir, readlink
=back