@finalout
@end iftex
-@dircategory Editors
-@direntry
-* SC: (sc). Supercite lets you cite parts of messages you're
- replying to, in flexible ways.
-@end direntry
-
@c @setchapternewpage odd % For book style double sided manual.
@comment %**end of header (This is for running Texinfo on a region.)
-@c @smallbook
-@tex
-\overfullrule=0pt
-%\global\baselineskip 30pt % For printing in double spaces
-@end tex
-@ifinfo
+
+@copying
This document describes the Supercite Version 3.1 package for citing and
attributing the replies for various GNU Emacs mail and news reading
subsystems.
-Copyright @copyright{} 1993 Barry A@. Warsaw
+Copyright @copyright{} 1993, 2001, 2002, 2003, 2004,
+2005, 2006 Free Software Foundation, Inc.
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, with the Front-Cover texts being ``A GNU
+Manual'', and with the Back-Cover Texts as in (a) below. A copy of the
+license is included in the section entitled ``GNU Free Documentation
+License'' in the Emacs manual.
+
+(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+this GNU Manual, like GNU software. Copies published by the Free
+Software Foundation raise funds for GNU development.''
+
+This document is part of a collection distributed under the GNU Free
+Documentation License. If you want to distribute this document
+separately from the collection, you can do so by adding a copy of the
+license to the document, as described in section 6 of the license.
+@end quotation
+@end copying
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
+@c @smallbook
-@ignore
-Permission is granted to process this file through TeX and print the
-results, provided the printed document carries copying permission
-notice identical to this one except for the removal of this paragraph
-(this paragraph not being relevant to the printed manual).
+@dircategory Emacs
+@direntry
+* SC: (sc). Supercite lets you cite parts of messages you're
+ replying to, in flexible ways.
+@end direntry
-@end ignore
-@end ifinfo
-@c
@titlepage
@sp 6
@center @titlefont{Supercite User's Manual}
@center @t{@dots{}!uunet!cen.com!bwarsaw}
@page
@vskip 0pt plus 1filll
-Copyright @copyright{} 1993 Barry A@. Warsaw
-
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
-
+@insertcopying
@end titlepage
-@page
-@ifinfo
+
+@ifnottex
@node Top, Introduction, (dir), (dir)
@comment node-name, next, previous, up
* Key Index::
* Variable Index::
@end menu
-@end ifinfo
+@end ifnottex
+
@node Introduction, Usage Overview, Top, Top
@comment node-name, next, previous, up
@cindex modeline
Next, Supercite visits each line in the reply, transforming the line
-according to a customizable ``script''. Lines which were not previously
+according to a customizable ``script.'' Lines which were not previously
cited in the original message are given a citation, while already cited
lines remain untouched, or are coerced to your preferred style.
Finally, Supercite installs a keymap into the reply buffer so that you
change @code{sc-citation-root-regexp} you should always also change
@code{sc-citation-nonnested-root-regexp}.@refill
-Nemacs users:@: For best results, try setting
-@code{sc-citation-root-regexp} to:@refill
-
-@example
-"\\([-._a-zA-Z0-9]\\|\\cc\\|\\cC\\|\\ch\\|\\cH\\|\\ck\\|\\cK\\|\\ca\\|\\cg\\|\\cr\\|\\cu\\)*"
-@end example
-
-Mule users:@: For best results, try setting
-@code{sc-citation-root-regexp} to:@refill
-
-@example
-"\\([-._a-zA-Z0-9]\\|\\cj\\)*"
-@end example
-
@node Information Keys and the Info Alist, Reference Headers, Miscellaneous Commands, Top
@comment node-name, next, previous, up
@cindex information keys
variable. The name of this variable has been agreed to in advance as
part of the @dfn{citation interface specification}. By default this
hook variable has a @code{nil} value, which the MUA recognizes to mean,
-``use your default citation function''. When you add Supercite's
+``use your default citation function.'' When you add Supercite's
citation function to the hook, thereby giving the variable a
non-@code{nil} value, it tells the MUA to run the hook via
@code{run-hooks} instead of using the default citation.@refill
(setq mail-citation-hook 'sc-cite-original)
@end example
-Note the lack of of a single quote on the first argument to @code{setq}.
+Note the lack of a single quote on the first argument to @code{setq}.
@node MH-E with any Emacsen, VM with any Emacsen, Emacs 18 MUAs, Getting Connected
@comment node-name, next, previous, up
initializes the reply buffer:
@enumerate
-@item
+@item
@vindex sc-pre-hook
@vindex pre-hook (sc-)
@emph{Runs @code{sc-pre-hook}.}
into the reply buffer's keymap. Instead, it puts its commands on a
keymap prefix, then installs this prefix onto the buffer's keymap. What
this means is that you typically have to type more characters to invoke
-a Supercite command, but Supercite's keybindings can be made much more
+a Supercite command, but Supercite's key bindings can be made much more
consistent across MUAs.
You can control what key Supercite uses as its keymap prefix by changing
the variable @code{sc-mode-map-prefix}. By default, this variable is
set to @code{C-c C-p}; a finger twister perhaps, but unfortunately the
-best default due to the scarcity of available keybindings in many MUAs.
+best default due to the scarcity of available key bindings in many MUAs.
@item
@emph{Turns on Supercite minor mode.}
active in that buffer by displaying the string @samp{SC}.
@item
-@emph{Sets the ``Undo Boundary''.}
+@emph{Sets the ``Undo Boundary.''}
@cindex undo boundary
Supercite sets an undo boundary before it begins to modify the original
yanked text. This allows you to easily undo Supercite's changes to
affect alternative citing styles.
-@item
+@item
@emph{Processes the mail headers.}
@vindex sc-confirm-always-p
@vindex confirm-always-p (sc-)
attribution string and a citation string which it will use to cite the
original message. @xref{Selecting an Attribution}, for details.
-@item
+@item
@emph{Cites the message body.}
@vindex sc-cite-region-limit
@vindex cite-region-limit (sc-)b
recognize those styles you see often.
@xref{Configuring the Citation Engine}, for details.@refill
-@item
+@item
@emph{Runs @code{sc-post-hook}.}
@vindex sc-post-hook
@vindex post-hook (sc-)
@vindex sc-use-only-preference-p
@vindex use-only-preference-p (sc-)
Also, if the preferred attribution, which you specified in your
-@code{sc-preferred-attribution-alist} variable cannot be found, a
+@code{sc-preferred-attribution-list} variable cannot be found, a
secondary method can be employed to find a valid attribution string. The
variable @code{sc-use-only-preference-p} controls what happens in this
case. If the variable's value is non-@code{nil}, then
@item
Use the value of the @code{"x-attribution"} key.
-@item
+@item
Use the author's first name.
@item
@item
Use the author's initials.
-@item
+@item
Find the first non-@code{nil}, non-empty attribution string in the
attribution alist.
-@item
+@item
@code{sc-default-attribution} is used.
@end enumerate
@table @asis
@item the symbol @code{continue}
This tells Regi to continue processing entries after a match, instead of
-reseting the frame and moving @samp{point}. In this way, lines of text
+resetting the frame and moving @samp{point}. In this way, lines of text
can have multiple matches, but you have to be careful to avoid entering
infinite loops.
Finally, the command @kbd{C-c C-p C-t h} (also @kbd{C-c C-p C-t ?})
brings up a Help message on the toggling keymap.
-
+
@node Mail Field Commands, Miscellaneous Commands, Variable Toggling Shortcuts, Post-yank Formatting Commands
@comment node-name, next, previous, up
steps:
@enumerate
-@item
+@item
Insert the original message, including the mail headers into the reply
buffer. At this point you should not modify the raw text in any way, and
you should place all the original headers into the body of the reply.
above the @code{mail-header-separator} line and one copy below,
however there will probably be more headers below this line.@refill
-@item
+@item
Set @samp{point} to the beginning of the line containing the first mail
header in the body of the reply. Set @samp{mark} at the end of the
message text. It is very important that the region be set around the
properly when the region is inactive, as should any other like-minded
package.@refill
-@item
+@item
Run the hook @code{mail-citation-hook}. You will probably want to
provide some kind of default citation functions in cases where the user
does not have Supercite installed. By default, your MUA should
@sp 2
@end iftex
@printindex vr
+@setchapternewpage odd
@summarycontents
@contents
@bye
+
+@ignore
+ arch-tag: 0521847a-4680-44b6-ae6e-13ce20e18436
+@end ignore