Once the original message has been yanked into the reply buffer, and
sc-cite-original has had a chance to do its thing, a number of
useful Supercite commands will be available to you. Since there is wide
variety in the keymaps that MUAs set up in their reply buffers, it is
next to impossible for Supercite to properly sprinkle its commands into
the existing keymap. For this reason Supercite places its commands on a
separate keymap, putting this keymap onto a prefix key in the reply
buffer. You can customize the prefix key Supercite uses by changing the
sc-mode-map-prefix. By default, the
sc-mode-map-prefix is C-c C-p; granted, not a great choice,
but unfortunately the best general solution so far. In the rest of this
chapter, we'll assume you've installed Supercite's keymap on the default
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
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
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)
sc-cite-frame-alist, or the default citing frame
sc-default-cite-frame. It runs the hook
sc-pre-cite-hookbefore interpreting the frame. With an optional universal argument (C-u), it temporarily sets
tso you can confirm the attribution string for a single manual citing. See section Configuring the Citation Engine.
sc-uncite-region(C-c C-p u)
sc-uncite-frame-alist, or the default unciting frame
sc-default-uncite-frame. It runs the hook
sc-pre-uncite-hookbefore interpreting the frame. See section Configuring the Citation Engine.
sc-recite-region(C-c C-p r)
sc-recite-frame-alist, or the default reciting frame
sc-default-recite-frame. It runs the hook
sc-pre-recite-hookbefore interpreting the frame. See section Configuring the Citation Engine. Supercite will always ask you to confirm the attribution when reciting a region, regardless of the value of
These two functions insert various strings into the reply buffer.
sc-insert-reference(C-c C-p w)
sc-preferred-header-styleis inserted. An optional numeric argument is the index into
sc-rewrite-header-listindicating which reference header to write. With just the universal argument (C-u), electric reference mode is entered, regardless of the value of
sc-insert-citation(C-c C-p i)
Supercite defines a number of commands that make it easier for you to toggle and set various Supercite variables as you are editing the reply buffer. For example, you may want to turn off filling or whitespace cleanup, but only temporarily. These toggling shortcut commands make this easy to do.
Like Supercite commands in general, the toggling commands are placed on
a keymap prefix within the greater Supercite keymap. For the default
sc-mode-map-prefix, this will be
C-c C-p C-t.
The following commands toggle the value of certain Supercite variables which take only a binary value:
The following commands let you set the value of multi-value variables,
in the same way that Emacs'
One special command is provided to toggle both
This is because you typically want to run Supercite with either variable
nil or non-
nil. The command to toggle these variables
together is bound on C-c C-p C-p.
Finally, the command C-c C-p C-t h (also C-c C-p C-t ?) brings up a Help message on the toggling keymap.
These commands allow you to view, modify, add, and delete various bits of information from the info alist. See section Information Keys and the Info Alist.
sc-mail-field-query(C-c C-p f)
sc-mail-process-headers(C-c C-p g)
sc-open-line(C-c C-p o)
open-linecommands, but inserts the citation string in front of the new line. As with
open-line, an optional numeric argument inserts that many new lines.
sc-describe(C-c C-p h and C-c C-p ?)
sc-version(C-c C-p v)
sc-submit-bug-report(C-c C-p C-b)