Changes to gnats/doc/gnats-faq.texi

[Hans-Albert Schneider]

Index: gnats/doc/gnats-faq.texi
diff -c gnats/doc/gnats-faq.texi:1.13 gnats/doc/gnats-faq.texi:1.14
*** gnats/doc/gnats-faq.texi:1.13       Sun Jan 26 18:11:07 2003
--- gnats/doc/gnats-faq.texi    Thu Jun  5 18:00:25 2003
***************
*** 353,364 ****
  @comment  node-name,  next,  previous,  up
  @chapter  Problems during Installation
  
! I am currently not aware of common problems during compilation and
! installation.
! 
! However, as installation and configuration problems often overlap,
  please check also @ref{Configuration}.
  
  
  @node     Configuration
  @comment  node-name,  next,  previous,  up
--- 353,383 ----
  @comment  node-name,  next,  previous,  up
  @chapter  Problems during Installation
  
! As installation and configuration problems often overlap,
  please check also @ref{Configuration}.
  
+ @menu
+ * Gnatsweb and GNATS::          Cooperation problems between @sc{gnats} and 
Gnatsweb
+ @end menu
+ 
+ 
+ @node     Gnatsweb and GNATS,  , Installation, Installation
+ @comment  node-name,  next,  previous,  up
+ @section  Gnatsweb and @sc{gnats} do not like each other.
+ 
+ @b{Q:} I have installed @sc{gnats} 3.999.x and Gnatsweb 2.9.x, and I
+ cannot get them work together.
+ 
+ Symptoms are that "make test" fails; if Gnatsweb is installed
+ nevertheless, it hangs when trying to login into the @sc{gnats} server.
+ 
+ 
+ @b{A:} The versions are incompatible.
+ Gnatsweb 2.9.x is for use with @sc{gnats} 3.113.1.
+ With @sc{gnats} 3.999.x, you must use Gnatsweb 3.99.x; it is in the
+ contrib subdirectory of the @sc{gnats} distribution.
+ 
+ 
  
  @node     Configuration
  @comment  node-name,  next,  previous,  up
***************
*** 475,480 ****
--- 494,506 ----
  GreatNewDB-query: "|/usr/local/lib/gnats/mail-query -d /usr/local/gnats/db2"
  @end smallexample
  
+ If you do not want to allow querying the database by mail, omit the
+ @samp{GreatNewDB-query} alias.
+ 
+ You usually need the cooperation of a system administrator for this step
+ (if you are not a system administrator yourself, of course).
+ 
+ 
  Make sure that @file{/usr/local/gnats/db2/gnats-adm/config} gives the
  correct mail addresses for @var{GNATS_ADDR} (this @emph{must} be
  different for each database) and for @var{GNATS_ADMIN} (this is probably
***************
*** 1036,1049 ****
  
  @menu
  * General Gnatsweb Questions::  
! * Gnatsweb Login Questions::    Problems logging in to gnatsweb
  @end menu
  
  @node General Gnatsweb Questions
  @comment  node-name,  next,  previous,  up
  @subsection General Gnatsweb Questions
  
! Currently none.
  
  
  @node Gnatsweb Login Questions
--- 1062,1075 ----
  
  @menu
  * General Gnatsweb Questions::  
! * Gnatsweb Login Questions::    Problems logging in to Gnatsweb
  @end menu
  
  @node General Gnatsweb Questions
  @comment  node-name,  next,  previous,  up
  @subsection General Gnatsweb Questions
  
! See also @ref{Gnatsweb and GNATS} in the chapter on @ref{Installation}.
  
  
  @node Gnatsweb Login Questions
***************
*** 1090,1096 ****
  correct.  It works fine on another machine and for other users.
  
  @b{A:} This has actually been reported only once; but as the effect is
! similar to the prevoius one, it is included in the FAQ.  It apparently
  was related to very strict security settings, but has not been
  investigated in detail.
  
--- 1116,1122 ----
  correct.  It works fine on another machine and for other users.
  
  @b{A:} This has actually been reported only once; but as the effect is
! similar to the previous one, it is included in the FAQ.  It apparently
  was related to very strict security settings, but has not been
  investigated in detail.
  
***************
*** 1104,1114 ****
  @b{Q:} Wait a moment!  Cookies?  Can I eat them?
  
  @b{A:} No, not these.  The cookies about which we are talking here are
! little data packages that a webserver sends to your browser (in our
  case, on behalf of Gnatsweb) and your browser sends them back to the
  server next time.  Modern browsers give you the option to generally
  accept or reject cookies, or to be asked whenever a cookie arrives (some
! even can make this decision based on the webserver).  To learn more
  about cookies, visit, e.g., @uref{http://www.cookiecentral.com/,the
  Cookie Central}.
  
--- 1130,1140 ----
  @b{Q:} Wait a moment!  Cookies?  Can I eat them?
  
  @b{A:} No, not these.  The cookies about which we are talking here are
! little data packages that a web-server sends to your browser (in our
  case, on behalf of Gnatsweb) and your browser sends them back to the
  server next time.  Modern browsers give you the option to generally
  accept or reject cookies, or to be asked whenever a cookie arrives (some
! even can make this decision based on the web-server).  To learn more
  about cookies, visit, e.g., @uref{http://www.cookiecentral.com/,the
  Cookie Central}.
  
***************
*** 1178,1184 ****
  
  @table @dfn
  @item cookie
! A junk of data that a www server stores in your browser.  It is sent
  back to the server when you contact it again.  Gnatsweb (see
  @ref{Gnatsweb}) uses cookies to store your login information,
  preferences, and named queries.
--- 1204,1210 ----
  
  @table @dfn
  @item cookie
! A chunk of data that a WWW server stores in your browser.  It is sent
  back to the server when you contact it again.  Gnatsweb (see
  @ref{Gnatsweb}) uses cookies to store your login information,
  preferences, and named queries.