>Number:         18231
>Category:       misc
>Synopsis:       ld.elf_so(1) should mention compilation with DEBUG
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sun Sep 08 03:26:01 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator:     Julio Merino
>Release:        NetBSD 1.6H
>Organization:
HispaBSD
>Environment:
	
	
System: NetBSD darkstar.local 1.6H NetBSD 1.6H (DARKSTAR) #12: Sun Sep 8 10:57:26 CEST 2002 jmmv@darkstar.local:/var/build/kernel/DARKSTAR i386
Architecture: i386
Machine: i386
>Description:
	The ld.so_elf(1) manpage talks about the environment variable
	LD_DEBUG. This variable is only recognized by ld.so_elf if it
	was compiled with debugging support (using -DDEBUG). The manpage
	should state this, as not everybody knows it.
>How-To-Repeat:
	Try:
	$ export LD_DEBUG=1
	$ <some shared binary here>
	with the default configuration. No debugging output is shown
	(and the user should know why).
>Fix:

Index: ld.elf_so.1
===================================================================
RCS file: /cvsroot/basesrc/libexec/ld.elf_so/ld.elf_so.1,v
retrieving revision 1.4
diff -u -r1.4 ld.elf_so.1
--- ld.elf_so.1	2002/02/08 01:30:08	1.4
+++ ld.elf_so.1	2002/09/08 10:23:30
@@ -164,7 +164,12 @@
 performed instead of the default lazy method.
 .It Ev LD_DEBUG
 If defined a variety of debug information will be written to the standard
-error of an dynamically linked executed when it is run.
+error of an dynamically linked executed when it is run. This variable is
+only recognized if
+.Nm
+was compiled with debugging support
+.Sy ( -DDEBUG ) .
+It is not available by default.
 .El
 .Sh FILES
 .Bl -tag -width /etc/ld.so.conf -compact
>Release-Note:
>Audit-Trail:
>Unformatted: