Changes to gnats/doc/gnats.texi

[Yngve Svendsen]

Index: gnats/doc/gnats.texi
diff -c gnats/doc/gnats.texi:1.37 gnats/doc/gnats.texi:1.38
*** gnats/doc/gnats.texi:1.37   Thu Oct 24 08:39:52 2002
--- gnats/doc/gnats.texi        Sun Oct 27 07:43:36 2002
***************
*** 269,277 ****
  may submit Problem Reports.
  
  Responsibility for a given Problem Report initially depends on the
! category of the problem.  Optionally, an automated reminder can be sent
! to the responsible person if a problem report is neglected for a
! requisite time period.  @xref{GNATS configuration,,GNATS configuration}.
  
  @cindex @code{pending} directory
  @cindex unparseable incoming PRs
--- 269,278 ----
  may submit Problem Reports.
  
  Responsibility for a given Problem Report initially depends on the
! category of the problem.  Optionally, an automated reminder can be
! sent to the responsible person if a problem report is neglected for a
! requisite time period.  @xref{GNATS configuration,,Overview of
! @sc{gnats} configuration}.
  
  @cindex @code{pending} directory
  @cindex unparseable incoming PRs
***************
*** 398,404 ****
  
  @c FIXME - check these
  @table @asis
! @item database-specific configuration and database contents
  @address@hidden/address@hidden
  
  @item site-wide configuration files
--- 399,405 ----
  
  @c FIXME - check these
  @table @asis
! @item the directory path of the default database
  @address@hidden/address@hidden
  
  @item site-wide configuration files
***************
*** 611,637 ****
  
  @table @file
  @item databases
! The list of valid databases.  For local databases it contains the
! pathname of the database directory, and for remote databases it has the
! hostname and port of the gnatsd server to connect to.
! (@pxref{databases file,,The @code{databases} file}).
  
  @item defaults
! A directory containing the set of default files used when a new database
! is created with @code{mkdb}.
! (@pxref{dbconfig file,,The @code{dbconfig} file}).
  
  @item gnatsd.host_access
! The access-level settings for the different hosts that will be accessing
! the databases on your server.  The settings in this file apply across
! all databases on the server.  @xref{gnatsd.host_access,,The
! @file{gnatsd.host_access} file}.
  
  @item gnatsd.user_access
! The access-level settings for the users that will be accessing
! the databases on your server.  The settings in this file apply across
! all databases on the server.  @xref{gnatsd.user_access,,The
! @file{gnatsd.user_access} file}.
  @end table
  
  @item @var{prefix}/share/emacs/site-lisp
--- 612,627 ----
  
  @table @file
  @item databases
! @xref{databases file,,The @file{databases} file}.
  
  @item defaults
! @xref{GNATS configuration,,Overview of @sc{gnats} configuration}.
  
  @item gnatsd.host_access
! @xref{gnatsd.host_access,,The @file{gnatsd.host_access} file}.
  
  @item gnatsd.user_access
! @xref{gnatsd.user_access,,The @file{gnatsd.user_access} file}.
  @end table
  
  @item @var{prefix}/share/emacs/site-lisp
***************
*** 697,703 ****
  (@emph{This file is created by @sc{gnats}.})
  @end table
  
! @noindent exist here.  @xref{GNATS configuration,,GNATS configuration},
  @ref{Admin files,,Administrative data files} and @ref{Access
  Control,,Controlling access to databases}.
  
--- 687,694 ----
  (@emph{This file is created by @sc{gnats}.})
  @end table
  
! @noindent exist here.
! @xref{Other config files,,Other database-specific config files},
  @ref{Admin files,,Administrative data files} and @ref{Access
  Control,,Controlling access to databases}.
  
***************
*** 1535,1542 ****
  @cindex @code{GNATSDB}
  
  @code{gnatsd} supports the @code{GNATSDB} environment varable,
! @xref{Environment}, in almost the same way as the GNATS tools do.  This
! variable is used to determine which database to use.  For a local
  database, it contains the name of the database to
  access. @code{gnatsd} cannot service remote databases (though it might
  be interesting if it could) so the database is always assumed to be
--- 1526,1533 ----
  @cindex @code{GNATSDB}
  
  @code{gnatsd} supports the @code{GNATSDB} environment varable,
! @xref{Environment}, in almost the same way as the @sc{gnats} tools do.
! This variable is used to determine which database to use.  For a local
  database, it contains the name of the database to
  access. @code{gnatsd} cannot service remote databases (though it might
  be interesting if it could) so the database is always assumed to be
***************
*** 1627,1637 ****
  @section Overall access levels per host
  @cindex @file{gnatsd.host_access}
  
! The file @address@hidden/gnats/gnatsd.host_access} (usually
! @file{/etc/gnats/gnatsd.host_access}) controls overall access levels
! on a per-host basis, meaning that settings in this file apply across
! all databases on the server.  Entries in this file are on the
! following format:
  
  @var{host:access-level:whatever}
  
--- 1618,1628 ----
  @section Overall access levels per host
  @cindex @file{gnatsd.host_access}
  
! The host access file (by default
! @file{/usr/local/etc/gnats/gnatsd.host_access}) controls overall
! access levels on a per-host basis, meaning that settings in this file
! apply across all databases on the server.  Entries in this file are in
! the following format:
  
  @var{host:access-level:whatever}
  
***************
*** 1661,1673 ****
  @cindex @file{gnatsd.user_access}
  
  Access levels per user can be set both across all databases on the
! server or on a per-database basis.  The @file{gnatsd.user_access} file in a
! database's @file{gnats-adm} directory specifies the user access rules
! for that database.  If it doesn't exist, or doesn't contain the user
! name given to @code{gnatsd}, then the file
! @address@hidden@var{SYSCONFDIR}/gnats/gnatsd.user_access}}, usually
! @address@hidden/etc/gnats/gnatsd.user_access}}, specifying the per-user
! access levels across all the databases on the server is checked.
  
  The user access files can only @emph{increase} the access level
  defined in the host access files for the given host, they can never
--- 1652,1664 ----
  @cindex @file{gnatsd.user_access}
  
  Access levels per user can be set both across all databases on the
! server or on a per-database basis.  The @file{gnatsd.user_access} file
! in a database's @file{gnats-adm} directory specifies the user access
! rules for that database.  If it doesn't exist, or doesn't contain the
! user name given to @code{gnatsd}, then the overall user access file
! (by default @address@hidden/usr/local/etc/gnats/gnatsd.user_access}})
! specifying the per-user access levels across all the databases on the
! server is checked.
  
  The user access files can only @emph{increase} the access level
  defined in the host access files for the given host, they can never
***************
*** 1690,1695 ****
--- 1681,1691 ----
  
  @var{userid:password:access-level}
  
+ The overall @file{gnatsd.user_access} user access file adds a fourth
+ @var{databases} field:
+ 
+ @var{userid:password:access-level:databases}
+ 
  @noindent @var{password} should either be in plain text, DES
  @code{crypt()address@hidden crypt is the standard password encryption
  format used by most UNIX systems} or MD5 hash address@hidden is
***************
*** 1760,1772 ****
  might be surprised if they suddenly found themselves logged in, but with
  a lower access level than they usually have.
  
! The overall user access file
! @address@hidden@var{SYSCONFDIR}/gnats/gnatsd.user_access}}, usually
! @address@hidden/etc/gnats/gnatsd.user_access}}, adds a fourth
! @var{database} field.  This file contains a comma-separated list of
! database names, as defined in the @file{databases} file
! (@pxref{databases file,,The @code{databases} file}.  Wildcard characters
! are supported. The databases listed in this field are the ones to which
  the other settings on the same line will be applied.
  
  @node Privileged gnatsd commands
--- 1756,1765 ----
  might be surprised if they suddenly found themselves logged in, but with
  a lower access level than they usually have.
  
! The @var{databases} field contains a comma-separated list of database
! names, as defined in the @file{databases} file (@pxref{databases
! file,,The @code{databases} file}.  Wildcard characters are
! supported. The databases listed in this field are the ones to which
  the other settings on the same line will be applied.
  
  @node Privileged gnatsd commands