Index: logview/grablogs.conf.4
===================================================================
--- logview/grablogs.conf.4	(revision 0)
+++ logview/grablogs.conf.4	(revision 0)
@@ -0,0 +1,79 @@
+'\" te
+.\" gnome-system-log.1 - GNOME logfile viewer
+.\" Copyright 1989 AT
+.\"|[amp   ]
+.\"|T
+.\" Copyright 2006 Lin Ma
+.TH grablogs.conf 4 "13 Oct 2006" "gnome-utils 2.16.0" "File Formats"
+.SH "NAME"
+grablogs.conf \- grablogs configuration for libgrablogs.so of the plugins of
+ gnome-system-log
+file
+.SH "SYNOPSIS"
+.PP
+.nf
+/usr/lib/gnome-system-log/plugins/grablogs.conf
+.fi
+.SH "DESCRIPTION"
+.PP
+The libgrablogs.so is a plugin for gnome-system-log(1), it colloct the log 
+files from the system as many as possible. grablogs.conf is a configuration 
+file that contains a set of lines mixed with sh(1) syntax codes and individual
+ log files. libgrablogs.so will read the file try to get a log files list for
+ gnome-system-log(1). Users can copy the file into $HOME/.gnome2/gnome-system-log/plugins/`uname -p` to overwrite the system default one.
+.PP
+The grablogs.conf file contains the following configuration categories:
+.RS
+.TP
+.B [configs]
+Each line under this category is interpreted as a config file of
+System. The plugin will open the config file and try to find all
+system paths of the logs.
+.TP
+.B [commands]
+Each line under this category is interpreted as a shell command and
+will be execute through a pipe. And each line of the output of the
+command will be interpreted as a log path.
+.TP
+.B [logs]
+Each line under this category is interpreted as a log path.
+.RE
+.SH "FILES"
+.TP
+.I /usr/lib/gnome-system-log/plugins/grablogs.conf
+The system default configuration file for the plugin libgrablogs.so
+.TP
+.I "$HOME/.gnome2/gnome\-system\-log/plugins/`uname \-p`/grablogs.conf"
+The user specific configuration file for the plugin libgrablogs.so
+.SH "EMAMPLE"
+.br
+.B [configs]
+.br
+.IR /etc/syslog.conf
+.br
+.B [commands]
+.br
+.IR "for i in `svcs -aH -o FMRI | grep -v lrc `; do svcprop -p restarter/logfile $i 2>/dev/null || svcprop -q -p restarter/alt_logfile $i 2>/dev/null ; done"
+.br
+.B [logs]
+.br
+.IR /var/log/messages
+.br
+.IR /var/log/secure
+.br
+.IR /var/log/maillog
+.br
+.IR /var/log/cron
+.br
+.IR /var/log/Xorg.0.log
+.br
+.IR /var/log/XFree86.0.log
+.br
+.IR /var/log/auth.log
+.br
+.IR /var/log/cups/error_log
+.SH "SEE ALSO"
+.PP
+.BR gnome-system-log (1),
+.BR pipelog.conf (1)
+.PP
Index: logview/pipelog.conf.4
===================================================================
--- logview/pipelog.conf.4	(revision 0)
+++ logview/pipelog.conf.4	(revision 0)
@@ -0,0 +1,49 @@
+'\" te
+.\" gnome-system-log.1 - GNOME logfile viewer
+.\" Copyright 1989 AT
+.\"|[amp   ]
+.\"|T
+.\" Copyright 2006 Lin Ma
+.TH pipelog.conf 4 "13 Oct 2006" "gnome-utils 2.16.0" "File Formats"
+.SH "NAME"
+pipelog.conf \- pipelog configuration for libpipelog.so of the plugins of 
+gnome-system-log
+file
+.SH "SYNOPSIS"
+.PP
+.nf
+/usr/lib/gnome-system-log/plugins/pipelog.conf
+.fi
+.SH "DESCRIPTION"
+.PP
+The libpipelog.so is a plugin for gnome-system-log(1), it runs commands through
+ pipes and get the output of the individual pipe as a log content. Users can
+ copy the file into $HOME/.gnome2/gnome-system-log/plugins/`uname -p` to
+ overwrite the system default one.
+.PP
+The syntax of pipelog.conf file is:
+.br
+.RS .5i
+<log path><whitespace><command>
+
+.RE
+<command> may be a simple program name (which will be found in $PATH)
+or an absolute path of a binary with arguments list. "%s" can be included in
+<command> zero or one time, will be replaced by <log path> in runtime.
+.SH "FILES"
+.TP
+.I /usr/lib/gnome-system-log/plugins/pipelog.conf
+The system default configuration file for the plugin libpipelog.so
+.TP
+.I "$HOME/.gnome2/gnome\-system\-log/plugins/`uname \-p`/pipelog.conf"
+The user specific configuration file for the plugin libpipelog.so
+.SH "EMAMPLE"
+.IR "/var/adm/wtmpx  last"
+.br
+.IR "/var/adm/utmpx  /bin/last -f %s"
+.SH "SEE ALSO"
+.PP
+.BR gnome-system-log (1),
+.BR grablogs.conf (4)
+.PP
+.\" LSARC 2006/325 Gnome System Log Viewer
diff -ruN gnome-utils-2.27.2.orig/logview/data/gnome-system-log.1 gnome-utils-2.27.2/logview/data/gnome-system-log.1
--- gnome-utils-2.27.2.orig/logview/data/gnome-system-log.1	2009-07-31 13:03:43.589752351 +0100
+++ gnome-utils-2.27.2/logview/data/gnome-system-log.1	2009-07-31 13:07:40.320623516 +0100
@@ -1,6 +1,7 @@
+'\" te
 .\" gnome-system-log.1 - GNOME logfile viewer
 .\" Copyright 2001  Jochen Voss
-.TH gnome-system-log 1 "Aug 09 2002" "gnome-utils 2.0.0"
+.TH gnome-system-log 1 "Aug 09 2002" "gnome-utils 2.16.0"
 .SH NAME
 gnome-system-log \- the GNOME System Log Viewer
 .SH SYNOPSIS
@@ -19,10 +20,81 @@
 .B GNOME System Log Viewer
 was written by Cesar Miquel <[email protected]>.
 .PP
+.B GNOME System Log Viewer Plugin Interface
+was written by Lin Ma <[email protected]>.
+.PP
 This manual page was written by Jochen Voss
 <[email protected]>.
+.TP
+.B Plugin Service Provider Interface (SPI)
+We have provided an SPI for adding plugins into Gnome Log Viewer. The SPI
+mainly includes three parts:
+.RS
+.TP
+.B I/O (LogviewIFaceIO)
+This defines the main input interface. This is used by Log Viewer to
+read a logs content into memory, whether the logs source is text or
+binary, the data returned here should be text - most likely in the
+current locale. It also provides methods to allow the main application
+to get other information about the log such as whether the log has
+changed.
+
+It's the reposibility of the plugin to maintain information about the
+log file(s) such as the current location in the file, the size of the
+file, etc.
+.TP
+.B Views (LogviewIFaceView)
+This interface defines a mechanism to enable the formatting of log
+data, dividing it into lines. The current implementation defines how to
+group lines by date and the conversion of the log from the current
+locale to UTF-8.
+.TP
+.B Collectors (LogviewIFaceCollector)
+This interface is used to gather the list of logs. New types of logs
+may be added using this interface.
+.RE
+
+For the detail information, please see /usr/share/gtk-doc/html/logview/index.html.
+.TP
+.B Plugin Priority
+ priority list is maintained for each category of plugin - this defines
+the order in which plugins will be used - higher priority plugins override
+lower priority plugins. Priorities are categorised as:
+
+.br
+Priority 0-9: Used by the delivered default plugins
+.br
+Priority 10+: End Users plugins.
+.TP
+.B Plugin Search Path
+Log Viewer will search in the following directories for plugins:
+
+.br
+$HOME/.gnome2/gnome-system-log/plugins/`uname -p`
+.br
+/lib/gnome-system-log/plugins
+.TP
+.B Plugin Security
+Both libgrablogs and libpipelog only recognize the configure file which has the
+same owner ship to the user, otherwise they will back to the system default
+ones. In Solaris, they will use a fork/exec/pfsh to run the commands within the
+configure files; in Linux, they will use popen(3).
+.TP
+.B Default Plugins
+Three plugins are available for the end-users. They are libgrablogs.so,
+libplainlog.so and libpipelog.so.
 .SH FILES
 .TP
+.I /usr/lib/gnome-system-log/plugins/libgrablogs.so
+A default plugin - collecting some log files from system. See grablogs.conf (4).
+.TP
+.I /usr/lib/gnome-system-log/plugins/libplainlog.so
+A default plugin - view ASCII log files.
+.TP
+.I /usr/lib/gnome-system-log/plugins/libpipelog.so
+A default plugin - has a higher priority than libplainlog.so, view the output
+of a command. See pipelog.conf (4).
+.TP
 .I /var/log/messages
 The system's main logfile.
 .TP
@@ -30,8 +102,27 @@
 Configuration file for syslogd.  See
 .BR syslog.conf (5)
 for exact information.
+.RE
+
+.SH ATTRIBUTES
+.sp
+.PP
+See \fBattributes\fR(5) for descriptions of the following attributes:
+
+.TS
+tab(^G) allbox;
+cw(2.750000i)| cw(2.750000i)
+lw(2.750000i)| lw(2.750000i).
+ATTRIBUTE TYPE^ATTRIBUTE VALUE
+Availability^SUNWgnome-log-viewer
+Interface stability^GVolatile
+.TE
+
 .SH SEE ALSO
 .BR syslogd (8),
 .BR sysklogd (8),
 .BR syslog.conf (5),
-.BR syslogd-listfiles (8)
+.BR syslogd-listfiles (8),
+.BR grablogs.conf (4),
+.BR pipelog.conf (4)
+.\" LSARC 2006/325 Gnome System Log Viewer