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@xxxxxxx>
Cc: "David S. Miller" <davem@xxxxxxxxxxxxx>
Cc: Greg Kroah-Hartman <gregkh@xxxxxxxxxxxxxxxxxxx>
Cc: Tony Nguyen <anthony.l.nguyen@xxxxxxxxx>
Cc: Vinod Koul <vkoul@xxxxxxxxxx>
Cc: Daniel Borkmann <daniel@xxxxxxxxxxxxx>
Cc: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
Cc: Akira Yokosawa <akiyks@xxxxxxxxx>
Cc: "Rafael J. Wysocki" <rafael.j.wysocki@xxxxxxxxx>
Cc: Jens Axboe <axboe@xxxxxxxxx>
Cc: linux-kernel@xxxxxxxxxxxxxxx
Suggested-by: Akira Yokosawa <akiyks@xxxxxxxxx>
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
