Bug 144332 – devmanual: add documentation for the $ROOT variable

• Product: Documentation
• Status: RESOLVED FIXED

[Description Rajiv Aaron Manglani (RETIRED) 2006-08-18 09:34:21 UTC]

$ROOT needs to be documented in the dev handbook at
http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&chap=1

[Comment 1 Petteri Räty (RETIRED) 2007-02-16 21:59:54 UTC]

It is documented in devmanual:
http://devmanual.gentoo.org/ebuild-writing/variables/index.html
But the explanation should be more clear. See bug 167240 for example.

[Comment 2 Bryan Østergaard (RETIRED) 2007-02-16 22:21:24 UTC]

Let's try to keep technical documentation in devmanual instead of spread all over the developers handbook. I'll leave it to QA to decide if the current devmanual documentation needs to be expanded or if it's already sufficient.

[Comment 3 Vlastimil Babka (Caster) (RETIRED) 2007-06-19 18:05:43 UTC]

I agree it should be kept in devmanual, but extended. Also, has_version and built_with_use (see bug 145134) documentation should warn that it uses ROOT and one should take care to override it to ROOT=/ when used in src_*

[Comment 4 Thilo Bangert (RETIRED) (RETIRED) 2009-03-05 19:33:05 UTC]

Created attachment 184040 [details, diff]
add_section_about_root.patch

first draft. please comment!

[Comment 5 Markos Chandras (RETIRED) 2010-07-16 17:11:40 UTC]

(In reply to comment #4)
> Created an attachment (id=184040) [details]
> add_section_about_root.patch
> 
> first draft. please comment!
> 

I like this patch. I will commit it if there are no objections

[Comment 6 Leho Kraav (:macmaN @lkraav) 2011-11-21 21:55:59 UTC]

just browsing through $ROOT stuff, since running into bug 53629. can 14 months of silence here be considered as "there are no objections"?

[Comment 7 Leho Kraav (:macmaN @lkraav) 2011-11-21 21:56:52 UTC]

that was supposed to be bug 53269

[Comment 8 Tom Wijsman (TomWij) (RETIRED) 2014-01-07 12:29:56 UTC]

Ping, is the attached patch still correct for today's way of dealing with ROOT?

Seems fine to me; but being only around for a year, a second ack would be nice.

[Comment 9 Göktürk Yüksek 2016-05-05 15:29:00 UTC]

Reassigning this to devmanual

[Comment 10 Göktürk Yüksek 2016-05-18 06:59:58 UTC]

This is fixed in:
https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=d1a7be9d1bf8138fe3476a579ce0af004979c914

Thanks for the patch!