From 30b1a62bd1ad86ec6de56cc315d385b348ef4c98 Mon Sep 17 00:00:00 2001 From: Zac Medico Date: Sat, 30 Jun 2007 23:18:34 +0000 Subject: [PATCH] Add docs for /etc/portage/color.map and a few misc man page fixes. Thanks to Arfrever Frehtes Taifersar Arahesis in bug #183758. (trunk r7100) svn path=/main/branches/2.1.2/; revision=7101 --- man/color.map.5 | 89 +++++++++++++++++++++++++++++++++++++++++++++++++ man/ebuild.1 | 10 ++++-- man/ebuild.5 | 14 +++++--- man/emerge.1 | 6 +++- man/make.conf.5 | 13 +++++--- man/portage.5 | 9 +++-- 6 files changed, 125 insertions(+), 16 deletions(-) create mode 100644 man/color.map.5 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 +.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 .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 Mark Guertin Nicholas Jones Mike Frysinger -Arfrever Frehtes Taifersar Arahesis +Arfrever Frehtes Taifersar Arahesis .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 .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 .BR emerge (1), .BR ebuild (1), .BR ebuild (5), -.BR make.conf (5) +.BR make.conf (5), +.BR color.map (5) -- 2.26.2