← Back to branch summary

~ubuntu-branches/ubuntu/dapper/gnats/dapper

« back to all changes in this revision

Viewing changes to doc/gnats-faq.info

  • Committer: Bazaar Package Importer
  • Author(s): Chad Walstrom
  • Date: 2005-03-07 17:56:31 UTC
  • mfrom: (1.1.1 upstream) (2.1.1 hoary)
  • Revision ID: james.westby@ubuntu.com-20050307175631-agtm10dvjbemuc64
Tags: 4.1.0-0
* New upstream version
* debian/rules: now uses '--with-lispdir' option instead of environment
  variable overloading. Re-enabled optimization.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/gnats-faq.info
1
 
This is gnats-faq.info, produced by makeinfo version 4.2 from
 
1
This is gnats-faq.info, produced by makeinfo version 4.7 from
2
2
gnats-faq.texi.
3
3
 
4
4
START-INFO-DIR-ENTRY
29
29
GNATS Frequently Asked Questions
30
30
********************************
31
31
 
32
 
   This document answers some frequently asked questions concerning
33
 
GNATS, the GNU problem report management system, and related software.
34
 
The most recent version of this FAQ can be found at
 
32
This document answers some frequently asked questions concerning GNATS,
 
33
the GNU problem report management system, and related software.  The
 
34
most recent version of this FAQ can be found at
35
35
`http://www.gnu.org/software/gnats/doc/faq/gnats-faq.html'.
36
36
 
37
37
   The questions and answers have been compiled by Hans-Albert
38
 
Schneider <Hans-Albert@HA-Schneider.de>, mainly using the help-gnats
 
38
Schneider <Gnats-FAQ@HA-Schneider.de>, mainly using the help-gnats
39
39
mailing list and the GNATS documentation as input.  Please report any
40
40
errors and suggestions to him.
41
41
 
51
51
 
52
52
File: gnats-faq.info,  Node: General,  Next: Installation,  Prev: Top,  Up: Top
53
53
 
54
 
General Questions
55
 
*****************
 
54
1 General Questions
 
55
*******************
56
56
 
57
57
* Menu:
58
58
 
62
62
* Versions::                    Which versions are available?
63
63
* Mailing Lists::               E-mail discussion lists
64
64
* Bug Reporting::               How to report a bug
 
65
* Upgrading::                   Considerations for the 3.x to 4.0 transition
65
66
 
66
67
 
67
68
File: gnats-faq.info,  Node: What is GNATS,  Next: How to pronounce it,  Up: General
68
69
 
69
 
What is GNATS?
70
 
==============
 
70
1.1 What is GNATS?
 
71
==================
71
72
 
72
 
   GNATS is the GNU problem report management system.  Problem report
 
73
GNATS is the GNU problem report management system.  Problem report
73
74
management systems are also known as "bug-tracking systems", though the
74
75
entries need not be bugs (e.g., think of change requests).  The acronym
75
76
stands for "GNats: A Tracking System".
102
103
 
103
104
File: gnats-faq.info,  Node: User view,  Next: Administrator View,  Up: What is GNATS
104
105
 
105
 
How it Works--User's View
106
 
-------------------------
 
106
1.1.1 How it Works--User's View
 
107
-------------------------------
107
108
 
108
 
   Users enter their problem reports (PRs) via some front-end.  This
 
109
Users enter their problem reports (PRs) via some front-end.  This
109
110
front-end either directly contacts the GNATS server, or sends the
110
111
report via e-mail.  (The server is available since about version 3.90
111
112
of GNATS).  For an incomplete list of front-ends see *Note Clients::.
117
118
 
118
119
File: gnats-faq.info,  Node: Administrator View,  Prev: User view,  Up: What is GNATS
119
120
 
120
 
How it Works--Administrator's View
121
 
----------------------------------
 
121
1.1.2 How it Works--Administrator's View
 
122
----------------------------------------
122
123
 
123
 
   The server is started by a super-server like inetd or xinetd.  It has
124
 
a built-in access control mechanism based on IP addresses and
 
124
The server is started by a super-server like inetd or xinetd.  It has a
 
125
built-in access control mechanism based on IP addresses and
125
126
username/password.
126
127
 
127
128
   For users sending their PRs via e-mail, some mail addresses must be
130
131
 
131
132
File: gnats-faq.info,  Node: How to pronounce it,  Next: Get it,  Prev: What is GNATS,  Up: General
132
133
 
133
 
How is "GNATS" pronounced?
134
 
==========================
 
134
1.2 How is "GNATS" pronounced?
 
135
==============================
135
136
 
136
 
   Q: So, How can I pronounce "GNATS?"  Should I pronounce "G"?
 
137
Q: So, How can I pronounce "GNATS?"  Should I pronounce "G"?
137
138
 
138
139
   It has been reported that the original developers pronounced the "G".
139
140
(This is unlike the little insect called "gnat" where the "G" is not
142
143
 
143
144
File: gnats-faq.info,  Node: Get it,  Next: Versions,  Prev: How to pronounce it,  Up: General
144
145
 
145
 
Where do I get it?
146
 
==================
 
146
1.3 Where do I get it?
 
147
======================
147
148
 
148
 
   See the GNATS home page at `http://www.gnu.org/software/gnats/'.
 
149
See the GNATS home page at `http://www.gnu.org/software/gnats/'.
149
150
 
150
151
   The current development version is available via CVS only, see the
151
152
GNU savannah GNATS project page
155
156
 
156
157
File: gnats-faq.info,  Node: Versions,  Next: Mailing Lists,  Prev: Get it,  Up: General
157
158
 
158
 
What is the latest version?
159
 
===========================
 
159
1.4 What is the latest version?
 
160
===============================
160
161
 
161
 
   The version numbers of GNATS 3.x is somewhat confusing, because
162
 
3.1xx is newer than 3.2.
 
162
The version numbers of GNATS 3.x is somewhat confusing, because 3.1xx
 
163
is newer than 3.2.
163
164
 
164
165
   Version 3.2 was released in 1993 (I never tried it, but it is said
165
166
to be "really broken").  A lot of new features have been added since
166
167
3.2, including multiple database support and customized fields.  Among
167
168
the contributed software are comprehensive WWW and Tk based front-ends.
168
169
 
169
 
   The latest 3.x release is 3.113.1.
 
170
   The latest 3.x release is 3.113.1.  It is deprecated due to security
 
171
concerns and lack of maintenance.
170
172
 
171
 
   A first beta of version 4.0 is available since January 10, 2002 (as
172
 
`ftp://ftp.gnu.org/gnu/gnats/gnats-3.999.1.tar.gz'), and an official
173
 
release is expected very soon now.
 
173
   GNATS 4.0 was released in August 2003, and 4.1 was released in March
 
174
2005.  All released versions are available for download at
 
175
`http://ftp.gnu.org/pub/gnu/gnats/'.
174
176
 
175
177
 
176
178
File: gnats-faq.info,  Node: Mailing Lists,  Next: Bug Reporting,  Prev: Versions,  Up: General
177
179
 
178
 
Is there a Mailing List?
179
 
========================
180
 
 
181
 
   Currently, the following GNATS mailing lists exist:
182
 
 
183
 
   * <info-gnats@gnu.org> This is a low volume moderated mailing lists
184
 
     for GNATS related announcements, like new releases or important
185
 
     information.
186
 
 
187
 
   * <help-gnats@gnu.org> A low-to-middle volume mailing list where
188
 
     anything related to GNATS can be discussed (development, help,
189
 
     questions, suggestions, etc.).
190
 
 
191
 
   * <bug-gnats@gnu.org> Bug reports can be sent there.  Please note
192
 
     that it's preferred to submit bug reports via the bug tracking
193
 
     system (*note Bug Reporting::), which automatically mirrors them
194
 
     to this list.
 
180
1.5 Is there a Mailing List?
 
181
============================
 
182
 
 
183
Currently, the following GNATS mailing lists exist:
 
184
 
 
185
   * info-gnats@gnu.org
 
186
     (http://lists.gnu.org/mailman/listinfo/info-gnats) This is a low
 
187
     volume moderated mailing lists for GNATS related announcements,
 
188
     like new releases or important information.
 
189
 
 
190
   * help-gnats@gnu.org
 
191
     (http://lists.gnu.org/mailman/listinfo/help-gnats) A low-to-middle
 
192
     volume mailing list where anything related to GNATS can be
 
193
     discussed (development, help, questions, suggestions, etc.).
 
194
 
 
195
   * bug-gnats@gnu.org (http://lists.gnu.org/mailman/listinfo/bug-gnats)
 
196
     Bug reports can be sent there.  Please note that it's preferred to
 
197
     submit bug reports via the bug tracking system (*note Bug
 
198
     Reporting::), which automatically mirrors them to this list.
195
199
 
196
200
   Lists that are of interest mainly for the GNATS developers:
197
201
 
198
 
   * <gnats-prs@gnu.org> Copies of the bug tracking system messages are
199
 
     sent there.  Contrast to bug-gnats@gnu.org which only gets new bug
200
 
     reports, this list also gets the follow-ups (Whatever goes into
201
 
     GNATS' `>Audit-Trail:' field).
202
 
 
203
 
   * <gnats-commit@gnu.org> CVS commit messages are sent there.
204
 
 
205
 
   * <gnats-diffs@gnu.org> Diffs of committed files are sent
206
 
     automatically to this address.
 
202
   * gnats-prs@gnu.org (http://lists.gnu.org/mailman/listinfo/gnats-prs)
 
203
     Copies of the bug tracking system messages are sent there.
 
204
     Contrast to bug-gnats@gnu.org which only gets new bug reports,
 
205
     this list also gets the follow-ups (Whatever goes into GNATS'
 
206
     `>Audit-Trail:' field).
 
207
 
 
208
   * gnats-commit@gnu.org
 
209
     (http://lists.gnu.org/mailman/listinfo/gnats-commit) CVS commit
 
210
     messages are sent there.
 
211
 
 
212
   * gnats-diffs@gnu.org
 
213
     (http://lists.gnu.org/mailman/listinfo/gnats-diffs) Diffs of
 
214
     committed files are sent automatically to this address.
207
215
 
208
216
 
209
 
File: gnats-faq.info,  Node: Bug Reporting,  Prev: Mailing Lists,  Up: General
210
 
 
211
 
How do I Report a Bug?
212
 
======================
213
 
 
214
 
   Before reporting a bug, make sure it really is a bug, not a simple
 
217
File: gnats-faq.info,  Node: Bug Reporting,  Next: Upgrading,  Prev: Mailing Lists,  Up: General
 
218
 
 
219
1.6 How do I Report a Bug?
 
220
==========================
 
221
 
 
222
Before reporting a bug, make sure it really is a bug, not a simple
215
223
misunderstanding or a misconfiguration.  Please check the manual and
216
 
this FAQ.  You may also ask for help on the <help-gnats@gnu.org>
217
 
mailing list.
 
224
this FAQ.  You may also ask for help on the help-gnats@gnu.org
 
225
(http://lists.gnu.org/mailman/listinfo/help-gnats) mailing list (you
 
226
may want to search the list archive first; it is available from
 
227
`http://lists.gnu.org/mailman/listinfo/help-gnats').
218
228
 
219
229
   If it is a bug, please report it via the bug tracking system.  It
220
230
resides at `http://bugs.gnu.org/cgi-bin/gnatsweb.pl?database=gnats'.
241
251
their spare time) and helps to track down and fix the problem soon.
242
252
 
243
253
 
 
254
File: gnats-faq.info,  Node: Upgrading,  Prev: Bug Reporting,  Up: General
 
255
 
 
256
1.7 Upgrading Considerations
 
257
============================
 
258
 
 
259
See *Note Upgrading from older versions: (gnats)Upgrading. for the
 
260
upgrade process from 3.x to 4.x.
 
261
 
 
262
   If you are running a 3.x version, _please consider upgrading to 4.0._
 
263
There are some security concerns about the 3.1xx code that have gone
 
264
with 4.0.  Furthermore, the GNATS 3 branch is not maintained anymore
 
265
due to lack of capacity.
 
266
 
 
267
   The default format of the reports has not changed during the
 
268
transition from 3.113.1 to 4.0, though you may add more fields to 4.0
 
269
reports (and leave out others).  The format of the index file is now
 
270
binary.
 
271
 
 
272
   However, you have to change the e-mail aliases because the meaning of
 
273
the `-d' option to the client programs has changed: It took the
 
274
_directory_ of the GNATS database in 3.1xx, and now takes its _name_
 
275
(plus, it is now installed into the `libexec' directory instead of the
 
276
`lib' directory).  I.e., you must change the aliases:
 
277
 
 
278
     # GNATS 3 aliases:
 
279
     ourdb-query: "|/usr/local/lib/gnats/mail-query -d /usr/local/gnats/db2"
 
280
     ourdb-bugs:  "|/usr/local/lib/gnats/queue-pr -d /usr/local/gnats/db2 -q"
 
281
   to
 
282
     # GNATS 4 aliases:
 
283
     ourdb-query: "|/usr/local/libexec/gnats/mail-query -d ourdb"
 
284
     ourdb-bugs:  "|/usr/local/libexec/gnats/queue-pr -d ourdb -q"
 
285
 
 
286
   Also note that the client/server protocol has changed from 3.1xx to
 
287
4.0; you cannot run clients from one version with the server from the
 
288
other version.
 
289
 
 
290
 
244
291
File: gnats-faq.info,  Node: Installation,  Next: Configuration,  Prev: General,  Up: Top
245
292
 
246
 
Problems during Installation
247
 
****************************
 
293
2 Problems during Installation
 
294
******************************
248
295
 
249
 
   As installation and configuration problems often overlap, please
250
 
check also *Note Configuration::.
 
296
As installation and configuration problems often overlap, please check
 
297
also *Note Configuration::.
251
298
 
252
299
* Menu:
253
300
 
256
303
 
257
304
File: gnats-faq.info,  Node: Gnatsweb and GNATS,  Prev: Installation,  Up: Installation
258
305
 
259
 
Gnatsweb and GNATS do not like each other.
260
 
==========================================
 
306
2.1 Gnatsweb and GNATS do not like each other.
 
307
==============================================
261
308
 
262
 
   Q: I have installed GNATS 3.999.x and Gnatsweb 2.9.x, and I cannot
263
 
get them work together.
 
309
Q: I have installed GNATS 3.999.x and Gnatsweb 2.9.x, and I cannot get
 
310
them work together.
264
311
 
265
312
   Symptoms are that "make test" fails; if Gnatsweb is installed
266
313
nevertheless, it hangs when trying to login into the GNATS server.
267
314
 
268
315
   A: The versions are incompatible.  Gnatsweb 2.9.x is for use with
269
316
GNATS 3.113.1.  With GNATS 3.999.x, you must use Gnatsweb 3.99.x; it is
270
 
in the contrib subdirectory of the GNATS distribution.
 
317
in the contrib subdirectory of the GNATS distribution.  (GNATS
 
318
3.999.x/Gnatsweb 3.99.x were pre-releases of the 4.0 releases.  As 4.0
 
319
is out now, you may consider to upgrade to the non-pre versions.)
 
320
 
 
321
   For GNATS 4.x, use Gnatsweb 4.0 or greater.
271
322
 
272
323
 
273
324
File: gnats-faq.info,  Node: Configuration,  Next: Clients,  Prev: Installation,  Up: Top
274
325
 
275
 
Configuration Issues
276
 
********************
 
326
3 Configuration Issues
 
327
**********************
277
328
 
278
329
* Menu:
279
330
 
285
336
 
286
337
File: gnats-faq.info,  Node: General configuration,  Next: Gnatsd,  Up: Configuration
287
338
 
288
 
General Configuration Questions
289
 
===============================
 
339
3.1 General Configuration Questions
 
340
===================================
290
341
 
291
342
* Menu:
292
343
 
297
348
 
298
349
File: gnats-faq.info,  Node: Add a database,  Next: Renaming a Category,  Up: General configuration
299
350
 
300
 
How do I add a new database?
301
 
----------------------------
302
 
 
303
 
A: (GNATS 3.1xx)
 
351
3.1.1 How do I add a new database?
 
352
----------------------------------
 
353
 
 
354
A: (GNATS 3.1xx) (Please consider upgrading to GNATS 4.0 or greater.)
 
355
 
304
356
  1. Create the base directory for the new database, say
305
357
     `/usr/local/gnats/db2', and make sure it is owned by the GNATS
306
358
     user.
431
483
     `gnats-queue'.  Note that you need to specify the database to
432
484
     `queue-pr', i.e.,
433
485
 
434
 
     `/usr/local/lib/gnats/queue-pr -d GreatNewDB -r'
 
486
     `/usr/local/libexec/gnats/queue-pr -d GreatNewDB -r'
435
487
 
436
488
     or, if you prefer the long options,
437
489
 
438
 
     `/usr/local/lib/gnats/queue-pr --database=GreatNewDB --run'
 
490
     `/usr/local/libexec/gnats/queue-pr --database=GreatNewDB --run'
439
491
 
440
492
  5. Don't forget to create mail aliases for your new database (*note
441
493
     Setting up mail aliases: (gnats)Aliases.).  Take care that the
456
508
 
457
509
File: gnats-faq.info,  Node: Renaming a Category,  Next: Changing Fields,  Prev: Add a database,  Up: General configuration
458
510
 
459
 
How do I rename a category?
460
 
---------------------------
 
511
3.1.2 How do I rename a category?
 
512
---------------------------------
461
513
 
462
 
   Renaming a category requires to touch every PR in that category,
 
514
Renaming a category requires to touch every PR in that category,
463
515
because each report contains the name of its category.
464
516
 
465
517
   To rename category `A' to `B', proceed as follows:
486
538
 
487
539
File: gnats-faq.info,  Node: Changing Fields,  Prev: Renaming a Category,  Up: General configuration
488
540
 
489
 
How do I add, remove, or rename a PR field?
490
 
-------------------------------------------
 
541
3.1.3 How do I add, remove, or rename a PR field?
 
542
-------------------------------------------------
491
543
 
492
544
A: (GNATS 3.1xx) The fields and their names are fixed in GNATS 3.1xx,
493
545
so this is not possible.
504
556
 
505
557
File: gnats-faq.info,  Node: Gnatsd,  Next: E-Mail,  Prev: General configuration,  Up: Configuration
506
558
 
507
 
Gnatsd, the GNATS Daemon
508
 
========================
 
559
3.2 Gnatsd, the GNATS Daemon
 
560
============================
509
561
 
510
562
* Menu:
511
563
 
516
568
 
517
569
File: gnats-faq.info,  Node: Port Number,  Next: Starting gnatsd,  Up: Gnatsd
518
570
 
519
 
Gnatsd Port Number
520
 
------------------
 
571
3.2.1 Gnatsd Port Number
 
572
------------------------
521
573
 
522
 
   In 3.xxx versions, gnatsd uses port 1529 by default; as this port is
 
574
In 3.xxx versions, gnatsd uses port 1529 by default; as this port is
523
575
officially assigned to another application (see the list of port
524
576
numbers (http://www.iana.org/assignments/port-numbers) maintained by
525
577
the Internet Assigned Numbers Authority (http://www.iana.org/)) it will
535
587
 
536
588
File: gnats-faq.info,  Node: Starting gnatsd,  Next: Gnatsd messages,  Prev: Port Number,  Up: Gnatsd
537
589
 
538
 
How to Start Gnatsd
539
 
-------------------
 
590
3.2.2 How to Start Gnatsd
 
591
-------------------------
540
592
 
541
 
   Gnatsd is intended to be started by some "super server", like
542
 
`inetd' or `xinetd'.  ("Super servers" are sometimes also called "super
 
593
Gnatsd is intended to be started by some "super server", like `inetd'
 
594
or `xinetd'.  ("Super servers" are sometimes also called "super
543
595
daemons".)
544
596
 
545
597
   This is also described in the GNATS manual; see *Note Installing the
556
608
How to configure inetd to start gnatsd
557
609
......................................
558
610
 
559
 
   If your gnatsd will be started by inetd (the "internet daemon"), add
 
611
If your gnatsd will be started by inetd (the "internet daemon"), add
560
612
the following entry to your `/etc/inetd.conf':
561
613
 
562
614
     # port                    userid program
578
630
How to configure xinetd to start gnatsd
579
631
.......................................
580
632
 
581
 
   If your gnatsd will be started by xinetd (the "extended internet
 
633
If your gnatsd will be started by xinetd (the "extended internet
582
634
daemon"), create a file `/etc/xinetd.d/support' with the following
583
635
lines (*note Installing the daemon: (gnats)Installing the daemon.):
584
636
 
589
641
             protocol    = tcp
590
642
             wait        = no
591
643
             user        = gnats
592
 
             server      = /usr/local/lib/gnats/gnatsd
 
644
             server      = /usr/local/libexec/gnats/gnatsd
593
645
             server_args = gnatsd
594
646
     }
595
647
 
607
659
 
608
660
File: gnats-faq.info,  Node: Gnatsd messages,  Prev: Starting gnatsd,  Up: Gnatsd
609
661
 
610
 
Gnatsd Messages
611
 
---------------
 
662
3.2.3 Gnatsd Messages
 
663
---------------------
612
664
 
613
665
* Menu:
614
666
 
621
673
You are not on the host access list: stdin (stdin)
622
674
..................................................
623
675
 
624
 
   Q: When starting gnatsd manually (on the command line), I get `520
625
 
You are not on the host access list: stdin (stdin)'.
 
676
Q: When starting gnatsd manually (on the command line), I get `520 You
 
677
are not on the host access list: stdin (stdin)'.
626
678
 
627
679
   A: (GNATS 3.1xx) Gnatsd is not intended to be started manually, but
628
680
via inetd, xinetd, or a similar "super server".  When gnatsd is started
651
703
You are not on the host access list
652
704
...................................
653
705
 
654
 
   Q: Gnatsd rejects connections from a remote host with the error
655
 
message `520 You are not on the host access list'.
 
706
Q: Gnatsd rejects connections from a remote host with the error message
 
707
`520 You are not on the host access list'.
656
708
 
657
 
   A: Check the file `gnatsd.conf' (GNATS 3.xxx) or
658
 
`gnatsd.host_access' (GNATS 4.x).  With GNATS 3, this is usually
659
 
`/usr/local/etc/gnatsd.conf'; with GNATS 4, it is usually
660
 
`/usr/local/etc/gnats/gnatsd.host_access'.
 
709
   A: Check the file `gnatsd.host_access'; if you are using the default
 
710
locations, this is `/usr/local/etc/gnats/gnatsd.host_access'.  (If you
 
711
are still using GNATS 3.xxx, the file is named `gnatsd.conf'; its
 
712
default place is `/usr/local/etc/gnatsd.conf'.)
661
713
 
662
714
   Each line of the file names a host and its access level, separated by
663
715
colons.  Gnatsd tries the lines in turn to match the remote host, and
710
762
 
711
763
File: gnats-faq.info,  Node: E-Mail,  Next: Miscellaneous,  Prev: Gnatsd,  Up: Configuration
712
764
 
713
 
E-Mail Issues
714
 
=============
 
765
3.3 E-Mail Issues
 
766
=================
715
767
 
716
768
* Menu:
717
769
 
724
776
queue-pr not available for sendmail programs
725
777
............................................
726
778
 
727
 
   Your sendmail installation uses `smrsh' to check programs that are
 
779
Your sendmail installation uses `smrsh' to check programs that are
728
780
invoked from a mail alias.  `smrsh' only allows the execution of
729
781
programs of which it is told that they are save.  To tell it that
730
782
`queue-pr' is save, create a symbolic link in the directory
743
795
Mail from GNATS bounces
744
796
.......................
745
797
 
746
 
   You are getting bounce mails like this:
 
798
You are getting bounce mails like this:
747
799
 
748
800
        ----- Transcript of session follows -----
749
801
     ... while talking to mail.example.com.:
771
823
 
772
824
File: gnats-faq.info,  Node: Miscellaneous,  Prev: E-Mail,  Up: Configuration
773
825
 
774
 
Miscellaneous Configuration Issues
775
 
==================================
 
826
3.4 Miscellaneous Configuration Issues
 
827
======================================
776
828
 
777
829
* Menu:
778
830
 
811
863
Assigning responsible etc. when entering a report
812
864
.................................................
813
865
 
814
 
   Q: When entering a new PR, I want to assign a value to some field
 
866
Q: When entering a new PR, I want to assign a value to some field
815
867
(e.g., `Responsible') which is normally assigned by GNATS.
816
868
 
817
869
   A: (GNATS 3.1xx) This is not possible in GNATS 3.1xx.
824
876
 
825
877
File: gnats-faq.info,  Node: Clients,  Next: Glossary,  Prev: Configuration,  Up: Top
826
878
 
827
 
Client Software
828
 
***************
 
879
4 Client Software
 
880
*****************
829
881
 
830
 
   Several client applications can be found in the GNATS distribution.
 
882
Several client applications can be found in the GNATS distribution.
831
883
The most important are Gnatsweb (a WWW interface to GNATS), TkGnats (a
832
884
Tcl/Tk based interface), a GNATS mode for Emacs and XEmacs, and send-pr
833
885
(the traditional command line interface that sends a PR by e-mail).
842
894
 
843
895
File: gnats-faq.info,  Node: Gnatsweb,  Next: TkGnats,  Up: Clients
844
896
 
845
 
Gnatsweb
846
 
========
 
897
4.1 Gnatsweb
 
898
============
847
899
 
848
 
   See also *Note Gnatsweb and GNATS:: in the chapter on *Note
 
900
See also *Note Gnatsweb and GNATS:: in the chapter on *Note
849
901
Installation::.
850
902
 
851
903
* Menu:
855
907
 
856
908
File: gnats-faq.info,  Node: Gnatsweb Login Questions,  Up: Gnatsweb
857
909
 
858
 
Login Questions
859
 
---------------
 
910
4.1.1 Login Questions
 
911
---------------------
860
912
 
861
913
* Menu:
862
914
 
870
922
What should be entered as login information?
871
923
............................................
872
924
 
873
 
   A: If you get an HTML form asking you to enter username, password,
874
 
and database, use what your gnats administrator has told you.  In this
 
925
A: If you get an HTML form asking you to enter username, password, and
 
926
database, use what your gnats administrator has told you.  In this
875
927
case, your authentication data is checked with gnatsd's own user
876
928
database.
877
929
 
887
939
Login data are not remembered
888
940
.............................
889
941
 
890
 
   Q: After logging in via Gnatsweb, the main screen is displayed, but
 
942
Q: After logging in via Gnatsweb, the main screen is displayed, but
891
943
whatever action is selected (whatever button is clicked), the login
892
944
screen gets displayed again.
893
945
 
911
963
Gnatsweb and Cookies
912
964
....................
913
965
 
914
 
   Q: Wait a moment!  Cookies?  Can I eat them?
 
966
Q: Wait a moment!  Cookies?  Can I eat them?
915
967
 
916
968
   A: No, not these.  The cookies about which we are talking here are
917
969
little data packages that a web-server sends to your browser (in our
941
993
 
942
994
File: gnats-faq.info,  Node: TkGnats,  Next: Emacs mode,  Prev: Gnatsweb,  Up: Clients
943
995
 
944
 
TkGnats
945
 
=======
 
996
4.2 TkGnats
 
997
===========
946
998
 
947
 
   To be completed.
 
999
To be completed.
948
1000
 
949
1001
 
950
1002
File: gnats-faq.info,  Node: Emacs mode,  Next: send-pr,  Prev: TkGnats,  Up: Clients
951
1003
 
952
 
GNATS Mode for Emacs
953
 
====================
 
1004
4.3 GNATS Mode for Emacs
 
1005
========================
954
1006
 
955
 
   The Emacs mode is in the file gnats.el
 
1007
The Emacs mode is in the file gnats.el
956
1008
 
957
1009
* Menu:
958
1010
 
964
1016
Does it also work for XEmacs?
965
1017
.............................
966
1018
 
967
 
   A: (GNATS 3.1xx) Yes.
 
1019
A: (GNATS 3.1xx) Yes.
968
1020
 
969
1021
   A: (GNATS 4.x) Still to be tested.
970
1022
 
971
1023
 
972
1024
File: gnats-faq.info,  Node: send-pr,  Prev: Emacs mode,  Up: Clients
973
1025
 
974
 
send-pr
975
 
=======
 
1026
4.4 send-pr
 
1027
===========
976
1028
 
977
 
   A simple command line tool that sends a report via electronic mail.
 
1029
A simple command line tool that sends a report via electronic mail.
978
1030
This is not contributed software, but part of GNATS itself.
979
1031
 
980
1032
   The 3.xxx versions do not support multiple databases.
984
1036
 
985
1037
File: gnats-faq.info,  Node: Glossary,  Next: Index,  Prev: Clients,  Up: Top
986
1038
 
987
 
Glossary
988
 
********
 
1039
Appendix A Glossary
 
1040
*******************
989
1041
 
990
1042
"cookie"
991
1043
     A chunk of data that a WWW server stores in your browser.  It is
1038
1090
Index
1039
1091
*****
1040
1092
 
 
1093
[index]
1041
1094
* Menu:
1042
1095
 
1043
 
* bug reporting:                         Bug Reporting.
1044
 
* cookies:                               Cookies.
1045
 
* GNATS server, see gnatsd:              Gnatsd.
1046
 
* gnatsd:                                Gnatsd.
1047
 
* gnatsd, starting:                      Administrator View.
1048
 
* inetd:                                 inetd configuration.
1049
 
* port:                                  Port Number.
1050
 
* server port:                           Port Number.
1051
 
* server, see gnatsd:                    Gnatsd.
1052
 
* starting gnatsd:                       Administrator View.
1053
 
* xinetd:                                xinetd configuration.
 
1096
* bug reporting:                         Bug Reporting.         (line 6)
 
1097
* cookies:                               Cookies.               (line 6)
 
1098
* GNATS server, see gnatsd:              Gnatsd.                (line 6)
 
1099
* gnatsd:                                Gnatsd.                (line 6)
 
1100
* gnatsd, starting:                      Administrator View.    (line 6)
 
1101
* inetd:                                 inetd configuration.   (line 6)
 
1102
* port:                                  Port Number.           (line 6)
 
1103
* server port:                           Port Number.           (line 6)
 
1104
* server, see gnatsd:                    Gnatsd.                (line 6)
 
1105
* starting gnatsd:                       Administrator View.    (line 6)
 
1106
* xinetd:                                xinetd configuration.  (line 6)
1054
1107
 
1055
1108
 
1056
1109
 
1057
1110
Tag Table:
1058
1111
Node: Top1052
1059
 
Node: General2059
1060
 
Node: What is GNATS2536
1061
 
Node: User view4171
1062
 
Node: Administrator View4764
1063
 
Node: How to pronounce it5163
1064
 
Node: Get it5542
1065
 
Node: Versions5928
1066
 
Node: Mailing Lists6668
1067
 
Node: Bug Reporting7910
1068
 
Node: Installation9283
1069
 
Node: Gnatsweb and GNATS9628
1070
 
Node: Configuration10231
1071
 
Node: General configuration10647
1072
 
Node: Add a database10995
1073
 
Node: Renaming a Category17634
1074
 
Node: Changing Fields18814
1075
 
Node: Gnatsd19549
1076
 
Node: Port Number19912
1077
 
Node: Starting gnatsd20703
1078
 
Node: inetd configuration21244
1079
 
Node: xinetd configuration21952
1080
 
Node: Gnatsd messages23000
1081
 
Node: No host access for stdin23264
1082
 
Node: No host access for remote24720
1083
 
Node: E-Mail27073
1084
 
Node: queue-pr not available27344
1085
 
Node: Outgoing mail bounces28049
1086
 
Node: Miscellaneous29429
1087
 
Node: No New Reports29796
1088
 
Node: Initially Assign Field Values30850
1089
 
Node: Clients31482
1090
 
Node: Gnatsweb32132
1091
 
Node: Gnatsweb Login Questions32376
1092
 
Node: What to enter32686
1093
 
Node: Login Not Remembered33379
1094
 
Node: Cookies34381
1095
 
Node: TkGnats35777
1096
 
Node: Emacs mode35905
1097
 
Node: XEmacs36152
1098
 
Node: send-pr36353
1099
 
Node: Glossary36654
1100
 
Node: Index38364
 
1112
Node: General2055
 
1113
Node: What is GNATS2613
 
1114
Node: User view4253
 
1115
Node: Administrator View4855
 
1116
Node: How to pronounce it5263
 
1117
Node: Get it5647
 
1118
Node: Versions6038
 
1119
Node: Mailing Lists6844
 
1120
Node: Bug Reporting8415
 
1121
Node: Upgrading9981
 
1122
Node: Installation11500
 
1123
Node: Gnatsweb and GNATS11846
 
1124
Node: Configuration12647
 
1125
Node: General configuration13067
 
1126
Node: Add a database13423
 
1127
Node: Renaming a Category20136
 
1128
Node: Changing Fields21325
 
1129
Node: Gnatsd22072
 
1130
Node: Port Number22443
 
1131
Node: Starting gnatsd23243
 
1132
Node: inetd configuration23793
 
1133
Node: xinetd configuration24498
 
1134
Node: Gnatsd messages25547
 
1135
Node: No host access for stdin25823
 
1136
Node: No host access for remote27276
 
1137
Node: E-Mail29665
 
1138
Node: queue-pr not available29944
 
1139
Node: Outgoing mail bounces30646
 
1140
Node: Miscellaneous32023
 
1141
Node: No New Reports32398
 
1142
Node: Initially Assign Field Values33452
 
1143
Node: Clients34081
 
1144
Node: Gnatsweb34732
 
1145
Node: Gnatsweb Login Questions34981
 
1146
Node: What to enter35303
 
1147
Node: Login Not Remembered35993
 
1148
Node: Cookies36992
 
1149
Node: TkGnats38385
 
1150
Node: Emacs mode38518
 
1151
Node: XEmacs38770
 
1152
Node: send-pr38968
 
1153
Node: Glossary39274
 
1154
Node: Index41006
1101
1155
 
1102
1156
End Tag Table