Re: [PATCH 2/2] docs: Fix links in html generation of man pages

[Anthony PERARD <anthony.perard@citrix.com>]

On Tue, Jan 15, 2019 at 03:57:35PM +0000, Ian Jackson wrote:
> Anthony PERARD writes ("[PATCH 2/2] docs: Fix links in html generation of man pages"):
> > Currently, all links to other man pages are sent to
> > http://man.he.net/man$mansection/$manpage, but that site doesn't have
> > Xen man pages, so all links to other Xen man pages are broken.
> > 
> > In order to fix that, this is going to be a bit complex.
> 
> Cor.  Thanks for digging.  Your approach seems no worse than is to be
> expected under the circumstances.  (So, well done.)
> 
> Do you have an example of the resulting output ?  You could put it on
> xenbits and then it would be easy to diff it.

Maybe: https://xenbits.xenproject.org/people/aperard/2019/man/

But here is a sample (the only not working link will be in
xl-disk-configuration, all other links works like shown in the diff of
xl.cfg):

--- html/man/xl-disk-configuration.5.html	2019-01-15 16:04:18.913012326 +0000
+++ html-man-v1/xl-disk-configuration.5.html	2019-01-15 16:01:35.922122233 +0000
@@ -150,7 +150,7 @@
 <dt id="Description2">Description</dt>
 <dd>
 
-<p>Virtual device as seen by the guest (also referred to as guest drive designation in some specifications). <a href="http://man.he.net/man7/xen-vbd-interface">xen-vbd-interface(7)</a></p>
+<p>Virtual device as seen by the guest (also referred to as guest drive designation in some specifications). <a>xen-vbd-interface(7)</a></p>
 
 </dd>
 <dt id="Supported-values2">Supported values</dt>

--- html/man/xl.cfg.5.html	2019-01-15 16:04:19.146342181 +0000
+++ html-man-v1/xl.cfg.5.html	2019-01-15 16:01:36.222117709 +0000
@@ -274,7 +274,7 @@
 
 <p>If this option is not specified (and <b>cpus=</b> is not specified either), libxl automatically tries to place the guest on the least possible number of nodes. A heuristic approach is used for choosing the best node (or set of nodes), with the goal of maximizing performance for the guest and, at the same time, achieving efficient utilization of host CPUs and memory. In that case, the soft affinity of all the vCPUs of the domain will be set to host CPUs belonging to NUMA nodes chosen during placement.</p>
 
-<p>For more details, see <a href="http://man.he.net/man7/xl-numa-placement">xl-numa-placement(7)</a>.</p>
+<p>For more details, see <a href="./xl-numa-placement.7.html">xl-numa-placement(7)</a>.</p>
 
 </dd>
 </dl>
@@ -2651,27 +2651,27 @@
 
 <dl>
 
-<dt id="xl-1"><a href="http://man.he.net/man1/xl">xl(1)</a></dt>
+<dt id="xl-1"><a href="./xl.1.html">xl(1)</a></dt>
 <dd>
 
 </dd>
-<dt id="xl.conf-5"><a href="http://man.he.net/man5/xl.conf">xl.conf(5)</a></dt>
+<dt id="xl.conf-5"><a href="./xl.conf.5.html">xl.conf(5)</a></dt>
 <dd>
 
 </dd>
-<dt id="xlcpupool.cfg-5"><a href="http://man.he.net/man5/xlcpupool.cfg">xlcpupool.cfg(5)</a></dt>
+<dt id="xlcpupool.cfg-5"><a href="./xlcpupool.cfg.5.html">xlcpupool.cfg(5)</a></dt>
 <dd>
 
 </dd>
-<dt id="xl-disk-configuration-5"><a href="http://man.he.net/man5/xl-disk-configuration">xl-disk-configuration(5)</a></dt>
+<dt id="xl-disk-configuration-5"><a href="./xl-disk-configuration.5.html">xl-disk-configuration(5)</a></dt>
 <dd>
 
 </dd>
-<dt id="xl-network-configuration-5"><a href="http://man.he.net/man5/xl-network-configuration">xl-network-configuration(5)</a></dt>
+<dt id="xl-network-configuration-5"><a href="./xl-network-configuration.5.html">xl-network-configuration(5)</a></dt>
 <dd>
 
 </dd>
-<dt id="xen-tscmode-7"><a href="http://man.he.net/man7/xen-tscmode">xen-tscmode(7)</a></dt>
+<dt id="xen-tscmode-7"><a href="./xen-tscmode.7.html">xen-tscmode(7)</a></dt>
 <dd>
 
 </dd>


-- 
Anthony PERARD

_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xenproject.org
https://lists.xenproject.org/mailman/listinfo/xen-devel