Re: CVS commit: src/sys/fs/tmpfs

["Julio M. Merino Vidal" <jmmv84%gmail.com@localhost>]

On 9/13/05, YAMAMOTO Takashi <yamt%mwd.biglobe.ne.jp@localhost> wrote:
> > Sure, but there will be times where people want to make changes and
> > fixes to that code itself.
> 
> in that case, what's a problem with just reading the code?
> while i haven't noticed the tmpfs(9) manpage until pointed out,
> i had no problem to understand the code.
>
> IMHO having this kind of redundant documentation
> merely increases maintenance cost.
> if you are volunteering to maintain it, it might be fine.
> but i don't want to maintain it.

After reading all the comments posted so far and thinking about it,
I tend to agree that tmpfs(9), in its current form, could be perfectly
merged into the code as comments correctly placed.  This will
certainly simplify maintenance and avoid some information that
currently is in the manual page but which is mostly useless.  (E.g.,
the manual page is mostly a description of internal structures and
functions :-/)

Sincerely, I wrote that document because it was part of my SoC
project proposal.

-- 
Julio M. Merino Vidal <jmmv84%gmail.com@localhost>
http://www.livejournal.com/users/jmmv/
The NetBSD Project - http://www.NetBSD.org/