linux-kernel - Re: [PATCH v3 1/2] Documentation: kernel-doc: Promote two chapter headings to page title

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <b92e00a1-04e4-c1e2-42a8-16d87d3d0183@gmail.com>
Date:   Mon, 28 Mar 2022 19:28:51 +0700
From:   Bagas Sanjaya <bagasdotme@...il.com>
To:     Akira Yokosawa <akiyks@...il.com>
Cc:     Jonathan Corbet <corbet@....net>,
        "David S. Miller" <davem@...emloft.net>,
        Greg Kroah-Hartman <gregkh@...uxfoundation.org>,
        Tony Nguyen <anthony.l.nguyen@...el.com>,
        Vinod Koul <vkoul@...nel.org>,
        Daniel Borkmann <daniel@...earbox.net>,
        Mauro Carvalho Chehab <mchehab+huawei@...nel.org>,
        "Rafael J. Wysocki" <rafael.j.wysocki@...el.com>,
        Jens Axboe <axboe@...nel.dk>, linux-kernel@...r.kernel.org,
        linux-doc@...r.kernel.org
Subject: Re: [PATCH v3 1/2] Documentation: kernel-doc: Promote two chapter
 headings to page title

On 28/03/22 14.46, Akira Yokosawa wrote:
> On Mon, 28 Mar 2022 13:50:30 +0700,
> Bagas Sanjaya wrote:
>> Promote two chapter headings, named "Writing kernel-doc comments" and
>> "Including kernel-doc comments" to page title. These titles deserve
>> their own chapters in PDF output, although these will also appear as two
>> separate titles in table of contents in HTML output.
> 
> As Mauro and I have pointed out, this change won't have any effect
> in the resulting HTML and PDF docs.  No difference *at all*.
> 
> Why do you think this change is worthwhile.
> 
> Please convince us!
> 

My intention is to give page title for kernel-doc.rst, according to
documentation guideline at [1].

>>
>> Cc: Jonathan Corbet <corbet@....net>
>> Cc: "David S. Miller" <davem@...emloft.net>
>> Cc: Greg Kroah-Hartman <gregkh@...uxfoundation.org>
>> Cc: Tony Nguyen <anthony.l.nguyen@...el.com>
>> Cc: Vinod Koul <vkoul@...nel.org>
>> Cc: Daniel Borkmann <daniel@...earbox.net>
>> Cc: Mauro Carvalho Chehab <mchehab+huawei@...nel.org>
>> Cc: Akira Yokosawa <akiyks@...il.com>
>> Cc: "Rafael J. Wysocki" <rafael.j.wysocki@...el.com>
>> Cc: Jens Axboe <axboe@...nel.dk>
>> Cc: linux-kernel@...r.kernel.org
>> Suggested-by: Akira Yokosawa <akiyks@...il.com>
> 
> Please don't put this Suggested-by: at the moment.
> 
>          Thanks, Akira
> 

OK, will drop the trailer.

-- 
An old man doll... just what I always wanted! - Clara