Revision: miles@gnu.org--gnu-2005/gnus--devo--0--patch-151
[gnus] / lisp / mail-parse.el
1 ;;; mail-parse.el --- Interface functions for parsing mail
2 ;; Copyright (C) 1998, 1999, 2000
3 ;;        Free Software Foundation, Inc.
4
5 ;; Author: Lars Magne Ingebrigtsen <larsi@gnus.org>
6 ;; This file is part of GNU Emacs.
7
8 ;; GNU Emacs is free software; you can redistribute it and/or modify
9 ;; it under the terms of the GNU General Public License as published by
10 ;; the Free Software Foundation; either version 2, or (at your option)
11 ;; any later version.
12
13 ;; GNU Emacs is distributed in the hope that it will be useful,
14 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
15 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 ;; GNU General Public License for more details.
17
18 ;; You should have received a copy of the GNU General Public License
19 ;; along with GNU Emacs; see the file COPYING.  If not, write to the
20 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
21 ;; Boston, MA 02110-1301, USA.
22
23 ;;; Commentary:
24
25 ;; This file contains wrapper functions for a wide range of mail
26 ;; parsing functions.  The idea is that there are low-level libraries
27 ;; that impement according to various specs (RFC2231, DRUMS, USEFOR),
28 ;; but that programmers that want to parse some header (say,
29 ;; Content-Type) will want to use the latest spec.
30 ;;
31 ;; So while each low-level library (rfc2231.el, for instance) decodes
32 ;; faithfully according to that (proposed) standard, this library is
33 ;; the interface library.  If some later RFC supersedes RFC2231, one
34 ;; would just have to write a new low-level library, adjust the
35 ;; aliases in this library, and the users and programmers won't notice
36 ;; any changes.
37
38 ;;; Code:
39
40 (require 'mail-prsvr)
41 (require 'ietf-drums)
42 (require 'rfc2231)
43 (require 'rfc2047)
44 (require 'rfc2045)
45
46 (defalias 'mail-header-parse-content-type 'rfc2231-parse-qp-string)
47 (defalias 'mail-header-parse-content-disposition 'rfc2231-parse-qp-string)
48 (defalias 'mail-content-type-get 'rfc2231-get-value)
49 ;(defalias 'mail-header-encode-parameter 'rfc2045-encode-string)
50 (defalias 'mail-header-encode-parameter 'rfc2231-encode-string)
51
52 (defalias 'mail-header-remove-comments 'ietf-drums-remove-comments)
53 (defalias 'mail-header-remove-whitespace 'ietf-drums-remove-whitespace)
54 (defalias 'mail-header-strip 'ietf-drums-strip)
55 (defalias 'mail-header-get-comment 'ietf-drums-get-comment)
56 (defalias 'mail-header-parse-address 'ietf-drums-parse-address)
57 (defalias 'mail-header-parse-addresses 'ietf-drums-parse-addresses)
58 (defalias 'mail-header-parse-date 'ietf-drums-parse-date)
59 (defalias 'mail-narrow-to-head 'ietf-drums-narrow-to-header)
60 (defalias 'mail-quote-string 'ietf-drums-quote-string)
61 (defalias 'mail-header-make-address 'ietf-drums-make-address)
62
63 (defalias 'mail-header-fold-field 'rfc2047-fold-field)
64 (defalias 'mail-header-unfold-field 'rfc2047-unfold-field)
65 (defalias 'mail-header-narrow-to-field 'rfc2047-narrow-to-field)
66 (defalias 'mail-header-field-value 'rfc2047-field-value)
67
68 (defalias 'mail-encode-encoded-word-region 'rfc2047-encode-region)
69 (defalias 'mail-encode-encoded-word-buffer 'rfc2047-encode-message-header)
70 (defalias 'mail-encode-encoded-word-string 'rfc2047-encode-string)
71 (defalias 'mail-decode-encoded-word-region 'rfc2047-decode-region)
72 (defalias 'mail-decode-encoded-word-string 'rfc2047-decode-string)
73
74 (provide 'mail-parse)
75
76 ;;; arch-tag: 3e63d75c-c962-4784-ab01-7ba07ca9d2d4
77 ;;; mail-parse.el ends here