Date: Wed, 10 May 2006 23:37:28 -0700
From: Andrew Morton <akpm@osdl.org>
To: Diego Calleja <diegocg@gmail.com>
Cc: linux-kernel@vger.kernel.org
Subject: Re: [RFC] Update/kill Documentation/sysctl/* docs?
Message-Id: <20060510233728.5c27cc43.akpm@osdl.org>
In-Reply-To: <20060509004837.d542d2d8.diegocg@gmail.com>
References: <20060509004837.d542d2d8.diegocg@gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: linux-kernel-owner@vger.kernel.org
Content-Length: 1298
Lines: 31

Diego Calleja <diegocg@gmail.com> wrote:
>
> In http://bugzilla.kernel.org/show_bug.cgi?id=6145 you asked to update
>  the sysctl docs. I've updated them and added/deleted the neccesary
>  stuff (except the ones that I don't know what on earth are they doing
>  because they're not...documented).

OK..

> However it looks like there's
>  duplication - Documentation/filesystems/proc.txt seems to document all
>  that aswell (but in a single doc, which makes it a bit unreadable 
>  for such big document, IMO)

Yes, the duplication is silly and wasteful and error-inducing.

>  What should be the best step? Kill Documentation/sysctl/ and keep 
>  filesystems/proc.txt updated and maybe split it in several files
>  to make it more readable? Update it but maintain in sync with
>  filesystems/proc.txt? delete proc.txt and keep sysctl/ updated...?

I'd have thought that keeping everything in Documentation/sysctl/*.txt and
killing proc.txt would be the best approach?

But I haven't looked into it much.  You have - what approach are you
recommending?
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/