1 new commit in supercite: https://bitbucket.org/xemacs/supercite/commits/a4d252435d88/ Changeset: a4d252435d88 User: Jerry James Date: 2014-05-13 21:54:54 Summary: Migrate .cvsignore files to a single .hgignore file. In addition: - Restore CVS keyword expansions that were lost during the switch to Mercurial - Update texinfo sources for texinfo 5.x See <CAHCOHQmqMvFtLqEt6M+w4vFyq9=e+i1Uy8zaQcUeAjeV3F9uWQ(a)mail.gmail.com&gt; in xemacs-patches and followups for details. Affected #: 4 files diff -r 6d62309d2d5a0cd18324dc458bdf5f586d5c0367 -r a4d252435d889aa34fa131bc0e1a425bf442eca6 .cvsignore --- a/.cvsignore +++ /dev/null ＠＠ -1,1 +0,0 ＠＠ -supercite*.html diff -r 6d62309d2d5a0cd18324dc458bdf5f586d5c0367 -r a4d252435d889aa34fa131bc0e1a425bf442eca6 .hgignore --- /dev/null +++ b/.hgignore ＠＠ -0,0 +1,12 ＠＠ +^#\..*#$ +^\.# +~$ +\.elc$ +\.html$ +\.info$ +^_pkg\.el$ +^auto-autoloads\.el$ +^custom-defines\.el$ +^custom-load\.el$ +^package-info$ +^pdepends\.mk$ diff -r 6d62309d2d5a0cd18324dc458bdf5f586d5c0367 -r a4d252435d889aa34fa131bc0e1a425bf442eca6 ChangeLog --- a/ChangeLog +++ b/ChangeLog ＠＠ -1,3 +1,9 ＠＠ +2014-05-13 Jerry James <james(a)xemacs.org&gt; + + * .cvsignore: Remove. + * .hgignore: New file. + * supercite.texi: Update for texinfo 5.x. + 2005-10-29 Norbert Koch <viteno(a)xemacs.org&gt; * Makefile (VERSION): XEmacs package 1.21 released. diff -r 6d62309d2d5a0cd18324dc458bdf5f586d5c0367 -r a4d252435d889aa34fa131bc0e1a425bf442eca6 supercite.texi --- a/supercite.texi +++ b/supercite.texi ＠＠ -17,7 +17,7 ＠＠ \overfullrule=0pt %\global\baselineskip 30pt % For printing in double spaces ＠end tex -＠ifinfo +＠ifnottex This document describes the Supercite Version 3.1 package for citing and attributing the replies for various GNU Emacs mail and news reading subsystems. ＠＠ -35,7 +35,7 ＠＠ (this paragraph not being relevant to the printed manual). ＠end ignore -＠end ifinfo +＠end ifnottex ＠c ＠titlepage ＠sp 6 ＠＠ -59,7 +59,7 ＠＠ ＠end titlepage ＠page -＠ifinfo +＠ifnottex ＠node Top, Introduction, (dir), (dir) ＠comment node-name, next, previous, up ＠＠ -87,14 +87,14 ＠＠ * Key Index:: * Variable Index:: ＠end menu -＠end ifinfo +＠end ifnottex ＠node Introduction, Usage Overview, Top, Top ＠comment node-name, next, previous, up ＠chapter Introduction -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Supercite version 3.1 is a GNU Emacs package written entirely in Emacs Lisp. It interfaces to most of the commonly used Emacs mail user agents (＠dfn{MUAs}) and news user agents (＠dfn{NUAs}), and provides ＠＠ -107,13 +107,13 ＠＠ and I won't be terribly offended if you use them. People often ask though＠dots{} -＠ifinfo +＠ifnottex ＠menu * Usage Overview:: * What Supercite Does Not Do:: * What Supercite Does:: ＠end menu -＠end ifinfo +＠end ifnottex ＠cindex MUA ＠cindex NUA ＠＠ -158,9 +158,9 ＠＠ ＠cindex attribute, attributing ＠comment ＠section Usage Overview -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Typical usage is as follows. You want to reply or followup to a message in your MUA. You will probably hit ＠kbd{r} (i.e., ``reply'') or ＠kbd{f} (i.e., ``forward'') to begin composing the reply. In response, the MUA ＠＠ -180,9 +180,9 ＠＠ ＠node What Supercite Does Not Do, What Supercite Does, Usage Overview, Introduction ＠comment node-name, next, previous, up ＠section What Supercite Doesn't Do -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Because of this clear division of labor, there are useful features which are the sole responsibility of the MUA, even though it might seem that Supercite should provide them. For example, many people would like to ＠＠ -206,9 +206,9 ＠＠ ＠comment node-name, next, previous, up ＠findex sc-cite-original ＠section What Supercite Does -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Supercite is invoked for the first time on a reply buffer via your MUA's reply or forward command. This command will actually perform citations by calling a hook variable to which Supercite's top-level function ＠＠ -272,9 +272,9 ＠＠ ＠cindex citation ＠comment ＠chapter Citations -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex A ＠dfn{citation} is the acknowledgement of the original author of a mail message in the body of the reply. There are two basic citation styles which Supercite supports. The first, called ＠dfn{nested citations} is ＠＠ -294,12 +294,12 ＠＠ And that's what I think too. ＠end example -＠ifinfo +＠ifnottex ＠menu * Citation Elements:: * Recognizing Citations:: ＠end menu -＠end ifinfo +＠end ifnottex Note that multiple inclusions of the original messages result in a nesting of the ＠samp{＠code{>}} characters. This can sometimes be quite ＠＠ -340,9 +340,9 ＠＠ ＠cindex citation string ＠comment ＠section Citation Elements -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex ＠dfn{Citation strings} are composed of one or more elements. Non-nested citations are composed of four elements, three of which are directly user definable. The elements are concatenated together, in this order: ＠＠ -397,9 +397,9 ＠＠ ＠node Recognizing Citations, Getting Connected, Citation Elements, Citations ＠comment node-name, next, previous, up ＠section Recognizing Citations -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Supercite also recognizes citations in the original article, and can transform these already cited lines in a number of ways. This is how Supercite suppresses the multiple citing of non-nested citations. ＠＠ -464,9 +464,9 ＠＠ ＠findex mail-field (sc-) ＠comment ＠chapter Information Keys and the Info Alist -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex ＠dfn{Mail header information keys} are nuggets of information that Supercite extracts from the various mail headers of the original message, placed in the reply buffer by the MUA. Information is kept in ＠＠ -573,9 +573,9 ＠＠ ＠comment node-name, next, previous, up ＠cindex reference headers ＠chapter Reference Headers -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Supercite will insert an informative ＠dfn{reference header} at the beginning of the cited body of text, which display more detail about the original article and provides the mapping between the attribution and ＠＠ -586,12 +586,12 ＠＠ information contained in the info alist can be inserted into a reference header. -＠ifinfo +＠ifnottex ＠menu * The Built-in Header Rewrite Functions:: * Electric References:: ＠end menu -＠end ifinfo +＠end ifnottex ＠cindex header rewrite functions ＠vindex sc-rewrite-header-list ＠＠ -618,9 +618,9 ＠＠ ＠cindex header rewrite functions, built-in ＠comment ＠section The Built-in Header Rewrite Functions -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Below are examples of the various built-in header rewrite functions. Please note the following:＠: first, the text which appears in the examples below as ＠var{infokey} indicates that the corresponding value ＠＠ -700,9 +700,9 ＠＠ ＠comment node-name, next, previous, up ＠cindex electric references ＠section Electric References -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex By default, when Supercite cites the original message for the first time, it just goes ahead and inserts the reference header indexed by ＠code{sc-preferred-header-style}. However, you may want to select ＠＠ -799,9 +799,9 ＠＠ ＠comment node-name, next, previous, up ＠cindex citation interface specification ＠chapter Getting Connected -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Hitting ＠kbd{C-c C-y} in your MUA's reply buffer yanks and cites the original message into the reply buffer. In reality, the citation of the original message is performed via a call through a configurable hook ＠＠ -813,7 +813,7 ＠＠ non-＠code{nil} value, it tells the MUA to run the hook via ＠code{run-hooks} instead of using the default citation.＠refill -＠ifinfo +＠ifnottex ＠menu * Emacs 19 MUAs:: * Emacs 18 MUAs:: ＠＠ -822,7 +822,7 ＠＠ * GNEWS with any Emacsen:: * Overloading for Non-conforming MUAs:: ＠end menu -＠end ifinfo +＠end ifnottex Early in Supercite's development, the Supercite author, a few MUA authors, and some early Supercite users got together and agreed upon a ＠＠ -891,9 +891,9 ＠＠ ＠vindex mail-citation-hook ＠cindex .emacs file ＠section GNUS, RMAIL, or RNEWS with any Emacs 19 -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex These MUAs, distributed with both FSF and Lucid GNU Emacs 19, use Emacs' built-in yanking facility, which provides the citing hook variable ＠code{mail-citation-hook}. By default, this hook's value is ＠code{nil}, ＠＠ -927,9 +927,9 ＠＠ ＠cindex overloading ＠cindex sendmail.el file ＠section GNUS, RMAIL, PCMAIL, RNEWS with Emacs 18 or Epoch 4 -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex These MUAs use Emacs' built-in yanking and citing routines, contained in the ＠file{sendmail.el} file. ＠file{sendmail.el} for Emacs 18, and its derivative Epoch 4, do not know anything about the citation interface ＠＠ -974,9 +974,9 ＠＠ ＠findex add-hook ＠cindex mail-citation-hook ＠section MH-E with any Emacsen -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex MH-E 4.x conforms to the ＠code{mail-citation-hook} interface supported by other MUAs. At the time of this writing, MH-E 4.0 has not been released, but if you have it, put this in your ＠file{.emacs} file to ＠＠ -1026,9 +1026,9 ＠＠ ＠vindex mail-citation-hook ＠vindex mail-yank-hooks ＠section VM with any Emacsen -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Since release 4.40, VM has supported the citation interface required by Supercite. But since the interface has changed recently the details of getting connected differ with the version of VM you are using. ＠＠ -1061,9 +1061,9 ＠＠ ＠findex perform-overloads (sc-) ＠vindex gnews-ready-hook ＠section GNEWS with any Emacsen -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex As far as I know, no version of GNEWS supports the citation interface required by Supercite. To connect Supercite with GNEWS, please first ＠pxref{Overloading for Non-conforming MUAs}. ＠＠ -1087,9 +1087,9 ＠＠ ＠findex sc-perform-overloads ＠cindex .emacs file ＠section Overloading for Non-conforming MUAs -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex As mentioned elsewhere, some MUAs do not provide the necessary hooks to connect with Supercite. Supercite version 3.1 provides an unsupported mechanism, called ＠dfn{overloading} which redefines certain key ＠＠ -1172,7 +1172,7 ＠＠ ＠node Replying and Yanking, Reply Buffer Initialization, Overloading for Non-conforming MUAs, Top ＠comment node-name, next, previous, up ＠chapter Replying and Yanking -＠ifinfo +＠ifnottex This chapter explains what happens when you reply and yank an original message from an MUA. ＠＠ -1181,16 +1181,16 ＠＠ * Reply Buffer Initialization:: * Filling Cited Text:: ＠end menu -＠end ifinfo +＠end ifnottex ＠node Reply Buffer Initialization, Filling Cited Text, Replying and Yanking, Replying and Yanking ＠comment node-name, next, previous, up ＠findex sc-cite-original ＠findex cite-original (sc-) ＠comment ＠section Reply Buffer Initialization -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Executing ＠code{sc-cite-original} performs the following steps as it initializes the reply buffer: ＠＠ -1355,9 +1355,9 ＠＠ ＠vindex sc-load-hook ＠vindex load-hook (sc-) ＠section Filling Cited Text -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Supercite will automatically fill newly cited text from the original message unless the variable ＠code{sc-auto-fill-region-p} has a ＠code{nil} value. Supercite will also re-fill paragraphs when you ＠＠ -1432,9 +1432,9 ＠＠ ＠vindex preferred-attribution-list (sc-) ＠comment ＠chapter Selecting an Attribution -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex As you know, the attribution string is the part of the author's name that will be used to composed a non-nested citation string. Supercite scans the various mail headers present in the original article and uses ＠＠ -1445,20 +1445,20 ＠＠ information as the author's first name, middle names, and last name, the author's initials, and the author's email terminus. -＠ifinfo +＠ifnottex ＠menu * Attribution Preferences:: * Anonymous Attributions:: * Author Names:: ＠end menu -＠end ifinfo +＠end ifnottex ＠node Attribution Preferences, Anonymous Attributions, Selecting an Attribution, Selecting an Attribution ＠comment node-name, next, previous, up ＠section Attribution Preferences -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex When you cite an original message, you can tell Supercite which part of the author's name you would prefer it to use as the attribution. The variable ＠code{sc-preferred-attribution-list} controls this; it contains ＠＠ -1566,9 +1566,9 ＠＠ ＠vindex default-attribution (sc-) ＠comment ＠section Anonymous Attributions -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex When the author's name cannot be found in the ＠samp{From:＠:} mail header, a fallback author name and attribution string must be supplied. The fallback author name is contained in the variable ＠＠ -1655,9 +1655,9 ＠＠ ＠comment node-name, next, previous, up ＠cindex author names ＠section Author Names -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Supercite employs a number of heuristics to decipher the author's name based on value of the ＠samp{From:＠:} mail field of the original message. Supercite can recognize almost all of the common ＠samp{From:＠:} field ＠＠ -1723,9 +1723,9 ＠＠ ＠cindex frames (Regi) ＠cindex entries (Regi) ＠chapter Configuring the Citation Engine -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex At the heart of Supercite is a regular expression interpreting engine called ＠dfn{Regi}. Regi operates by interpreting a data structure called a Regi-frame (or just ＠dfn{frame}), which is a list of ＠＠ -1737,12 +1737,12 ＠＠ throughout Supercite, from mail header information extraction, to header nuking, to citing text. -＠ifinfo +＠ifnottex ＠menu * Using Regi:: * Frames You Can Customize:: ＠end menu -＠end ifinfo +＠end ifnottex While the details of Regi are discussed below (＠pxref{Using Regi}), only those who wish to customize certain aspects of Supercite need concern ＠＠ -1764,9 +1764,9 ＠＠ ＠findex eval ＠findex looking-at ＠section Using Regi -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Regi works by interpreting frames with the function ＠code{regi-interpret}. A frame is a list of arbitrary size where each element is a entry of the following form: ＠＠ -1863,9 +1863,9 ＠＠ ＠comment node-name, next, previous, up ＠vindex sc-nuke-mail-header ＠section Frames You Can Customize -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex As mentioned earlier, Supercite uses various frames to perform certain jobs such as mail header information extraction and mail header nuking. However, these frames are not available for you to customize, ＠＠ -1932,9 +1932,9 ＠＠ ＠vindex mode-map-prefix (sc-) ＠kindex C-c C-p ＠chapter Post-yank Formatting Commands -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Once the original message has been yanked into the reply buffer, and ＠code{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 ＠＠ -1949,7 +1949,7 ＠＠ chapter, we'll assume you've installed Supercite's keymap on the default prefix.＠refill -＠ifinfo +＠ifnottex ＠menu * Citing Commands:: * Insertion Commands:: ＠＠ -1957,15 +1957,15 ＠＠ * Mail Field Commands:: * Miscellaneous Commands:: ＠end menu -＠end ifinfo +＠end ifnottex ＠node Citing Commands, Insertion Commands, Post-yank Formatting Commands, Post-yank Formatting Commands ＠comment node-name, next, previous, up ＠vindex sc-cite-region-limit ＠section Commands to Manually Cite, Recite, and Uncite -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex 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 ＠＠ -2039,9 +2039,9 ＠＠ ＠node Insertion Commands, Variable Toggling Shortcuts, Citing Commands, Post-yank Formatting Commands ＠comment node-name, next, previous, up ＠section Insertion Commands -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex These two functions insert various strings into the reply buffer. ＠table ＠asis ＠＠ -2075,9 +2075,9 ＠＠ ＠comment node-name, next, previous, up ＠cindex toggling variables ＠section Variable Toggling Shortcuts -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex 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 ＠＠ -2157,9 +2157,9 ＠＠ ＠node Mail Field Commands, Miscellaneous Commands, Variable Toggling Shortcuts, Post-yank Formatting Commands ＠comment node-name, next, previous, up ＠section Mail Field Commands -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex These commands allow you to view, modify, add, and delete various bits of information from the info alist. ＠xref{Information Keys and the Info Alist}.＠refill ＠＠ -2213,9 +2213,9 ＠＠ ＠node Miscellaneous Commands, Information Keys and the Info Alist, Mail Field Commands, Post-yank Formatting Commands ＠comment node-name, next, previous, up ＠section Miscellaneous Commands -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex ＠table ＠asis ＠findex sc-open-line ＠findex open-line (sc-) ＠＠ -2262,9 +2262,9 ＠＠ ＠node Hints to MUA Authors, Version 3 Changes, Electric References, Top ＠comment node-name, next, previous, up ＠chapter Hints to MUA Authors -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex In June of 1989, some discussion was held between the various MUA authors, the Supercite author, and other Supercite users. These discussions centered around the need for a standard interface between ＠＠ -2355,9 +2355,9 ＠＠ ＠node Version 3 Changes, Thanks and History, Hints to MUA Authors, Top ＠comment node-name, next, previous, up ＠chapter Version 3 Changes -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex ＠cindex sc-unsupp.el file With version 3, Supercite has undergone an almost complete rewrite, and has hopefully benefitted in a number of ways, including vast ＠＠ -2433,9 +2433,9 ＠＠ ＠node Thanks and History, The Supercite Mailing List, Version 3 Changes, Top ＠comment node-name, next, previous, up ＠chapter Thanks and History -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex The Supercite package was derived from its predecessor Superyank 1.11 which was inspired by various bits of code and ideas from Martin Neitzel and Ashwin Ram. They were the folks who came up with the idea of ＠＠ -2465,9 +2465,9 ＠＠ ＠cindex supercite mailing list address ＠cindex mailing list address ＠chapter The Supercite Mailing List -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Supercite is currently an orphan, and the mailing list has been decommissioned (see the message from the author below). The XEmacs package version of Supercite is maintained by the XEmacs Development ＠＠ -2526,9 +2526,9 ＠＠ ＠node Command Index, Key Index, Concept Index, Top ＠comment node-name, next, previous, up ＠unnumbered Command Index -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Since all supercite commands are prepended with the string ``＠code{sc-}'', each appears under its ＠code{sc-}＠var{command} name and its ＠var{command} name. ＠＠ -2545,9 +2545,9 ＠＠ ＠node Variable Index, , Key Index, Top ＠comment node-name, next, previous, up ＠unnumbered Variable Index -＠ifinfo +＠ifnottex -＠end ifinfo +＠end ifnottex Since all supercite variables are prepended with the string ``＠code{sc-}'', each appears under its ＠code{sc-}＠var{variable} name and its ＠var{variable} name. Repository URL: https://bitbucket.org/xemacs/supercite/ -- This is a commit notification from bitbucket.org. You are receiving this because you have the service enabled, addressing the recipient of this email. _______________________________________________ XEmacs-Patches mailing list XEmacs-Patches(a)xemacs.org http://lists.xemacs.org/mailman/listinfo/xemacs-patches