X-Authentication-Warning: delorie.com: mail set sender to geda-user-bounces using -f
X-Recipient: geda-user AT delorie DOT com
X-Mailer: exmh version 2.7.2 01/07/2005 (debian 1:2.7.2-18) with nmh-1.3
X-Exmh-Isig-CompType: repl
X-Exmh-Isig-Folder: inbox
To: geda-user AT delorie DOT com
Subject: Re: [geda-user] gattrib doxygen \mainpage
In-reply-to: <50A8DEE1.8080106@xs4all.nl>
References: <20121118111433 DOT 5D1378134612 AT turkos DOT aspodata DOT se> <50A8DEE1 DOT 8080106 AT xs4all DOT nl>
Comments: In-reply-to Bert Timmerman <bert DOT timmerman AT xs4all DOT nl>
   message dated "Sun, 18 Nov 2012 14:13:05 +0100."
Mime-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Message-Id: <20121118132212.0AA8C813461A@turkos.aspodata.se>
Date: Sun, 18 Nov 2012 14:22:11 +0100 (CET)
From: karl AT aspodata DOT se (Karl Hammar)
X-Virus-Scanned: ClamAV using ClamSMTP
Reply-To: geda-user AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: geda-user AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk

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