Re: kern/32430: genfs lacking documentation

[Jukka Ruohonen <jruohonen%iki.fi@localhost>]

The following reply was made to PR kern/32430; it has been noted by GNATS.

From: Jukka Ruohonen <jruohonen%iki.fi@localhost>
To: gnats-bugs%NetBSD.org@localhost
Cc: reinoud%NetBSD.org@localhost
Subject: Re: kern/32430: genfs lacking documentation
Date: Sat, 11 Jun 2011 13:48:36 +0300

 On Sat, Jun 11, 2011 at 10:30:07AM +0000, Reinoud Zandijk wrote:
 >  I think the stub should be more seen as a genfs(0), layerfs(0), specfs(0),
 >  fifofs(0). Still a nice thing to add :) Even if its just marked as a stub.
 >  People seeing references to them at least have a way of knowing what it is 
 > all
 >  about.
 
 There is no "section zero". Since the page contains the CODE REFERENCES
 section, and references to various section 9 pages, section 9 seems right.
 Otherwise, section 7 could be appropriate.
 
 But.
 
 Clearly this is unfinished. I don't see much value with stubs like this.
 
      "The genfs subsystem implements generic filesystem operations to be
       shared across different filesystems".
 
 This comes close to "null-documentation". Note that the issue has been
 discussed previously [1].
 
 - Jukka.
 
 [1] http://mail-index.netbsd.org/current-users/2010/05/13/msg013353.html