Bug 131459

Summary:	usage of a concept that is previously undefined in the document -- FEATURES=nostrip
Product:	[OLD] Docs on www.gentoo.org	Reporter:	Matej Stepanek <dito2>
Component:	Other documents	Assignee:	Docs Team <docs-team>
Status:	RESOLVED DUPLICATE
Severity:	normal
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
URL:	http://www.gentoo.org/doc/en/bugzilla-howto.xml
Whiteboard:
Package list:		Runtime testing required:	---

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 ***