Mail Archives: geda-user/2012/11/18/10:31:42
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.
- Raw text -