From f2a538a2a00a0b057c184f8f146cc7e2ea91c629 Mon Sep 17 00:00:00 2001 From: Glenn Morris Date: Wed, 3 Jul 2013 00:45:25 -0700 Subject: [PATCH] Fix/update some gnus manual links to external resources * doc/misc/gnus-faq.texi (FAQ 5-8, FAQ 6-3): Remove defunct URLs. (FAQ 7-1): Update URL. * doc/misc/gnus.texi (Top): Restrict "Other related manuals" to info output. (Foreign Groups): Use @indicateurl for examples. (Direct Functions): Remove defunct URL. (RSS): Update URL. --- doc/misc/ChangeLog | 8 ++++++++ doc/misc/gnus-faq.texi | 22 ++++++++++++++-------- doc/misc/gnus.texi | 25 ++++++++++++++++--------- 3 files changed, 38 insertions(+), 17 deletions(-) diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index ddd8b81e868..6a745b27d96 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog @@ -4,6 +4,14 @@ * dbus.texi (Introspection): Update URL to a less defunct one. + * gnus.texi (Top): Restrict "Other related manuals" to info output. + (Foreign Groups): Use @indicateurl for examples. + (Direct Functions): Remove defunct URL. + (RSS): Update URL. + + * gnus-faq.texi (FAQ 5-8, FAQ 6-3): Remove defunct URLs. + (FAQ 7-1): Update URL. + * pgg.texi (Top, Overview): Add note about obsolescence. * bovine.texi (top): diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi index ede957a5c35..55756ac9b34 100644 --- a/doc/misc/gnus-faq.texi +++ b/doc/misc/gnus-faq.texi @@ -1541,8 +1541,9 @@ cat file.face | sed 's/\\/\\\\/g;s/\"/\\\"/g;' > file.face.quoted If you can't use compface, there's an online X-face converter at @uref{http://www.dairiki.org/xface/}. -If you use MS Windows, you could also use the WinFace program from -@uref{http://www.xs4all.nl/~walterln/winface/}. +If you use MS Windows, you could also use the WinFace program, +which used to be available from +@indicateurl{http://www.xs4all.nl/~walterln/winface/}. Now you only have to tell Gnus to include the X-face in your postings by saying @example @@ -1835,15 +1836,20 @@ too. Of course you can also use grep to search through your local mail, but this is both slow for big archives and inconvenient since you are not displaying the found mail -in Gnus. Here comes nnir into action. Nnir is a front end +in Gnus. Here nnir comes into action. Nnir is a front end to search engines like swish-e or swish++ and -others. You index your mail with one of those search +others. You index your mail with one of those search engines and with the help of nnir you can search through the indexed mail and generate a temporary group with all -messages which met your search criteria. If this sound -cool to you get nnir.el from +messages which met your search criteria. If this sounds +cool to you, get nnir.el from +@c FIXME Isn't this file in Gnus? +@ignore +@c Dead link 2013/7. @uref{ftp://ls6-ftp.cs.uni-dortmund.de/pub/src/emacs/} -or @uref{ftp://ftp.is.informatik.uni-duisburg.de/pub/src/emacs/}. +or +@end ignore +@uref{ftp://ftp.is.informatik.uni-duisburg.de/pub/src/emacs/}. Instructions on how to use it are at the top of the file. @node FAQ 6-4 @@ -1966,7 +1972,7 @@ the easiest solution is a small nntp server like @uref{http://infa.abo.fi/~patrik/sn/, sn}, of course you can also install a full featured news server like -@uref{http://www.isc.org/products/INN/, inn}. +@uref{http://www.isc.org/software/inn/, inn}. Then you want to fetch your Mail, popular choices are @uref{http://www.catb.org/~esr/fetchmail/, fetchmail} and @uref{http://pyropus.ca/software/getmail/, getmail}. diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index b70c31b28fa..4279820acda 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -420,6 +420,9 @@ This manual corresponds to Gnus v5.13 * Index:: Variable, function and concept index. * Key Index:: Key Index. +@c Doesn't work right in html. +@c FIXME Do this in a more standard way. +@ifinfo Other related manuals * Message:(message). Composing messages. @@ -427,6 +430,7 @@ Other related manuals * Sieve:(sieve). Managing Sieve scripts in Emacs. * EasyPG:(epa). @acronym{PGP/MIME} with Gnus. * SASL:(sasl). @acronym{SASL} authentication in Emacs. +@end ifinfo @detailmenu --- The Detailed Node Listing --- @@ -2708,11 +2712,11 @@ the article range. This command is similar to @code{gnus-read-ephemeral-gmane-group}, but the group name and the article number and range are constructed from a given @acronym{URL}. Supported @acronym{URL} formats include: -@url{http://thread.gmane.org/gmane.foo.bar/12300/focus=12399}, -@url{http://thread.gmane.org/gmane.foo.bar/12345/}, -@url{http://article.gmane.org/gmane.foo.bar/12345/}, -@url{http://permalink.gmane.org/gmane.foo.bar/12345/}, and -@url{http://news.gmane.org/group/gmane.foo.bar/thread=12345}. +@indicateurl{http://thread.gmane.org/gmane.foo.bar/12300/focus=12399}, +@indicateurl{http://thread.gmane.org/gmane.foo.bar/12345/}, +@indicateurl{http://article.gmane.org/gmane.foo.bar/12345/}, +@indicateurl{http://permalink.gmane.org/gmane.foo.bar/12345/}, and +@indicateurl{http://news.gmane.org/group/gmane.foo.bar/thread=12345}. @item gnus-read-ephemeral-emacs-bug-group @findex gnus-read-ephemeral-emacs-bug-group @@ -13805,9 +13809,12 @@ installed. You then define a server as follows: @findex nntp-open-ssl-stream @item nntp-open-ssl-stream Opens a connection to a server over a @dfn{secure} channel. To use -this you must have @uref{http://www.openssl.org, OpenSSL} or -@uref{ftp://ftp.psy.uq.oz.au/pub/Crypto/SSL, SSLeay} installed. You -then define a server as follows: +this you must have @uref{http://www.openssl.org, OpenSSL} +@ignore +@c Defunct URL, ancient package, so don't mention it. +or @uref{ftp://ftp.psy.uq.oz.au/pub/Crypto/SSL, SSLeay} +@end ignore +installed. You then define a server as follows: @lisp ;; @r{"snews" is port 563 and is predefined in our @file{/etc/services}} @@ -16919,7 +16926,7 @@ Some web sites have an RDF Site Summary (@acronym{RSS}). @acronym{RSS} is a format for summarizing headlines from news related sites (such as BBC or CNN). But basically anything list-like can be presented as an @acronym{RSS} feed: weblogs, changelogs or recent -changes to a wiki (e.g., @url{http://cliki.net/recent-changes.rdf}). +changes to a wiki (e.g., @url{http://cliki.net/site/recent-changes}). @acronym{RSS} has a quite regular and nice interface, and it's possible to get the information Gnus needs to keep groups updated. -- 2.39.2