aboutsummaryrefslogtreecommitdiffstats
path: root/doc/misc
diff options
context:
space:
mode:
authorLars Ingebrigtsen2019-08-15 15:27:01 -0700
committerLars Ingebrigtsen2019-08-15 15:27:01 -0700
commit7aefbe86f22a1c0b7d329c1931d0297f801e1f83 (patch)
tree1cd64e57d80852ac53cfd2d0f576bf316edca2da /doc/misc
parent3c494946913e164e997c5e57cba7474813039355 (diff)
downloademacs-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.texi43
-rw-r--r--doc/misc/gnus.texi190
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
164Gnus is released independent from releases of Emacs and XEmacs. 163Gnus is released independent from releases of Emacs. Therefore, the
165Therefore, the version bundled with Emacs or the version in XEmacs's 164version bundled with Emacs might not be up to date (e.g., Gnus 5.9
166package system might not be up to date (e.g., Gnus 5.9 bundled with Emacs 165bundled with Emacs 21 is outdated).
16721 is outdated).
168You can get the latest released version of Gnus from 166You 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}
170or from 168or from
@@ -187,13 +185,11 @@ tarball with some packer (e.g., Winace from
187and use the batch-file make.bat included in the tarball to install 185and use the batch-file make.bat included in the tarball to install
188Gnus.) If you don't want to (or aren't allowed to) install Gnus 186Gnus.) If you don't want to (or aren't allowed to) install Gnus
189system-wide, you can install it in your home directory and add the 187system-wide, you can install it in your home directory and add the
190following lines to your ~/.xemacs/init.el or ~/.emacs: 188following 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
226Gnus 5.13 requires an Emacs version that is greater than or equal 222Gnus 5.13 requires an Emacs version that is greater than or equal
227to Emacs 23.1 or XEmacs 21.1, although there are some features that 223to Emacs 23.1, although there are some features that
228only work on Emacs 24. 224only work on Emacs 24.
229 225
230@node FAQ 1-7
231@subsubheading Question 1.7
232
233How do I run Gnus on both Emacs and XEmacs?
234
235@subsubheading Answer
236
237You can't use the same copy of Gnus in both as the Lisp
238files are byte-compiled to a format which is different
239depending on which Emacs did the compilation. Get one copy
240of 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}
1390and for on-the-fly spell-checking 1374and 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}.
1392Ispell.el is shipped with Emacs and available through the XEmacs package system, 1376Ispell.el is shipped with Emacs,
1393flyspell.el is shipped with Emacs and part of XEmacs text-modes package which is 1377flyspell.el is shipped with Emacs, so there should be no need to install them
1394available through the package system, so there should be no need to install them
1395manually. 1378manually.
1396 1379
1397Ispell.el assumes you use ispell, if you choose aspell say 1380Ispell.el assumes you use ispell, if you choose aspell say
@@ -1465,7 +1448,7 @@ node "Mail Aliases" in Message (not Gnus) manual for
1465details. 1448details.
1466 1449
1467However, what you really want is the Insidious Big Brother 1450However, what you really want is the Insidious Big Brother
1468Database bbdb. Get it through the XEmacs package system or from 1451Database bbdb. Get it from
1469@uref{http://bbdb.sourceforge.net/, bbdb's homepage}. 1452@uref{http://bbdb.sourceforge.net/, bbdb's homepage}.
1470Now place the following in @file{~/.gnus.el}, to activate bbdb for Gnus: 1453Now 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
2289to functions like "get message", "get Headers" etc. 2270to functions like "get message", "get Headers" etc.
2290 2271
2291@item Emacs 2272@item Emacs
2292When the term Emacs is used in this FAQ, it means either GNU 2273When the term Emacs is used in this FAQ, it means GNU
2293Emacs or XEmacs. 2274Emacs.
2294 2275
2295@item Message 2276@item Message
2296In this FAQ message means either a mail or a posting to a 2277In 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
877Appendices 877Appendices
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
930Back End Interface 928Back 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
4321The value of this variable should be a coding system or @code{nil}. The 4319The value of this variable should be a coding system or @code{nil}. The
4322default is @code{nil} in Emacs, or is the aliasee of the coding system 4320default is @code{nil} in Emacs.
4323named @code{file-name} (a certain coding system of which an alias is
4324@code{file-name}) in XEmacs.
4325 4321
4326The @code{nnml} back end, the @code{nnrss} back end, the agent, and 4322The @code{nnml} back end, the @code{nnrss} back end, the agent, and
4327the cache use non-@acronym{ASCII} group names in those files and 4323the 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
4330when encoding and decoding those file names and directory names. 4326when encoding and decoding those file names and directory names.
4331 4327
4332In XEmacs (with the @code{mule} feature), @code{file-name-coding-system} 4328Emacs uses the value of @code{default-file-name-coding-system} if
4333is 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
4334file names. On the other hand, Emacs uses the value of 4330value of @code{nnmail-pathname-coding-system} which is @code{nil}.
4335@code{default-file-name-coding-system} if @code{file-name-coding-system}
4336is @code{nil} or it is bound to the value of
4337@code{nnmail-pathname-coding-system} which is @code{nil}.
4338 4331
4339Normally the value of @code{default-file-name-coding-system} in Emacs or 4332Normally the value of @code{default-file-name-coding-system} is
4340@code{nnmail-pathname-coding-system} in XEmacs is initialized according 4333initialized according to the locale, so you will need to do nothing if
4341to the locale, so you will need to do nothing if the value is suitable 4334the value is suitable to encode and decode non-@acronym{ASCII} group
4342to encode and decode non-@acronym{ASCII} group names. 4335names.
4343 4336
4344The value of this variable (or @code{default-file-name-coding-system}) 4337The value of this variable (or @code{default-file-name-coding-system})
4345does not necessarily need to be the same value that is determined by 4338does not necessarily need to be the same value that is determined by
@@ -12557,11 +12550,11 @@ still a pain, though.
12557 12550
12558This variable controls which information should be exposed in the 12551This variable controls which information should be exposed in the
12559User-Agent header. It can be a list of symbols or a string. Valid 12552User-Agent header. It can be a list of symbols or a string. Valid
12560symbols are @code{gnus} (show Gnus version) and @code{emacs} (show Emacs 12553symbols are @code{gnus} (show Gnus version) and @code{emacs} (show
12561version). In addition to the Emacs version, you can add @code{codename} 12554Emacs 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
12563configuration) or @code{type} (show system type). If you set it to a 12556type). If you set it to a string, be sure to use a valid format, see
12564string, be sure to use a valid format, see RFC 2616. 12557RFC 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
17155The coding system used when reading and writing the @code{nnrss} groups 17148The coding system used when reading and writing the @code{nnrss} groups
17156data files. The default is the value of 17149data 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}).
17158in 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
22613variables should be either strings or symbols naming functions that 22599variables should be either strings or symbols naming functions that
22614return a string. When the mouse passes over text with this property 22600return a string. When the mouse passes over text with this property
22615set, a balloon window will appear and display the string. Please 22601set, a balloon window will appear and display the string. Please
22616refer to @ref{Tooltips, ,Tooltips, emacs, The Emacs Manual}, 22602refer to @ref{Tooltips, ,Tooltips, emacs, The Emacs Manual} for more
22617(in Emacs) or the doc string of @code{balloon-help-mode} (in 22603information on this. (For technical reasons, the guillemets have been
22618XEmacs) for more information on this. (For technical reasons, the 22604approximated as @samp{<<} and @samp{>>} in this paragraph.)
22619guillemets have been approximated as @samp{<<} and @samp{>>} in this
22620paragraph.)
22621 22605
22622Here's an alternative recipe for the group buffer: 22606Here'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
22699To help fix this, you can set @code{gnus-use-correct-string-widths} to 22683To 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
22701prettier. The default value under XEmacs is @code{t} but @code{nil} 22685prettier. The default value is @code{nil}.
22702for 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,
22878instead of the normal @code{1.0} top-level spec, each additional split 22861instead of the normal @code{1.0} top-level spec, each additional split
22879should have a frame parameter alist as the size spec. 22862should 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
22881Reference Manual}. Under XEmacs, a frame property list will be 22864Reference Manual}.
22882accepted, too---for instance, @code{(height 5 width 15 left -1 top 1)}
22883is such a plist.
22884The list of all possible keys for @code{gnus-buffer-configuration} can 22865The list of all possible keys for @code{gnus-buffer-configuration} can
22885be found in its default value. 22866be 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
23420XEmacs, as well as Emacs 21@footnote{Emacs 21 on MS Windows doesn't 23401Emacs 21@footnote{Emacs 21 on MS Windows doesn't
23421support images, Emacs 22 does.} and up, are able to display pictures and 23402support images, Emacs 22 does.} and up are able to display pictures and
23422stuff, so Gnus has taken advantage of that. 23403stuff, 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
23453Viewing an @code{X-Face} header either requires an Emacs that has 23434Viewing 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
23455have suitable conversion or display programs installed. If your Emacs 23436have suitable conversion or display programs installed. If your Emacs
23456has image support the default action is to display the face before the 23437has 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
23458will try to convert the @code{X-Face} header using external programs 23439will try to convert the @code{X-Face} header using external programs
23459from the @code{pbmplus} package and friends, see below. For XEmacs it's 23440from the @code{pbmplus} package and friends, see below. The
23460faster if XEmacs has been compiled with @code{X-Face} support. The
23461default action under Emacs without image support is to fork off the 23441default 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
23495Alist of image types and properties applied to Face (@pxref{Face}) and 23475Alist of image types and properties applied to Face (@pxref{Face}) and
23496X-Face images. The default value is @code{((pbm . (:face gnus-x-face)) 23476X-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:
23498XEmacs. 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},
23513for the valid properties for various image types. Currently, 23492for 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
23515images in Emacs. Only the @code{:face} property is effective on the 23494images 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
23520If you use posting styles, you can use an @code{x-face-file} entry in 23497If 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
23587Viewing a @code{Face} header requires an Emacs that is able to display 23564Viewing a @code{Face} header requires an Emacs that is able to display
23588PNG images. 23565PNG images.
23589@c Maybe add this:
23590@c (if (featurep 'xemacs)
23591@c (featurep 'png)
23592@c (image-type-available-p 'png))
23593 23566
23594Gnus provides a few convenience functions and variables to allow 23567Gnus provides a few convenience functions and variables to allow
23595easier insertion of Face headers in outgoing messages. 23568easier insertion of Face headers in outgoing messages.
@@ -26398,8 +26371,7 @@ This variable controls whether to add timestamps to messages that are
26398controlled by @code{gnus-verbose} and @code{gnus-verbose-backends} and 26371controlled by @code{gnus-verbose} and @code{gnus-verbose-backends} and
26399are issued. The default value is @code{nil} which means never to add 26372are issued. The default value is @code{nil} which means never to add
26400timestamp. If it is @code{log}, add timestamps to only the messages 26373timestamp. If it is @code{log}, add timestamps to only the messages
26401that go into the @file{*Messages*} buffer (in XEmacs, it is the 26374that 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
26404displayed in the echo area. 26376displayed 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
26531XEmacs is distributed as a collection of packages. You should install
26532whatever packages the Gnus XEmacs package requires. The current
26533requirements 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
26646everywhere I could imagine it being useful. By doing so, I'm inviting 26604everywhere I could imagine it being useful. By doing so, I'm inviting
26647every one of you to explore and invent. 26605every one of you to explore and invent.
26648 26606
26649May Gnus never be complete. @kbd{C-u 100 M-x all-hail-emacs} and 26607May 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
26812Emacs 23.1 and up. 26768Emacs 23.1 and up.
26813 26769
26814@item
26815XEmacs 21.4 and up.
26816
26817@end itemize 26770@end itemize
26818 26771
26819This Gnus version will absolutely not work on any Emacsen older than 26772This Gnus version will absolutely not work on any Emacsen older than
26820that. Not reliably, at least. Older versions of Gnus may work on older 26773that. Not reliably, at least. Older versions of Gnus may work on older
26821Emacs versions. Particularly, Gnus 5.10.8 should also work on Emacs 26774Emacs versions. Particularly, Gnus 5.10.8 should also work on Emacs
2682220.7 and XEmacs 21.1. 2677520.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.
27374Gnus can make use of GroupLens predictions. 27327Gnus can make use of GroupLens predictions.
27375 27328
27376@item 27329@item
27377Picons (personal icons) can be displayed under XEmacs (@pxref{Picons}). 27330Picons (personal icons) can be displayed (@pxref{Picons}).
27378 27331
27379@item 27332@item
27380A @code{trn}-like tree buffer can be displayed (@pxref{Tree Display}). 27333A @code{trn}-like tree buffer can be displayed (@pxref{Tree Display}).
@@ -27946,28 +27899,6 @@ shadows manually or remove them using @code{make
27946remove-installed-shadows}. 27899remove-installed-shadows}.
27947 27900
27948@item 27901@item
27949New @file{make.bat} for compiling and installing Gnus under MS Windows
27950
27951Use @file{make.bat} if you want to install Gnus under MS Windows, the
27952first argument to the batch-program should be the directory where
27953@file{xemacs.exe} respectively @file{emacs.exe} is located, if you want
27954to install Gnus after compiling it, give @file{make.bat} @code{/copy} as
27955the second parameter.
27956
27957@file{make.bat} has been rewritten from scratch, it now features
27958automatic recognition of XEmacs and Emacs, generates
27959@file{gnus-load.el}, checks if errors occur while compilation and
27960generation of info files and reports them at the end of the build
27961process. It now uses @code{makeinfo} if it is available and falls
27962back to @file{infohack.el} otherwise. @file{make.bat} should now
27963install all files which are necessary to run Gnus and be generally a
27964complete replacement for the @code{configure; make; make install}
27965cycle used under Unix systems.
27966
27967The new @file{make.bat} makes @file{make-x.bat} and @file{xemacs.mak}
27968superfluous, so they have been removed.
27969
27970@item
27971@file{~/News/overview/} not used. 27902@file{~/News/overview/} not used.
27972 27903
27973As a result of the following change, the @file{~/News/overview/} 27904As a result of the following change, the @file{~/News/overview/}
@@ -28526,7 +28457,7 @@ message, Message Manual}).
28526The tool bars have been updated to use GNOME icons in Group, Summary and 28457The tool bars have been updated to use GNOME icons in Group, Summary and
28527Message mode. You can also customize the tool bars: @kbd{M-x 28458Message mode. You can also customize the tool bars: @kbd{M-x
28528customize-apropos @key{RET} -tool-bar$} should get you started. This is a new 28459customize-apropos @key{RET} -tool-bar$} should get you started. This is a new
28529feature in Gnus 5.10.10. (Only for Emacs, not in XEmacs.) 28460feature 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
28532in the group buffer, see the variable @code{gnus-group-update-tool-bar}. 28463in 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.
28903You can also customize the tool bars: @kbd{M-x customize-apropos @key{RET} 28831You 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}.
28909Its default value depends on your Emacs version. 28837Its 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.
28913See @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
30960While Gnus runs under Emacs, XEmacs and Mule, I decided that one of the
30961platforms must be the primary one. I chose Emacs. Not because I don't
30962like XEmacs or Mule, but because it comes first alphabetically.
30963
30964This means that Gnus will byte-compile under Emacs with nary a warning,
30965while XEmacs will pump out gigabytes of warnings while byte-compiling.
30966As I use byte-compilation warnings to help me root out trivial errors in
30967Gnus, that's very useful.
30968
30969I've also consistently used Emacs function interfaces, but have used
30970Gnusey aliases for the functions. To take an example: Emacs defines a
30971@code{run-at-time} function while XEmacs defines a @code{start-itimer}
30972function. I then define a function called @code{gnus-run-at-time} that
30973takes the same parameters as the Emacs @code{run-at-time}. When running
30974Gnus under Emacs, the former function is just an alias for the latter.
30975However, when running under XEmacs, the former is an alias for the
30976following 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
30987This sort of thing has been done for bunches of functions. Gnus does
30988not redefine any native Emacs functions while running under XEmacs---it
30989does this @code{defalias} thing with Gnus equivalents instead. Cleaner
30990all over.
30991
30992In the cases where the XEmacs function interface was obviously cleaner,
30993I used it instead. For example @code{gnus-region-active-p} is an alias
30994for @code{region-active-p} in XEmacs, whereas in Emacs it is a function.
30995
30996Of course, I could have chosen XEmacs as my native platform and done
30997mapping functions the other way around. But I didn't. The performance
30998hit 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