Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 131459 - usage of a concept that is previously undefined in the document -- FEATURES=nostrip
Summary: usage of a concept that is previously undefined in the document -- FEATURES=n...
Status: RESOLVED DUPLICATE of bug 128225
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Other documents (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Docs Team
URL: http://www.gentoo.org/doc/en/bugzilla...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-04-27 08:00 UTC by Matej Stepanek
Modified: 2006-04-27 08:52 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Matej Stepanek 2006-04-27 08:00:58 UTC
"One of the main things you must do in order to debug a program is to emerge the program with FEATURES=\"nostrip\""

It's not clear at this point how to emerge with FEATURES=nostrip. If it should be put into make.conf or into system variable or wherev

This is actually clarified further below in the example:

"Code Listing 2.4: Re-emergeing a package with debugging # FEATURES="nostrip" emerge package"

Refering to a concept first and defining it later, without pointing to the
definition at the place of referral, causes a confusion to the reader.
Therefore I suggest that one of the possible measures be taken:
1) add "(see Code Listing 2.4 below)" after "FEATURES=nostrip"
2) make the "FEATURES=nostrip" a clickable link that points to anchor that is at
Code Listing 2.4
3) make the "FEATURES=nostrip" a hyperlink that points to a document that
explains the FEATURES concept in it's entirety (I currently don't know if such
document exists)
4) like 3), but using "(see <hyperlink>)" appended after "FEATURES=nostrip"
instead of making the "FEATURES=nostrip" a hyperlink.
Comment 1 Jakub Moc (RETIRED) gentoo-dev 2006-04-27 08:52:05 UTC
You've already filed this once. Enough, thanks.

*** This bug has been marked as a duplicate of 128225 ***