Re: [Devil-linux-develop] Creating help files.

[John v. V. <joh...@ya...>]

If we go with Webmin,as I hope, and utilize perl for producing DL (and eLSD)
then maybe the Perl "Pod" format from Perl would be an appropriate format.

Standardized perl scripts exist to create formatted text or html with ease. 
Perl, despite its weird community, has a culture of pragmatism and
practicallity (same thing ??) which I feel parallels the DL philosophy.

If you look at any recent perl module, you will see robust Pod documentation. 
More often than not, perlers include a common example of its usage.  I think
that the DL mission could be greatly enhanced with an educational purpose if
users are encouraged to supply their own configurations and usages as addendums
to the standard documentation.
  
Pod, btw, stands for "plain old document"

On another formatting topic, XML, I made contact w/ a XML-RSS news feed guru,
Morbus Iff, who created AmphetaDesk, also in Perl.  I found him on the
Sourceforge RSS page, so I am sure RSS is available to DL as well.  

Morbus is an O'Reilly author  w/ several books to his credit.  The latest, he
claims will be a winner, but he won't tell anything more.  It seems to include
the word "hack" though.


--- Heiko Zuerker <hz...@pr...> wrote:
> On 05/15/2003 10:16:11 AM Bruce Smith wrote:
> >In my effort to help out, I noticed that very few help files exist in
> >the directory:   scripts/configuration/help/
> >
> >If anyone else is working on creating them, please speak up.  Otherwise
> >I'll go through the packages and create as many as I can figure out.
> >
> >All I have to do is create the help files for packages listed in
> >"make menuconfig", right?  No other tweaking required?
> 
> Correct. It's mostly a cut'n'paste from websites.
> 
> Have fun and many thanks for the help !
> 
> Heiko
> 
> 
> 
> 
> -------------------------------------------------------
> Enterprise Linux Forum Conference & Expo, June 4-6, 2003, Santa Clara
> The only event dedicated to issues related to Linux enterprise solutions
> www.enterpriselinuxforum.com
> 
> _______________________________________________
> Devil-linux-develop mailing list
> Dev...@li...
> https://lists.sourceforge.net/lists/listinfo/devil-linux-develop


=====
CXN, Inc. Contact: jo...@th...
President, The Linux Society
http://groups.yahoo.com/group/linux-society
linux society distro -> http://www.thinman.com/eLSD/readme
ThinMan is a registered trademark of CXN, Inc

__________________________________
Do you Yahoo!?
The New Yahoo! Search - Faster. Easier. Bingo.
http://search.yahoo.com