Re: [gentoo-dev] Gentoo beeping at me!

[Georgi Georgiev <chutz@gg3.net>]

maillog: 25/11/2004-19:19:27(+0000): Ed Grimm types
> On Thu, 25 Nov 2004, Georgi Georgiev wrote:
> 
> If you really think that in-line docs are ugly, use vim(1), and
> automagically fold them out of your view (:help foldexpr, although this
> can be set to happen in the eclass syntax file).  I suspect that most of
> the people who only occasionally work with the eclasses, and those who
> are just starting to use the eclasses, would find them more useful than
> ugly.

I have nothing against in-line docs in general. I simply had trouble
imagining it in the bash case.

What about using perldoc itself? Simply prepend every doc line with a
'#', then run

awk '/^#/ { sub("#",""); print }

on the file and pass this output to perldoc. This has the advantage of
having the necessary tools at hand already, so that no extra tools are
needed for the docs.

-- 
\    Georgi Georgiev   \  A lot of people I know believe in positive   \
 /    chutz@gg3.net     / thinking, and so do I. I believe              /
\   +81(90)6266-1163   \  everything positively stinks. ti -- Lew      \
 / -------------------  / Col                                           /

--
gentoo-dev@gentoo.org mailing list