Hi,
Should I obtain valadoc from gnome.org ?
On Wed, 2008-10-29 at 12:10 +0100, Florian Brosch wrote:
> Hello Yu,
>
> you are welcome.
>
> As far as I think vala is a great language for libraries I like to
> implement a painless way to generate documentation for the C api too.
> I think the easiest way to get there is to compile the whole source to
> C with gtk-doc-translations of our valadoc-comments and some
> bootstrap-magic.
>
> ~ Flo
>
>
> On Wed, Oct 29, 2008 at 4:45 AM, Yu Feng <[EMAIL PROTECTED]> wrote:
> > On Mon, 2008-10-27 at 13:54 +0100, Florian Brosch wrote:
> >> Hi Yu,
> >>
> >> basic stuff should work fine. There are few issues I'm about to solve:
> >> It is not possible to add a code-related comment upper or after a
> >> documentation comment because they are merged to one by libvala. I'm
> >> about to improve that part. (Struct-copy and documentation handling.
> >> See #529040\valac) When the changes are done we will also have correct
> >> line numbers in our warning- and error-messages.
> >>
> >> There are also some very small style-related things I have to change.
> >> (Different symbols for methods, symbols for constants, larger text;
> >> such stuff.) I like to waith until we have the first library with full
> >> documentation, to make my life easier.
> >>
> >>
> >> Following taglets are shiped with valadoc:
> >> - @see [Symbol] (All symbols)
> >> - @return [Description] (Methods)
> >> - @throws [Exception, Description] (Methods, Signals, Delegates)
> >> - @version [Version]
> >> - @parameter [Name, Description] (Methods, Signals, Delegates)
> >>
> >> There is no context-check right now.
> >>
> >> Inline-Taglets:
> >> - { @inheritDoc }
> >> - { @link [Symbol] }
> >>
> >>
> >> Stuff i like to add in future:
> >> - Devhelp integration
> >> -- devhelp2-files (They like to add a language-switch)
> >> -- A gtk-doc-like output.
> >> - Deprecated-Tag @deprecated [Version, Description] (Or an
> >> valac-attribute. I think a warning could be nice at valac-level.)
> >> - Since-Tag @since [Version]
> >> - gtk-doc-Translation (C-Code+gtk-doc comments)
> >> - External documentation / Documentation-Import
> >> - Wiki-Parser
> >>
> >> A small example:
> >> - vala-File: http://www.valadoc.org/sample/foo.vala
> >> - Command: valadoc -o FOO foo.vala
> >> - Output: http://valadoc.org/sample/FOO/index.html
> >>
> >>
> > Thanks for the explanations Flo!
> >
> > The example is already quite impressive and promising. I'll add valadoc
> > in gnome-globalmenu very soon.
> >
> > I am not sure what you mean by gtk-doc-Translation? Do you mean
> > producing documents for how to operate the library in C? If so, the
> > feature will be extremely useful at least for me, since I am writing
> > some libraries intended to be called from C code.
> >
> > Regards,
> >
> > Yu
> >
> >> Regards,
> >> Flo / mog\Irc
> >>
> >> On Sat, Oct 25, 2008 at 10:04 AM, Yu Feng <[EMAIL PROTECTED]> wrote:
> >> >
> >> > Can I use vala-doc to generate api documentation of my library written
> >> > in vala?
> >> >
> >> > Are there any alternative methods?
> >> >
> >> > Regards,
> >> >
> >> > Yu
> >> >
> >> >
> >> >
> >> >
> >> > _______________________________________________
> >> > Vala-list mailing list
> >> > Vala-list@gnome.org
> >> > http://mail.gnome.org/mailman/listinfo/vala-list
> >
> >
_______________________________________________
Vala-list mailing list
Vala-list@gnome.org
http://mail.gnome.org/mailman/listinfo/vala-list
