X-Authentication-Warning: delorie.com: mail set sender to geda-user-bounces using -f
X-Recipient: geda-user AT delorie DOT com
Message-ID: <50A8EA58.3030004@xs4all.nl>
Date: Sun, 18 Nov 2012 15:02:00 +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>
In-Reply-To: <20121118132212.0AA8C813461A@turkos.aspodata.se>
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-vbr19.xs4all.nl id qAIE20iq097242
Content-Transfer-Encoding: 8bit
X-MIME-Autoconverted: from quoted-printable to 8bit by delorie.com id qAIE25gp006547
Reply-To: geda-user AT delorie DOT com

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.