svn commit: r211501 - in head/sys: modules modules/send netinet
netinet6 sys
Doug Barton
dougb at FreeBSD.org
Fri Aug 20 01:33:43 UTC 2010
On 08/19/2010 14:50, Bjoern A. Zeeb wrote:
> On Thu, 19 Aug 2010, Doug Barton wrote:
>
>> On 08/19/2010 04:42, Ana Kukec wrote:
>>> Hi all,
>>>
>>> A man page for the kernel side SeND, and an updated port with
>>> Secure Neighbor Discovery application will follow soon.
>>
>> At minimum committing the man page along with new code is how such
>> things should be done. Can you define "soon?"
>
> Yes I can: soon will be when it'll be comitted.
I'm guessing that's an attempt at humor, but what I'm looking for is an
actual timeline. If the answer is "in the next day or two" then that's
fine, we'll let this one go with a warning. If the answer is "someday"
then I'm going to request that the code be backed out until the man
page(s) are done. I'm actually trying to be reasonable and work with a
new developer so that they can learn how we like to have things done
around here. What are you trying to do?
> Meanwhile if you have time I'd know several dozen other things we
> don't have a man page for ...
I would definitely recommend that you make a list of them, preferably
someplace visible like the wiki. If you don't already have access to the
wiki (or some other suitable forum) then send the list to -doc@ and
we'll make sure that it gets posted. Given the recent resurgence of
interest in updating our documentation it certainly wouldn't hurt to
have some examples of low-hanging fruit that we can turn budding mdoc
gurus loose on.
Meanwhile, the fact that in the past code has been committed without man
pages is the exact cause of the problem you're describing. It is
certainly not a justification for continuing to do it wrong.
Doug
--
Improve the effectiveness of your Internet presence with
a domain name makeover! http://SupersetSolutions.com/
Computers are useless. They can only give you answers.
-- Pablo Picasso
More information about the svn-src-head
mailing list