On 08.12.2013 23:57, Dan Kenigsberg wrote: > Note to reviewers: this patch is too naive and has devastating effect of > headers that lack a named anchor element. Still, I'd love to hear your > opinion about the idea. > > On Sun, Dec 08, 2013 at 02:05:46PM +0000, Dan Kenigsberg wrote: >> Quite often, I need to cite URLs like >> http://libvirt.org/formatnetwork.html#elementQoS >> but it is annoying to copy them from the table of contents or the html >> source. >> >> This patch borrows from the Python documentation in order to make it >> easier to cite headers on libvirt's oneline documentation. >> --- >> docs/libvirt.css | 13 +++++++++++++ >> docs/page.xsl | 7 +++++++ >> 2 files changed, 20 insertions(+) I like the idea - I often find myself in the same situation, but if we decide to merge this, we need to fix some issues: Validating internals/command.html ./html/libvirt-libvirt.html:6: element a: validity error : No declaration for attribute xmlns:html of element a ne">blah</a></h2><h3><a xmlns:html="http://www.w3.org/1999/xhtml"; href="#macros" ^ (line repeats over and over) Moreover, going with '¶' turns out to be not cool: Generating logging.html.tmp ../docs/page.xsl:192: parser error : Input is not proper UTF-8, indicate encoding ! Bytes: 0xB6 0x3C 0x2F 0x61 <a class="headerlink" href="#{html:a/@name}" title="Permalink to this headline"> Michal -- libvir-list mailing list libvir-list@xxxxxxxxxx https://www.redhat.com/mailman/listinfo/libvir-list