Date: Sun, 15 Jul 2001 00:46:28 -0600 From: Chad David <davidc@acns.ab.ca> To: Alfred Perlstein <alfred@FreeBSD.org> Cc: John Baldwin <jhb@FreeBSD.org>, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org, Chad David <davidc@acns.ab.ca>, Dima Dorfman <dima@unixfreak.org> Subject: Re: cvs commit: src/share/man/man9 cdevsw_add.9 cdevsw_remove.9 Message-ID: <20010715004628.B40654@colnta.acns.ab.ca> In-Reply-To: <20010714231159.G15299@sneakerz.org>; from alfred@FreeBSD.org on Sat, Jul 14, 2001 at 11:11:59PM -0500 References: <20010714211033.D15299@sneakerz.org> <XFMail.010714205456.jhb@FreeBSD.org> <20010714231159.G15299@sneakerz.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, Jul 14, 2001 at 11:11:59PM -0500, Alfred Perlstein wrote: > * John Baldwin <jhb@FreeBSD.org> [010714 22:54] wrote: > > > > On 15-Jul-01 Alfred Perlstein wrote: > > > > > > Well I'm proud to state that all this 'discussion' seems to have > > > scared Chad away from wrinting manpages that don't conform to all > > > of our 200 developers' ideas of perfection. Meaning I haven't > > > heard from him since these useless suggestions started pouring in. > > > > Oh please. How many manpages have you written, Alfred? :) Also, it is the > > weekend right now. Maybe Chad is one of the really unique geeks who has a > > life and he's busy doing that? :) Oh, and didn't major.9, minor.9 get combined > > into a device_ids.9 already? > > Well I hope he has a life, however he was handing me about 5 manpages > a day untill *developers started offering 'helpful' suggestions. Of course I have a life, and I have all fifteen of Kirk's videos to prove it :). > > Of course none of it was about the technical accuracy of the > documentation, rather it was nitpicking about layout and format. > This is FreeBSD so it's to be expected since form is so much more > important than progress and functionality. Or at least that's the > impression I get from anyone who's tried to contribute and doesn't > have time for all the BS and politics. I hope I have absorbed all of the nitpicking and that I will be able to absorb all that will follow... as long as I am learning and there are individuals like alfred, shealdonh, and ru I do not anticipate any problems. Some of the form and fixing has been a little trying. For example changing every -width entry to -xwidth on Wednesday, and then having ru commit changes to make -width the proper method on Thurday was a little much. But that is how it goes, and ru has actually done enough work himself that I am not in any position to complain; besides, that is what sed is for. What I really need is individuals who can answer questions (some stupid) about whatever I am documenting, and others who can suggest what needs to be documented and what doesn't. For example should getpbuf() be documented to take a NULL pfreecnt or is that really going away, and does FreeBSD do any IO outside of VMIO anymore? I can read the source for some of these, but sometimes just asking is a lot more effective. For those who do not know what I am doing I am working on a project that will require me to go into parts of the kernel I have never touched, and I figured that while I was reading the code I would just document it. The path I am following is from bread() down. My intention is to go down to just before the machine specific code, and then work back up into UFS. If it is still "fun" after that I will most likely move into net as that is more my area of interest. This is what I have done so far (there are many more on my todo list, and yes I am going to merge some of these :-) ): vinvalbuf - done/commit vfs_mount - done/commit vfs_busy - done/commit vfs_unbusy - done/commit ucred - done/commit uidinfo - done/commit groupmember - done/commit vn_isdisk - done/commit devsw - done/commit cdevsw_add - done/commit cdevsw_remove - done/commit lockmgr - done/commit lockcount - done/commit lockdestroy - done/commit lockstatus - done/commit lockmgr_printinfo - done/commit BUF_LOCKINIT - done/commit BUF_LOCK - done/commit BUF_TIMELOCK - done/commit BUF_UNLOCK - done/commit BUF_LOCKFREE - done/commit BUF_REFCNT - done/commit ! device_ids --------------- major - done/commit umajor - done/commit minor - done/commit uminor - done/commit ! device_ids --------------- ! pbuf --------------- trypbuf - done/sent getpbuf - done/sent relpbuf - done/sent ! pbuf --------------- * bufflags - started * cdevsw - started bremfree - started bread - started getnewbuf - started brelse - started linker - started/hold vm_page_alloc - done/sent vm_page_lookup - done/sent vm_page_sleep_busy - done/sent vm_page_protect - done ! vm_page_wire --------------- vm_page_wire - done/sent vm_page_unwire - done/sent ! vm_page_wire --------------- ! vm_page_hold --------------- vm_page_hold - done vm_page_unhold - done ! vm_page_hold --------------- ! vm_page_flag --------------- vm_page_flag_clear - done vm_page_flag_set - done ! vm_page_flag --------------- Now that I have established that I am still alive and kicking I am going to get back to my life :). Chad To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010715004628.B40654>