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. Note: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. Note: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. Note: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'.