Using edit-pr from within Emacs

Call edit-pr from within Emacs with M-x edit-pr(2). When edit-pr prompts you for a PR identification number, type the number of the PR you wish to edit.

If the PR is locked, Emacs announces the login name of the person who has locked the file. If not, M-x edit-pr locks the PR, loads it into a buffer named `*edit-pr*', and places the cursor in the `>Number:' field. (Do not change this field.)

Edit the PR to reflect correct information. Resubmit the PR to the database using `C-c C-c' (see below).

The easiest way to edit a PR from Emacs is to use the special key bindings provided. These are:

C-c C-c

M-x gnats-submit-pr

Saves and resubmits the PR currently being edited. Do this when you finish editing the PR; if you simply kill the buffer, your changes are lost.

C-x C-s

M-x save-buffer

Saves the current buffer tp a file. You are prompted for a filename. This is not a special key binding, but at one point in the history of GNATS it was used to resubmit the PR (i.e., it was bound to `M-x gnats-submit-pr'). `C-x C-s' now simply saves a copy of the PR. This command does not resubmit the PR to the database. Use `C-c C-c' to resubmit the PR.

C-x k

M-x gnats:kill-buffer (use this only with Emacs 18)

M-x kill-buffer

Kills the current buffer (destroying all changes) and unlocks the current PR. Use this to back out of a change without affecting the database.

C-c C-u

M-x unlock-pr

Unlocks a PR that you have locked. Use this if you have a locked PR from a failed editing session. You are prompted for the gnats-id of a PR to unlock.

C-c C-q

M-x unlock-buffer

Removes the lock on the current PR, allowing others to edit it. The buffer remains active and non-writeable. To relock a PR, simply type `e' in the buffer containing the Problem Report.

C-c C-e

M-x edit-pr

Runs edit-pr in a new buffer.

C-c C-f

M-x change-field

Changes the field under the cursor. edit-pr prompts you for a new value. If you use

C-u C-c C-f  or
C-u M-x change-field

you are prompted for a field to change.

C-c C-a

M-x gnats-mail-reply

Sends mail to the originator of this PR, using the address in the `From:' field of the mail header. The `Subject', `To:', and `Cc:' fields are constructed from the Problem Report currently being edited. Edit the message, and use `C-c C-c' to send it.

C-c RET

C-c C-m

M-x gnats-mail-other-window

Splits the current window, and starts a mail message. The `Subject:' field is constructed from the Problem Report currently being edited. Edit the message, and use `C-c C-c' to send it.

C-c C-r

M-x gnats-responsible-change-from-to

Changes the `>Responsible:' field. edit-pr prompts you for the new responsible person, and for a message describing the reason for the change. When you type `C-c C-c' to resubmit the PR, the cursor is placed in a mail buffer containing a copy of the change. You can then edit this buffer and type `C-c C-c' again to send the mail.

C-c C-s

M-x gnats-state-change-from-to

Changes the `>State:' field. edit-pr prompts you for the new state, and for a message describing the reason for the change. When you type `C-c C-c' to resubmit the PR, the cursor is placed in a mail buffer containing a copy of the change. You can then edit this buffer and type `C-c C-c' again to send the mail.

C-c C-t

M-x category-change-from-to

Changes the `>Category:' field of the PR. edit-pr prompts you for the new category. edit-pr also prompts you with the question

Update the >Responsible field?

Type `y' to change the value of the `>Responsible:' field to the name of the party responsible for the new category. Type `n' to keep the current value of `>Responsible:'.

M-C-b

M-x gnats-backward-field

Moves the cursor to the beginning of the value of the current field.

M-C-f

M-x gnats-forward-field

Moves the cursor to the end of the value of the current field.

M-p

M-x gnats-previous-field

Moves the cursor back one field to the beginning of the value of the previous field.

M-n

M-x gnats-next-field

Moves the cursor forward one field to the beginning of the value of the next field.

Go to the first, previous, next, last section, table of contents.