[augeas-devel] Re: Lenses documentation

[Free Ekanayaka]

Hi Raphaël,

|--==> On Fri, 5 Sep 2008 08:36:52 +0200, "Raphaël Pinson" <raphink at gmail.com> said:

  RP> Hi all,
  RP> I made some basic tests yesterday with NaturalDocs.

  RP> The modified files can be found on [0], the conf for NaturalDocs is at [1]
  RP> and the generated doc is at [2].


  RP> The down side of this currently is that the comments repeat the contents of
  RP> the code, which make it a bit heavy to document. Ideally, I would like to
  RP> make a Perl Module for NaturalDocs to enhance the Augeas language support,
  RP> in order to parse the files for definitions, and only add comments for what
  RP> is not explicit yet.

Very interesting. Does it work only for lenses written with specific
patterns for comments? I like the idea of having a "standard" way for
writing lenses.

Ciao,

Free