From d5c070d8f1e3f877cd3c4ff94aea64e5541f9cf7 Mon Sep 17 00:00:00 2001
From: Zac Medico <zmedico@gentoo.org>
Date: Fri, 11 Aug 2006 20:08:02 +0000
Subject: [PATCH] Add some docs for use.force and package.use.force.

svn path=/main/trunk/; revision=4215
---
 man/portage.5 | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/man/portage.5 b/man/portage.5
index 3aca18c38..0a57c971d 100644
--- a/man/portage.5
+++ b/man/portage.5
@@ -28,10 +28,12 @@ make.defaults
 packages
 packages.build
 package.provided
+package.use.force
 package.use.mask
 parent
 profile.bashrc
 use.defaults
+use.force
 use.mask
 virtuals
 .fi
@@ -225,6 +227,28 @@ x11-libs/qt-3.3.0
 x11-base/xorg-x11-6.8
 .fi
 .TP
+.BR package.use.force
+Per\-package USE flag forcing.
+
+.I Note:
+In a cascading profile setup, you can remove USE flags in children 
+profiles which were added by parent profiles by prefixing the flag with 
+a '\-'.
+
+.I Format:
+.nf
+\- comments begin with #
+\- one DEPEND atom per line with space-delimited USE flags
+.fi
+
+.I Example:
+.nf
+# force docs for GTK 2.x
+=x11\-libs/gtk+\-2* doc
+# unforce mysql support for QT
+x11\-libs/qt \-mysql
+.fi
+.TP
 .BR package.use.mask
 Per\-package USE flag masks.
 
@@ -284,6 +308,21 @@ sdl        media\-libs/libsdl
 tcltk      dev\-lang/tcl   dev\-lang/tk
 .fi
 .TP
+.BR use.force
+Some USE flags don't make sense to disable under certain conditions.  Here we
+list forced flags.
+
+.I Note:
+In a cascading profile setup, you can remove USE flags in children 
+profiles which were added by parent profiles by prefixing the flag with 
+a '\-'.
+
+.I Format:
+.nf
+\- comments begin with #
+\- one USE flag per line
+.fi
+.TP
 .BR use.mask
 Some USE flags don't make sense on some archs (for example altivec on 
 non\-ppc or mmx on non\-x86), or haven't yet been tested.  Here we list 
-- 
2.26.2