procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Resurrect GNUS-NEWS autogeneration

Browse source 
* doc/misc/gnus-coding.texi (Gnus Maintenance Guide): Update
GNUS-NEWS section to match current file locations and procedure.
* etc/GNUS-NEWS: Regenerate by using new procedure.
* lisp/Makefile.in (update-gnus-news): New rule, containing a
procedure for building GNUS-NEWS.  The old procedure got lost
somehow when Gnus was merged into Emacs.
This commit is contained in:
Paul Eggert 2016-03-23 00:07:14 -07:00
parent 1e5327c7c7
commit c0165ea4d6
3 changed files with 280 additions and 30 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
doc/misc/gnus-coding.texi
View file

@ -364,11 +364,11 @@ such multiple commits, like whitespace differences, and unify those ;-).
@heading @file{GNUS-NEWS}
Starting from No Gnus, the @file{GNUS-NEWS} is created from
@file{texi/gnus-news.texi}. Don't edit @file{GNUS-NEWS}. Edit
@file{texi/gnus-news.texi}, type @command{make GNUS-NEWS} in the
@file{texi} directory and commit @file{GNUS-NEWS} and
@file{texi/gnus-news.texi}.
The @file{etc/GNUS-NEWS} is created from
@file{doc/misc/gnus-news.texi}. Don't edit @file{etc/GNUS-NEWS}.
Edit @file{doc/misc/gnus-news.texi}, type @command{make
update-gnus-news} in the @file{lisp} directory and commit
@file{etc/GNUS-NEWS} and @file{doc/misc/gnus-news.texi}.
@heading Conventions for version information in defcustoms

292
etc/GNUS-NEWS
View file

@ -7,40 +7,286 @@ Please send Gnus bug reports to bugs@gnus.org.
For older news, see Gnus info node "New Features".
* New features
* Supported Emacs versions The following Emacs versions are supported by No
Gnus:
** nnimap can request and use the Gmail "X-GM-LABELS".
** Emacs 22 and up
** XEmacs 21.4
** XEmacs 21.5
** SXEmacs
** New package `gnus-notifications.el' can send notifications when you
receive new messages.
* Installation changes
** If you have the "tnef" program installed, Gnus will display ms-tnef
files, aka "winmail.dat".
** Upgrading from previous (stable) version if you have used No Gnus.
** Archives (like tar and zip files) will be automatically unpacked,
and the files inside the packages will be displayed as MIME parts.
If you have tried No Gnus (the unstable Gnus branch leading to this
release) but went back to a stable version, be careful when upgrading to
this version. In particular, you will probably want to remove the
'~/News/marks' directory (perhaps selectively), so that flags are read
from your '~/.newsrc.eld' instead of from the stale marks file, where
this release will store flags for nntp. See a later entry for more
information about nntp marks. Note that downgrading isn't safe in
general.
** shr has a new command `z' that cycles through image sizes.
** Incompatibility when switching from Emacs 23 to Emacs 22 In Emacs 23,
Gnus uses Emacs's new internal coding system 'utf-8-emacs' for saving
articles drafts and '~/.newsrc.eld'. These files may not be read
correctly in Emacs 22 and below. If you want to use Gnus across
different Emacs versions, you may set 'mm-auto-save-coding-system' to
'emacs-mule'.
** `backtab' in the summary buffer now selects the previous link in
the article buffer.
** Lisp files are now installed in '.../site-lisp/gnus/' by default. It
defaulted to '.../site-lisp/' formerly. In addition to this, the new
installer issues a warning if other Gnus installations which will shadow
the latest one are detected. You can then remove those shadows manually
or remove them using 'make remove-installed-shadows'.
** Using the "X-Message-SMTP-Method" header in Message buffers now
allows specifying how messages are to be sent. For example:
** The installation directory name is allowed to have spaces and/or tabs.
X-Message-SMTP-Method: smtp smtp.fsf.org 587
* New packages and libraries within Gnus
** Gnus keeps track of non-existent articles for nnimap groups, so
that sparse IMAP folders now list a correct number of messages in
them.
** New version of 'nnimap'
** Gnus will guess the real type of MIME parts of type
application/octet-stream based on the file suffix. So an
application/octet-stream with a name of "rms.jpg" will be displayed
as an image/jpeg type by default, for instance.
'nnimap' has been reimplemented in a mostly-compatible way. See the Gnus
manual for a description of the new interface. In particular,
'nnimap-inbox' and the client side split method has changed.
** `nnimap-inbox' can now be a list of mail box names.
** Gnus includes the Emacs Lisp SASL library.
This provides a clean API to SASL mechanisms from within Emacs. The user
visible aspects of this, compared to the earlier situation, include
support for DIGEST-MD5 and NTLM. *Note Emacs SASL: (sasl)Top.
** ManageSieve connections uses the SASL library by default.
The primary change this brings is support for DIGEST-MD5 and NTLM, when
the server supports it.
** Gnus includes a password cache mechanism in password.el.
It is enabled by default (see 'password-cache'), with a short timeout of
16 seconds (see 'password-cache-expiry'). If PGG is used as the PGP back
end, the PGP passphrase is managed by this mechanism. Passwords for
ManageSieve connections are managed by this mechanism, after querying the
user about whether to do so.
** Using EasyPG with Gnus When EasyPG, is available, Gnus will use it
instead of PGG. EasyPG is an Emacs user interface to GNU Privacy Guard.
*Note EasyPG Assistant user's manual: (epa)Top. EasyPG is included in
Emacs 23 and available separately as well.
* Changes in group mode
** Symbols like 'gcc-self' now have the same precedence rules in
'gnus-parameters' as other "real" variables: The last match wins instead
of the first match.
** Old intermediate incoming mail files ('Incoming*') are deleted after a
couple of days, not immediately. *Note Mail Source Customization::.
(New in Gnus 5.10.10 / No Gnus 0.8)
* Changes in summary and article mode
** There's now only one variable that determines how HTML is rendered:
'mm-text-html-renderer'.
** Gnus now supports sticky article buffers. Those are article buffers that
are not reused when you select another article. *Note Sticky Articles::.
** Gnus can selectively display 'text/html' articles with a WWW browser with
'K H'. *Note MIME Commands::.
** International host names (IDNA) can now be decoded inside article bodies
using 'W i' ('gnus-summary-idna-message'). This requires that GNU Libidn
(<http://www.gnu.org/software/libidn/>) has been installed.
** The non-ASCII group names handling has been much improved. The back ends
that fully support non-ASCII group names are now 'nntp', 'nnml', and
'nnrss'. Also the agent, the cache, and the marks features work with
those back ends. *Note Non-ASCII Group Names::.
** Gnus now displays DNS master files sent as text/dns using dns-mode.
** Gnus supports new limiting commands in the Summary buffer: '/ r'
('gnus-summary-limit-to-replied') and '/ R'
('gnus-summary-limit-to-recipient'). *Note Limiting::.
** You can now fetch all ticked articles from the server using 'Y t'
('gnus-summary-insert-ticked-articles'). *Note Summary Generation
Commands::.
** Gnus supports a new sort command in the Summary buffer: 'C-c C-s C-t'
('gnus-summary-sort-by-recipient'). *Note Summary Sorting::.
** S/MIME now features LDAP user certificate searches. You need to
configure the server in 'smime-ldap-host-list'.
** URLs inside OpenPGP headers are retrieved and imported to your PGP key
ring when you click on them.
** Picons can be displayed right from the textual address, see
'gnus-picon-style'. *Note Picons::.
** ANSI SGR control sequences can be transformed using 'W A'.
ANSI sequences are used in some Chinese hierarchies for highlighting
articles ('gnus-article-treat-ansi-sequences').
** Gnus now MIME decodes articles even when they lack "MIME-Version" header.
This changes the default of 'gnus-article-loose-mime'.
** 'gnus-decay-scores' can be a regexp matching score files. For example,
set it to '\\.ADAPT\\'' and only adaptive score files will be decayed.
*Note Score Decays::.
** Strings prefixing to the 'To' and 'Newsgroup' headers in summary lines
when using 'gnus-ignored-from-addresses' can be customized with
'gnus-summary-to-prefix' and 'gnus-summary-newsgroup-prefix'. *Note To
From Newsgroups::.
** You can replace MIME parts with external bodies. See
'gnus-mime-replace-part' and 'gnus-article-replace-part'. *Note MIME
Commands::, *note Using MIME::.
** The option 'mm-fill-flowed' can be used to disable treatment of
format=flowed messages. Also, flowed text is disabled when sending
inline PGP signed messages. *Note Flowed text: (emacs-mime)Flowed text.
(New in Gnus 5.10.7)
** Now the new command 'S W' ('gnus-article-wide-reply-with-original') for a
wide reply in the article buffer yanks a text that is in the active
region, if it is set, as well as the 'R'
('gnus-article-reply-with-original') command. Note that the 'R' command
in the article buffer no longer accepts a prefix argument, which was used
to make it do a wide reply. *Note Article Keymap::.
** The new command 'C-h b' ('gnus-article-describe-bindings') used in the
article buffer now shows not only the article commands but also the real
summary commands that are accessible from the article buffer.
* Changes in Message mode
** Gnus now defaults to saving all outgoing messages in per-month nnfolder
archives.
** Gnus now supports the "hashcash" client puzzle anti-spam mechanism. Use
'(setq message-generate-hashcash t)' to enable. *Note Hashcash::.
** You can now drag and drop attachments to the Message buffer. See
'mml-dnd-protocol-alist' and 'mml-dnd-attach-options'. *Note MIME:
(message)MIME.
** The option 'message-yank-empty-prefix' now controls how empty lines are
prefixed in cited text. *Note Insertion Variables: (message)Insertion
Variables.
** Gnus uses narrowing to hide headers in Message buffers. The 'References'
header is hidden by default. To make all headers visible, use '(setq
message-hidden-headers nil)'. *Note Message Headers: (message)Message
Headers.
** You can highlight different levels of citations like in the article
buffer. See 'gnus-message-highlight-citation'.
** 'auto-fill-mode' is enabled by default in Message mode. See
'message-fill-column'. *Note Message Headers: (message)Various Message
Variables.
** You can now store signature files in a special directory named
'message-signature-directory'.
** The option 'message-citation-line-format' controls the format of the
"Whomever writes:" line. You need to set
'message-citation-line-function' to
'message-insert-formatted-citation-line' as well.
* Changes in Browse Server mode
** Gnus' sophisticated subscription methods are now available in Browse
Server buffers as well using the variable
'gnus-browse-subscribe-newsgroup-method'.
* Changes in back ends
** The nntp back end stores article marks in '~/News/marks'.
The directory can be changed using the (customizable) variable
'nntp-marks-directory', and marks can be disabled using the (back end)
variable 'nntp-marks-is-evil'. The advantage of this is that you can
copy '~/News/marks' (using rsync, scp or whatever) to another Gnus
installation, and it will realize what articles you have read and marked.
The data in '~/News/marks' has priority over the same data in
'~/.newsrc.eld'.
** You can import and export your RSS subscriptions from OPML files. *Note
RSS::.
** IMAP identity (RFC 2971) is supported.
By default, Gnus does not send any information about itself, but you can
customize it using the variable 'nnimap-id'.
** The 'nnrss' back end now supports multilingual text. Non-ASCII group
names for the 'nnrss' groups are also supported. *Note RSS::.
** Retrieving mail with POP3 is supported over SSL/TLS and with StartTLS.
** The nnml back end allows other compression programs beside 'gzip' for
compressed message files. *Note Mail Spool::.
** The nnml back end supports group compaction.
This feature, accessible via the functions 'gnus-group-compact-group' ('G
z' in the group buffer) and 'gnus-server-compact-server' ('z' in the
server buffer) renumbers all articles in a group, starting from 1 and
removing gaps. As a consequence, you get a correct total article count
(until messages are deleted again).
* Appearance
** The tool bar has been updated to use GNOME icons. You can also customize
the tool bars: 'M-x customize-apropos RET -tool-bar$' should get you
started. (Only for Emacs, not in XEmacs.)
** The tool bar icons are now (de)activated correctly in the group buffer,
see the variable 'gnus-group-update-tool-bar'. Its default value depends
on your Emacs version.
** You can change the location of XEmacs's toolbars in Gnus buffers. See
'gnus-use-toolbar' and 'message-use-toolbar'.
* Miscellaneous changes
** Having edited the select-method for the foreign server in the server
buffer is immediately reflected to the subscription of the groups which
use the server in question. For instance, if you change
'nntp-via-address' into 'bar.example.com' from 'foo.example.com', Gnus
will connect to the news host by way of the intermediate host
'bar.example.com' from next time.
** The 'all.SCORE' file can be edited from the group buffer using 'W e'.
** You can set 'gnus-mark-copied-or-moved-articles-as-expirable' to a
non-'nil' value so that articles that have been read may be marked as
expirable automatically when copying or moving them to a group that has
auto-expire turned on. The default is 'nil' and copying and moving of
articles behave as before; i.e., the expirable marks will be unchanged
except that the marks will be removed when copying or moving articles to
a group that has not turned auto-expire on. *Note Expiring Mail::.
** NoCeM support has been removed.
** Carpal mode has been removed.
* For older news, see Gnus info node "New Features".
----------------------------------------------------------------------

8
lisp/Makefile.in
View file

@ -194,7 +194,7 @@ update-subdirs:
$(srcdir)/../build-aux/update-subdirs $$file; \
done;
.PHONY: updates repo-update update-authors
.PHONY: updates repo-update update-authors update-gnus-news
# Some modes of make-dist use this.
updates: update-subdirs autoloads finder-data custom-deps
@ -207,12 +207,16 @@ updates: update-subdirs autoloads finder-data custom-deps
# this directory's autoloads rule.
repo-update: compile finder-data custom-deps
# Update the AUTHORS file.
# Update etc/AUTHORS and etc/GNUS-NEWS.
update-authors:
$(emacs) -L "$(top_srcdir)/admin" -l authors \
-f batch-update-authors "$(top_srcdir)/etc/AUTHORS" "$(top_srcdir)"
update-gnus-news:
$(emacs) -L "$(top_srcdir)/doc/misc" -l gnus-news -f batch-gnus-news \
"$(top_srcdir)/doc/misc/gnus-news.texi" \
"$(top_srcdir)/etc/GNUS-NEWS"
ETAGS = ../lib-src/etags