From: Ian Jackson <ian.jackson@citrix.com>
To: Anthony PERARD <anthony.perard@citrix.com>
Cc: "xen-devel@lists.xenproject.org" <xen-devel@lists.xenproject.org>,
Wei Liu <wei.liu2@citrix.com>
Subject: Re: [PATCH 1/2] docs: Fix all links to Xen man pages in html
Date: Tue, 15 Jan 2019 19:15:11 +0000 [thread overview]
Message-ID: <23614.12607.847851.918514@mariner.uk.xensource.com> (raw)
In-Reply-To: <20190115182159.17494-1-anthony.perard@citrix.com>
Anthony PERARD writes ("[PATCH 1/2] docs: Fix all links to Xen man pages in html"):
> Second try, this time also works for all links to xen-vbd-interface(7).
>
> We don't try anymore to have pod2html generate relative links, instead
> we do it ourself.
>
> First, we modify all links to man pages to have what looks like an
> absolute URL and pod2html will just write it in the html output.
> Absolute URL in POD are in the form L<text|scheme:...> so let's just use
> a scheme that isn't real, but easy to find in the resulting html output:
> "relative:".
>
> Then we fix the output and remove all the bogus scheme "relative" and
> can end up with nice relative links.
...
> - sed -r -e 's%L<([^>]+)\(([1-9])\)>%L<\1(\2)|\1.\2>%g' $$< | \
> - (cd man; $(POD2HTML) --podpath=. --htmlroot=. --outfile=../$$@)
> + sed -r -e 's%L<([^>]+)\(([1-9])\)>%L<\1(\2)|relative:\1.\2.html>%g' $$< | \
> + $(POD2HTML) | \
> + sed -r -e 's%( href=")relative:%\1%g' > $$@
Acked-by: Ian Jackson <ian.jackson@eu.citrix.com>
Did you intend this for 4.12 ? If so you should probably CC Juergen.
Regards,
Ian.
_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xenproject.org
https://lists.xenproject.org/mailman/listinfo/xen-devel
next prev parent reply other threads:[~2019-01-15 19:15 UTC|newest]
Thread overview: 22+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-08-02 11:24 [BUG] docs: our man page generation uses http://man.he.net/ by default which causes broken links. It should be changed to point to a relative path Lars Kurth
2018-08-02 11:25 ` Lars Kurth
2019-01-11 14:15 ` Lars Kurth
2019-01-15 15:47 ` Anthony PERARD
2019-01-15 15:48 ` [PATCH 1/2] man: Fix links in xl(1) Anthony PERARD
2019-01-15 15:54 ` Ian Jackson
2019-01-15 17:13 ` Juergen Gross
2019-01-15 15:48 ` [PATCH 2/2] docs: Fix links in html generation of man pages Anthony PERARD
2019-01-15 15:57 ` Ian Jackson
2019-01-15 16:17 ` Anthony PERARD
2019-01-15 17:07 ` Ian Jackson
2019-01-15 17:14 ` Juergen Gross
2019-01-15 17:33 ` Anthony PERARD
2019-01-15 17:44 ` Ian Jackson
2019-01-15 18:21 ` [PATCH 1/2] docs: Fix all links to Xen man pages in html Anthony PERARD
2019-01-15 18:30 ` Andrew Cooper
2019-01-15 19:16 ` Ian Jackson
2019-01-16 16:07 ` Anthony PERARD
2019-01-15 19:15 ` Ian Jackson [this message]
2019-01-15 18:21 ` [PATCH 2/2] man: Highlight reference in xl-disk-configuration(5) Anthony PERARD
2019-01-15 19:14 ` Ian Jackson
2019-01-15 17:41 ` [PATCH 2/2] docs: Fix links in html generation of man pages Lars Kurth
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=23614.12607.847851.918514@mariner.uk.xensource.com \
--to=ian.jackson@citrix.com \
--cc=anthony.perard@citrix.com \
--cc=wei.liu2@citrix.com \
--cc=xen-devel@lists.xenproject.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.