[gentoo-dev] merging man page documentation into eclasses

[Mike Frysinger]

keeping documentation of functions in a separate file (man pages in this case) 
has obvious bit rot problems written all over it, so i'd like to merge the 
documentation into the respective eclasses so that the man pages can be 
automatically generated

off the cuff, i'd propose a style like:
# FUNCTION: edos2unix
# USAGE: <files>
# DESCRIPTION:
# A handy replacement for dos2unix, recode, fixdos, etc...  This allows you
# to remove all of these text utilities from DEPEND variables because this
# is a script based solution.  Just give it a list of files to convert and
# they will all be changed from the DOS CRLF format to the UNIX LF format.
-mike