From nobody Tue May 7 12:42:35 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; envelope-from=libvir-list-bounces@redhat.com; helo=mx1.redhat.com; Authentication-Results: mx.zohomail.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1566980335; cv=none; d=zoho.com; s=zohoarc; b=RE15nUb/LAeOjC+v6yVGpTxx7ylBA1yX3Z1EV/t9G5xBSueX8D9Hne0BD2iNTTsIIehkHQj49I7DHjABZg2NDxMs54lpaZgtqtZEIj/P9yJeG50fAzv7SlDAjmErRsT6+rfJTQzw316Wj8d1M88d/JzHH0Lmu4AQxkL6fdFgm8s= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com; s=zohoarc; t=1566980335; h=Content-Type:Content-Transfer-Encoding:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To:ARC-Authentication-Results; bh=+TfKN64G8c0kDBPXBQdSi7sUBCcKUIiS07NhCgwQK4Q=; b=m1vMPFnNkDkDPLNPcCT30QG9+ujf5eqNTsdYPM2lsR0UJv89SzwAU0Rdn24rWsgyZt+AcPL8AyHaLNU0IsFEGpFgO13nUXz4yjjUJIN2pwjFmqZyWw+LOluk4W4VOCEkGRcS5yc9p0bYowXgyGeW7nrCLVFV04eGv1zTx5rkTCU= ARC-Authentication-Results: i=1; mx.zoho.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.zohomail.com with SMTPS id 1566980335376232.2216373705719; Wed, 28 Aug 2019 01:18:55 -0700 (PDT) Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id D9130356DC; Wed, 28 Aug 2019 08:18:53 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 5832B5C1D6; Wed, 28 Aug 2019 08:18:53 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 44F78180BA9A; Wed, 28 Aug 2019 08:18:52 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id x7S8Io7T024575 for ; Wed, 28 Aug 2019 04:18:50 -0400 Received: by smtp.corp.redhat.com (Postfix) id 4AA215DC18; Wed, 28 Aug 2019 08:18:50 +0000 (UTC) Received: from moe.brq.redhat.com (unknown [10.43.2.30]) by smtp.corp.redhat.com (Postfix) with ESMTP id C48865D9E1 for ; Wed, 28 Aug 2019 08:18:47 +0000 (UTC) From: Michal Privoznik To: libvir-list@redhat.com Date: Wed, 28 Aug 2019 10:18:45 +0200 Message-Id: <800ee22ea2087fcabb580ffed1e236e78c3103a0.1566980278.git.mprivozn@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 X-loop: libvir-list@redhat.com Subject: [libvirt] [PATCH] docs: Make anchors follow HTML5 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.30]); Wed, 28 Aug 2019 08:18:54 +0000 (UTC) Content-Type: text/plain; charset="utf-8" According to HTML specification, works in HTML4, but works in both HTML4 and HTML5. This is followed even in docs/page.xsl where HTML bookmark links are generated only for those anchors which have @id attribute. Signed-off-by: Michal Privoznik --- For instance, ToC at the following page doesn't work: https://libvirt.org/hvsupport.html But after this patch the links are generated properly. docs/api_extension.html.in | 12 ++++++------ docs/dbus.html.in | 6 +++--- docs/devhelp/html.xsl | 16 ++++++++-------- docs/genaclperms.pl | 4 ++-- docs/hvsupport.pl | 2 +- docs/newapi.xsl | 6 +++--- 6 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/api_extension.html.in b/docs/api_extension.html.in index 604c397c84..79e7913c1a 100644 --- a/docs/api_extension.html.in +++ b/docs/api_extension.html.in @@ -89,7 +89,7 @@ separately.

=20 -

Defining the public API

+

Defining the public API

=20

The first task is to define the public API. If the new API involves an XML extension, you have to enhance the RelaxNG @@ -119,7 +119,7 @@ rework it as you go through the process of implementing it.

=20 -

Defining the internal API

+

Defining the internal API

=20

Each public API call is associated with a driver, such as a host @@ -146,7 +146,7 @@ provide a NULL stub for the new function.

=20 -

Implementing the public API

+

Implementing the public API

=20

Implementing the public API is largely a formality in which we wire = up @@ -179,7 +179,7 @@ =20

src/libvirt-$MODULE.c

=20 -

Implementing the remote protocol

+

Implementing the remote protocol

=20

Implementing the remote protocol is essentially a @@ -187,7 +187,7 @@ understood by referring to the existing code.

=20 -

Defining the wire protocol format

+

Defining the wire protocol format

=20

Defining the wire protocol involves making additions to: @@ -226,7 +226,7 @@ src/remote/remote_protocol.h

=20 -

Implement the RPC client

+

Implement the RPC client

=20

Implementing the RPC client uses the rpcgen generated .h files. diff --git a/docs/dbus.html.in b/docs/dbus.html.in index 6ff71d2770..4dfe4ca427 100644 --- a/docs/dbus.html.in +++ b/docs/dbus.html.in @@ -6,14 +6,14 @@ =20

    =20 -

    Description

    +

    Description

    =20

    libvirt-dbus wraps libvirt API to provide a high-level object-orient= ed API better suited for dbus-based applications.

    =20 -

    GIT source repository

    +

    GIT source repository

    The D-Bus bindings source code is maintained in a git repository available on @@ -32,7 +32,7 @@ git clone https://libvirt.org/git/libvirt-dbus.git https://libvirt.= org/git/?p=3Dlibvirt-dbus.git =20 -

    Usage

    +

    Usage

    =20

    libvirt-dbus exports libvirt API using D-Bus objects with methods and diff --git a/docs/devhelp/html.xsl b/docs/devhelp/html.xsl index 9cdc049150..587cbfc1a9 100644 --- a/docs/devhelp/html.xsl +++ b/docs/devhelp/html.xsl @@ -173,7 +173,7 @@

    -

    Structure =

    +

    Structure
          {
     
    @@ -214,7 +214,7 @@
       
         
         
    -

    Typedef +

    Typedef

         
           
    @@ -236,7 +236,7 @@
       
         
         
    -

    Variable <= /h3> +

    Variable
         
           
    @@ -258,7 +258,7 @@
       
         
         
    -

    Enum

    +

    Enum

         enum 
         
    @@ -267,7 +267,7 @@
         
           
               
    -      
    +      
           
              =3D 
     	
    @@ -295,7 +295,7 @@
       
         
         
    -

    Macro

    +

    Macro

         #define 
         
    @@ -342,7 +342,7 @@
         
         
         
    -

    ()

    +

    ()

         
           
    @@ -419,7 +419,7 @@
         
         
         
    -

    Function type

    +

    Function type

         
           
    diff --git a/docs/genaclperms.pl b/docs/genaclperms.pl
    index 34c526021c..e20b4c11c3 100755
    --- a/docs/genaclperms.pl
    +++ b/docs/genaclperms.pl
    @@ -84,7 +84,7 @@ foreach my $object (sort { $a cmp $b } keys %perms) {
         my $class =3D $class{$object};
         my $olink =3D lc "object_" . $object;
         print <$class

    +

    $class

    @@ -106,7 +106,7 @@ EOF =20 print < - + EOF diff --git a/docs/hvsupport.pl b/docs/hvsupport.pl index 4f4d86fbf1..494b8a27ec 100755 --- a/docs/hvsupport.pl +++ b/docs/hvsupport.pl @@ -364,7 +364,7 @@ when it was removed is also mentioned (highlighted in EOF =20 foreach my $grp (sort { $a cmp $b } keys %groups) { - print "

    ", $groupheaders{$grp}, "

    \n"; + print "

    ", $groupheaders{$grp}, "

    \n"; print < diff --git a/docs/newapi.xsl b/docs/newapi.xsl index 4c7b241659..ca8c703d5c 100644 --- a/docs/newapi.xsl +++ b/docs/newapi.xsl @@ -258,7 +258,7 @@ - + @@ -281,7 +281,7 @@ - + @@ -320,7 +320,7 @@ - --=20 2.21.0 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list
    $perm$perm $description
    + =3D