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

List:       kde-core-devel
Subject:    Re: Proposal: replace KDOC with Doxygen after 2.0 (fwd)
From:       Richard Moore <rich () ipso-facto ! freeserve ! co ! uk>
Date:       2000-10-22 22:07:48
[Download RAW message or body]

Peter Putzer wrote:
> 
> On Sun, 22 Oct 2000, Richard Moore wrote:
> 
> > Do you think you could get doxygen's author to add options to:
> >
> > - Only accept docs in headers
> 
> You have got that rule-file. If you tell it only to look at headers, well,
> then it only looks at headers.

I'll take your word for it - I haven't messed about with the
configuration
file much.

> 
> Of course anyone can rewrite the rules-file, but it's impossible to guard
> against that ;-)

No problem, cvs rules. :-)

> 
> > - Only accept javadoc comments
> 
> OK, I'll ask him. (or rather, I'll cc: this mail to him)

Thanks

> 
> > Given your offer to fix up any doc-comment syntax problems, then
> > if you can do that and help me setup the developer site to use the
> > new stuff then I will have no objection to changing.
> 
> OK

We ought to get the docs team (or maybe the website team?) to help
create a KDE-style template for the doc files. We should try to make
them fit nicely with the overall style of the user-level docs IMHO.
Maybe we could go with something like a very similar style, but with
a different colour scheme indicating that this is developer info.

Rich.

> 
> bye,
> Peter

-- 
     Richard Moore		rich@ipso-facto.freeserve.co.uk
http://www.macromedia.com/	rjmoore@macromedia.com
http://developer.kde.org/	rich@kde.org

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