NetBSD-Bugs archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

Re: kern/32430: genfs lacking documentation

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

From: Julian Fagir <>
Subject: Re: kern/32430: genfs lacking documentation
Date: Sat, 11 Jun 2011 13:21:57 +0200

 >  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

Home | Main Index | Thread Index | Old Index