This series provides code to generate a feature support matrix, to
replace the one on the wiki.  You can see an example of the output
here:
  https://xenbits.xen.org/people/iwj/2018/support-matrix-example-v3a/t.html
  https://xenbits.xen.org/people/iwj/2018/support-matrix-example-v3b/t.html
There is also an accompanying SUPPORT.html to make the links for 4.11
work.  (The links into the 4.10 SUPPORT.html do not work in this
example, but they should do when this makes it into stable-4.10.)

This is similar to v2, except that I have fixed the bug identified by
Lars where the [*] annotation would be added onto the last applicable
table row.

Fixing this produced some infelicitous output, which patch 10 fixes.
Patch 11 is optional.  I prefer it, but others may prefer without.
Of the links above, v3a is without patch 11, and v3b is with it.

  ar 01/11] SUPPORT.md: Syntax: Fix some bullet lists
  ar 02/11] SUPPORT.md: Syntax: Fix a typo "States"
   r 03/11] SUPPORT.md: Syntax: Provide a title rather than a
   r 04/11] docs/gen-html-index: Extract titles from HTML documents
   r 05/11] docs/gen-html-index: Support documents at the toplevel
   r 06/11] docs/Makefile: Introduce GENERATE_PANDOC_RULE_RAW
   r 07/11] docs/Makefile: Format SUPPORT.md into the toplevel
 * r 08/11] docs: Provide parse-support-md
 * r 09/11] docs: Provide support-matrix-generate, to generate a
 +   10/11] docs/parse-support-md: Unify identical [*] in footnotes
 +   11/11] docs/parse-support-md: Identical [*]: only use extra

 a = acked (by a tools or REST maintainer)
 r = release-acked for 4.11
 * = amended patch
 + = new patch

As before, I think if the output is tolerably accurate, it would be
valuable to get this set up as a cron job ASAP.  Stylistic and
formatting improvements etc. can be done on top.

FAOD, I think this series is blocked awaiting review from another
tools or REST maintainer.  That's not particularly surprising at this
stage of the release...

My plan is that the cron job will use the matrix generator from
xen.git#master.

For my reference, this was generated with
  docs/support-matrix-generate -D HEAD SUPPORT.html 
refs/heads/wip.support-stmt-NN 
https://xenbits.xen.org/docs/NN-testing/SUPPORT.html 2>&1 >docs/html/t.html 
|less
  rsync -LvP docs/html/{t,SUPPORT}.html 
xenbits:public_html/2018/support-matrix-example-v3b

Thanks,
Ian.

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

Reply via email to