From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <binutils-return-39669-listarch-binutils=sources.redhat.com@sources.redhat.com>
Received: (qmail 21639 invoked by alias); 14 Apr 2005 12:41:17 -0000
Mailing-List: contact binutils-help@sources.redhat.com; run by ezmlm
Precedence: bulk
List-Subscribe: <mailto:binutils-subscribe@sources.redhat.com>
List-Archive: <http://sources.redhat.com/ml/binutils/>
List-Post: <mailto:binutils@sources.redhat.com>
List-Help: <mailto:binutils-help@sources.redhat.com>, <http://sources.redhat.com/ml/#faqs>
Sender: binutils-owner@sources.redhat.com
Received: (qmail 21425 invoked from network); 14 Apr 2005 12:41:02 -0000
Received: from unknown (HELO mx1.redhat.com) (66.187.233.31)
  by sourceware.org with SMTP; 14 Apr 2005 12:41:02 -0000
Received: from int-mx1.corp.redhat.com (int-mx1.corp.redhat.com [172.16.52.254])
	by mx1.redhat.com (8.12.11/8.12.11) with ESMTP id j3ECf2vt028106
	for <binutils@sources.redhat.com>; Thu, 14 Apr 2005 08:41:02 -0400
Received: from post-office.corp.redhat.com (post-office.corp.redhat.com [172.16.52.227])
	by int-mx1.corp.redhat.com (8.11.6/8.11.6) with ESMTP id j3ECf2O13713;
	Thu, 14 Apr 2005 08:41:02 -0400
Received: from greed.delorie.com (dj.cipe.redhat.com [10.0.0.222])
	by post-office.corp.redhat.com (8.11.6/8.11.6) with ESMTP id j3ECf2v10426;
	Thu, 14 Apr 2005 08:41:02 -0400
Received: from greed.delorie.com (greed.delorie.com [127.0.0.1])
	by greed.delorie.com (8.13.1/8.13.1) with ESMTP id j3ECemIi032076;
	Thu, 14 Apr 2005 08:40:49 -0400
Received: (from dj@localhost)
	by greed.delorie.com (8.13.1/8.13.1/Submit) id j3ECegXI032073;
	Thu, 14 Apr 2005 08:40:42 -0400
Date: Thu, 14 Apr 2005 12:41:00 -0000
Message-Id: <200504141240.j3ECegXI032073@greed.delorie.com>
From: DJ Delorie <dj@redhat.com>
To: tg@66h.42h.de
CC: binutils@sources.redhat.com, gcc-patches@gcc.gnu.org
In-reply-to: <Pine.BSO.4.61L.0504140739230.17420@thor.66h.42h.de> (message
	from Thorsten Glaser on Thu, 14 Apr 2005 07:40:52 +0000)
Subject: Re: Remove parameter names from libiberty.h
References: <20050412012121.GA3321@bubble.modra.org>
 <200504132357.j3DNvcF1028534@caip.rutgers.edu> <Pine.BSO.4.61L.0504140739230.17420@thor.66h.42h.de>
X-SW-Source: 2005-04/txt/msg00369.txt.bz2


Opinions follow...

Since libiberty has a separate texinfo documentation that's supposed
to document all the parameters, and since most of libiberty's
functions are common system functions anyway, IMHO it's not as big a
deal if libiberty.h doesn't have names of parameters in it.

In DJGPP we got around this by adding underscores, but that was
acceptable only because it was the C library and that namespace was
reserved for it.

Commented out parameter names gets messy fast, esp for functions with
lots of parameters.