Re: [Evolution-hackers] Any documentation around anywhere?
On Fri, 2002-06-14 at 23:10, A. Lloyd Flanagan wrote: > Beg your pardon, I didn't realize this. Is all the code documented this > way? If not, I may be able to help add it. > for the calendar API, yes. for the mailer, as Jeff said, it's not integrated into the doc building. So, if you want to help on that, that would be great for other people wanting to use the mailer API. To see how to do it, just have a look at the files in evolution/doc/devel cheers -- http://www.ximian.com, http://www.gnome-db.org, http://www.hispalinux.es ___ evolution-hackers maillist - [EMAIL PROTECTED] http://lists.ximian.com/mailman/listinfo/evolution-hackers
Re: [Evolution-hackers] Any documentation around anywhere?
Beg your pardon, I didn't realize this. Is all the code documented this way? If not, I may be able to help add it. On Fri, 2002-06-14 at 16:58, Rodrigo Moya wrote: On Fri, 2002-06-14 at 22:50, A. Lloyd Flanagan wrote: > I'd like to suggest that for the future we might want to use a tool like > javadoc. This would allow the documentation for the classes/functions > to be included in the source code and automatically extracted to HTML. > This is a great way to the basic documentation for the classes, although > you still have to do overviews, how-tos, etc. > we are already using gtk-doc, which does the same, but for C and GTK. If you install gtk-doc-tools and docbook, the documentation about the calendar APIs should be built in evolution/doc/devel cheers -- http://www.ximian.com, http://www.gnome-db.org, http://www.hispalinux.es
Re: [Evolution-hackers] Any documentation around anywhere?
On Fri, 2002-06-14 at 22:50, A. Lloyd Flanagan wrote: > I'd like to suggest that for the future we might want to use a tool like > javadoc. This would allow the documentation for the classes/functions > to be included in the source code and automatically extracted to HTML. > This is a great way to the basic documentation for the classes, although > you still have to do overviews, how-tos, etc. > we are already using gtk-doc, which does the same, but for C and GTK. If you install gtk-doc-tools and docbook, the documentation about the calendar APIs should be built in evolution/doc/devel cheers -- http://www.ximian.com, http://www.gnome-db.org, http://www.hispalinux.es ___ evolution-hackers maillist - [EMAIL PROTECTED] http://lists.ximian.com/mailman/listinfo/evolution-hackers
Re: [Evolution-hackers] Any documentation around anywhere?
I'd like to suggest that for the future we might want to use a tool like javadoc. This would allow the documentation for the classes/functions to be included in the source code and automatically extracted to HTML. This is a great way to the basic documentation for the classes, although you still have to do overviews, how-tos, etc. A tool that does javadoc-like doc generation for C++ is CCDoc, found at http://www.joelinoff.com/ccdoc/. I don't know of a tool for C/Cobra code, although it shouldn't be too hard to do one. On Thu, 2002-06-13 at 23:47, Joe Khoobyar wrote: . . . However, I was wondering if there was any documentation lying around about the class hierarchy in Evolution? I figured if there was, it would save me a lot of time tooling around to figure out the basic structure of things. Unfortunately, free time is something that can be pretty elusive. ___ evolution-hackers maillist - [EMAIL PROTECTED] http://lists.ximian.com/mailman/listinfo/evolution-hackers ___ evolution-hackers maillist - [EMAIL PROTECTED] http://lists.ximian.com/mailman/listinfo/evolution-hackers
Re: [Evolution-hackers] Any documentation around anywhere?
We already have something like this called GtkDoc - and the inline comments in Camel already contain comments in the correct format in order to be extracted by the tool, but someone has to go and setup the makefiles to do it. Jeff On Fri, 2002-06-14 at 16:50, A. Lloyd Flanagan wrote: > I'd like to suggest that for the future we might want to use a tool like > javadoc. This would allow the documentation for the classes/functions > to be included in the source code and automatically extracted to HTML. > This is a great way to the basic documentation for the classes, although > you still have to do overviews, how-tos, etc. > A tool that does javadoc-like doc generation for C++ is CCDoc, found at > http://www.joelinoff.com/ccdoc/. I don't know of a tool for C/Cobra > code, although it shouldn't be too hard to do one. > > > On Thu, 2002-06-13 at 23:47, Joe Khoobyar wrote: > . > . > . > However, I was wondering if there was any documentation lying around > about the class hierarchy in Evolution? I figured if there was, it > would save me a lot of time tooling around to figure out the basic > structure of things. Unfortunately, free time is something that can be > pretty elusive. > > > ___ > evolution-hackers maillist - [EMAIL PROTECTED] > http://lists.ximian.com/mailman/listinfo/evolution-hackers > > > > > ___ > evolution-hackers maillist - [EMAIL PROTECTED] http://lists.ximian.com/mailman/listinfo/evolution-hackers -- Jeffrey Stedfast <[EMAIL PROTECTED]> Ximian, Inc. ___ evolution-hackers maillist - [EMAIL PROTECTED] http://lists.ximian.com/mailman/listinfo/evolution-hackers
Re: [Evolution-hackers] Any documentation around anywhere?
On 13 Jun 2002, Joe Khoobyar wrote: > Hi everyone. I just recently subscribed to this list because I'd really > love to customize and add some features to Evolution. I'm a > professional software developer and I've been writing code since I was > ten, so I'm not out of my element or anything. Ha! Are you sure mate? We're kinda 1337 aroun here you might not be up to speed :) (i'm totally joking of course!) > However, I was wondering if there was any documentation lying around > about the class hierarchy in Evolution? I figured if there was, it > would save me a lot of time tooling around to figure out the basic > structure of things. Unfortunately, free time is something that can be > pretty elusive. > > I know we all hate documenting code (at least I do) so it's probably > likely that it hasn't been done yet, but I was hoping against hope that > there might be some docs out there already? There are a ew bits and pieces, but not a whole hell of a lot :( there's some stuff in camel/devel-docs, but a lot of it is a bit out of date, and only relevent if you're interested in low-level email stuff. Unofortunately for most things you have to resort to the source. Although at least the coba compnent like wombat (addressbook/calendar) are wrapped in corba idl's. > -- > Joe Khoobyar > Ankhcraft > "where technology is our art" > http://www.ankhcraft.com > Voice: (703) 200-7871 > Fax: (703) 941-1175 > > > ___ > evolution-hackers maillist - [EMAIL PROTECTED] > http://lists.ximian.com/mailman/listinfo/evolution-hackers > ___ evolution-hackers maillist - [EMAIL PROTECTED] http://lists.ximian.com/mailman/listinfo/evolution-hackers