lisp/gnus/mail-parse.el

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