Re: [Libguestfs] [PATCH] podwrapper: simplify external references pointing to self

Richard W.M. Jones
2015-06-09T13:21:13Z

On Tue, Jun 09, 2015 at 11:58:25AM +0200, Pino Toscano
wrote:
> When convering a POD documentation, possibily combining various
> sub-documents together, simplify the L<> links that explicitly point
to
> the very same documentation being generated.
>
> For example, when generating the virt-builder documentation, links like
>   L<virt-builder(1)/SECTION>
> will be turned into
> L
> thus not making Pod::Simple parse them as external reference.
>
> While it is a slightly crude hack, it seems there's no easy way to
> process the link parsing with Pod::Simple subclasses.
> ---
>  podwrapper.pl.in | 3 +++
>  1 file changed, 3 insertions(+)
>
> diff --git a/podwrapper.pl.in b/podwrapper.pl.in
> index 0bb7b28..b354db6 100755
> --- a/podwrapper.pl.in
> +++ b/podwrapper.pl.in
> @@ -278,6 +278,9 @@ foreach (@inserts) {
>          if $content eq $oldcontent;
>  }
>
> +# Turn external links to this man page into simple cross-section links.
> +$content =~ s,\QL<$name($section)/\E,L</,g;
> +
>  # Perform @verbatims.
>  foreach (@verbatims) {
>      my @a = split /:/, $_, 2;

ACK.

Rich.

--
Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
Read my programming and virtualization blog: http://rwmj.wordpress.com
virt-top is 'top' for virtual machines.  Tiny program with many
powerful monitoring features, net stats, disk stats, logging, etc.