diff --git a/docs/Makefile.am b/docs/Makefile.am index 49cde78e6..40c699306 100644 --- a/docs/Makefile.am +++ b/docs/Makefile.am @@ -97,22 +97,11 @@ stamp-guestfs-faq.pod: guestfs-faq.pod guestfs-hacking.1 $(top_builddir)/website/guestfs-hacking.1.html: stamp-guestfs-hacking.pod -stamp-guestfs-hacking.pod: guestfs-hacking.pod +stamp-guestfs-hacking.pod: guestfs-hacking.pod internal-documentation.pod $(PODWRAPPER) \ --section 1 \ --man guestfs-hacking.1 \ --html $(top_builddir)/website/guestfs-hacking.1.html \ - --license LGPLv2+ \ - $< - touch $@ - -guestfs-internals.1 $(top_builddir)/website/guestfs-internals.1.html: stamp-guestfs-internals.pod - -stamp-guestfs-internals.pod: guestfs-internals.pod internal-documentation.pod - $(PODWRAPPER) \ - --section 1 \ - --man guestfs-internals.1 \ - --html $(top_builddir)/website/guestfs-internals.1.html \ --insert internal-documentation.pod:__INTERNAL_DOCUMENTATION__ \ --license LGPLv2+ \ $< @@ -128,6 +117,17 @@ internal-documentation.pod: $(source_files:%=$(top_srcdir)/%) $(source_files) mv $@-t $@ +guestfs-internals.1 $(top_builddir)/website/guestfs-internals.1.html: stamp-guestfs-internals.pod + +stamp-guestfs-internals.pod: guestfs-internals.pod + $(PODWRAPPER) \ + --section 1 \ + --man guestfs-internals.1 \ + --html $(top_builddir)/website/guestfs-internals.1.html \ + --license LGPLv2+ \ + $< + touch $@ + guestfs-performance.1 $(top_builddir)/website/guestfs-performance.1.html: stamp-guestfs-performance.pod stamp-guestfs-performance.pod: guestfs-performance.pod diff --git a/docs/guestfs-hacking.pod b/docs/guestfs-hacking.pod index 798f25124..ef2495dec 100644 --- a/docs/guestfs-hacking.pod +++ b/docs/guestfs-hacking.pod @@ -861,6 +861,15 @@ Optionally do a full release of the development branch. =back +=head1 INTERNAL DOCUMENTATION + +This section documents internal functions inside libguestfs and +various utilities. It is intended for libguestfs developers only. +These functions are not publicly exported, and may change or be +removed at any time. + +__INTERNAL_DOCUMENTATION__ + =head1 SEE ALSO L, diff --git a/docs/guestfs-internals.pod b/docs/guestfs-internals.pod index bbb278d55..a554b130d 100644 --- a/docs/guestfs-internals.pod +++ b/docs/guestfs-internals.pod @@ -397,15 +397,6 @@ on a platform that does support supermin using L, copy it over, and use that to run libguestfs. -=head1 INTERNAL DOCUMENTATION - -This section documents internal functions inside libguestfs and -various utilities. It is intended for libguestfs developers only. -These functions are not publicly exported, and may change or be -removed at any time. - -__INTERNAL_DOCUMENTATION__ - =head1 SEE ALSO L, diff --git a/docs/make-internal-documentation.pl b/docs/make-internal-documentation.pl index f503c13d8..571518d01 100755 --- a/docs/make-internal-documentation.pl +++ b/docs/make-internal-documentation.pl @@ -33,7 +33,7 @@ make-internal-documentation.pl - Generate internal documentation from C files =head1 DESCRIPTION C is a script that generates -L. +L. You must specify the name of the output file using the I<-o> or I<--output> option, and a list of the C source files in the project. @@ -233,7 +233,7 @@ exit 0; =head1 SEE ALSO L, -L. +L. =head1 AUTHOR