X-Authentication-Warning: delorie.com: mail set sender to geda-user-bounces using -f
X-Recipient: geda-user AT delorie DOT com
Message-ID: <50A8FF05.9040201@xs4all.nl>
Date: Sun, 18 Nov 2012 16:30:13 +0100
From: Bert Timmerman <bert DOT timmerman AT xs4all DOT nl>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.1.19) Gecko/20110429 Fedora/2.0.14-1.fc13 SeaMonkey/2.0.14
MIME-Version: 1.0
To: geda-user AT delorie DOT com
Subject: Re: [geda-user] gattrib doxygen \mainpage
References: <20121118111433 DOT 5D1378134612 AT turkos DOT aspodata DOT se> <50A8DEE1 DOT 8080106 AT xs4all DOT nl> <20121118132212 DOT 0AA8C813461A AT turkos DOT aspodata DOT se> <50A8EA58 DOT 3030004 AT xs4all DOT nl>
In-Reply-To: <50A8EA58.3030004@xs4all.nl>
Content-Type: text/plain; charset=utf-8; format=flowed
X-Virus-Scanned: by XS4ALL Virus Scanner
X-MIME-Autoconverted: from 8bit to quoted-printable by smtp-vbr12.xs4all.nl id qAIFUDh5025014
Content-Transfer-Encoding: 8bit
X-MIME-Autoconverted: from quoted-printable to 8bit by delorie.com id qAIFUHki015541
Reply-To: geda-user AT delorie DOT com

Bert Timmerman wrote:
> Karl Hammar wrote:
>> Bert Timmerman:
>>> Karl Hammar wrote:
>>>>    There are multiple \maintext in gattrib doxygen documentation:
>>>>
>>>> $ find gattrib -type f| xargs fgrep '\mainpage' | cut -b-80
>>>> gattrib/docs/gattrib-main.txt:/*! \mainpage gattrib - The GPL 
>>>> Electronic Design
>>>> gattrib/src/gattrib.c: * \mainpage
>>>> $
>>>>
>>>> They are introduced:
>>>> file              date       commit
>>>> gattrib.c         2009-07-31 633766c156acc8fcca4a34c619f63b773eccce2e
>>>> gattrib-main.txt  2009-07-28 5737a8a01786b6b76c595029633d3680f6fc7514
>>>>
>>>> Which one is the to keep?
>>> AFAICT, in the current situation the "\mainpage" tag in gattrib.c takes
>>> precedence over the "\mainpage"  tag in gattrib-main.txt.
>> Yes, it does.
>>
>>> In my (biased) opinion the "\mainpage" tag in gattrib.c should go away,
>>> and should remain in gattrib-main.txt
>>>
>>> Some (or all) parts of the Doxygen header text in gattrib.c should go
>>> into gattrib-main.txt too.
>> Yes, that would make it more in line with how it's done for the other
>> subdirs.
>>
>> Anyone knowledgeable enough about gattrib to do it,
>> or able to give instructions what to keep or drop ?
>>
>> Regards,
>> /Karl Hammar
>>
>> -----------------------------------------------------------------------
>> Aspö Data
>> Lilla Aspö 148
>> S-742 94 Östhammar
>> Sweden
>> +46 173 140 57
>>
>>
> Hi Karl,
>
> I will *try* to cook up a patch this evening.
>
> I don't know if it will be in time for the 1.8.0,release, and I have 
> no idea how near/far this release is in time.
>
> Kind regards,
>
> Bert Timmerman.
>
>
>
>
Hi Karl and all,

Done !

See https://github.com/bert/geda-gaf/tree/gattrib_dox

and

https://github.com/bert/geda-gaf/commit/df4df8901d6d27fcae6de32336ac06b7f56f2f6b

Feel free to proof read the patch and/or test by rebuilding the Doxygen 
docs.

See if this commit gets in before 1.8.0 gets out ;-)

Kind regards,

Bert Timmerman.