From mwm@mired.org  Tue Nov  7 17:17:52 2000
Return-Path: <mwm@mired.org>
Received: from guru.mired.org (okc-27-149-77.mmcable.com [24.27.149.77])
	by hub.freebsd.org (Postfix) with SMTP id 13EF437B479
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  7 Nov 2000 17:17:52 -0800 (PST)
Received: (qmail 9110 invoked by uid 100); 8 Nov 2000 01:17:46 -0000
Message-Id: <20001108011746.9109.qmail@guru.mired.org>
Date: 8 Nov 2000 01:17:46 -0000
From: mwm@mired.org
Reply-To: mwm@mired.org
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Function is gone, but the man page lingers on
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         22675
>Category:       docs
>Synopsis:       Function is gone, but the man page lingers on
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Nov 07 17:20:01 PST 2000
>Closed-Date:    Tue Nov 21 13:33:41 GMT 2000
>Last-Modified:  Tue Nov 21 13:34:19 GMT 2000
>Originator:     Mike Meyer
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
Meyer Consulting
>Environment:

System: FreeBSD guru.mired.org 5.0-CURRENT FreeBSD 5.0-CURRENT #1: Sat Nov 4 19:39:06 CST 2000 root@:/usr/obj/sharetmp/src/sys/GURU i386

>Description:

The cfree man page exists, claiming that cfree is an alias for
free. However, trying to use it generates link errors.

>How-To-Repeat:

Try compiling the following short C program:

	int main() {
	  cfree((char *) 0);
	}

and get:

bash-2.04$ cc test.c
test.c: In function `main':
test.c:2: `NULL' undeclared (first use in this function)
test.c:2: (Each undeclared identifier is reported only once
test.c:2: for each function it appears in.)

whereas using free() instead of cfree() works.

>Fix:

Delete the man page? Add cfree back to libc?

>Release-Note:
>Audit-Trail:

From: Chris Faulhaber <jedgar@fxp.org>
To: mwm@mired.org
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/22675: Function is gone, but the man page lingers on
Date: Tue, 7 Nov 2000 20:26:31 -0500

 On Wed, Nov 08, 2000 at 01:17:46AM -0000, mwm@mired.org wrote:
 > 
 > >Number:         22675
 > >Category:       docs
 > >Synopsis:       Function is gone, but the man page lingers on
 > 
 > >How-To-Repeat:
 > 
 > bash-2.04$ cc test.c
 > test.c: In function `main':
 > test.c:2: `NULL' undeclared (first use in this function)
 > test.c:2: (Each undeclared identifier is reported only once
 > test.c:2: for each function it appears in.)
 > 
 > whereas using free() instead of cfree() works.
 > 
 
 How about following the man pages instructions:
 
 The cfree function considered obsolete.
 It is available from the compatibility library, libcompat.
 
 (i.e. cc test.c -lcompat)
 
 -- 
 Chris D. Faulhaber - jedgar@fxp.org - jedgar@FreeBSD.org
 --------------------------------------------------------
 FreeBSD: The Power To Serve   -   http://www.FreeBSD.org
 

From: Mike Meyer <mwm@mired.org>
To: Chris Faulhaber <jedgar@fxp.org>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/22675: Function is gone, but the man page lingers on
Date: Tue, 7 Nov 2000 19:29:51 -0600 (CST)

 Chris Faulhaber <jedgar@fxp.org> types:
 > On Wed, Nov 08, 2000 at 01:17:46AM -0000, mwm@mired.org wrote:
 > > 
 > > >Number:         22675
 > > >Category:       docs
 > > >Synopsis:       Function is gone, but the man page lingers on
 > > 
 > > >How-To-Repeat:
 > > 
 > > bash-2.04$ cc test.c
 > > test.c: In function `main':
 > > test.c:2: `NULL' undeclared (first use in this function)
 > > test.c:2: (Each undeclared identifier is reported only once
 > > test.c:2: for each function it appears in.)
 > > 
 > > whereas using free() instead of cfree() works.
 > > 
 > 
 > How about following the man pages instructions:
 > 
 > The cfree function considered obsolete.
 > It is available from the compatibility library, libcompat.
 > (i.e. cc test.c -lcompat)
 
 That would be a fine solution by me. I assumed no library was needed
 because such are normally documented.
 
 	Thanx,
 	<mike
 

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: Mike Meyer <mwm@mired.org>
Cc: Chris Faulhaber <jedgar@fxp.org>,
	freebsd-gnats-submit@freebsd.org
Subject: Re: docs/22675: Function is gone, but the man page lingers on 
Date: Wed, 08 Nov 2000 14:17:14 +0200

 On Tue, 07 Nov 2000 19:51:38 CST, Mike Meyer wrote:
 
 > In which case, I missed it and you can just close the pr. Though I
 > think adding the -lcompat line would still be a good idea.
 
 I think this manpage just needs the new .Lb macro.
 
 Ciao,
 Sheldon.
 

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: freebsd-gnats-submit@freebsd.org
Cc:  
Subject: Re: docs/22675: Function is gone, but the man page lingers on 
Date: Mon, 20 Nov 2000 17:09:11 +0200

 On Tue, 14 Nov 2000 13:42:41 +0200, Alexey Zelkin wrote:
 
 > On Mon, Nov 13, 2000 at 09:26:58AM +0200, Sheldon Hearn wrote:
 > > 
 > > Alexey, is there anything stopping us from adding an Lb macro for
 > > libcompat?
 >
 > Nothing. Go for it.
 
 Okay, so we have a libcompat entry for the Lb macro.  So do we go
 apeshit and smack up all the libcompat manual pages? :-)
 
 Is there anyone else with more time on hand to do this?  I'm _really_
 pressured for time. :-(
 
 Ciao,
 Sheldon.
 
State-Changed-From-To: open->closed 
State-Changed-By: ben 
State-Changed-When: Tue Nov 21 13:33:41 GMT 2000 
State-Changed-Why:  
Manual page fixed to use the .Lb macro. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=22675 
>Unformatted:
