Received: (qmail 33102 invoked by uid 501); 6 Feb 2002 00:28:24 -0000
Message-Id: <20020206002824.33101.qmail@apache.org>
Date: 6 Feb 2002 00:28:24 -0000
From: Walter Gonzalez <waldo@playstation.sony.com>
Reply-To: waldo@playstation.sony.com
To: submit@bugz.apache.org
Subject: Better support for debugging , do not use EXTRA_CFLAGS internally
X-Send-Pr-Version: 3.110

>Number:         9729
>Category:       build
>Synopsis:       Better support for debugging , do not use EXTRA_CFLAGS internally
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    apache
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          sw-bug
>Submitter-Id:   apache
>Arrival-Date:   Tue Feb 05 16:30:00 PST 2002
>Closed-Date:    Wed Feb 06 07:23:59 PST 2002
>Last-Modified:  Wed Feb 06 07:23:59 PST 2002
>Originator:     waldo@playstation.sony.com
>Release:        
>Organization:
>Environment:
Solaris SunOS 5.8
>Description:
Your debugging guide (http://httpd.apache.org/dev/debugging.html) 
suggests adding the -g flag with EXTRA_CFLAGS . 

However at the toplevel dir (ie: apache_1.3.23) doing the command: 

% make EXTRA_CFLAGS=" -g"

Causes the build under src/main to not use apaci and possibly use the 
wrong HTTPD_ROOT path. This is because src/main/Makefile has the line: 

EXTRA_CFLAGS =`$(SRCDIR)/apaci`

Hence (properly) adding a debug flag is not quite as simple as the 
debugging doc suggests.


>How-To-Repeat:


cd apache_1.3.23
./configure --prefix=/usr/foobar
make EXTRA_CFLAGS=" -g" 
./src/httpd -V 

<observe how the prefix didn't make it into the linked server binary> 
>Fix:

The documentation should probably be either updated to say: 

"Add the -g flag to EXTRA_CFLAGS in  apache_1.3.23/src/Configuration *before*
running apache_1.3.23/configure , to ensure all Makefiles are generated properly. " 

And/Or do *not* use EXTRA_CFLAGS internally and instead set apaci in another internal makefile variable. Reserving the EXTRA_* variable defines for user customization.

I would really suggest doing both, because there will be users like me that
may assume it's safe to redefine the EXTRA_*  variables on the fly. 


[And... Thankyou for all your efforts!]
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open-closed
State-Changed-By: slive
State-Changed-When: Wed Feb  6 07:23:59 PST 2002
State-Changed-Why:

Actually, if you are using apaci, I believe the INSTALL
file tells you the correct way to do it:

CFLAGS="-g" ./configure ...
make

Of course, I agree this is not too well documented.
But things are changing completely in 2.0 to an 
autoconf based system.  I hope that will be more
consistent with user expectations.

Thanks for using Apache!

>Unformatted:
 [In order for any reply to be added to the PR database, you need]
 [to include <apbugs@Apache.Org> in the Cc line and make sure the]
 [subject line starts with the report component and number, with ]
 [or without any 'Re:' prefixes (such as "general/1098:" or      ]
 ["Re: general/1098:").  If the subject doesn't match this       ]
 [pattern, your message will be misfiled and ignored.  The       ]
 ["apbugs" address is not added to the Cc line of messages from  ]
 [the database automatically because of the potential for mail   ]
 [loops.  If you do not include this Cc, your reply may be ig-   ]
 [nored unless you are responding to an explicit request from a  ]
 [developer.  Reply only with text; DO NOT SEND ATTACHMENTS!     ]