[docpp-users] Re: [DOC++] Where is Dragos

[Carsten B. <Car...@op...>]

Hi Dragos,

> > im seeking Dragos, I have written him some mail, but i never
> > get any respond. Di someone here from him?
> 
> 	I didn't get any mail from you. I'm here...

Great, thanks for replying!!

I have send you an email to dr...@bi... and even to
ad...@us..., but perhaps they are lost.

I copy here - with some updates - the mail from may 
that was lost:

=========================================================
Hi Dragos,


first i want to thank you verry much for your work
on DOC++. I use it for Source Documentation by my
work at a big german company.

I have written an article about DOC++ for a german magazine
and i will send it to them in the next days.
I had allready written anarticle about freedos and you can see 
- if you are Interested in - here:

www.openwin.de/downloads/freedos-artikel.zip

Are you currently working on DOC++? I have seen that the
CVS doesnt get changes in the last 8 month. 
Im interested to become a developer of DOC++ and get
CVS access on sourceforge. My user id is:

carstenbreuer.


I have also found some problems with comments and i dont know
if they are known. It should be great if they are fixed before the
article came out:

I had to reedit most source because there are some errors in comment
handling.

1.=====================================

Comments like
/********************
 CIniFile
/*********************/

brings DOC++ to hang. It doesnt document any file after that.

2. =======================================
Comments like
///////////////////////
// My file header
// ....
///////////////////////

are threated like a comment for the following statement.
if Visual C++ this is offen a guid like AFX_CINIFILE_054457855686BLABLA..
which should be defently not documented ;-)).

3. =======================================

I miss a statement like @ignore to say that what ever
came after this, ignore it until a end came. This could be
/// @ignore
///@{
A lot of carbage
///@}

4. ========================================

I would like to have a keyword @intro which put all
text to the index.html before any explanation.
I use DOC++ for a library we have developed and would like
to have this before any other stuff would came out.

I have tried it with @memo etc, but this doesnt rteally work.

I have seen that DOC++ does this by the dxx file format,
so i use it also for my libs. The dxx format is - as i know -
not documented in the help of DOC++.

5. =========================================
Side effects

DOC++ have alot of strange side effects and i sometimes
use the "try and error" method to get the results i had expected.
This is perhaps depends on the strange side effects of flex.

Nonetheless thanks you and all the other People working on DOC++
for this work.


Best Regards,



Carsten Breuer