X-Authentication-Warning: delorie.com: mail set sender to geda-user-bounces using -f X-Recipient: geda-user AT delorie DOT com Message-ID: <50A8DEE1.8080106@xs4all.nl> Date: Sun, 18 Nov 2012 14:13:05 +0100 From: Bert Timmerman 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> In-Reply-To: <20121118111433.5D1378134612@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-vbr1.xs4all.nl id qAIDD6Rx096816 Content-Transfer-Encoding: 8bit X-MIME-Autoconverted: from quoted-printable to 8bit by delorie.com id qAIDDHkJ003103 Reply-To: geda-user AT delorie DOT com 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? > > Regards, > /Karl Hammar > > ----------------------------------------------------------------------- > Aspö Data > Lilla Aspö 148 > S-742 94 Östhammar > Sweden > +46 173 140 57 > > > > Hi Karl, AFAICT, in the current situation the "\mainpage" tag in gattrib.c takes precedence over the "\mainpage" tag in gattrib-main.txt. 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. Kind regards, Bert Timmerman.