docpp-users — DOC++ Mailing List

[DOC++] DOC++ 3.4.10 released

[Dragos A. <dr...@bi...>]

	Hello all,


	I've just released DOC++ 3.4.10. Summary of changes since 3.4.9:

FEATURES:
- added crufty XML DocBook support

PORTABILITY FIXES:
- fixed a g++ 3.0 compilation problem


Best regards and A Happy New Year!
Dragos.

---------------------------------------------------------------------
Dragos Acostachioaie                               dr...@bi...
BIOSFARM SRL                           http://www.biosfarm.ro/~dragos
Spital Pascanu 35A                       Mobile Phone: +40-744-564548
IASI 6600, ROMANIA          Phone/Fax: +40-232-270914, 272510, 272716
---------------------------------------------------------------------

[DOC++] Array type not linked correctly

[Edward B. <eb...@el...>]

Hi,
=20
When I define an array type, the HTML documentation for structures and
functions that make use of it does not link back to the array type. For
example, say that I define types as follows
=20
=20
/// @memo Maximum length (including null) of string.
const int MaxStringLen =3D 25;
/// @memo Static string type.
typedef char StaticStringT[MaxStringLen];
=20
/// @memo Example structure.
struct ExampleT
{
      /// @memo Name field.
      StaticStringT name;
      /// @memo Age field.
      int age;
};
=20
The resultant HTML documentation will include a section for the typedef
called "StaticStringT[MaxStringLen]", and the structure is documented as
having a name field of type "StaticStringT". Since these don't match, I
can see why no link is created, but I think the typedef documentation is
being generated incorrectly (should be called "StaticStringT" as well).
=20
I haven't seen this reported previously, so I'm curious if this is a bug
or operator error. Any assistance would be appreciated.
=20
Ed
=20
Edward Berg
ELEMATICS
V 503.716.1029
F 503.716.1061
=20

[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

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

[Breuer S. B. <Car...@op...>]

Hi all

im seeking Dragos, I have written him some mail, but i never
get any respond. Di someone here from him?

Best regards,


Carsten Breuer

[DOC++] [docpp-users] Announce: New Windows Shell Extension for DOC++

[Breuer S. B. <Car...@op...>]

Hi all,


i have written a Shell Extension for DOC++ to create some browsing
information on the fly. You can select some header files and click on
Create DOC++ Overview. The Extension runs then DOC++ with the
path to %TEMP_DIR%help. Afterwards it starts the default browser.

The project ist located on sourceforge:

http://www.sf.net/projects/cbshellext.

Best regards



Carsten Breuer

Re: [DOC++] full return value and parameters for c functions

[Yannis B. <Yan...@cm...>]

> I am new to using doc++, and was wondering if there is a way to make
> the return value and the parameter information show up for C
> functions (that are not defined inside a class).
     Like in Javadoc, you can use @param and @result tags...
          Yannis


======================================================================
Esterel Technologies                      www.esterel-technologies.com
Core Technology Group                     +33 (4) 92 02 40 63
Twins 2, 885 Av Julien Lefebvre
06270 Villeneuve Loubet
FRANCE
----------------------------------------------------------------------
CMA-EMP / INRIA                           www.esterel.org
----------------------------------------------------------------------
+33 (6) 60 38 79 52                       www.yannisbres.net
======================================================================

[DOC++] full return value and parameters for c functions

[Jason F. <ja...@wi...>]

Hi,

I am new to using doc++, and was wondering if there is a way to make the
return value and the parameter information show up for C functions (that
are not defined inside a class). Currently I just get the name, and if the
comment is only singled lined, then no option to click on it and see more
information). Ideally I would like the index.html to show me the full
function information:

int somefunction(int a, int b) My comments on the function

Is there is some way to do this?

Thanks,

Jason Friedman

-------------------------------------------------------
Jason Friedman
Ph.D. Student
Department of Computer Science and Applied Mathematics
Weizmann Institute of Science, Rehovot, Israel.
Home page: http://www.wisdom.weizmann.ac.il/~jason

[DOC++] DOC++ 3.4.10-pre1

[Dragos A. <dr...@bi...>]

	Hello again,


	Here we go with 3.4.10-pre1. The main change is the XML output 
support, thanks to Vincent Sanders. It needs some tweaks and other 
changes, but it currently works.
	Please test it, and scream with ideas, failure/success reports, 
patches.


Best regards,
Dragos.

---------------------------------------------------------------------
Dragos Acostachioaie                               dr...@bi...
BIOSFARM SRL                           http://www.biosfarm.ro/~dragos
Spital Pascanu 35A                        Mobile Phone: +40-94-564548
IASI 6600, ROMANIA           Phone/Fax: +40-32-270914, 272510, 272716
---------------------------------------------------------------------

[DOC++] test

[Dragos A. <dr...@bi...>]

[DOC++] test

[Dragos A. <dr...@bi...>]