[prev in list] [next in list] [prev in thread] [next in thread] 

List:       freebsd-hackers
Subject:    Re: Manpages 9
From:       Warner Losh <imp () village ! org>
Date:       1996-07-31 19:41:52
[Download RAW message or body]


: You're right, that doesn't work at all.  Hmmmm.  Any suggestions,
: anyone? :-)

Yes, but aren't use of manacles, spiked chambers and branding irons
against the Geneva conventions?

Your best bet:
	Pay a tech writer (or find some sucker to volunteer) to fly to
each of the hacker's home towns.  Buy them a beer or three (or sushi
or whatever their poison is) and get them babbling about the
interfaces, possibly in their native language.  Record this on tape,
and take notes.  Then, have that person massage the results into man
pages.  Take those man pages and pass them back by the original
authors, or people that would know for corrections.  It is much easier
to correct something than it is to write it from scratch (unless it is
so wrong that it has to be completely rewritten).

Warner

[prev in list] [next in list] [prev in thread] [next in thread]