sc: Citing Commands

 
 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.
 
    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.  SeeConfiguring 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.  SeeConfiguring 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
      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’.