2017-11-01 9:51 GMT+01:00 Michal Čihař <mic...@cihar.com>:
> Hello
>
> On Tue, 2017-10-31 at 23:00 +0100, Manuel A. Fernandez Montecelo wrote:
>> This happened a year ago, yet the fix is not in unstable yet.
>>
>> Would it be possible to include it in the near future? Can we help
>> in
>> any way?
>
> The only reason why I haven't yet made new release is that there is
> currently problem with building the documentation as the gtk-doc has
> dropped support for features enca uses. It builds, but the docs is
> mostly empty. I didn't find time to investigate this as I know nothing
> about gtk-doc right now...
>
> See https://github.com/nijel/enca/issues/27
My limited[1] knowledge on this matter makes me thing that templates
are completely out, so the headers/code would have to include
explicitly what it was in templates before.
There seems to be a direct mapping between the contents of the sgml
files ("SECTION Short_Description", "SECTION See_Also", "SECTION
Title", "SECTION Image", etc.) with @short_description, @see_also,
@image, @title etc. as described in:
https://developer.gnome.org/gtk-doc-manual/unstable/documenting_sections.html
Since in the sgml templates the sections are sometimes empty, I
suspect that most of the job would be to map the specific enums to the
correct files in the code where they are relevant.
I am afraid that I am not familiar with the code, so I cannot be of
much help on that front.
[1] I've never used gtk-doc before, never even programmed with gtk libs
Cheers.
--
Manuel A. Fernandez Montecelo <manuel.montez...@gmail.com>
