# ====================[ gentoo-local.conf                  ]====================
#                     [ Time-stamp: "2008-11-04 12:55:31 leycec" ]
#
# Configuration settings for the local repository having locally added ebuilds.
#
# --------------------( PACKAGE NAMING                     )--------------------
# The category name for a package is the top-level Portage path under which it
# resides. (The "scribus" package, for example, resides under the top-level
# Portage path, "app-office". Thus, "app-office" is Scribus' category.)
# 
# The "master_repository = gentoo" setting, below, insists this repository
# inherit its categories list (typically, a plaintext file residing in
# "${location}/profile/categories/" enumerating all categories for the
# repository) and packages list from the master repository (typically,
# "/usr/portage/").
#
# Consequently packages added to this repository must be placed under existing
# category and package names -- where 'existing', here, implies that those
# category and package names already exist in the master repository.
# Complicated? Yes; unfortunately, over-so.
#
# --------------------( PACKAGE ADDING                     )--------------------
# After placing a new package into some existing category and package name, as
# above, you must manually regenerate a cache of category and package names for
# this repository. This is:
#
#    # This is necessary, generally.
#    paludis --regenerate-installable-cache gentoo-local
#
#    # This should not be necessary -- but might be.
#    paludis --sync gentoo-local
#
# Lastly, if you note a "**" prefix in the "eix" output for that package, that
# implies that package has been "package-masked." (That is, that package is
# masked for all architectures.) I've found no better means of unmasking
# package-masked packages than manually editing their ebuilds, and providing a
# default:
#
#    KEYWORDS="~amd64 ~hppa ~ppc ~ppc64 ~sparc ~x86"
#
# This is not ideal, but suffices. (And, of course, you must regenerate your
# cache, as above, after doing this.)

# ....................{ SETTINGS                           }....................
location = ${ROOT}/usr/local/portage
master_repository = gentoo
format = ebuild