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]
Date:   Fri, 12 Apr 2019 18:45:42 +0200
From:   Markus Heiser <>
To:     Jonathan Corbet <>
Cc:     David Howells <>,
        Mauro Carvalho Chehab <>,
        Linux Doc Mailing List <>,
        Mauro Carvalho Chehab <>,,
        Andrea Parri <>,
        Nicholas Piggin <>,, Peter Zijlstra <>,
        Boqun Feng <>,
        Luc Maranget <>,
        Alan Stern <>,
        Akira Yokosawa <>,
        Will Deacon <>,
        "Paul E. McKenney" <>,
        Daniel Lustig <>,
        Jade Alglave <>
Subject: Re: [PATCH 0/8] Prepare files under Documentation/*.txt to build with

Am 12.04.19 um 17:39 schrieb Jonathan Corbet:
> On Fri, 12 Apr 2019 14:34:25 +0200
> Markus Heiser <> wrote:
>> Am 12.04.19 um 14:19 schrieb David Howells:
>>> Markus Heiser <> wrote:
>>>> Which is already named in our 'How to write kernel documentation' introduction
>>>> -
>>> This should really be in Documentation/ directory.
>> I agree with you, it is a kind of information hiding.  If you know proper
>> places, please send a patch to Jon.
> As Jani pointed out, it's in Documentation/doc-guide.
> If you're saying it should be in the top level, I kind of disagree.
> Documentation/ is an exercise in hiding information by placing it in the
> middle of 200 other, unrelated files.  We've made some progress on that,
> and I would like to continue to do so.

For those who are new and are willing to document, it migth be a good idea
to have a simple Documentation/README.txt  with a link to doc-guide?

Just a few words, I find with my editor, this is what I find often helpful
when I'am new to a project.

-- Markus --

Powered by blists - more mailing lists