Add docs for /etc/portage/color.map and a few misc man page fixes. Thanks to Arfrever Frehtes Taifersar Arahesis <Arfrever.FTA@GMail.Com> in bug #183758. (trunk r7100)

svn path=/main/branches/2.1.2/; revision=7101

6 files changed, 125 insertions, 16 deletions

diff --git a/man/color.map.5 b/man/color.map.5
new file mode 100644
index 000000000..f76276100
--- /dev/null
+++ b/man/color.map.5
@@ -0,0 +1,89 @@
+.TH "COLOR.MAP" "5" "Jun 2007" "Portage 2.1.3" "Portage"
+.SH "NAME"
+color.map \- custom color settings for Portage
+.SH "SYNOPSIS"
+.B /etc/portage/color.map
+.SH "DESCRIPTION"
+This file contains variables that define color classes used by Portage.
+Portage will check this file first for color classes settings. If no setting
+of given color class is found in /etc/portage/color.map, Portage uses default
+value defined internally.
+.SH "VARIABLES"
+.TP
+\fBBAD\fR = \fI"0xFF5555"\fR
+Defines color used for some words occuring in bad context.
+.TP
+\fBBRACKET\fR = \fI"0x5555FF"\fR
+Defines color used for brackets.
+.TP
+\fBGOOD\fR = \fI"0x55FF55"\fR
+Defines color used for some words occuring in good context.
+.TP
+\fBHILITE\fR = \fI"0x00AAAA"\fR
+Defines color used for highlighted words.
+.TP
+\fBINFORM\fR = \fI"0x00AA00"\fR
+Defines color used for informational words.
+.TP
+\fBMERGE_LIST_PROGRESS\fR = \fI"0xFFFF55"\fR
+Defines color used for numbers used in merge progress lists.
+.TP
+\fBPKG_MERGE\fR = \fI"0x00AA00"\fR
+Defines color used for packages planned to be merged.
+.TP
+\fBPKG_MERGE_ARG\fR = \fI"0x00AA00"\fR
+Defines color used for packages planned to be merged and given as command line
+arguments.
+.TP
+\fBPKG_MERGE_SYSTEM\fR = \fI"0x55FF55"\fR
+Defines color used for packages planned to be merged and belonging to
+system set.
+.TP
+\fBPKG_MERGE_WORLD\fR = \fI"0x55FF55"\fR
+Defines color used for packages planned to be merged and belonging to
+world set.
+.TP
+\fBPKG_NOMERGE\fR = \fI"0x0000AA"\fR
+Defines color used for packages not planned to be merged.
+.TP
+\fBPKG_NOMERGE_ARG\fR = \fI"0x0000AA"\fR
+Defines color used for packages not planned to be merged and given as command
+line arguments.
+.TP
+\fBPKG_NOMERGE_SYSTEM\fR = \fI"0x5555FF"\fR
+Defines color used for packages not planned to be merged and belonging to
+system set.
+.TP
+\fBPKG_NOMERGE_WORLD\fR = \fI"0x5555FF"\fR
+Defines color used for packages not planned to be merged and belonging to
+world set.
+.TP
+\fBSECURITY_WARN\fR = \fI"0xFF5555"\fR
+Defines color used for security warnings.
+.TP
+\fBUNMERGE_WARN\fR = \fI"0xFF5555"\fR
+Defines color used for unmerge warnings.
+.TP
+\fBWARN\fR = \fI"0xFFFF55"\fR
+Defines color used for warnings.
+.SH "REPORTING BUGS"
+Please report bugs via http://bugs.gentoo.org/
+.SH "AUTHORS"
+.nf
+Arfrever Frehtes Taifersar Arahesis <Arfrever.FTA@gmail.com>
+.fi
+.SH "FILES"
+.TP
+.B /etc/portage/color.map
+Contains variables customizing colors.
+.TP
+.B /etc/make.conf
+Contains other variables.
+.SH "SEE ALSO"
+.BR make.conf (5),
+.BR portage (5),
+.BR emerge (1),
+.BR ebuild (1),
+.BR ebuild (5)
+.TP
+The \fI/usr/lib/portage/pym/portage/output.py\fR Python module.
diff --git a/man/ebuild.1 b/man/ebuild.1
index 226bdca2b..f9dd5b0e5 100644
--- a/man/ebuild.1
+++ b/man/ebuild.1
@@ -1,4 +1,4 @@
-.TH "EBUILD" "1" "Dec 2005" "Portage 2.1" "Portage"
+.TH "EBUILD" "1" "Jun 2007" "Portage 2.1.3" "Portage"
 .SH "NAME"
 ebuild \- a low level interface to the Portage system
 .SH "SYNOPSIS"
@@ -178,13 +178,17 @@ Mike Frysinger <vapier@gentoo.org>
 .fi
 .SH "FILES"
 .TP
-\fB/etc/make.conf\fR 
+.B /etc/make.conf 
 Contains variables for the build\-process and overwrites those
 in make.globals.
+.TP
+.B /etc/portage/color.map
+Contains variables customizing colors.
 .SH "SEE ALSO"
 .BR emerge (1),
 .BR ebuild (5),
-.BR make.conf (5)
+.BR make.conf (5),
+.BR color.map (5)
 .TP
 The \fI/usr/sbin/ebuild.sh\fR script. 
 .TP
diff --git a/man/ebuild.5 b/man/ebuild.5
index db9f1c8bf..03a02d585 100644
--- a/man/ebuild.5
+++ b/man/ebuild.5
@@ -1,4 +1,4 @@
-.TH "EBUILD" "5" "Jan 2007" "Portage 2.1.2" "Portage"
+.TH "EBUILD" "5" "Jun 2007" "Portage 2.1.3" "Portage"
 .SH "NAME"
 ebuild \- the internal format, variables, and functions in an ebuild script
 .SH "DESCRIPTION"
@@ -869,7 +869,7 @@ Achim Gottinger <achim@gentoo.org>
 Mark Guertin <gerk@gentoo.org>
 Nicholas Jones <carpaski@gentoo.org>
 Mike Frysinger <vapier@gentoo.org>
-Arfrever Frehtes Taifersar Arahesis <FFTA@WP.PL>
+Arfrever Frehtes Taifersar Arahesis <Arfrever.FTA@gmail.com>
 .fi
 .SH "FILES"
 .TP
@@ -877,12 +877,16 @@ The \fI/usr/sbin/ebuild.sh\fR script.
 .TP
 The helper apps in \fI/usr/lib/portage/bin\fR.
 .TP
-\fB/etc/make.conf\fR 
+.B /etc/make.conf
 Contains variables for the build\-process and overwrites those in make.defaults.
 .TP
-\fB/etc/make.globals\fR
+.B /etc/make.globals
 Contains the default variables for the build\-process, you should edit
 \fI/etc/make.conf\fR instead.
+.TP
+.B /etc/portage/color.map
+Contains variables customizing colors.
 .SH "SEE ALSO"
 .BR ebuild (1),
-.BR make.conf (5)
+.BR make.conf (5),
+.BR color.map (5)
diff --git a/man/emerge.1 b/man/emerge.1
index dd3cda1ae..ed38ed66e 100644
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -1,4 +1,4 @@
-.TH "EMERGE" "1" "Dec 2006" "Portage 2.1" "Portage"
+.TH "EMERGE" "1" "Jun 2007" "Portage 2.1.3" "Portage"
 .SH "NAME"
 emerge \- Command\-line interface to the Portage system
 .SH "SYNOPSIS"
@@ -578,6 +578,9 @@ Contains variables for the build process, overriding those in
 \fBmake.globals\fR.  \fBYou should edit this file instead of the ones
 listed below\fR.
 .TP
+.B /etc/portage/color.map
+Contains variables customizing colors.
+.TP
 .B /etc/dispatch\-conf.conf
 Contains settings to handle automatic updates/backups of configuration 
 files.
@@ -610,6 +613,7 @@ this file\fR.
 .BR ebuild (1),
 .BR ebuild (5),
 .BR make.conf (5),
+.BR color.map (5),
 .BR portage (5)
 .LP
 A number of helper applications reside in \fI/usr/lib/portage/bin\fR.
diff --git a/man/make.conf.5 b/man/make.conf.5
index c4df57adf..5af718690 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -1,4 +1,4 @@
-.TH "MAKE.CONF" "5" "Jan 2007" "Portage 2.1.2" "Portage"
+.TH "MAKE.CONF" "5" "Jun 2007" "Portage 2.1.3" "Portage"
 .SH "NAME"
 make.conf \- custom settings for Portage
 .SH "SYNOPSIS"
@@ -510,16 +510,19 @@ Saleem Abdulrasool <compnerd@gentoo.org>
 .fi
 .SH "FILES"
 .TP
-\fB/etc/make.conf\fR 
+.B /etc/make.conf
 Contains variables for the build\-process and overwrites those in make.defaults.
 .TP
-\fB/etc/make.globals\fR 
+.B /etc/make.globals
 Contains the default variables for the build\-process, you should edit \fI/etc/make.conf\fR instead.
 .TP
-\fB/usr/portage/profiles/use.desc\fR
+.B /etc/portage/color.map
+Contains variables customizing colors.
+.TP
+.B /usr/portage/profiles/use.desc
 Contains a list of all global USE flags.
 .TP
-\fB/usr/portage/profiles/use.local.desc\fR
+.B /usr/portage/profiles/use.local.desc
 Contains a list of all local USE variables.
 .SH "SEE ALSO"
 .BR emerge (1),
diff --git a/man/portage.5 b/man/portage.5
index d3e6d3550..0ca9c4020 100644
--- a/man/portage.5
+++ b/man/portage.5
@@ -1,4 +1,4 @@
-.TH "PORTAGE" "5" "Dec 2005" "Portage 2.1" "Portage"
+.TH "PORTAGE" "5" "Jun 2007" "Portage 2.1.3" "Portage"
 .SH NAME
 portage \- the heart of Gentoo
 .SH "DESCRIPTION"
@@ -41,6 +41,7 @@ virtuals
 .BR /etc/portage/
 .nf
 bashrc
+color.map
 modules
 package.keywords
 package.mask
@@ -368,6 +369,9 @@ If needed, this file can be used to set up a special environment for ebuilds,
 different from the standard root environment.  The syntax is the same as for
 any other bash script.
 .TP
+.BR color.map
+Contains variables customizing colors. See \fBcolor.map\fR(5).
+.TP
 .BR modules
 This file can be used to override the metadata cache implementation.  In
 practice, portdbapi.auxdbmodule is the only variable that the user will want to
@@ -731,4 +735,5 @@ Drake Wyrm <wyrm@haell.com>
 .BR emerge (1),
 .BR ebuild (1),
 .BR ebuild (5),
-.BR make.conf (5)
+.BR make.conf (5),
+.BR color.map (5)