Re: [Doxygen-users] Problem with documenting generic parameter contraints in c#

[Dimitri v. H. <do...@gm...>]

Hi Steen,

Doxygen does not (properly) support generic methods with type constraints at
the moment.

I'm trying to improve the C# parsing whenever problems are found. I do not
use C# myself
so I rely on others to find and report problems. Please report them to the
bug tracker if you
find them along with an example.

I'm currently looking into the issue you reported and trying to improve the
parser.
Type constraints are a new "concept" in doxygen so this will need some work.

Regards,
  Dimitri


On 7/17/07, Steen Manniche <st...@db...> wrote:
>
> Pardons for the *BUMP*
>
> After you all have had some summer sun in which to think about this little
> nagging obstruction, I wondered if any of you did come up with an answer
> or
> perhaps just a little bit of info or pointers?
>
> Best regards,
> Steen
>
>
> On Friday 25 May 2007 09:47, Steen Manniche wrote:
> > Sorry for the typo, the part in the generated documentation where it
> > reads "<cid:part1...>" should not have shown... The correct rendering
> > should be (in its complete form):
> > List<T> GenericList() where T
> >
> > Steen Manniche wrote:
> > > Hi.
> > >
> > > We have a problem generating dokumentation from certain generic
> classes
> > > in our code base.
> > > The problem consists of getting doxygen to show the parameter
> contraints
> > > from the C# code:
> > >
> > > C# example:
> > >
> > > using System;
> > > using System.Collections.Generic;
> > > public sealed class GenericsTest{
> > >
> > >   public List<T> GenericList <T>() where T:IDisposable{
> > >     return new List<T>();
> > >   }
> > >
> > > }
> > >
> > > This will show up in the documentation as:
> > >
> > > Public Member Functions
> > > List< T > GenericList () where T
> > >
> > >
> > > Thereby stripping the documentation of the information that the class
> > > itself is generic (the "GenericList<T>" bit) as well as the
> information
> > > on the parameter constraints(the "where T: IDisposable" bit)
> > >
> > > This looks like a neglection in the parsing of the c# source, which I
> > > would be happy to provide a patch to, if I was able to find my way
> > > through the doxygen code...
> > >
> > > Pointers, solutions or ideas are most welcome!
> > >
> > > Best regards,
> > > Steen Manniche
> > >
> > >
> > >
> -------------------------------------------------------------------------
> > > This SF.net email is sponsored by DB2 Express
> > > Download DB2 Express C - the FREE version of DB2 express and take
> > > control of your XML. No limits. Just data. Click to get it now.
> > > http://sourceforge.net/powerbar/db2/
> > > _______________________________________________
> > > Doxygen-users mailing list
> > > Dox...@li...
> > > https://lists.sourceforge.net/lists/listinfo/doxygen-users
> >
> >
> -------------------------------------------------------------------------
> > This SF.net email is sponsored by DB2 Express
> > Download DB2 Express C - the FREE version of DB2 express and take
> > control of your XML. No limits. Just data. Click to get it now.
> > http://sourceforge.net/powerbar/db2/
> > _______________________________________________
> > Doxygen-users mailing list
> > Dox...@li...
> > https://lists.sourceforge.net/lists/listinfo/doxygen-users
>
> --
> Steen Manniche, Programmer.
> DanishBibliographicCentre
> Tempovej 7-11
> 2750 DK-Ballerup
>
>
> -------------------------------------------------------------------------
> This SF.net email is sponsored by DB2 Express
> Download DB2 Express C - the FREE version of DB2 express and take
> control of your XML. No limits. Just data. Click to get it now.
> http://sourceforge.net/powerbar/db2/
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>