[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Netsukuku-vala] valadoc
From: |
Yussi |
Subject: |
Re: [Netsukuku-vala] valadoc |
Date: |
Sun, 01 Jul 2012 07:22:49 +0100 |
User-agent: |
Mozilla/5.0 (X11; Linux i686; rv:10.0.4) Gecko/20120510 Icedove/10.0.4 |
Hi Luca,
I cleaned this up a little, I also took the liberty of changing a few of
the comments, Unfortunately, I had to use my interpretation for a LOT of
them, and I am pretty sure I got a lot of this wrong, so you now (not
literally now) have to go over this patch and correct what I misunderstood.
I couldn't get valadoc to do exactly what I wanted, but for the most
part I got some workaround. there should now be no "^\t" in any of the
vala files...
On 29/06/12 09:55, Luca Dionisi wrote:
> Thanks Yussi.
> If you have time, substitute the tabs with spaces.
>
> On Thu, Jun 28, 2012 at 5:45 AM, Yussi <address@hidden> wrote:
>> Hi Luka,
>> Having spent the better part of the last couple of days trying to
>> generate the api documentation from the code, I have now had partial
>> success. partly due to just brute force.
>> valadoc seems to be really particular over how it expects to find the
>> comments, the first /** needs to be on a line of it's own, after a *
>> there can only be exactly 1 space, and other such particularities.
>>
>> Anyway, since you already put in the valadoc comments, I assume that
>> either you tried and failed to generate these, or that you had a better
>> way of doing so, in which case I might as well start pulling hairs out :)
>>
>> I attach the patch to do this,
>> the command I used to generate it was :
>> valadoc *.vala -o doc/vd --pkg gcrypt --pkg gee-1.0 --pkg gio-2.0 --pkg
>> posix --pkg posix_extras --pkg linux --pkg libpth
>> --vapidir="/usr/share/vala-0.16/vapi/" --vapidir="."
>>
>> You will have to change some stuff depending on where vala is installed
>> etc. Some of it might be redundant but I can't be arsed to check now.
>>
>> When I regain my patience I would attempt to add this to the make file.
>> Hope this is helpful, otherwise I just wasted a hell of a lot of time.
>> Take care.
>> Yussi.
>
cleaner.patch
Description: Text Data
signature.asc
Description: OpenPGP digital signature
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- Re: [Netsukuku-vala] valadoc,
Yussi <=