Richard W.M. Jones
53bffd9d0f
EPEL 5: podwrapper: Don't use Pod::Man.
...
This unfortunately means the man pages are generated as plain text.
However that's necessary as Pod::Man does not have an output_string
method.
2013-10-17 22:45:13 +01:00
Richard W.M. Jones
42da2432bf
EPEL 5: podwrapper: Remove HTML output.
...
It requires perl Pod::Simple::XHTML which did not exist in
RHEL 5 era.
2013-10-17 22:45:13 +01:00
Richard W.M. Jones
4df69b604d
podwrapper: guestunmount is a libguestfs page, don't link it to he.net.
...
Cherry picked from commit bd30d3a61c
and commit 0087cf2531 .
Note that libguestfs 1.20 does not use guestunmount.
2013-08-24 11:40:58 +01:00
Richard W.M. Jones
6b0c91a5a6
podwrapper: Set Text::Wrap::huge property to "overflow".
...
This stops long URLs from being broken in the text output mode.
See:
https://www.redhat.com/archives/libguestfs/2013-May/thread.html#00088
(cherry picked from commit aab882a3a6 )
(cherry picked from commit 8296c56c34 )
2013-06-03 14:27:44 +01:00
Richard W.M. Jones
115f1c5be4
pod: Fix "wide character in print" warnings by declaring encoding correctly.
...
(cherry picked from commit a3de6eddd4 )
2013-04-11 15:26:13 +01:00
Richard W.M. Jones
f001144c2d
Use 'supermin' and 'supermin-helper' in preference to febootstrap.
...
Febootstrap has been renamed upstream to 'supermin':
https://www.redhat.com/archives/libguestfs/2013-February/msg00004.html
This commit changes libguestfs so it can use either program to build
the supermin appliance.
(cherry picked from commit a0a4ee5245 )
2013-02-14 16:18:12 +00:00
Richard W.M. Jones
a8fa61b745
podwrapper: Refresh podwrapper man page.
...
This also adds a rule so you can do:
make podwrapper.1
if you want to read the documentation as a man page.
(cherry picked from commit ce828c6afc )
2013-02-14 15:03:53 +00:00
Richard W.M. Jones
4a4ca0c01d
syntax: Use __PATTERNS__ instead of @PATTERNS@ in podwrapper man pages.
...
It is slightly dangerous to use @PATTERNS@, since these might
be substituted by autoconf when they appear in Makefile.am files.
2012-10-03 09:22:45 +01:00
Richard W.M. Jones
ddc67d94f3
po-docs: Fix podwrapper so it works on translated POD files.
...
These don't contain literal strings like "AUTHORS" (they have the
translated versions instead) and so checking for these English strings
is rather useless.
Also we don't usually have the '--license' parameter conveniently
around so don't enforce this section.
2012-08-28 13:18:47 +01:00
Richard W.M. Jones
23b7fe09e1
tools: Fix podwrapper errors in tools directory.
...
This also makes the test for license "code" less strict, so it should
only match POD, not Perl comments.
This fixes commit 2f97bf873b .
2012-08-28 13:18:40 +01:00
Richard W.M. Jones
d555a68ca6
podwrapper: Ignore $parser->html_charset if it fails (thanks Wulf C. Krueger).
...
This method was added in Pod::Simple 3.16 so earlier versions of Perl
won't have it. It's not the end of the world if we don't set it.
2012-08-28 04:46:04 -04:00
Richard W.M. Jones
c638e1f03d
docs: Use man page name as default title in HTML output.
2012-08-21 22:02:21 +01:00
Richard W.M. Jones
2f97bf873b
podwrapper: Add --license parameter, which is required.
...
This adds standard LICENSE and BUGS sections to all of the man pages
that are processed by podwrapper.
Modify all the calls to $(PODWRAPPER) to add the right --license
parameter according to the content. Note that this relaxes the
license on some code example pages, making them effectively BSD-style
licensed.
2012-08-21 20:33:21 +01:00
Richard W.M. Jones
e89e180d2b
podwrapper: Ensure the input file is printed in some error messages.
2012-08-21 20:11:15 +01:00
Richard W.M. Jones
f514d462cd
podwrapper: Fix setting of GIT_DIR in git subcommand.
...
This fixes commit 1e17a32060 .
2012-07-19 16:10:48 +01:00
Richard W.M. Jones
8e75e21b23
podwrapper: Use UTF8 in output, send errors to stderr.
...
This fixes commit 1e17a32060 .
2012-07-17 20:04:24 +01:00
Richard W.M. Jones
182b4a6660
podwrapper: Subclass Pod::Man so we can fix the way links are generated.
2012-07-17 13:18:34 +01:00
Richard W.M. Jones
9967ad3fa1
podwrapper: Define $VERSION in subclass.
...
The superclass sometimes uses this and will give an undefined
error if it's missing.
2012-07-17 13:18:34 +01:00
Richard W.M. Jones
60c42dd2a1
podwrapper: Tidy up the program name.
...
Messages now look like this:
podwrapper.pl: wrote guestfs-examples.3
podwrapper.pl: wrote ../html/guestfs-examples.3.html
2012-07-17 13:18:34 +01:00
Richard W.M. Jones
1e17a32060
Replace podwrapper shell script with custom Perl script.
...
This uses Pod::Simple so it properly parses the input POD and can
generate proper custom output as required specifically by libguestfs.
One immediate benefit is that links between and within manual pages
now work mostly correctly.
2012-07-16 22:53:01 +01:00