Pileus Git - ~andy/sunrise/blob - app-portage/elogviewer/files/elogviewer.1

   1 .TH elogviewer 1 "October 07, 2006" "elogviewer -- An interface to Portage's ELOG system"
   2
   3 .SH NAME
   4 elogviewer \-\- a program to easily manage elog files created by Portage during emerge
   5
   6 .SH DESCRIPTION
   7 This manual page explains the
   8 .B elogviewer
   9 program. This program lists all elogs created during emerges of
  10 packages from Portage, the package manager of Gentoo Linux.  So all
  11 warnings or informational messages generated during an update can be
  12 reviewed at one glance.
  13
  14 .SH USAGE
  15
  16 To generate elogs, the user needs to tell Portage to activate the
  17 saving features for the ELOG facilities in his /etc/make.conf file via
  18 the line
  19
  20 .RS 4
  21 PORTAGE_ELOG_SYSTEM="save"
  22 .RE
  23
  24 and choose at least one out of
  25
  26 .RS 4
  27 PORTAGE_ELOG_CLASSES="warn info error log"
  28 .RE
  29
  30 Further prerequisite is the elog directory (in most cases
  31 /var/log/portage/elog/, see variable PORT_LOGDIR), which may need to
  32 be created and belong to the portage group. If the user wants to start
  33 the program as non-root, he needs to add himself to portage group.
  34 For more information on the ELOG system, see /etc/make.conf.example.
  35
  36 The program allows to select the ebuild functions in which to look for
  37 messages, so unpack messages about patching can be disabled while
  38 still having warnings from the post installation function without
  39 informational messages.  elogs can be deleted individually or all in
  40 one step.
  41
  42 .SH BUGS
  43 For bugs in this man page contact <gentoo@faulhammer.org> and for problems with the program the original author Mathias Laurin <synss@cashette.com>.
  44
  45 There are a few the author will address when time permits.  But elogviewer does what it was created for.
  46 .PP
  47 Prints an error message after the last elog has been deleted.
  48 .PP
  49 Error messages should be routed to the error dev on not the console.
  50 .PP
  51 No del-key shortcut.
  52 .PP
  53 The filter is getting inconvenient.
  54
  55 .SH ENVIRONMENT
  56
  57 Uses
  58 .B PORT_LOGDIR
  59 from
  60 .B /etc/make.conf (5)
  61 . Passing
  62 .B PORT_LOGDIR
  63 on the command line overwrites the defaults.
  64
  65 .SH SEE ALSO
  66 /etc/make.conf.example
  67
  68 .SH AUTHOR
  69 Mathias Laurin <synss@cashette.com> for the program, Christian
  70 Faulhammer <gentoo@faulhammer.org> for this man page