From CQG00620@nifty.ne.jp  Sun May 23 05:57:05 2004
Return-Path: <CQG00620@nifty.ne.jp>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id B91DB16A4EC
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 23 May 2004 05:57:05 -0700 (PDT)
Received: from mail504.nifty.com (mail504.nifty.com [202.248.37.212])
	by mx1.FreeBSD.org (Postfix) with ESMTP id C885443D1F
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 23 May 2004 05:57:04 -0700 (PDT)
	(envelope-from CQG00620@nifty.ne.jp)
Received: from nifty.ne.jp (ntceast045205.east.dup.ppp.infoweb.ne.jp [220.219.9.205])by mail504.nifty.com with ESMTP id i4NCugJI001821
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 23 May 2004 21:56:43 +0900
Message-Id: <200405231256.i4NCugJI001821@mail504.nifty.com>
Date: Sun, 23 May 2004 21:58:41 +0900
From: Watanabe Kazuhiro <CQG00620@nifty.ne.jp>
Reply-To: Watanabe Kazuhiro <CQG00620@nifty.ne.jp>
To: FreeBSD-gnats-submit@freebsd.org
Subject: [patch] MFC of a rtld(1) man page is incomplete.

>Number:         67078
>Category:       docs
>Synopsis:       [patch] MFC of a rtld(1) man page is incomplete.
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun May 23 06:00:42 PDT 2004
>Closed-Date:    Wed Aug 30 10:27:53 GMT 2006
>Last-Modified:  Wed Aug 30 10:27:53 GMT 2006
>Originator:     Watanabe Kazuhiro
>Release:        FreeBSD 5.2.1-RELEASE-p5 i386
>Organization:
>Environment:
System: FreeBSD pisces.zodiac.org 5.2.1-RELEASE-p5 FreeBSD 5.2.1-RELEASE-p5 #2: Fri May 21 23:57:29 JST 2004 nabe@pisces.zodiac.org:/opt/obj/usr/src/sys/VASH i386

>Description:
In a rtld(1) man page (revision 1.18.2.8, CVS tag is RELENG_4_10_BP),
there is a mistake of MFC.

>How-To-Repeat:
Run "man rtld" on FreeBSD 4.10-RC3.

| LD_PRELOAD       A list of shared libraries, separated by colons and/or
|                  white space, to be linked in before any other shared
|                  libraries.  If the directory is not specified then the
|                  directories specified by
| 
| LD_LIBMAP_DISABLE
|                  If set, disables the use of libmap.conf(5).
|                  LD_LIBRARY_PATH will be searched first followed by the
|                  set of built-in standard directories.  This is ignored
|                  for set-user-ID and set-group-ID programs.

>Fix:
--- rtld.1.orig	Sun May 23 18:44:45 2004
+++ rtld.1	Sun May 23 18:45:39 2004
@@ -88,13 +88,13 @@
 other shared libraries.
 If the directory is not specified then
 the directories specified by
-.It Ev LD_LIBMAP_DISABLE
-If set, disables the use of
-.Xr libmap.conf 5 .
 .Ev LD_LIBRARY_PATH
 will be searched first
 followed by the set of built-in standard directories.
 This is ignored for set-user-ID and set-group-ID programs.
+.It Ev LD_LIBMAP_DISABLE
+If set, disables the use of
+.Xr libmap.conf 5 .
 .It Ev LD_BIND_NOW
 When set to a nonempty string, causes
 .Nm
>Release-Note:
>Audit-Trail:

From: George Keramidas <keramida@ceid.upatras.gr>
To: Watanabe Kazuhiro <CQG00620@nifty.ne.jp>
Cc: bug-followup@freebsd.org
Subject: Re: docs/67078: [patch] MFC of a rtld(1) man page is incomplete.
Date: Tue, 8 Jun 2004 12:17:36 +0300

 Shouldn't LD_LIBRARY_PATH be indented with .It too below?
 
 > --- rtld.1.orig	Sun May 23 18:44:45 2004
 > +++ rtld.1	Sun May 23 18:45:39 2004
 > @@ -88,13 +88,13 @@
 >  other shared libraries.
 >  If the directory is not specified then
 >  the directories specified by
 > -.It Ev LD_LIBMAP_DISABLE
 > -If set, disables the use of
 > -.Xr libmap.conf 5 .
 >  .Ev LD_LIBRARY_PATH
 >  will be searched first
 >  followed by the set of built-in standard directories.
 >  This is ignored for set-user-ID and set-group-ID programs.
 > +.It Ev LD_LIBMAP_DISABLE
 > +If set, disables the use of
 > +.Xr libmap.conf 5 .
 >  .It Ev LD_BIND_NOW
 >  When set to a nonempty string, causes
 >  .Nm
 
 By looking at the rest of the .Ev entries, I think the correct change
 would just add an .It before ".Ev LD_LIBRARY_PATH".  The LD_xxx
 environment vars seems to be alphabetically sorted, so moving
 LD_LIBMAP_DISABLE *after* LD_LIBRARY_PATH would break the sorting.
 
 - Giorgos
 

From: Watanabe Kazuhiro <CQG00620@nifty.ne.jp>
To: bug-followup@freebsd.org
Cc: George Keramidas <keramida@ceid.upatras.gr>
Subject: Re: docs/67078: [patch] MFC of a rtld(1) man page is incomplete.
Date: Wed, 09 Jun 2004 21:41:37 +0900

 At Tue, 8 Jun 2004 12:17:36 +0300,
 George Keramidas wrote:
 > Shouldn't LD_LIBRARY_PATH be indented with .It too below?
 (snip)
 > By looking at the rest of the .Ev entries, I think the correct change
 > would just add an .It before ".Ev LD_LIBRARY_PATH".
 
 I don't think so. Because in the -current's rtld(1) man page, this
 part is described as below:
 
 | .It Ev LD_PRELOAD
 | A list of shared libraries, separated by colons and/or white space,
 | to be linked in before any
 | other shared libraries.
 | If the directory is not specified then
 | the directories specified by
 | .Ev LD_LIBRARY_PATH
 | will be searched first
 | followed by the set of built-in standard directories.
 | This is ignored for set-user-ID and set-group-ID programs.
 
 
 > The LD_xxx
 > environment vars seems to be alphabetically sorted, so moving
 > LD_LIBMAP_DISABLE *after* LD_LIBRARY_PATH would break the sorting.
 
 If we adjust the man page to the -current's one, LD_LIBMAP_DISABLE
 should be placed before LD_PRELOAD (and my patch is wrong).
 ---
 Watanabe Kazuhiro (CQG00620@nifty.ne.jp)
State-Changed-From-To: open->closed 
State-Changed-By: remko 
State-Changed-When: Wed Aug 30 10:26:12 UTC 2006 
State-Changed-Why:  
~ And now the end is near.  closed the PR with the argumentation 
of niclas (which i do support since our main scope is 5.X,6.X at the 
moment): 

I think pr docs/67078 can be closed. The pr mentions a MFC from Freebsd 5.2.1 
to FreeBSD 4.10-RC3 which has gone slightly wrong. Since RELENG_4 is pretty 
much at the end of things, and the change is already in all branches from 
RELENG_5, I think the issue is no more. 

Reported by:	Niclas Zeising on freebsd-doc 

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