portpeek.1

   1 .TH "PORTPEEK" "1" "Aug 2009"
   2 .SH "NAME"
   3 portpeek \- Package (un)masking management script
   4 .SH "SYNOPSIS"
   5 .TP
   6 .BR portpeek
   7 [\fIoptions\fR] \fIcommand\fR
   8 .TP
   9 .BR portpeek
  10 \fB\-\-keyword\fR | \fB\-\-unmask\fR | \fB\-\-mask\fR | \fB\-\-package\-use\fR | \fB\-\-all
  11 .TP
  12 .BR portpeek
  13 \fB\-\-changes-only\fR [\fB--keyword\fR | \fB\-\-unmask\fR | \fB\-\-mask\fR | \fB\-\-package\-use\fR | \fB\-\-all]
  14 .SH "DESCRIPTION"
  15 \fBportpeek\fR is a utility script that will process a system's package.*
  16 files and display to the user potential package upgrades. Along with displaying
  17 the installed packages and the versions that the package could be upgraded to,
  18 the keywords for each specific package will also be displayed.
  19 Results are colorcoded for readability.
  20 .SH "OPTIONS"
  21 The 'command' is the only mandatory option to \fBportpeek\fR.
  22
  23 [options] may only be:
  24
  25 .B \-c, \-\-changes-only:
  26 show only packages that have a possible upgrade
  27 .PP
  28 .B \-n, \-\-no-color:
  29 suppress color output
  30 .PP
  31 .B \-r, \-\-removable-only:
  32 show all matches that can be removed from package files
  33 .PP
  34 .B \-f \-\-fix:
  35 remove the stabled packages without asking for confirmation
  36 .PP
  37 .B \-d \-\-debug:
  38 display more verbose output for debugging
  39 .PP
  40 Except for version information, commands can be combined.  The possible commands are:
  41
  42 .B \-a, \-\-all
  43 show all matches
  44 .PP
  45 .B \-h, \-\-help
  46 displays a help summary
  47 .PP
  48 .B \-k, \-\-keyword
  49 show matches from package.keywords only
  50 .PP
  51 .B \-m, \-\-mask
  52 show matches from package.mask only
  53 .PP
  54 .B \-u, \-\-unmask
  55 show matches from package.unmask only
  56 .PP
  57 .B \-s, \-\-package.use
  58 show matches from package.use only
  59 .PP
  60 .B \-t, \-\-tilde-check
  61 process tilde entries ~(cat/pkg-version)
  62 .PP
  63 .B \-V, \-\-version
  64 displays the equery version
  65 .PP
  66
  67 .SH "EXAMPLES"
  68
  69 portpeek \-\-changes-only \-\-keyword \- list all packages with a potential upgrade located in package.keywords
  70
  71 portpeek \-\-unmask \- list all packages and their keywords currently listed in package.unmask
  72
  73 portpeek \-ac \- list all packages and keywords from all package.* files
  74
  75 portpeek \-arf \- list all packages which are stable and can be removed and then remove them automatically
  76
  77 .SH "AUTHORS"
  78 .nf
  79 Michael Pagano <mpagano@gentoo.org>