Date: Wed, 22 Jun 2005 02:51:01 GMT From: Vlad Skvortsov <vss@high.net.ru> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/82508: misleading man page for basename/dirname Message-ID: <200506220251.j5M2p1UX022891@www.freebsd.org> Resent-Message-ID: <200506220300.j5M30eug043970@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 82508 >Category: docs >Synopsis: misleading man page for basename/dirname >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Jun 22 03:00:39 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Vlad Skvortsov >Release: 5.2.1 >Organization: Netli, Inc. >Environment: FreeBSD vlad.hq.netli.lan 5.2.1-RELEASE FreeBSD 5.2.1-RELEASE #0: Sat May 22 11:32:00 PDT 2004 root@vlad.hq.netli.lan:/usr/obj/usr/src/sys/VLAD i386 >Description: The man pages for both basename(3) and dirname(3) state that the functions return pointers to the internal _static_ storage. However, those functions actually perform malloc() call to allocate storage on the first invocation. Thus, the memory pointer returned is actually a pointer to internal but dynamically allocated storage. I don't know whether this violates standard or not, but the documentation is misleading. >How-To-Repeat: Not applicable. >Fix: Fix the docs. >Release-Note: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200506220251.j5M2p1UX022891>