[gentoo-catalyst] documentation

[William Kilian]

I went through the threads thus far and pulled out what I think should be added to the online documentation. I don't know the proper way to add it to the documention. It's all written by John Davis, Chris Gianelloni, or me. I edited a little.

FAQs:
-----
Where do I put per-package use flags, mask settings, etc.?

Catalyst supports the configuration files in /etc/portage. Just add the
following to your spec file.

portage_confdir: /path/to/custom/etc/portage

Note that you need to use the same portage_confdir for your seed stages.
--
Should I really build my own stage1 or just use stage1s from gentoo mirrors?

Just use the stage1 from the mirrors, unless you use
--
How do I keep a GRP updated?

To keep your GRP updated, all that you will have to do is regenerate
your snapshot and rebuild the GRP set. Catalyst will take care of the
upgrades automatically by only rebuilding the packages that have been
upgraded.
--

Refererence:
------------
Options clst_storedir and clst_sharedir go in catalyst.conf.
--
Don't use a symlink for your portage_confdir.
--
For grp, tinderbox, and livecd targets, the target/use setting uses normal portage USE syntax.
--
Your seed stage should never have anything in /etc/portage, at all.  If
you are using a portage_confdir for one target, then you will need it
for them all (unless it doesn't apply).  For example, if you make a
change to glibc in your portage_confdir, then you must use the same
portage_confdir throughout the entire build process, or glibc will be
rebuilt in a later target when emerge --newuse is called.  Everything
must be consistent across all targets, otherwise the latest target's
environment takes precedence.

The seed is basically devoid of portage configuration data because it 
shouldn't have an /etc/portage or a /usr/portage/profiles and its 
make.conf (if any) is ignored. The spec file use flags during an 
applicable build are functionally equivalent to USE= in make.conf on a 
normal system. The profile information is provided by the snapshot and 
portage_confdir provides the information a normal system's /etc/portage 
directory would provide. The snapshot's profile, target/use, and 
portage_confdir are used the same way as portage on a normal system uses 
its profile, USE in make.conf, and portage_confdir.

--
gentoo-catalyst@g.o mailing list