www.delorie.com/gnu/docs/emacs/sc_30.html

search

	Buy the book!

Supercite Version 3.1 User's Manual

9.1 Commands to Manually Cite, Recite, and Uncite

Probably the three most common post-yank formatting operations that you will perform will be the manual citing, reciting, and unciting of regions of text in the reply buffer. Often you may want to recite a paragraph to use a nickname, or manually cite a message when setting sc-cite-region-limit to nil. The following commands perform these functions on the region of text between `point' and `mark'. Each of them sets the undo boundary before modifying the region so that the command can be undone in the standard Emacs way.

A quick note about Emacs 19. Unlike in Emacs 18, the region delimited by `point' and `mark' can have two states. It can be active or inactive. Although Emacs 19 and Lucid Emacs 19 use different terminology and functions, both employ the same convention such that when the region is inactive, commands that modify the region should generate an error. The user needs to explicitly activate the region before successfully executing the command. All Supercite commands conform to this convention.

Here is the list of Supercite citing commands:

sc-cite-region (C-c C-p c)

This command cites each line in the region of text by interpreting the selected frame from sc-cite-frame-alist, or the default citing frame sc-default-cite-frame. It runs the hook sc-pre-cite-hook before interpreting the frame. With an optional universal argument (C-u), it temporarily sets sc-confirm-always-p to t so you can confirm the attribution string for a single manual citing. See section 8. Configuring the Citation Engine.

sc-uncite-region (C-c C-p u)

This command removes any citation strings from the beginning of each cited line in the region by interpreting the selected frame from sc-uncite-frame-alist, or the default unciting frame sc-default-uncite-frame. It runs the hook sc-pre-uncite-hook before interpreting the frame. See section 8. Configuring the Citation Engine.

sc-recite-region (C-c C-p r)

This command recites each line the region by interpreting the selected frame from sc-recite-frame-alist, or the default reciting frame sc-default-recite-frame. It runs the hook sc-pre-recite-hook before interpreting the frame. See section 8. Configuring the Citation Engine.

Supercite will always ask you to confirm the attribution when reciting a region, regardless of the value of sc-confirm-always-p.