Looking in the ports(7) man page, there does not appear to be any information
in there whatsoever that describes the accepted & official method whereby
any given port can be built and installed in such a way so that the
executable(s) and also the shared library/libraries that form the port
will be compiled with full debugging symbols AND so that this debug info
will NOT be stripped out of the components of the port as they are actually
being installed into the directories where they will ultimately live.
This makes no sense to me (and I consider it a bug), because the ports(7)
man page _does_ have what looks like complete information about any and
every possible ``standard'' port Makefile target. Given that, it seems
to me to be more than reasonable to expect this man page to also document
something as fundamental as how to build & install a port with debug symbols.
I would suggest some prose to add, but frankly, I am not 100% sure that I
know the Right Way to build & install with debugging symbols. (I think that
I know, but I could easily be wrong.)
man 7 ports
I think that we should just make the manpage a stub pointing to (in
/usr/ports) README, Mk/bsd.options.desc.mk and the comments in
The ports tree evolves so quickly that any man page written for it
will immediately be out of date and incorrect.
Anyone else agree?
If anything, set DEBUG in /etc/make.conf at a minimal. And after that is
written, and committed, a new method will exist :)
This should be closed.
Jason Helfman | FreeBSD Committer
jgh@FreeBSD.org | http://people.freebsd.org/~jgh | The Power to Serve
For bugs matching the following criteria:
Status: In Progress Changed: (is less than) 2014-06-01
Reset to default assignee and clear in-progress tags.
Mail being skipped