Re: kern/32430: genfs lacking documentation

[Julian Fagir <gnrp%komkon2.de@localhost>]

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

From: Julian Fagir <gnrp%komkon2.de@localhost>
To: gnats-bugs%NetBSD.org@localhost
Cc: 
Subject: Re: kern/32430: genfs lacking documentation
Date: Sat, 11 Jun 2011 13:21:57 +0200

 Hi,
 
 >  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].
 Ah, I didn't know that, ok.
 Yes, it is unfinished. The thought about making a stub came up when I wanted
 to know what genfs is for, but found nothing in the online documentation.
 Only analysing the code a bit and eventually having it seen in the NetBSD
 Internals Guide turned out what it really is. Having a manpage for faster
 lookup would be nice.
 There is actually no more documentation about these issues anywhere than
 this manpage/in the NetBSD Internals.
 
 I agree this does not have a great value, but at least you find documentation
 somewhere in the online documentation of what it is about.
 The question seems to be rather if you want only good documentation or at
 least whole, but incomplete documentation.
 The ticket should remain open, no matter if this stub is commited or not.
 
 Regards, Julian