(defvar): Silence byte-compiler warnings.
[gnus] / lisp / nnspool.el
1 ;;; nnspool.el --- spool access for GNU Emacs
2
3 ;; Copyright (C) 1988, 1989, 1990, 1993, 1994, 1995, 1996, 1997, 1998,
4 ;;               2000, 2002, 2003
5 ;;               Free Software Foundation, Inc.
6
7 ;; Author: Masanobu UMEDA <umerin@flab.flab.fujitsu.junet>
8 ;;      Lars Magne Ingebrigtsen <larsi@gnus.org>
9 ;; Keywords: news
10
11 ;; This file is part of GNU Emacs.
12
13 ;; GNU Emacs is free software; you can redistribute it and/or modify
14 ;; it under the terms of the GNU General Public License as published by
15 ;; the Free Software Foundation; either version 2, or (at your option)
16 ;; any later version.
17
18 ;; GNU Emacs is distributed in the hope that it will be useful,
19 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
21 ;; GNU General Public License for more details.
22
23 ;; You should have received a copy of the GNU General Public License
24 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
25 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
26 ;; Boston, MA 02111-1307, USA.
27
28 ;;; Commentary:
29
30 ;;; Code:
31
32 (require 'nnheader)
33 (require 'nntp)
34 (require 'nnoo)
35 (eval-when-compile (require 'cl))
36
37 (nnoo-declare nnspool)
38
39 (defvoo nnspool-inews-program news-inews-program
40   "Program to post news.
41 This is most commonly `inews' or `injnews'.")
42
43 (defvoo nnspool-inews-switches '("-h" "-S")
44   "Switches for nnspool-request-post to pass to `inews' for posting news.
45 If you are using Cnews, you probably should set this variable to nil.")
46
47 (defvoo nnspool-spool-directory (file-name-as-directory news-path)
48   "Local news spool directory.")
49
50 (defvoo nnspool-nov-directory (concat nnspool-spool-directory "over.view/")
51   "Local news nov directory.")
52
53 (defvoo nnspool-lib-dir
54     (if (file-exists-p "/usr/lib/news/active")
55         "/usr/lib/news/"
56       "/var/lib/news/")
57   "Where the local news library files are stored.")
58
59 (defvoo nnspool-active-file (concat nnspool-lib-dir "active")
60   "Local news active file.")
61
62 (defvoo nnspool-newsgroups-file (concat nnspool-lib-dir "newsgroups")
63   "Local news newsgroups file.")
64
65 (defvoo nnspool-distributions-file (concat nnspool-lib-dir "distribs.pat")
66   "Local news distributions file.")
67
68 (defvoo nnspool-history-file (concat nnspool-lib-dir "history")
69   "Local news history file.")
70
71 (defvoo nnspool-active-times-file (concat nnspool-lib-dir "active.times")
72   "Local news active date file.")
73
74 (defvoo nnspool-large-newsgroup 50
75   "The number of the articles which indicates a large newsgroup.
76 If the number of the articles is greater than the value, verbose
77 messages will be shown to indicate the current status.")
78
79 (defvoo nnspool-nov-is-evil nil
80   "Non-nil means that nnspool will never return NOV lines instead of headers.")
81
82 (defconst nnspool-sift-nov-with-sed nil
83   "If non-nil, use sed to get the relevant portion from the overview file.
84 If nil, nnspool will load the entire file into a buffer and process it
85 there.")
86
87 (defvoo nnspool-rejected-article-hook nil
88   "*A hook that will be run when an article has been rejected by the server.")
89
90 (defvoo nnspool-file-coding-system nnheader-file-coding-system
91   "Coding system for nnspool.")
92
93 \f
94
95 (defconst nnspool-version "nnspool 2.0"
96   "Version numbers of this version of NNSPOOL.")
97
98 (defvoo nnspool-current-directory nil
99   "Current news group directory.")
100
101 (defvoo nnspool-current-group nil)
102 (defvoo nnspool-status-string "")
103
104 \f
105 ;;; Interface functions.
106
107 (nnoo-define-basics nnspool)
108
109 (deffoo nnspool-retrieve-headers (articles &optional group server fetch-old)
110   "Retrieve the headers of ARTICLES."
111   (save-excursion
112     (set-buffer nntp-server-buffer)
113     (erase-buffer)
114     (when (nnspool-possibly-change-directory group)
115       (let* ((number (length articles))
116              (count 0)
117              (default-directory nnspool-current-directory)
118              (do-message (and (numberp nnspool-large-newsgroup)
119                               (> number nnspool-large-newsgroup)))
120              (nnheader-file-coding-system nnspool-file-coding-system)
121              file beg article ag)
122         (if (and (numberp (car articles))
123                  (nnspool-retrieve-headers-with-nov articles fetch-old))
124             ;; We successfully retrieved the NOV headers.
125             'nov
126           ;; No NOV headers here, so we do it the hard way.
127           (while (setq article (pop articles))
128             (if (stringp article)
129                 ;; This is a Message-ID.
130                 (setq ag (nnspool-find-id article)
131                       file (and ag (nnspool-article-pathname
132                                     (car ag) (cdr ag)))
133                       article (cdr ag))
134               ;; This is an article in the current group.
135               (setq file (int-to-string article)))
136             ;; Insert the head of the article.
137             (when (and file
138                        (file-exists-p file))
139               (insert "221 ")
140               (princ article (current-buffer))
141               (insert " Article retrieved.\n")
142               (setq beg (point))
143               (inline (nnheader-insert-head file))
144               (goto-char beg)
145               (if (search-forward "\n\n" nil t)
146                   (progn
147                     (forward-char -1)
148                     (insert ".\n"))
149                 (goto-char (point-max))
150                 (if (bolp)
151                     (insert ".\n")
152                   (insert "\n.\n")))
153               (delete-region (point) (point-max)))
154
155             (and do-message
156                  (zerop (% (incf count) 20))
157                  (nnheader-message 5 "nnspool: Receiving headers... %d%%"
158                                    (/ (* count 100) number))))
159
160           (when do-message
161             (nnheader-message 5 "nnspool: Receiving headers...done"))
162
163           ;; Fold continuation lines.
164           (nnheader-fold-continuation-lines)
165           'headers)))))
166
167 (deffoo nnspool-open-server (server &optional defs)
168   (nnoo-change-server 'nnspool server defs)
169   (cond
170    ((not (file-exists-p nnspool-spool-directory))
171     (nnspool-close-server)
172     (nnheader-report 'nnspool "Spool directory doesn't exist: %s"
173                      nnspool-spool-directory))
174    ((not (file-directory-p
175           (directory-file-name
176            (file-truename nnspool-spool-directory))))
177     (nnspool-close-server)
178     (nnheader-report 'nnspool "Not a directory: %s" nnspool-spool-directory))
179    ((not (file-exists-p nnspool-active-file))
180     (nnheader-report 'nnspool "The active file doesn't exist: %s"
181                      nnspool-active-file))
182    (t
183     (nnheader-report 'nnspool "Opened server %s using directory %s"
184                      server nnspool-spool-directory)
185     t)))
186
187 (deffoo nnspool-request-article (id &optional group server buffer)
188   "Select article by message ID (or number)."
189   (nnspool-possibly-change-directory group)
190   (let ((nntp-server-buffer (or buffer nntp-server-buffer))
191         file ag)
192     (if (stringp id)
193         ;; This is a Message-ID.
194         (when (setq ag (nnspool-find-id id))
195           (setq file (nnspool-article-pathname (car ag) (cdr ag))))
196       (setq file (nnspool-article-pathname nnspool-current-group id)))
197     (and file
198          (file-exists-p file)
199          (not (file-directory-p file))
200          (save-excursion (nnspool-find-file file))
201          ;; We return the article number and group name.
202          (if (numberp id)
203              (cons nnspool-current-group id)
204            ag))))
205