[MonoDevelop] Doc comments

Jacob Ilsø Christensen jacobilsoe at gmail.com
Wed Jan 25 17:07:08 EST 2006


Well, actually I am not sure what I am looking for. I am trying to fix the
issue explained in the start of this thread: That doc comments are not shown
when using code completion for the code in the current project. It only
works for "system" assemblies.

/Jacob

On 1/25/06, C.J. Collier <cjcollier at colliertech.org> wrote:
>
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Jacob,
>
> Are you familiar with monodocer ?  Is it what you're looking for?
>
> Cheers,
>
> C.J.
>
>
> Jacob Ilsø Christensen wrote:
> > Hi.
> >
> > I have looked a bit at fixing this issue, but it seems that the C#
> > parser does not support doc comments at the moment. Is this true or
> >  am I missing something. I looked in the cs.ATG file. On another
> > note, how do we switch to supporting .NET 2.0. Can this parser be
> > autogenerated from some mono code?
> >
> > /Jacob
> >
> > On 12/9/05, *Atsushi Eno* <atsushi at ximian.com
> > <mailto:atsushi at ximian.com>> wrote:
> >
> > Hi,
> >
> > John Luke wrote:
> >> Atsushi Eno wrote:
> >>> You might want to reuse some code in cs2ecma.cs in monodoc,
> > if you
> >>> are really interested in implementing it (though I dislike C#
> >>> doc comments as a kind of translator dude, I remember I wrote
> > such code).
> >>>
> >> I know I'm jumping off topic, but why does this present a
> > problem for
> >> translators?
> >
> > There is simply no built in support for localization in C# doc
> > comments and IF we include those translations in the sources as
> > well, the lengthy documentation will mess you. And if you split
> > translation documents out from the source, it won't reflect
> > on-the-fly documentations for you.
> >
> > When it comes to monodoc, we can at least theoretically use
> > non-"en" documentations as its basis (and it would be pretty simple
> > to localize).
> >
> >> Another possibility is to get the inline doc information with the
> >>  monodevelop parser.
> >
> > Yes. Am not familiar with MD sources so I might misunderstand, but
> > since monodevelop has its own parser, so it would make much sense
> > to have its own doc comment support.
> >
> > Atsushi Eno
> >
> >
>
>
> - --
> <cjcollier at colliertech.org>
> http://cjcollier.livejournal.com/tag/
> +1 206 226 5809
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.1 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
>
> iD8DBQFD1/XnbS8rWWzCfqgRAodWAKCI3NdTGWhFAZtw7HDfQVUaA2gJFwCfVV0b
> JlbvPArm54LN+YZXDNg5Gk8=
> =DDq+
> -----END PGP SIGNATURE-----
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.ximian.com/pipermail/monodevelop-list/attachments/20060125/2aac7463/attachment.html


More information about the Monodevelop-list mailing list