Changes to gnats/doc/s-usage.texi

[Milan Zamazal]

Index: gnats/doc/s-usage.texi
diff -c gnats/doc/s-usage.texi:1.1 gnats/doc/s-usage.texi:1.2
*** gnats/doc/s-usage.texi:1.1  Thu Jun 21 17:18:15 2001
--- gnats/doc/s-usage.texi      Tue Dec 11 16:36:11 2001
***************
*** 203,214 ****
  shell, you are prompted as to whether or not you wish to try editing the
  same Problem Report again.  If you are running @code{send-pr} from
  Emacs, the Problem Report is placed in the buffer
! @address@hidden; you can edit this file and then submit it
! with
! 
! @smallexample
! M-x gnats-submit-pr
! @end smallexample
  
  @cindex subsequent mail
  @cindex other mail
--- 203,210 ----
  shell, you are prompted as to whether or not you wish to try editing the
  same Problem Report again.  If you are running @code{send-pr} from
  Emacs, the Problem Report is placed in the buffer
! @address@hidden; you can edit this file and then submit it
! with @kbd{C-c C-c}.
  
  @cindex subsequent mail
  @cindex other mail
***************
*** 229,235 ****
  field in the order received.
  
  @c ---------------------------------------------------------------
! @node send-pr in Emacs 
  @section Using @code{send-pr} from within Emacs
  @cindex using @code{send-pr} from within Emacs
  @cindex @code{send-pr} within Emacs
--- 225,231 ----
  field in the order received.
  
  @c ---------------------------------------------------------------
! @node send-pr in Emacs
  @section Using @code{send-pr} from within Emacs
  @cindex using @code{send-pr} from within Emacs
  @cindex @code{send-pr} within Emacs
***************
*** 243,252 ****
  
  Call @code{send-pr} with @address@hidden address@hidden typing
  @address@hidden send-pr}} doesn't work, see your system administrator for
! help loading @code{send-pr} into Emacs.}  @code{send-pr} responds with a
! Problem Report template preconfigured for the Support Site from which
! you received @code{send-pr}.  (If you use @code{send-pr} locally, the
! default Support Site is probably your local site.)
  
  You may also submit problem reports to different Support Sites from the
  default site.  To use this feature, invoke @code{send-pr} with
--- 239,247 ----
  
  Call @code{send-pr} with @address@hidden address@hidden typing
  @address@hidden send-pr}} doesn't work, see your system administrator for
! help loading @file{gnats.el} into Emacs.}  @code{send-pr} responds with a
! Problem Report template preconfigured for the Support Site to which
! you are going to send the report.
  
  You may also submit problem reports to different Support Sites from the
  default site.  To use this feature, invoke @code{send-pr} with
***************
*** 257,380 ****
  
  @code{send-pr} prompts you for the name of a @var{site}.  @var{site} is
  an alias on your local machine which points to an alternate Support
! Site.
! 
! @cindex Emacs
! @code{send-pr} displays the template and prompts you in the minibuffer
! with the line:
! @smallexample
! >Category: other
! @end smallexample
! 
! @noindent
! Delete the default value @samp{other} @emph{in the minibuffer} and
! replace it with the keyword corresponding to your problem (the list of
! valid categories is in the topmost section of the PR template).  For
! example, if the problem you wish to report has to do with the @sc{gnu} C
! compiler, and your support organization accepts bugs submitted for this
! program under the category @samp{gcc}, delete @samp{other} and then type
! @address@hidden@key{RET}]}}.  @code{send-pr} replaces the line
! 
! @smallexample
! >Category:       <name of the product (one line)>
! @end smallexample
! 
! @noindent
! in the template with
! 
! @smallexample
! >Category:       gcc
! @end smallexample
! 
! @noindent
! and moves on to another field.  
! 
! @cindex completion in Emacs
! @cindex name completion in Emacs
! @address@hidden provides name completion in the minibuffer.  For
! instance, you can also type @address@hidden@key{TAB}]}}, and @code{send-pr}
! attempts to complete the entry for you.  Typing @address@hidden@key{TAB}]}}
! may not have the same effect if several possible entries begin with
! @samp{g}.  In that case @code{send-pr} cannot complete the entry because
! it cannot determine whether you mean @samp{gcc} or, for example,
! @samp{gdb}, if both of those are possible categories.
! @address@hidden continues to prompt you for a valid entry until you
! enter one.
! 
! @address@hidden prompts you interactively to enter each field for
! which there is a range of specific choices.  If you attempt to enter a
! value which is not in the range of acceptable entries, @code{send-pr}
! responds with @address@hidden match]}} and allows you to change the entry
! until it contains an acceptable value.  This avoids unusable information
! (at least in these fields) and also avoids typographical errors which
! could cause problems later.
! 
! @code{send-pr} prompts you for the following fields:
! 
! @c FIXME - should these go before the discussion on completion?
! @example
! @group
! >Category:
! >Confidential: (@emph{default}:  no)
! >Severity:     (@emph{default}:  serious)
! >Priority:     (@emph{default}:  medium)
! >Class:        (@emph{default}:  sw-bug)
! >Release:
! >Synopsis:     (@emph{this value is copied to @code{Subject:}})
! @end group
! @end example
! 
! @noindent
! After you complete these fields, @address@hidden places the cursor in
! the @samp{>Description:} field and displays the message
! 
! @smallexample
! To send the problem report use: C-c C-c
! @end smallexample
! 
! @noindent
! in the minibuffer.  At this point, edit the file in the main buffer to
! reflect your specific problem, putting relevant information in the
! proper fields.
! @ifset SENDPR
! @xref{An Example}, for a sample Problem Report.
! @end ifset
! 
! @address@hidden provides a few key bindings to make moving
! around in a template buffer more simple:
! 
! @table @code
! @item C-c C-f
! @itemx M-x change-field
! Changes the field under the cursor.  @code{edit-pr} prompts you for a
! new value.
! 
! @item M-C-b
! @itemx M-x gnats-backward-field
! Moves the cursor to the beginning of the value of the current field.
! 
! @item M-C-f
! @itemx M-x gnats-forward-field
! Moves the cursor to the end of the value of the current field.
! 
! @item M-p
! @itemx M-x gnats-previous-field
! Moves the cursor back one field to the beginning of the value of the
! previous field.
! 
! @item M-n
! @itemx M-x gnats-next-field
! Moves the cursor forward one field to the beginning of the value of the
! next field.
! @end table
! 
! @code{send-pr} takes over again when you type @samp{C-c C-c} to send the
! message.  @code{send-pr} reports any errors in a separate buffer, which
! remains in existence until you send the PR properly (or, of course,
! until you explicitly kill the buffer).
! 
! For detailed instructions on using Emacs, see
! @ref{Introduction,,,emacs,GNU Emacs}.
  
  @node send-pr from the shell
  @section Invoking @code{send-pr} from the shell
--- 252,259 ----
  
  @code{send-pr} prompts you for the name of a @var{site}.  @var{site} is
  an alias on your local machine which points to an alternate Support
! Site.  The Emacs interface to @sc{gnats} is described in a separate
! section, @xref{Emacs}.
  
  @node send-pr from the shell
  @section Invoking @code{send-pr} from the shell