From owner-freebsd-doc@FreeBSD.ORG  Tue Jun 28 11:40:10 2011
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 6A14B106564A
	for <freebsd-doc@hub.freebsd.org>; Tue, 28 Jun 2011 11:40:10 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id 2F39A8FC1F
	for <freebsd-doc@hub.freebsd.org>; Tue, 28 Jun 2011 11:40:10 +0000 (UTC)
Received: from freefall.freebsd.org (localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id p5SBe6KG067585
	for <freebsd-doc@freefall.freebsd.org>; Tue, 28 Jun 2011 11:40:06 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.4/8.14.4/Submit) id p5SBe6L4067584;
	Tue, 28 Jun 2011 11:40:06 GMT (envelope-from gnats)
Resent-Date: Tue, 28 Jun 2011 11:40:06 GMT
Resent-Message-Id: <201106281140.p5SBe6L4067584@freefall.freebsd.org>
Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer)
Resent-To: freebsd-doc@FreeBSD.org
Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org,
	Greg Becker <greg@codeconcepts.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 8724A1065673
	for <freebsd-gnats-submit@FreeBSD.org>;
	Tue, 28 Jun 2011 11:31:29 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 77F0F8FC13
	for <freebsd-gnats-submit@FreeBSD.org>;
	Tue, 28 Jun 2011 11:31:29 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p5SBVTYi031614
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 28 Jun 2011 11:31:29 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id p5SBVTkh031613;
	Tue, 28 Jun 2011 11:31:29 GMT (envelope-from nobody)
Message-Id: <201106281131.p5SBVTkh031613@red.freebsd.org>
Date: Tue, 28 Jun 2011 11:31:29 GMT
From: Greg Becker <greg@codeconcepts.com>
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-3.1
Cc: 
Subject: docs/158387: The tree(3) man should mention the RB_FOREACH_SAFE()
	API...
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 28 Jun 2011 11:40:10 -0000


>Number:         158387
>Category:       docs
>Synopsis:       The tree(3) man should mention the RB_FOREACH_SAFE() API...
>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:   Tue Jun 28 11:40:05 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Greg Becker
>Release:        8.2
>Organization:
CodeConcepts
>Environment:
FreeBSD gromit.codeconcepts.com 8.2-STABLE FreeBSD 8.2-STABLE #0: Sun Jun  5 05:09:04 CDT 2011     root@gromit.codeconcepts.com:/build/obj/usr/src/sys/GROMIT  amd64

>Description:
The tree(2) man page mentions neither the RB_FOREACH_SAFE() nor the RB_FOREACH_REVERSE_SAFE(), yet they are clearly included in /usr/include/sys/tree.h.  Not a problem for anyone familiar with the API, but useful to those reading man pages to understand the scope its scope and capabilities.  Also, good for completeness :-)

>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
>Unformatted: