1 ;;; url-news.el --- News Uniform Resource Locator retrieval code
3 ;; Copyright (C) 1996, 1997, 1998, 1999, 2004,
4 ;; 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
6 ;; Keywords: comm, data, processes
8 ;; This file is part of GNU Emacs.
10 ;; GNU Emacs is free software; you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation; either version 3, or (at your option)
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs; see the file COPYING. If not, write to the
22 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
23 ;; Boston, MA 02110-1301, USA.
31 (autoload 'url-warn "url")
32 (autoload 'gnus-group-read-ephemeral-group "gnus-group")
33 (eval-when-compile (require 'cl))
35 (defgroup url-news nil
36 "News related options."
39 (defun url-news-open-host (host port user pass)
40 (if (fboundp 'nnheader-init-server-buffer)
41 (nnheader-init-server-buffer))
42 (nntp-open-server host (list port))
45 (nntp-send-command "^.*\r?\n" "AUTHINFO USER" user)
46 (nntp-send-command "^.*\r?\n" "AUTHINFO PASS" pass)
47 (if (not (nntp-server-opened host))
48 (url-warn 'url (format "NNTP authentication to `%s' as `%s' failed"
51 (defun url-news-fetch-message-id (host message-id)
52 (let ((buf (generate-new-buffer " *url-news*")))
53 (if (eq ?> (aref message-id (1- (length message-id))))
55 (setq message-id (concat "<" message-id ">")))
56 (if (cdr-safe (nntp-request-article message-id nil host buf))
57 ;; Successfully retrieved the article
59 (with-current-buffer buf
60 (insert "Content-type: text/html\n\n"
63 " <title>Error</title>\n"
67 " <h1>Error requesting article...</h1>\n"
69 " The status message returned by the NNTP server was:"
76 " If you If you feel this is an error, <a href=\""
77 "mailto:" url-bug-address "\">send mail</a>\n"
82 "<!-- Automatically generated by URL v" url-version " -->\n"
86 (defun url-news-fetch-newsgroup (newsgroup host)
87 (declare (special gnus-group-buffer))
88 (if (string-match "^/+" newsgroup)
89 (setq newsgroup (substring newsgroup (match-end 0))))
90 (if (string-match "/+$" newsgroup)
91 (setq newsgroup (substring newsgroup 0 (match-beginning 0))))
93 ;; This saves us from checking new news if Gnus is already running
94 ;; FIXME - is it relatively safe to use gnus-alive-p here? FIXME
95 (if (or (not (get-buffer gnus-group-buffer))
96 (with-current-buffer gnus-group-buffer
97 (not (eq major-mode 'gnus-group-mode))))
99 (set-buffer gnus-group-buffer)
100 (goto-char (point-min))
101 (gnus-group-read-ephemeral-group newsgroup
103 (list 'nntp-open-connection-function
104 nntp-open-connection-function))
106 (cons (current-buffer) 'browse)))
109 (defun url-news (url)
110 ;; Find a news reference
111 (let* ((host (or (url-host url) url-news-server))
112 (port (url-port url))
113 (article-brackets nil)
115 (article (url-unhex-string (url-filename url))))
116 (url-news-open-host host port (url-user url) (url-password url))
118 ((string-match "@" article) ; Its a specific article
119 (setq buf (url-news-fetch-message-id host article)))
120 ((string= article "") ; List all newsgroups
123 (url-news-fetch-newsgroup article host)))
127 (defun url-snews (url)
128 (let ((nntp-open-connection-function (if (eq 'ssl url-gateway-method)
129 'nntp-open-ssl-stream
130 'nntp-open-tls-stream)))
135 ;; arch-tag: 8975be13-04e8-4d38-bfff-47918e3ad311
136 ;;; url-news.el ends here