add header info and help

15 files changed, 134 insertions, 85 deletions

diff --git a/profiles/default/packages b/profiles/default/packages
index 2c79e0b46eb9..7c6b1d741be2 100644
--- a/profiles/default/packages
+++ b/profiles/default/packages
@@ -1,3 +1,7 @@
+# Copyright 2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /var/cvsroot/gentoo-x86/profiles/default/packages,v 1.101 2004/03/18 01:11:31 seemant Exp $
+
 # This file extends the base packages file for the default profile that all
 # architectures will enjoy.  Please note that default is what most architectures
 # will have.  Some will have an selinux profile (see ${PORTDIR}/profiles/selinux).
diff --git a/profiles/default/parent b/profiles/default/parent
index df967b96a579..7955f48b74a6 100644
--- a/profiles/default/parent
+++ b/profiles/default/parent
@@ -1 +1,8 @@
+# Copyright 2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /var/cvsroot/gentoo-x86/profiles/default/parent,v 1.2 2004/03/18 01:11:32 seemant Exp $
+
+# This file describes the parent profile to this.  In most cases this will
+# just be the name of the parent directory
+
 base
diff --git a/profiles/default/use.mask b/profiles/default/use.mask
index 09e5402b74b1..51fb011250fe 100644
--- a/profiles/default/use.mask
+++ b/profiles/default/use.mask
@@ -1,3 +1,7 @@
+# Copyright 2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /var/cvsroot/gentoo-x86/profiles/default/use.mask,v 1.3 2004/03/18 01:11:32 seemant Exp $
+
 # This file masks out USE flags that are simply NOT allowed in the default
 # profile for any architecture.  This works, for example, if a non-default
 # profile (such as the selinux profiles) have a USE flag associated with
diff --git a/profiles/default/virtuals b/profiles/default/virtuals
index 649a87831277..b7e6d0677672 100644
--- a/profiles/default/virtuals
+++ b/profiles/default/virtuals
@@ -1,3 +1,10 @@
+# Copyright 2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /var/cvsroot/gentoo-x86/profiles/default/virtuals,v 1.49 2004/03/18 01:11:32 seemant Exp $
+
+# Use this virtuals file to either overload the base profile's defined
+# virtuals, or add virtuals that are specific to this family of profiles
+
 virtual/dev-manager			sys-fs/devfsd
 virtual/kernel				sys-kernel/linux
 virtual/os-headers			sys-kernel/linux-headers
diff --git a/profiles/default/x86/1.0/make.defaults b/profiles/default/x86/1.0/make.defaults
index 53a88b25ac62..31087f354338 100644
--- a/profiles/default/x86/1.0/make.defaults
+++ b/profiles/default/x86/1.0/make.defaults
@@ -1,5 +1,8 @@
-# Copyright 2000 Daniel Robbins, Gentoo Technologies, Inc.
-# System-wide defaults for the Portage system
+# Copyright 2000 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /var/cvsroot/gentoo-x86/profiles/default/x86/1.0/make.defaults,v 1.3 2004/03/18 01:11:32 seemant Exp $
+
+# System-wide defaults for the Portage system (1.0)
 
 USE="x86 oss 3dnow apm arts avi berkdb crypt cups encode gdbm gif gpm gtk imlib
 java jpeg kde libg++ libwww mikmod mmx motif  mpeg ncurses nls
diff --git a/profiles/default/x86/1.0/packages b/profiles/default/x86/1.0/packages
index d52eabad837c..30284e281550 100644
--- a/profiles/default/x86/1.0/packages
+++ b/profiles/default/x86/1.0/packages
@@ -1,61 +1,37 @@
-# IMPORTANT: In order to parse this new format, you need Portage 1.6 or later!
+# Copyright 2001-2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /home/cvsroot/gentoo-x86/profiles/default/x86/2004.0/packages,v
+# 1.2 2004/03/18 00:16:43 seemant Exp $
 
-# OK; you're staring at this file and you have no idea what these stars are
-# for.  Here's the scoop.  An initial "*" marks a package that is part of the
-# official "base" system profile.  If there's a "*", then "emerge system" will
-# use the line in its calculations of what "should" be installed for this
-# profile.  Lines without a "*" prefix will be ignored for profile
-# calculations.
+# For instructions on how this file works (as an inclusion mask, primarily),
+# please refer to ${PORTDIR}/profiles/base/packages
 
-# Now, this is new: *all* lines (star or no star) will be used as a special
-# package *inclusion* mask.  For example, the line *=sys-devel/gcc-2.95.3-r1
-# will cause Portage to totally ignore all gcc ebuilds other than
-# gcc-2.95.3-r1.  >=, <=, <, > and ~ can be used to offer a bit more
-# flexibility.  For example, >=sys-libs/glibc-2.2.4 will cause emerge to ignore
-# all glibc ebuilds with a version less than 2.2.4.  This allows us to have
-# profile-specific package.mask settings.  *All* lines are used for this
-# masking process, whether they are prefixed with a * or not.  And if a generic
-# dep is used, like "sys-apps/foo", then all versions of foo are included.  If
-# there is no entry, then all versions of an app are included.  The key thing
-# to note is that this file does not need to end up being an exhaustive list
-# of portage packages; just the ones critical to this profile.
+# Use this file to lock down specific versions of packages ONLY TO THIS
+# SPECIFIC PROFILE!
 
-# So, what happens to /usr/portage/profiles/package.mask?  It's still around,
-# and still useful.  But it should mainly be used for broken ebuilds only.
-# package.mask continues to function as normal, masking out ebuilds from *all*
-# system profiles.
+# You can also add files to the base system itself if you prefix them with a
+# *
 
-# Which to use?  Use the profile-specific stuff to "lock down" specific
-# versions of ebuilds.  Gentoo Linux 1.0_rc6 uses certain known-compatible
-# versions of binutils, gcc and glibc, so we lock them down here.  This
-# prevents the user from shooting himself/herself in the foot by installing a
-# wacky version.
 
-#does not build with gcc-2.x
-<media-video/transcode-0.6.12
-sys-fs/ntfsprogs
-<app-arch/rar-3.2.0
-<dev-util/ddd-3.3.6
-
-*=sys-devel/gcc-2.95.3-r8
-*~sys-libs/glibc-2.2.5
-
->=x11-base/xfree-4.1.0-r2
+=sys-devel/gcc-2.95.3-r8
+~sys-libs/glibc-2.2.5
 
 # sash - static shell for system recovery
-*app-shells/sash
 
-*<sys-apps/shadow-5
-*>=sys-apps/texinfo-4.2-r1
-*>=sys-devel/automake-1.6.1-r5
-*>=sys-devel/libtool-1.4.1-r4
-*<sys-libs/readline-4.2 
+>=sys-apps/texinfo-4.2-r1
+>=sys-devel/automake-1.6.1-r5
+<sys-libs/readline-4.2 
 
 #these ones have the new rc6 style init scripts
 >=sys-libs/gpm-1.19.3-r5
 >=sys-apps/isapnptools-1.23-r6
 
-*>=sys-fs/devfsd-1.3.20
+#does not build with gcc-2.x
+<media-video/transcode-0.6.12
+sys-fs/ntfsprogs
+<app-arch/rar-3.2.0
+<dev-util/ddd-3.3.6
+
 >=sys-apps/xinetd-2.3.3-r6
 >=net-fs/samba-2.2.2-r6
 >=sys-apps/at-3.1.8-r6
diff --git a/profiles/default/x86/1.0/packages.build b/profiles/default/x86/1.0/packages.build
index e69de29bb2d1..66b2d7a94123 100644
--- a/profiles/default/x86/1.0/packages.build
+++ b/profiles/default/x86/1.0/packages.build
@@ -0,0 +1,7 @@
+# Copyright 2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /var/cvsroot/gentoo-x86/profiles/default/x86/1.0/packages.build,v 1.2 2004/03/18 01:11:32 seemant Exp $
+
+# This file inherits from the parent profiles as well.  The packages listed
+# in this file enumerate those which are needed to build a stage 1 based on
+# this profile.
diff --git a/profiles/default/x86/1.0/use.defaults b/profiles/default/x86/1.0/use.defaults
index 26869081edb8..cf836fa6b656 100644
--- a/profiles/default/x86/1.0/use.defaults
+++ b/profiles/default/x86/1.0/use.defaults
@@ -1 +1,14 @@
+# Copyright 2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /var/cvsroot/gentoo-x86/profiles/default/x86/1.0/use.defaults,v 1.2 2004/03/18 01:11:32 seemant Exp $
+
+# Use this file to override specific mappings indicating which package
+# satisfies a particular USE flag.  The base profile (in
+# ${PORTDIR}/profiles/base/use.defaults) will already describe those
+# mappings which apply to absolutely all architectures.  This file is used
+# to describe mappings which are unique to THIS SPECIFIC PROFILE ONLY.
+# Note, that these mappings extend the parent profiles' (its own parent,
+# grandparent, and so on up to the base profile).  However, mappings that
+# are present in the parents can be overridden in this file.
+
 gnome-libs	gnome-base/gnome-libs
diff --git a/profiles/default/x86/1.0/virtuals b/profiles/default/x86/1.0/virtuals
index 3b06e708a2a0..e0e2e1573b83 100644
--- a/profiles/default/x86/1.0/virtuals
+++ b/profiles/default/x86/1.0/virtuals
@@ -1,4 +1,7 @@
-virtual/linux-sources				sys-kernel/gentoo-sources
-virtual/xemacs						app-editors/xemacs
-virtual/winkernel					sys-kernel/win4lin-sources
-virtual/wine						app-emulation/wine
+# Copyright 2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /var/cvsroot/gentoo-x86/profiles/default/x86/1.0/virtuals,v 1.2 2004/03/18 01:11:32 seemant Exp $
+
+
+# Use this virtuals file to override or add virtuals that are specific ONLY
+# TO THIS PROFILE!
diff --git a/profiles/default/x86/packages b/profiles/default/x86/packages
index 63c0506a67cb..a23e2fe56fcb 100644
--- a/profiles/default/x86/packages
+++ b/profiles/default/x86/packages
@@ -1,41 +1,22 @@
-# IMPORTANT: In order to parse this new format, you need Portage 1.6 or later!
+# Copyright 2001-2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /home/cvsroot/gentoo-x86/profiles/default/x86/2004.0/packages,v
+# 1.2 2004/03/18 00:16:43 seemant Exp $
 
-# OK; you're staring at this file and you have no idea what these stars are
-# for.  Here's the scoop.  An initial "*" marks a package that is part of the
-# official "base" system profile.  If there's a "*", then "emerge system" will
-# use the line in its calculations of what "should" be installed for this
-# profile.  Lines without a "*" prefix will be ignored for profile
-# calculations.
+# For instructions on how this file works (as an inclusion mask, primarily),
+# please refer to ${PORTDIR}/profiles/base/packages
 
-# Now, this is new: *all* lines (star or no star) will be used as a special
-# package *inclusion* mask.  For example, the line *=sys-devel/gcc-2.95.3-r1
-# will cause Portage to totally ignore all gcc ebuilds other than
-# gcc-2.95.3-r1.  >=, <=, <, > and ~ can be used to offer a bit more
-# flexibility.  For example, >=sys-libs/glibc-2.2.4 will cause emerge to ignore
-# all glibc ebuilds with a version less than 2.2.4.  This allows us to have
-# profile-specific package.mask settings.  *All* lines are used for this
-# masking process, whether they are prefixed with a * or not.  And if a generic
-# dep is used, like "sys-apps/foo", then all versions of foo are included.  If
-# there is no entry, then all versions of an app are included.  The key thing
-# to note is that this file does not need to end up being an exhaustive list
-# of portage packages; just the ones critical to this profile.
+# Use this file to lock down specific versions of packages ONLY TO THIS
+# SPECIFIC ARCHITECTURE!!
 
-# So, what happens to /usr/portage/profiles/package.mask?  It's still around,
-# and still useful.  But it should mainly be used for broken ebuilds only.
-# package.mask continues to function as normal, masking out ebuilds from *all*
-# system profiles.
+# You can also add files to the base system itself if you prefix them with a
+# *
 
-# Which to use?  Use the profile-specific stuff to "lock down" specific
-# versions of ebuilds.  Gentoo Linux 1.0_rc6 uses certain known-compatible
-# versions of binutils, gcc and glibc, so we lock them down here.  This
-# prevents the user from shooting himself/herself in the foot by installing a
-# wacky version.
-
-*>=sys-devel/binutils-2.13.90.0.4
-
->=x11-base/xfree-4.1.0-r2
 
 *sys-devel/bin86
-*>=sys-devel/libtool-1.4.1-r4
 *sys-libs/pwdb
-*sys-fs/devfsd
+
+>=sys-devel/binutils-2.13.90.0.4
+>=sys-devel/libtool-1.4.1-r4
+<sys-apps/shadow-5
+>=x11-base/xfree-4.1.0-r2
diff --git a/profiles/default/x86/packages.build b/profiles/default/x86/packages.build
index 76f3abc1223d..542e295091f2 100644
--- a/profiles/default/x86/packages.build
+++ b/profiles/default/x86/packages.build
@@ -1,3 +1,10 @@
+# Copyright 2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /var/cvsroot/gentoo-x86/profiles/default/x86/packages.build,v 1.2 2004/03/18 01:11:32 seemant Exp $
+
+# This file describes the packages needed to build a stage 1 based on this
+# profile
+
 app-arch/bzip2
 app-arch/gzip
 app-arch/tar
diff --git a/profiles/default/x86/parent b/profiles/default/x86/parent
index 4ad96d51599f..f0c62c60091b 100644
--- a/profiles/default/x86/parent
+++ b/profiles/default/x86/parent
@@ -1 +1,9 @@
+# Copyright 2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /home/cvsroot/gentoo-x86/profiles/default/x86/2004.0/parent,v 1.2
+# 2004/03/18 00:16:43 seemant Exp $
+
+# This file describes the parent profile to this.  In most cases this will
+# just be the name of the parent directory
+
 default
diff --git a/profiles/default/x86/use.defaults b/profiles/default/x86/use.defaults
index e69de29bb2d1..cf5241f5b7b4 100644
--- a/profiles/default/x86/use.defaults
+++ b/profiles/default/x86/use.defaults
@@ -0,0 +1,12 @@
+# Copyright 2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /var/cvsroot/gentoo-x86/profiles/default/x86/use.defaults,v 1.2 2004/03/18 01:11:32 seemant Exp $
+
+# Use this file to override specific mappings indicating which package
+# satisfies a particular USE flag.  The base profile (in
+# ${PORTDIR}/profiles/base/use.defaults) will already describe those
+# mappings which apply to absolutely all architectures.  This file is used
+# to describe mappings which are unique to THIS SPECIFIC PROFILE ONLY.
+# Note, that these mappings extend the parent profiles' (its own parent,
+# grandparent, and so on up to the base profile).  However, mappings that
+# are present in the parents can be overridden in this file.
diff --git a/profiles/default/x86/use.mask b/profiles/default/x86/use.mask
index e69de29bb2d1..1a5abbdfbbfe 100644
--- a/profiles/default/x86/use.mask
+++ b/profiles/default/x86/use.mask
@@ -0,0 +1,9 @@
+# Copyright 2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /var/cvsroot/gentoo-x86/profiles/default/x86/use.mask,v 1.2 2004/03/18 01:11:32 seemant Exp $
+
+# This file masks out USE flags that are simply NOT allowed in the default
+# profile for any architecture.  This works, for example, if a non-default
+# profile (such as the selinux profiles) have a USE flag associated with
+# them.
+
diff --git a/profiles/default/x86/virtuals b/profiles/default/x86/virtuals
index 9d0c46eca877..fb09d16ed7c8 100644
--- a/profiles/default/x86/virtuals
+++ b/profiles/default/x86/virtuals
@@ -1,2 +1,10 @@
+# Copyright 2004 Gentoo Technologies, Inc.
+# Distributed under the terms of the GNU General Public License, v2
+# $Header: /var/cvsroot/gentoo-x86/profiles/default/x86/virtuals,v 1.3 2004/03/18 01:11:32 seemant Exp $
+
+# This file is used to either override or extend the parent profile's
+# virtuals mappings.   In this case, this is for ARCHITECTURE SPECIFIC
+# mappings
+
 virtual/bootloader			sys-boot/grub
 virtual/linux-sources		sys-kernel/gentoo-sources