diff options
| author | Lars Ingebrigtsen | 2019-08-15 15:27:01 -0700 |
|---|---|---|
| committer | Lars Ingebrigtsen | 2019-08-15 15:27:01 -0700 |
| commit | 7aefbe86f22a1c0b7d329c1931d0297f801e1f83 (patch) | |
| tree | 1cd64e57d80852ac53cfd2d0f576bf316edca2da /doc/misc | |
| parent | 3c494946913e164e997c5e57cba7474813039355 (diff) | |
| download | emacs-7aefbe86f22a1c0b7d329c1931d0297f801e1f83.tar.gz emacs-7aefbe86f22a1c0b7d329c1931d0297f801e1f83.zip | |
Remove mentions of XEmacs from the Gnus manual and faq
* doc/misc/gnus-faq.texi:
* doc/misc/gnus.texi: Remove references to XEmacs throughout.
Diffstat (limited to 'doc/misc')
| -rw-r--r-- | doc/misc/gnus-faq.texi | 43 | ||||
| -rw-r--r-- | doc/misc/gnus.texi | 190 |
2 files changed, 46 insertions, 187 deletions
diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi index 840cc082054..e2cfa796198 100644 --- a/doc/misc/gnus-faq.texi +++ b/doc/misc/gnus-faq.texi | |||
| @@ -104,7 +104,6 @@ misprints are the Gnus team's fault, sorry. | |||
| 104 | * FAQ 1-5:: I sometimes read references to No Gnus and Oort Gnus, | 104 | * FAQ 1-5:: I sometimes read references to No Gnus and Oort Gnus, |
| 105 | what are those? | 105 | what are those? |
| 106 | * FAQ 1-6:: Which version of Emacs do I need? | 106 | * FAQ 1-6:: Which version of Emacs do I need? |
| 107 | * FAQ 1-7:: How do I run Gnus on both Emacs and XEmacs? | ||
| 108 | @end menu | 107 | @end menu |
| 109 | 108 | ||
| 110 | @node FAQ 1-1 | 109 | @node FAQ 1-1 |
| @@ -161,10 +160,9 @@ Where and how to get Gnus? | |||
| 161 | 160 | ||
| 162 | @subsubheading Answer | 161 | @subsubheading Answer |
| 163 | 162 | ||
| 164 | Gnus is released independent from releases of Emacs and XEmacs. | 163 | Gnus is released independent from releases of Emacs. Therefore, the |
| 165 | Therefore, the version bundled with Emacs or the version in XEmacs's | 164 | version bundled with Emacs might not be up to date (e.g., Gnus 5.9 |
| 166 | package system might not be up to date (e.g., Gnus 5.9 bundled with Emacs | 165 | bundled with Emacs 21 is outdated). |
| 167 | 21 is outdated). | ||
| 168 | You can get the latest released version of Gnus from | 166 | You can get the latest released version of Gnus from |
| 169 | @uref{http://www.gnus.org/dist/gnus.tar.gz} | 167 | @uref{http://www.gnus.org/dist/gnus.tar.gz} |
| 170 | or from | 168 | or from |
| @@ -187,13 +185,11 @@ tarball with some packer (e.g., Winace from | |||
| 187 | and use the batch-file make.bat included in the tarball to install | 185 | and use the batch-file make.bat included in the tarball to install |
| 188 | Gnus.) If you don't want to (or aren't allowed to) install Gnus | 186 | Gnus.) If you don't want to (or aren't allowed to) install Gnus |
| 189 | system-wide, you can install it in your home directory and add the | 187 | system-wide, you can install it in your home directory and add the |
| 190 | following lines to your ~/.xemacs/init.el or ~/.emacs: | 188 | following lines to your ~/.emacs: |
| 191 | 189 | ||
| 192 | @example | 190 | @example |
| 193 | (add-to-list 'load-path "/path/to/gnus/lisp") | 191 | (add-to-list 'load-path "/path/to/gnus/lisp") |
| 194 | (if (featurep 'xemacs) | 192 | (add-to-list 'Info-default-directory-list "/path/to/gnus/texi/") |
| 195 | (add-to-list 'Info-directory-list "/path/to/gnus/texi/") | ||
| 196 | (add-to-list 'Info-default-directory-list "/path/to/gnus/texi/")) | ||
| 197 | @end example | 193 | @end example |
| 198 | @noindent | 194 | @noindent |
| 199 | 195 | ||
| @@ -224,21 +220,9 @@ Which version of Emacs do I need? | |||
| 224 | @subsubheading Answer | 220 | @subsubheading Answer |
| 225 | 221 | ||
| 226 | Gnus 5.13 requires an Emacs version that is greater than or equal | 222 | Gnus 5.13 requires an Emacs version that is greater than or equal |
| 227 | to Emacs 23.1 or XEmacs 21.1, although there are some features that | 223 | to Emacs 23.1, although there are some features that |
| 228 | only work on Emacs 24. | 224 | only work on Emacs 24. |
| 229 | 225 | ||
| 230 | @node FAQ 1-7 | ||
| 231 | @subsubheading Question 1.7 | ||
| 232 | |||
| 233 | How do I run Gnus on both Emacs and XEmacs? | ||
| 234 | |||
| 235 | @subsubheading Answer | ||
| 236 | |||
| 237 | You can't use the same copy of Gnus in both as the Lisp | ||
| 238 | files are byte-compiled to a format which is different | ||
| 239 | depending on which Emacs did the compilation. Get one copy | ||
| 240 | of Gnus for Emacs and one for XEmacs. | ||
| 241 | |||
| 242 | @node FAQ 2 - Startup / Group buffer | 226 | @node FAQ 2 - Startup / Group buffer |
| 243 | @subsection Startup / Group buffer | 227 | @subsection Startup / Group buffer |
| 244 | 228 | ||
| @@ -1389,9 +1373,8 @@ installed and in your Path. Then you need | |||
| 1389 | @uref{http://www.kdstevens.com/~stevens/ispell-page.html, ispell.el} | 1373 | @uref{http://www.kdstevens.com/~stevens/ispell-page.html, ispell.el} |
| 1390 | and for on-the-fly spell-checking | 1374 | and for on-the-fly spell-checking |
| 1391 | @uref{http://www-sop.inria.fr/members/Manuel.Serrano/flyspell/flyspell.html, flyspell.el}. | 1375 | @uref{http://www-sop.inria.fr/members/Manuel.Serrano/flyspell/flyspell.html, flyspell.el}. |
| 1392 | Ispell.el is shipped with Emacs and available through the XEmacs package system, | 1376 | Ispell.el is shipped with Emacs, |
| 1393 | flyspell.el is shipped with Emacs and part of XEmacs text-modes package which is | 1377 | flyspell.el is shipped with Emacs, so there should be no need to install them |
| 1394 | available through the package system, so there should be no need to install them | ||
| 1395 | manually. | 1378 | manually. |
| 1396 | 1379 | ||
| 1397 | Ispell.el assumes you use ispell, if you choose aspell say | 1380 | Ispell.el assumes you use ispell, if you choose aspell say |
| @@ -1465,7 +1448,7 @@ node "Mail Aliases" in Message (not Gnus) manual for | |||
| 1465 | details. | 1448 | details. |
| 1466 | 1449 | ||
| 1467 | However, what you really want is the Insidious Big Brother | 1450 | However, what you really want is the Insidious Big Brother |
| 1468 | Database bbdb. Get it through the XEmacs package system or from | 1451 | Database bbdb. Get it from |
| 1469 | @uref{http://bbdb.sourceforge.net/, bbdb's homepage}. | 1452 | @uref{http://bbdb.sourceforge.net/, bbdb's homepage}. |
| 1470 | Now place the following in @file{~/.gnus.el}, to activate bbdb for Gnus: | 1453 | Now place the following in @file{~/.gnus.el}, to activate bbdb for Gnus: |
| 1471 | 1454 | ||
| @@ -1774,9 +1757,7 @@ more then one article." | |||
| 1774 | (let ((archive-name | 1757 | (let ((archive-name |
| 1775 | (format | 1758 | (format |
| 1776 | "nnml:1.%s" | 1759 | "nnml:1.%s" |
| 1777 | (if (featurep 'xemacs) | 1760 | (replace-in-string gnus-newsgroup-name "^.*:" "")))) |
| 1778 | (replace-in-string gnus-newsgroup-name "^.*:" "") | ||
| 1779 | (replace-regexp-in-string "^.*:" "" gnus-newsgroup-name))))) | ||
| 1780 | (gnus-summary-copy-article n archive-name))) | 1761 | (gnus-summary-copy-article n archive-name))) |
| 1781 | @end example | 1762 | @end example |
| 1782 | @noindent | 1763 | @noindent |
| @@ -2289,8 +2270,8 @@ whatever-server which offers Gnus a standardized interface | |||
| 2289 | to functions like "get message", "get Headers" etc. | 2270 | to functions like "get message", "get Headers" etc. |
| 2290 | 2271 | ||
| 2291 | @item Emacs | 2272 | @item Emacs |
| 2292 | When the term Emacs is used in this FAQ, it means either GNU | 2273 | When the term Emacs is used in this FAQ, it means GNU |
| 2293 | Emacs or XEmacs. | 2274 | Emacs. |
| 2294 | 2275 | ||
| 2295 | @item Message | 2276 | @item Message |
| 2296 | In this FAQ message means either a mail or a posting to a | 2277 | In this FAQ message means either a mail or a posting to a |
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index 81e3c1dda5b..28a5eccc6ae 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi | |||
| @@ -821,7 +821,7 @@ Various | |||
| 821 | * Undo:: Some actions can be undone. | 821 | * Undo:: Some actions can be undone. |
| 822 | * Predicate Specifiers:: Specifying predicates. | 822 | * Predicate Specifiers:: Specifying predicates. |
| 823 | * Moderation:: What to do if you're a moderator. | 823 | * Moderation:: What to do if you're a moderator. |
| 824 | * Image Enhancements:: Modern versions of Emacs/XEmacs can display images. | 824 | * Image Enhancements:: Modern versions of Emacs can display images. |
| 825 | * Fuzzy Matching:: What's the big fuzz? | 825 | * Fuzzy Matching:: What's the big fuzz? |
| 826 | * Thwarting Email Spam:: Simple ways to avoid unsolicited commercial email. | 826 | * Thwarting Email Spam:: Simple ways to avoid unsolicited commercial email. |
| 827 | * Spam Package:: A package for filtering and processing spam. | 827 | * Spam Package:: A package for filtering and processing spam. |
| @@ -876,7 +876,6 @@ Spam Statistics Package | |||
| 876 | 876 | ||
| 877 | Appendices | 877 | Appendices |
| 878 | 878 | ||
| 879 | * XEmacs:: Requirements for installing under XEmacs. | ||
| 880 | * History:: How Gnus got where it is today. | 879 | * History:: How Gnus got where it is today. |
| 881 | * On Writing Manuals:: Why this is not a beginner's guide. | 880 | * On Writing Manuals:: Why this is not a beginner's guide. |
| 882 | * Terminology:: We use really difficult, like, words here. | 881 | * Terminology:: We use really difficult, like, words here. |
| @@ -924,7 +923,6 @@ Gnus Reference Guide | |||
| 924 | * Ranges:: A handy format for storing mucho numbers. | 923 | * Ranges:: A handy format for storing mucho numbers. |
| 925 | * Group Info:: The group info format. | 924 | * Group Info:: The group info format. |
| 926 | * Extended Interactive:: Symbolic prefixes and stuff. | 925 | * Extended Interactive:: Symbolic prefixes and stuff. |
| 927 | * Emacs/XEmacs Code:: Gnus can be run under all modern Emacsen. | ||
| 928 | * Various File Formats:: Formats of files that Gnus use. | 926 | * Various File Formats:: Formats of files that Gnus use. |
| 929 | 927 | ||
| 930 | Back End Interface | 928 | Back End Interface |
| @@ -4319,9 +4317,7 @@ names: | |||
| 4319 | @item nnmail-pathname-coding-system | 4317 | @item nnmail-pathname-coding-system |
| 4320 | @vindex nnmail-pathname-coding-system | 4318 | @vindex nnmail-pathname-coding-system |
| 4321 | The value of this variable should be a coding system or @code{nil}. The | 4319 | The value of this variable should be a coding system or @code{nil}. The |
| 4322 | default is @code{nil} in Emacs, or is the aliasee of the coding system | 4320 | default is @code{nil} in Emacs. |
| 4323 | named @code{file-name} (a certain coding system of which an alias is | ||
| 4324 | @code{file-name}) in XEmacs. | ||
| 4325 | 4321 | ||
| 4326 | The @code{nnml} back end, the @code{nnrss} back end, the agent, and | 4322 | The @code{nnml} back end, the @code{nnrss} back end, the agent, and |
| 4327 | the cache use non-@acronym{ASCII} group names in those files and | 4323 | the cache use non-@acronym{ASCII} group names in those files and |
| @@ -4329,17 +4325,14 @@ directories. This variable overrides the value of | |||
| 4329 | @code{file-name-coding-system} which specifies the coding system used | 4325 | @code{file-name-coding-system} which specifies the coding system used |
| 4330 | when encoding and decoding those file names and directory names. | 4326 | when encoding and decoding those file names and directory names. |
| 4331 | 4327 | ||
| 4332 | In XEmacs (with the @code{mule} feature), @code{file-name-coding-system} | 4328 | Emacs uses the value of @code{default-file-name-coding-system} if |
| 4333 | is the only means to specify the coding system used to encode and decode | 4329 | @code{file-name-coding-system} is @code{nil} or it is bound to the |
| 4334 | file names. On the other hand, Emacs uses the value of | 4330 | value of @code{nnmail-pathname-coding-system} which is @code{nil}. |
| 4335 | @code{default-file-name-coding-system} if @code{file-name-coding-system} | ||
| 4336 | is @code{nil} or it is bound to the value of | ||
| 4337 | @code{nnmail-pathname-coding-system} which is @code{nil}. | ||
| 4338 | 4331 | ||
| 4339 | Normally the value of @code{default-file-name-coding-system} in Emacs or | 4332 | Normally the value of @code{default-file-name-coding-system} is |
| 4340 | @code{nnmail-pathname-coding-system} in XEmacs is initialized according | 4333 | initialized according to the locale, so you will need to do nothing if |
| 4341 | to the locale, so you will need to do nothing if the value is suitable | 4334 | the value is suitable to encode and decode non-@acronym{ASCII} group |
| 4342 | to encode and decode non-@acronym{ASCII} group names. | 4335 | names. |
| 4343 | 4336 | ||
| 4344 | The value of this variable (or @code{default-file-name-coding-system}) | 4337 | The value of this variable (or @code{default-file-name-coding-system}) |
| 4345 | does not necessarily need to be the same value that is determined by | 4338 | does not necessarily need to be the same value that is determined by |
| @@ -12557,11 +12550,11 @@ still a pain, though. | |||
| 12557 | 12550 | ||
| 12558 | This variable controls which information should be exposed in the | 12551 | This variable controls which information should be exposed in the |
| 12559 | User-Agent header. It can be a list of symbols or a string. Valid | 12552 | User-Agent header. It can be a list of symbols or a string. Valid |
| 12560 | symbols are @code{gnus} (show Gnus version) and @code{emacs} (show Emacs | 12553 | symbols are @code{gnus} (show Gnus version) and @code{emacs} (show |
| 12561 | version). In addition to the Emacs version, you can add @code{codename} | 12554 | Emacs version). In addition to the Emacs version, you can add |
| 12562 | (show (S)XEmacs codename) or either @code{config} (show system | 12555 | @code{config} (show system configuration) or @code{type} (show system |
| 12563 | configuration) or @code{type} (show system type). If you set it to a | 12556 | type). If you set it to a string, be sure to use a valid format, see |
| 12564 | string, be sure to use a valid format, see RFC 2616. | 12557 | RFC 2616. |
| 12565 | 12558 | ||
| 12566 | @end table | 12559 | @end table |
| 12567 | 12560 | ||
| @@ -17154,8 +17147,7 @@ The directory where @code{nnrss} stores its files. The default is | |||
| 17154 | @vindex nnrss-file-coding-system | 17147 | @vindex nnrss-file-coding-system |
| 17155 | The coding system used when reading and writing the @code{nnrss} groups | 17148 | The coding system used when reading and writing the @code{nnrss} groups |
| 17156 | data files. The default is the value of | 17149 | data files. The default is the value of |
| 17157 | @code{mm-universal-coding-system} (which defaults to @code{emacs-mule} | 17150 | @code{mm-universal-coding-system} (which defaults to @code{emacs-mule}). |
| 17158 | in Emacs or @code{escape-quoted} in XEmacs). | ||
| 17159 | 17151 | ||
| 17160 | @item nnrss-ignore-article-fields | 17152 | @item nnrss-ignore-article-fields |
| 17161 | @vindex nnrss-ignore-article-fields | 17153 | @vindex nnrss-ignore-article-fields |
| @@ -21102,13 +21094,7 @@ and `gnus-score-decay-scale'." | |||
| 21102 | (max gnus-score-decay-constant | 21094 | (max gnus-score-decay-constant |
| 21103 | (* (abs score) | 21095 | (* (abs score) |
| 21104 | gnus-score-decay-scale))))))) | 21096 | gnus-score-decay-scale))))))) |
| 21105 | (if (and (featurep 'xemacs) | 21097 | (floor n))) |
| 21106 | ;; XEmacs's floor can handle only the floating point | ||
| 21107 | ;; number below the half of the maximum integer. | ||
| 21108 | (> (abs n) (lsh -1 -2))) | ||
| 21109 | (string-to-number | ||
| 21110 | (car (split-string (number-to-string n) "\\."))) | ||
| 21111 | (floor n)))) | ||
| 21112 | @end lisp | 21098 | @end lisp |
| 21113 | 21099 | ||
| 21114 | @vindex gnus-score-decay-scale | 21100 | @vindex gnus-score-decay-scale |
| @@ -22270,7 +22256,7 @@ to you, using @kbd{G b u} and updating the group will usually fix this. | |||
| 22270 | * Predicate Specifiers:: Specifying predicates. | 22256 | * Predicate Specifiers:: Specifying predicates. |
| 22271 | * Moderation:: What to do if you're a moderator. | 22257 | * Moderation:: What to do if you're a moderator. |
| 22272 | * Fetching a Group:: Starting Gnus just to read a group. | 22258 | * Fetching a Group:: Starting Gnus just to read a group. |
| 22273 | * Image Enhancements:: Modern versions of Emacs/XEmacs can display images. | 22259 | * Image Enhancements:: Modern versions of Emacs can display images. |
| 22274 | * Fuzzy Matching:: What's the big fuzz? | 22260 | * Fuzzy Matching:: What's the big fuzz? |
| 22275 | * Thwarting Email Spam:: Simple ways to avoid unsolicited commercial email. | 22261 | * Thwarting Email Spam:: Simple ways to avoid unsolicited commercial email. |
| 22276 | * Spam Package:: A package for filtering and processing spam. | 22262 | * Spam Package:: A package for filtering and processing spam. |
| @@ -22613,11 +22599,9 @@ special @code{balloon-help} property set to | |||
| 22613 | variables should be either strings or symbols naming functions that | 22599 | variables should be either strings or symbols naming functions that |
| 22614 | return a string. When the mouse passes over text with this property | 22600 | return a string. When the mouse passes over text with this property |
| 22615 | set, a balloon window will appear and display the string. Please | 22601 | set, a balloon window will appear and display the string. Please |
| 22616 | refer to @ref{Tooltips, ,Tooltips, emacs, The Emacs Manual}, | 22602 | refer to @ref{Tooltips, ,Tooltips, emacs, The Emacs Manual} for more |
| 22617 | (in Emacs) or the doc string of @code{balloon-help-mode} (in | 22603 | information on this. (For technical reasons, the guillemets have been |
| 22618 | XEmacs) for more information on this. (For technical reasons, the | 22604 | approximated as @samp{<<} and @samp{>>} in this paragraph.) |
| 22619 | guillemets have been approximated as @samp{<<} and @samp{>>} in this | ||
| 22620 | paragraph.) | ||
| 22621 | 22605 | ||
| 22622 | Here's an alternative recipe for the group buffer: | 22606 | Here's an alternative recipe for the group buffer: |
| 22623 | 22607 | ||
| @@ -22698,8 +22682,7 @@ these countries, that's not true. | |||
| 22698 | @vindex gnus-use-correct-string-widths | 22682 | @vindex gnus-use-correct-string-widths |
| 22699 | To help fix this, you can set @code{gnus-use-correct-string-widths} to | 22683 | To help fix this, you can set @code{gnus-use-correct-string-widths} to |
| 22700 | @code{t}. This makes buffer generation slower, but the results will be | 22684 | @code{t}. This makes buffer generation slower, but the results will be |
| 22701 | prettier. The default value under XEmacs is @code{t} but @code{nil} | 22685 | prettier. The default value is @code{nil}. |
| 22702 | for Emacs. | ||
| 22703 | 22686 | ||
| 22704 | 22687 | ||
| 22705 | @node Window Layout | 22688 | @node Window Layout |
| @@ -22878,9 +22861,7 @@ frame will be created where picons will be shown. As you can see, | |||
| 22878 | instead of the normal @code{1.0} top-level spec, each additional split | 22861 | instead of the normal @code{1.0} top-level spec, each additional split |
| 22879 | should have a frame parameter alist as the size spec. | 22862 | should have a frame parameter alist as the size spec. |
| 22880 | @xref{Frame Parameters, , Frame Parameters, elisp, The GNU Emacs Lisp | 22863 | @xref{Frame Parameters, , Frame Parameters, elisp, The GNU Emacs Lisp |
| 22881 | Reference Manual}. Under XEmacs, a frame property list will be | 22864 | Reference Manual}. |
| 22882 | accepted, too---for instance, @code{(height 5 width 15 left -1 top 1)} | ||
| 22883 | is such a plist. | ||
| 22884 | The list of all possible keys for @code{gnus-buffer-configuration} can | 22865 | The list of all possible keys for @code{gnus-buffer-configuration} can |
| 22885 | be found in its default value. | 22866 | be found in its default value. |
| 22886 | 22867 | ||
| @@ -23417,8 +23398,8 @@ It takes the group name as a parameter. | |||
| 23417 | @node Image Enhancements | 23398 | @node Image Enhancements |
| 23418 | @section Image Enhancements | 23399 | @section Image Enhancements |
| 23419 | 23400 | ||
| 23420 | XEmacs, as well as Emacs 21@footnote{Emacs 21 on MS Windows doesn't | 23401 | Emacs 21@footnote{Emacs 21 on MS Windows doesn't |
| 23421 | support images, Emacs 22 does.} and up, are able to display pictures and | 23402 | support images, Emacs 22 does.} and up are able to display pictures and |
| 23422 | stuff, so Gnus has taken advantage of that. | 23403 | stuff, so Gnus has taken advantage of that. |
| 23423 | 23404 | ||
| 23424 | @menu | 23405 | @menu |
| @@ -23451,13 +23432,12 @@ readers. | |||
| 23451 | @c @anchor{X-Face} | 23432 | @c @anchor{X-Face} |
| 23452 | 23433 | ||
| 23453 | Viewing an @code{X-Face} header either requires an Emacs that has | 23434 | Viewing an @code{X-Face} header either requires an Emacs that has |
| 23454 | @samp{compface} support (which most XEmacs versions have), or that you | 23435 | @samp{compface} support, or that you |
| 23455 | have suitable conversion or display programs installed. If your Emacs | 23436 | have suitable conversion or display programs installed. If your Emacs |
| 23456 | has image support the default action is to display the face before the | 23437 | has image support the default action is to display the face before the |
| 23457 | @code{From} header. If there's no native @code{X-Face} support, Gnus | 23438 | @code{From} header. If there's no native @code{X-Face} support, Gnus |
| 23458 | will try to convert the @code{X-Face} header using external programs | 23439 | will try to convert the @code{X-Face} header using external programs |
| 23459 | from the @code{pbmplus} package and friends, see below. For XEmacs it's | 23440 | from the @code{pbmplus} package and friends, see below. The |
| 23460 | faster if XEmacs has been compiled with @code{X-Face} support. The | ||
| 23461 | default action under Emacs without image support is to fork off the | 23441 | default action under Emacs without image support is to fork off the |
| 23462 | @code{display} program. | 23442 | @code{display} program. |
| 23463 | 23443 | ||
| @@ -23494,8 +23474,7 @@ default colors are black and white. | |||
| 23494 | @vindex gnus-face-properties-alist | 23474 | @vindex gnus-face-properties-alist |
| 23495 | Alist of image types and properties applied to Face (@pxref{Face}) and | 23475 | Alist of image types and properties applied to Face (@pxref{Face}) and |
| 23496 | X-Face images. The default value is @code{((pbm . (:face gnus-x-face)) | 23476 | X-Face images. The default value is @code{((pbm . (:face gnus-x-face)) |
| 23497 | (png . nil))} for Emacs or @code{((xface . (:face gnus-x-face)))} for | 23477 | (png . nil))}. Here are examples: |
| 23498 | XEmacs. Here are examples: | ||
| 23499 | 23478 | ||
| 23500 | @lisp | 23479 | @lisp |
| 23501 | ;; Specify the altitude of Face and X-Face images in the From header. | 23480 | ;; Specify the altitude of Face and X-Face images in the From header. |
| @@ -23512,9 +23491,7 @@ XEmacs. Here are examples: | |||
| 23512 | @xref{Image Descriptors,,, elisp, The Emacs Lisp Reference Manual}, | 23491 | @xref{Image Descriptors,,, elisp, The Emacs Lisp Reference Manual}, |
| 23513 | for the valid properties for various image types. Currently, | 23492 | for the valid properties for various image types. Currently, |
| 23514 | @code{pbm} is used for X-Face images and @code{png} is used for Face | 23493 | @code{pbm} is used for X-Face images and @code{png} is used for Face |
| 23515 | images in Emacs. Only the @code{:face} property is effective on the | 23494 | images in Emacs. |
| 23516 | @code{xface} image type in XEmacs if it is built with the | ||
| 23517 | @samp{libcompface} library. | ||
| 23518 | @end table | 23495 | @end table |
| 23519 | 23496 | ||
| 23520 | If you use posting styles, you can use an @code{x-face-file} entry in | 23497 | If you use posting styles, you can use an @code{x-face-file} entry in |
| @@ -23586,10 +23563,6 @@ displayed Face images. @xref{X-Face}. | |||
| 23586 | 23563 | ||
| 23587 | Viewing a @code{Face} header requires an Emacs that is able to display | 23564 | Viewing a @code{Face} header requires an Emacs that is able to display |
| 23588 | PNG images. | 23565 | PNG images. |
| 23589 | @c Maybe add this: | ||
| 23590 | @c (if (featurep 'xemacs) | ||
| 23591 | @c (featurep 'png) | ||
| 23592 | @c (image-type-available-p 'png)) | ||
| 23593 | 23566 | ||
| 23594 | Gnus provides a few convenience functions and variables to allow | 23567 | Gnus provides a few convenience functions and variables to allow |
| 23595 | easier insertion of Face headers in outgoing messages. | 23568 | easier insertion of Face headers in outgoing messages. |
| @@ -26398,8 +26371,7 @@ This variable controls whether to add timestamps to messages that are | |||
| 26398 | controlled by @code{gnus-verbose} and @code{gnus-verbose-backends} and | 26371 | controlled by @code{gnus-verbose} and @code{gnus-verbose-backends} and |
| 26399 | are issued. The default value is @code{nil} which means never to add | 26372 | are issued. The default value is @code{nil} which means never to add |
| 26400 | timestamp. If it is @code{log}, add timestamps to only the messages | 26373 | timestamp. If it is @code{log}, add timestamps to only the messages |
| 26401 | that go into the @file{*Messages*} buffer (in XEmacs, it is the | 26374 | that go into the @file{*Messages*} buffer. If it is neither @code{nil} nor |
| 26402 | @w{@file{ *Message-Log*}} buffer). If it is neither @code{nil} nor | ||
| 26403 | @code{log}, add timestamps not only to log messages but also to the ones | 26375 | @code{log}, add timestamps not only to log messages but also to the ones |
| 26404 | displayed in the echo area. | 26376 | displayed in the echo area. |
| 26405 | 26377 | ||
| @@ -26511,7 +26483,6 @@ but at the common table.@* | |||
| 26511 | @chapter Appendices | 26483 | @chapter Appendices |
| 26512 | 26484 | ||
| 26513 | @menu | 26485 | @menu |
| 26514 | * XEmacs:: Requirements for installing under XEmacs. | ||
| 26515 | * History:: How Gnus got where it is today. | 26486 | * History:: How Gnus got where it is today. |
| 26516 | * On Writing Manuals:: Why this is not a beginner's guide. | 26487 | * On Writing Manuals:: Why this is not a beginner's guide. |
| 26517 | * Terminology:: We use really difficult, like, words here. | 26488 | * Terminology:: We use really difficult, like, words here. |
| @@ -26523,19 +26494,6 @@ but at the common table.@* | |||
| 26523 | @end menu | 26494 | @end menu |
| 26524 | 26495 | ||
| 26525 | 26496 | ||
| 26526 | @node XEmacs | ||
| 26527 | @section XEmacs | ||
| 26528 | @cindex XEmacs | ||
| 26529 | @cindex installing under XEmacs | ||
| 26530 | |||
| 26531 | XEmacs is distributed as a collection of packages. You should install | ||
| 26532 | whatever packages the Gnus XEmacs package requires. The current | ||
| 26533 | requirements are @samp{gnus}, @samp{mail-lib}, @samp{xemacs-base}, | ||
| 26534 | @samp{eterm}, @samp{sh-script}, @samp{net-utils}, @samp{os-utils}, | ||
| 26535 | @samp{dired}, @samp{mh-e}, @samp{sieve}, @samp{ps-print}, | ||
| 26536 | @samp{pgg}, @samp{mailcrypt}, @samp{ecrypto}, and @samp{sasl}. | ||
| 26537 | |||
| 26538 | |||
| 26539 | @node History | 26497 | @node History |
| 26540 | @section History | 26498 | @section History |
| 26541 | 26499 | ||
| @@ -26646,8 +26604,7 @@ and news from different sources. I have added hooks for customizations | |||
| 26646 | everywhere I could imagine it being useful. By doing so, I'm inviting | 26604 | everywhere I could imagine it being useful. By doing so, I'm inviting |
| 26647 | every one of you to explore and invent. | 26605 | every one of you to explore and invent. |
| 26648 | 26606 | ||
| 26649 | May Gnus never be complete. @kbd{C-u 100 M-x all-hail-emacs} and | 26607 | May Gnus never be complete. @kbd{C-u 100 M-x all-hail-emacs}. |
| 26650 | @kbd{C-u 100 M-x all-hail-xemacs}. | ||
| 26651 | 26608 | ||
| 26652 | 26609 | ||
| 26653 | @node Compatibility | 26610 | @node Compatibility |
| @@ -26800,7 +26757,6 @@ know. | |||
| 26800 | @node Emacsen | 26757 | @node Emacsen |
| 26801 | @subsection Emacsen | 26758 | @subsection Emacsen |
| 26802 | @cindex Emacsen | 26759 | @cindex Emacsen |
| 26803 | @cindex XEmacs | ||
| 26804 | @cindex Mule | 26760 | @cindex Mule |
| 26805 | @cindex Emacs | 26761 | @cindex Emacs |
| 26806 | 26762 | ||
| @@ -26811,15 +26767,12 @@ This version of Gnus should work on: | |||
| 26811 | @item | 26767 | @item |
| 26812 | Emacs 23.1 and up. | 26768 | Emacs 23.1 and up. |
| 26813 | 26769 | ||
| 26814 | @item | ||
| 26815 | XEmacs 21.4 and up. | ||
| 26816 | |||
| 26817 | @end itemize | 26770 | @end itemize |
| 26818 | 26771 | ||
| 26819 | This Gnus version will absolutely not work on any Emacsen older than | 26772 | This Gnus version will absolutely not work on any Emacsen older than |
| 26820 | that. Not reliably, at least. Older versions of Gnus may work on older | 26773 | that. Not reliably, at least. Older versions of Gnus may work on older |
| 26821 | Emacs versions. Particularly, Gnus 5.10.8 should also work on Emacs | 26774 | Emacs versions. Particularly, Gnus 5.10.8 should also work on Emacs |
| 26822 | 20.7 and XEmacs 21.1. | 26775 | 20.7. |
| 26823 | 26776 | ||
| 26824 | @c No-merge comment: The paragraph added in v5-10 here must not be | 26777 | @c No-merge comment: The paragraph added in v5-10 here must not be |
| 26825 | @c synced here! | 26778 | @c synced here! |
| @@ -27374,7 +27327,7 @@ referred. | |||
| 27374 | Gnus can make use of GroupLens predictions. | 27327 | Gnus can make use of GroupLens predictions. |
| 27375 | 27328 | ||
| 27376 | @item | 27329 | @item |
| 27377 | Picons (personal icons) can be displayed under XEmacs (@pxref{Picons}). | 27330 | Picons (personal icons) can be displayed (@pxref{Picons}). |
| 27378 | 27331 | ||
| 27379 | @item | 27332 | @item |
| 27380 | A @code{trn}-like tree buffer can be displayed (@pxref{Tree Display}). | 27333 | A @code{trn}-like tree buffer can be displayed (@pxref{Tree Display}). |
| @@ -27946,28 +27899,6 @@ shadows manually or remove them using @code{make | |||
| 27946 | remove-installed-shadows}. | 27899 | remove-installed-shadows}. |
| 27947 | 27900 | ||
| 27948 | @item | 27901 | @item |
| 27949 | New @file{make.bat} for compiling and installing Gnus under MS Windows | ||
| 27950 | |||
| 27951 | Use @file{make.bat} if you want to install Gnus under MS Windows, the | ||
| 27952 | first argument to the batch-program should be the directory where | ||
| 27953 | @file{xemacs.exe} respectively @file{emacs.exe} is located, if you want | ||
| 27954 | to install Gnus after compiling it, give @file{make.bat} @code{/copy} as | ||
| 27955 | the second parameter. | ||
| 27956 | |||
| 27957 | @file{make.bat} has been rewritten from scratch, it now features | ||
| 27958 | automatic recognition of XEmacs and Emacs, generates | ||
| 27959 | @file{gnus-load.el}, checks if errors occur while compilation and | ||
| 27960 | generation of info files and reports them at the end of the build | ||
| 27961 | process. It now uses @code{makeinfo} if it is available and falls | ||
| 27962 | back to @file{infohack.el} otherwise. @file{make.bat} should now | ||
| 27963 | install all files which are necessary to run Gnus and be generally a | ||
| 27964 | complete replacement for the @code{configure; make; make install} | ||
| 27965 | cycle used under Unix systems. | ||
| 27966 | |||
| 27967 | The new @file{make.bat} makes @file{make-x.bat} and @file{xemacs.mak} | ||
| 27968 | superfluous, so they have been removed. | ||
| 27969 | |||
| 27970 | @item | ||
| 27971 | @file{~/News/overview/} not used. | 27902 | @file{~/News/overview/} not used. |
| 27972 | 27903 | ||
| 27973 | As a result of the following change, the @file{~/News/overview/} | 27904 | As a result of the following change, the @file{~/News/overview/} |
| @@ -28526,7 +28457,7 @@ message, Message Manual}). | |||
| 28526 | The tool bars have been updated to use GNOME icons in Group, Summary and | 28457 | The tool bars have been updated to use GNOME icons in Group, Summary and |
| 28527 | Message mode. You can also customize the tool bars: @kbd{M-x | 28458 | Message mode. You can also customize the tool bars: @kbd{M-x |
| 28528 | customize-apropos @key{RET} -tool-bar$} should get you started. This is a new | 28459 | customize-apropos @key{RET} -tool-bar$} should get you started. This is a new |
| 28529 | feature in Gnus 5.10.10. (Only for Emacs, not in XEmacs.) | 28460 | feature in Gnus 5.10.10. |
| 28530 | 28461 | ||
| 28531 | @item The tool bar icons are now (de)activated correctly | 28462 | @item The tool bar icons are now (de)activated correctly |
| 28532 | in the group buffer, see the variable @code{gnus-group-update-tool-bar}. | 28463 | in the group buffer, see the variable @code{gnus-group-update-tool-bar}. |
| @@ -28599,9 +28530,6 @@ The following Emacs versions are supported by No Gnus: | |||
| 28599 | @itemize @bullet | 28530 | @itemize @bullet |
| 28600 | 28531 | ||
| 28601 | @item Emacs 22 and up | 28532 | @item Emacs 22 and up |
| 28602 | @item XEmacs 21.4 | ||
| 28603 | @item XEmacs 21.5 | ||
| 28604 | @item SXEmacs | ||
| 28605 | 28533 | ||
| 28606 | @end itemize | 28534 | @end itemize |
| 28607 | 28535 | ||
| @@ -28901,7 +28829,7 @@ messages are deleted again). | |||
| 28901 | 28829 | ||
| 28902 | @item The tool bar has been updated to use GNOME icons. | 28830 | @item The tool bar has been updated to use GNOME icons. |
| 28903 | You can also customize the tool bars: @kbd{M-x customize-apropos @key{RET} | 28831 | You can also customize the tool bars: @kbd{M-x customize-apropos @key{RET} |
| 28904 | -tool-bar$} should get you started. (Only for Emacs, not in XEmacs.) | 28832 | -tool-bar$} should get you started. |
| 28905 | @c FIXME: Document this in the manual | 28833 | @c FIXME: Document this in the manual |
| 28906 | 28834 | ||
| 28907 | @item The tool bar icons are now (de)activated correctly | 28835 | @item The tool bar icons are now (de)activated correctly |
| @@ -28909,9 +28837,6 @@ in the group buffer, see the variable @code{gnus-group-update-tool-bar}. | |||
| 28909 | Its default value depends on your Emacs version. | 28837 | Its default value depends on your Emacs version. |
| 28910 | @c FIXME: Document this in the manual | 28838 | @c FIXME: Document this in the manual |
| 28911 | 28839 | ||
| 28912 | @item You can change the location of XEmacs's toolbars in Gnus buffers. | ||
| 28913 | See @code{gnus-use-toolbar} and @code{message-use-toolbar}. | ||
| 28914 | |||
| 28915 | @end itemize | 28840 | @end itemize |
| 28916 | 28841 | ||
| 28917 | @item Miscellaneous changes | 28842 | @item Miscellaneous changes |
| @@ -29610,7 +29535,6 @@ and general methods of operation. | |||
| 29610 | * Ranges:: A handy format for storing mucho numbers. | 29535 | * Ranges:: A handy format for storing mucho numbers. |
| 29611 | * Group Info:: The group info format. | 29536 | * Group Info:: The group info format. |
| 29612 | * Extended Interactive:: Symbolic prefixes and stuff. | 29537 | * Extended Interactive:: Symbolic prefixes and stuff. |
| 29613 | * Emacs/XEmacs Code:: Gnus can be run under all modern Emacsen. | ||
| 29614 | * Various File Formats:: Formats of files that Gnus use. | 29538 | * Various File Formats:: Formats of files that Gnus use. |
| 29615 | @end menu | 29539 | @end menu |
| 29616 | 29540 | ||
| @@ -30952,52 +30876,6 @@ function. | |||
| 30952 | @end table | 30876 | @end table |
| 30953 | 30877 | ||
| 30954 | 30878 | ||
| 30955 | @node Emacs/XEmacs Code | ||
| 30956 | @subsection Emacs/XEmacs Code | ||
| 30957 | @cindex XEmacs | ||
| 30958 | @cindex Emacsen | ||
| 30959 | |||
| 30960 | While Gnus runs under Emacs, XEmacs and Mule, I decided that one of the | ||
| 30961 | platforms must be the primary one. I chose Emacs. Not because I don't | ||
| 30962 | like XEmacs or Mule, but because it comes first alphabetically. | ||
| 30963 | |||
| 30964 | This means that Gnus will byte-compile under Emacs with nary a warning, | ||
| 30965 | while XEmacs will pump out gigabytes of warnings while byte-compiling. | ||
| 30966 | As I use byte-compilation warnings to help me root out trivial errors in | ||
| 30967 | Gnus, that's very useful. | ||
| 30968 | |||
| 30969 | I've also consistently used Emacs function interfaces, but have used | ||
| 30970 | Gnusey aliases for the functions. To take an example: Emacs defines a | ||
| 30971 | @code{run-at-time} function while XEmacs defines a @code{start-itimer} | ||
| 30972 | function. I then define a function called @code{gnus-run-at-time} that | ||
| 30973 | takes the same parameters as the Emacs @code{run-at-time}. When running | ||
| 30974 | Gnus under Emacs, the former function is just an alias for the latter. | ||
| 30975 | However, when running under XEmacs, the former is an alias for the | ||
| 30976 | following function: | ||
| 30977 | |||
| 30978 | @lisp | ||
| 30979 | (defun gnus-xmas-run-at-time (time repeat function &rest args) | ||
| 30980 | (start-itimer | ||
| 30981 | "gnus-run-at-time" | ||
| 30982 | `(lambda () | ||
| 30983 | (,function ,@@args)) | ||
| 30984 | time repeat)) | ||
| 30985 | @end lisp | ||
| 30986 | |||
| 30987 | This sort of thing has been done for bunches of functions. Gnus does | ||
| 30988 | not redefine any native Emacs functions while running under XEmacs---it | ||
| 30989 | does this @code{defalias} thing with Gnus equivalents instead. Cleaner | ||
| 30990 | all over. | ||
| 30991 | |||
| 30992 | In the cases where the XEmacs function interface was obviously cleaner, | ||
| 30993 | I used it instead. For example @code{gnus-region-active-p} is an alias | ||
| 30994 | for @code{region-active-p} in XEmacs, whereas in Emacs it is a function. | ||
| 30995 | |||
| 30996 | Of course, I could have chosen XEmacs as my native platform and done | ||
| 30997 | mapping functions the other way around. But I didn't. The performance | ||
| 30998 | hit these indirections impose on Gnus under XEmacs should be slight. | ||
| 30999 | |||
| 31000 | |||
| 31001 | @node Various File Formats | 30879 | @node Various File Formats |
| 31002 | @subsection Various File Formats | 30880 | @subsection Various File Formats |
| 31003 | 30881 | ||