(qmtp-open-connection-function): Revert initial value to
[elisp/flim.git] / FLIM-API.en
index 8d40147..2334d62 100644 (file)
@@ -1,3 +1,7 @@
+         FLIM (Faithful Library about Internet Message) API
+                            Version 1.14
+                          Draft Release 1
+
 * Notation
 
 Each function is described by following notation:
@@ -55,6 +59,7 @@ ULEVEL specifies implementation level:
   representation-type.
 
   [Required]<Suggest>
+  (Usage: SEMI 1.14 MIME-View)
 
 
 [Function] mime-parse-buffer (&optional buffer representation-type)
@@ -71,6 +76,7 @@ ULEVEL specifies implementation level:
   Return list of entities included in the ENTITY.
 
   [Required]<Suggest>
+  (Usage: SEMI 1.14 MIME-View, MIME-PGP)
 
 
 [Function] mime-entity-parent (entity &optional message)
@@ -79,6 +85,13 @@ ULEVEL specifies implementation level:
   If MESSAGE is specified, it is regarded as root entity.
 
   [Suggest]
+  (Usage: SEMI 1.14 MIME-View, MIME-PGP)
+
+
+[Function] mime-find-root-entity (entity)
+  Return root entity of ENTITY.
+
+  [Suggest]
 
 
 [Function] mime-root-entity-p (entity &optional message)
@@ -86,19 +99,21 @@ ULEVEL specifies implementation level:
 
   If MESSAGE is specified, it is regarded as root entity.
 
-  [Suggest]
+  [Suggest]<Suggest>
 
 
 [Function] mime-entity-node-id (entity)
   Return node-id of ENTITY.
 
   [Suggest]
+  (Usage: SEMI 1.14 MIME-View, MIME-PGP)
 
 
 [Function] mime-entity-number (entity)
   Return entity-number of ENTITY.
 
   [Optional]
+  (Usage: SEMI 1.14 MIME-View, MIME-PGP)
 
 
 ** MIME-Entity Search
@@ -121,52 +136,86 @@ ULEVEL specifies implementation level:
   [Suggest]<Suggest>
 
 
-[Function] mime-find-root-entity (entity)
-  Return root entity of ENTITY.
+** MIME-Entity Attributes
+
+[Function] mime-entity-content-type (entity)
+  Return content-type of ENTITY.
+
+  (cf. <** Content-Type>)
 
   [Suggest]
+  (Usage: SEMI 1.14 MIME-View)
 
 
-** MIME-Entity Attributes
+[Inline function] mime-entity-media-type (entity)
+  Return primary media-type of ENTITY.
 
-[Function] mime-entity-content-type (entity)
-  Return content-type of ENTITY.
+  [Suggest]<Not Suggest>
+  (Usage: SEMI 1.14 MIME-View)
+
+
+[Inline function] mime-entity-media-subtype (entity)
+  Return media-subtype of ENTITY.
+
+  [Suggest]<Not Suggest>
+  (Usage: SEMI 1.14 MIME-View)
+
+
+[Inline function] mime-entity-type/subtype (entity)
+  Return media-type/subtype of ENTITY.
 
   [Suggest]
+  (Usage: SEMI 1.14 MIME-W3)
+
+
+[Inline function] mime-entity-parameters (entity)
+  Return parameters of Content-Type of ENTITY.
+
+  [Suggest]<Not Suggest>
+  (Usage: SEMI 1.14 MIME-View)
 
 
 [Function] mime-entity-set-content-type (entity content-type)
   Set ENTITY's content-type to CONTENT-TYPE.
 
+  (cf. <** Content-Type>)
+
   [Suggest]
+  (Usage: SEMI 1.14 MIME-View)
 
 
 [Function] mime-entity-content-disposition (entity)
   Return content-disposition of ENTITY.
 
+  (cf. <** Content-Disposition>)
+
   [Suggest]
+  (Usage: SEMI 1.14 MIME-View)
 
 
 [Function] mime-entity-filename (entity)
   Return filename of ENTITY.
 
   [Suggest]
+  (Usage: SEMI 1.14 MIME-View)
 
 
 [Function] mime-entity-encoding (entity &optional default-encoding)
   Return content-transfer-encoding of ENTITY.
 
-If the ENTITY does not have Content-Transfer-Encoding field, this
-function returns DEFAULT-ENCODING.  If it is nil, "7bit" is used as
-default value.
+  If the ENTITY does not have Content-Transfer-Encoding field, this
+  function returns DEFAULT-ENCODING.  If it is nil, "7bit" is used as
+  default value.
 
   [Suggest]
+  (Usage: SEMI 1.14 MIME-View)
 
 
 [Function] mime-entity-set-encoding (entity encoding)
   Set ENTITY's content-transfer-encoding to ENCODING.
 
   [Suggest]
+  (Usage: SEMI 1.14 MIME-View)
 
 
 [Function] mime-entity-cooked-p (entity)
@@ -174,12 +223,14 @@ default value.
   code-converted.
 
   [Suggest]
+  (Usage: SEMI 1.14 MIME-PGP)
 
 
 [Function] mime-entity-name (entity)
   Return unique name of the ENTITY.
 
   [Suggest]
+  (Usage: SEMI 1.14 MIME-View)
 
 
 ** MIME-Entity Header
@@ -193,6 +244,7 @@ default value.
   If FIELD-NAME field is not found, this function returns nil.
 
   [Required]<Suggest>
+  (Usage: SEMI 1.14 MIME-View, MIME-BBDB)
 
 
 [Function] mime-entity-read-field (entity field-name)
@@ -208,6 +260,7 @@ default value.
   If FIELD-NAME field is not found, this function returns nil.
 
   [Suggest]
+  (Usage: SEMI 1.14 MIME-View, MIME-BBDB)
 
 
 ** Text Presentation of MIME-Entity Content
@@ -255,6 +308,7 @@ default value.
   Return content of ENTITY as byte sequence (string).
 
   [Required]
+  (Usage: SEMI 1.14 MIME-View, Postpet)
 
 
 [Function] mime-insert-entity-content (entity)
@@ -345,7 +399,7 @@ default value.
   Read field-body of Content-Type field from current-buffer,
   and return the parsed result.
 
-  Format of return value is as same as `mime-parse-Content-Type'."
+  Format of return value is as same as `mime-parse-Content-Type'.
 
   Return `nil' if Content-Type field is not found.
 
@@ -384,30 +438,42 @@ default value.
 
 ** Content-Disposition
 
+[Function] mime-parse-Content-Disposition (string)
+  Parse STRING as field-body of Content-Disposition field.
+
+  [Suggest]
+
+
+[Function] mime-read-Content-Disposition ()
+  Read field-body of Content-Disposition field from current-buffer,
+and return parsed it.
+
+  [Suggest]
+
+
 [Inline function] mime-content-disposition-type (content-disposition)
   Return disposition-type of CONTENT-DISPOSITION.
 
+  [Required]
+
 
 [Inline function] mime-content-disposition-parameter
                                (content-disposition parameter)
   Return PARAMETER value of CONTENT-DISPOSITION.
 
+  [Required]
+
 
 [Inline function] mime-content-disposition-filename (content-disposition)
   Return filename of CONTENT-DISPOSITION.
 
+  [Suggest]<Suggest>
+
 
 [Inline function] mime-content-disposition-parameters (content-disposition)
   Return disposition-parameters of CONTENT-DISPOSITION.
 
-
-[Function] mime-parse-Content-Disposition (string)
-  Parse STRING as field-body of Content-Disposition field.
-
-
-[Function] mime-read-Content-Disposition ()
-  Read field-body of Content-Disposition field from current-buffer,
-and return parsed it.
+  [Suggest]
 
 
 * encoded-word
@@ -419,7 +485,8 @@ and return parsed it.
 
 ** decoder
 
-[Function] mime-decode-header-in-buffer (&optional code-conversion separator)
+[Function] mime-decode-header-in-buffer (&optional code-conversion
+                                                  separator)
   Decode MIME encoded-words in header fields.
 
   If CODE-CONVERSION is nil, it decodes only encoded-words.  If it is
@@ -432,6 +499,19 @@ and return parsed it.
   [Suggest]
 
 
+[Function] [Function] eword-decode-header (&optional code-conversion
+                                                    separator)
+  As same as `mime-decode-header-in-buffer', q.v.
+
+  Note that
+
+       (require 'eword-decode)
+
+  is necessary to use this function.
+
+  [Optional]<Obsolete> (Usage: cmail 2.61)
+
+
 [Function] mime-decode-header-in-region (start end
                                         &optional code-conversion)
   Decode MIME encoded-words in region between START and END.
@@ -546,7 +626,7 @@ and return parsed it.
   [Suggest]
 
 
-** Decoder
+** String
 
 [Function] mime-decode-string (string encoding)
   Decode STRING using ENCODING.
@@ -557,15 +637,32 @@ and return parsed it.
   [Required]<Suggest>
 
 
-[Function] mime-decode-region (start end encoding)
-  Decode region START to END of current buffer using ENCODING.
+[Function] mime-encode-string (string encoding)
+  Encode STRING using ENCODING.
 
   ENCODING must be string.
 
-  [Suggest]<Not Suggest>
+  [Required]<Suggest>
+
+
+[Function] base64-decode-string (STRING)
+  Base64-decode STRING and return the result.
+
+  [Required]
+
+
+[Function] base64-encode-string (STRING &optional NO-LINE-BREAK)
+  Base64-encode STRING and return the result.
+
+  Optional second argument NO-LINE-BREAK means do not break long lines
+  into shorter lines.
+
+  [Required]
 
 
-[Function] mime-write-decoded-region (start end filename encoding)
+** File
+
+[Command] mime-write-decoded-region (start end filename encoding)
   Decode and write current region encoded by ENCODING into FILENAME.
 
   START and END are buffer positions.
@@ -573,17 +670,94 @@ and return parsed it.
   [Required]<Suggest>
 
 
-** Encoder
+[Command] mime-insert-encoded-file (filename encoding)
+  Insert file FILENAME encoded by ENCODING format.
 
-[Function] mime-encode-string (string encoding)
-  Encode STRING using ENCODING.
+  [Required]<Suggest>
+
+
+[Command] 7bit-write-decoded-region (start end filename)
+  Decode and write current region encoded by "7bit" into FILENAME.
+
+  START and END are buffer positions.
+
+  [Optional]
+
+
+[Command] 7bit-insert-encoded-file (filename)
+  Insert file FILENAME encoded by "7bit" format.
+
+  [Optional]
+
+
+[Command] 8bit-write-decoded-region (start end filename)
+  Decode and write current region encoded by "8bit" into FILENAME.
+
+  START and END are buffer positions.
+
+  [Optional]
+
+
+[Command] 8bit-insert-encoded-file (filename)
+  Insert file FILENAME encoded by "8bit" format.
+
+  [Optional]
+
+
+[Command] binary-write-decoded-region (start end filename)
+  Decode and write current region encoded by "binary" into FILENAME.
+
+  START and END are buffer positions.
+
+  [Required]
+
+
+[Command] binary-insert-encoded-file (filename)
+  Insert file FILENAME encoded by "binary" format.
+
+  [Required]
+
+
+[Command] base64-write-decoded-region (start end filename)
+  Decode and write current region encoded by "base64" into FILENAME.
+
+  START and END are buffer positions.
+
+  [Optional]
+
+
+[Command] base64-insert-encoded-file (filename)
+  Insert file FILENAME encoded by "base64" format.
+
+  [Optional]
+
+
+[Command] quoted-printable-write-decoded-region (start end filename)
+  Decode and write current region encoded by "quoted-printable" into
+  FILENAME.
+
+  START and END are buffer positions.
+
+  [Optional]
+
+
+[Command] quoted-printable-insert-encoded-file (filename)
+  Insert file FILENAME encoded by "quoted-printable" format.
+
+  [Optional]
+
+
+** Region
+
+[Command] mime-decode-region (start end encoding)
+  Decode region START to END of current buffer using ENCODING.
 
   ENCODING must be string.
 
-  [Optional]<Not Suggest>
+  [Suggest]<Not Suggest>
 
 
-[Function] mime-encode-region (start end encoding)
+[Command] mime-encode-region (start end encoding)
   Encode region START to END of current buffer using ENCODING.
 
   ENCODING must be string.
@@ -591,10 +765,26 @@ and return parsed it.
   [Suggest]<Not Suggest>
 
 
-[Function] mime-insert-encoded-file (filename encoding)
-  Insert file FILENAME encoded by ENCODING format.
+[Command] base64-decode-region (BEG END)
+  Base64-decode the region between BEG and END.
 
-  [Required]<Suggest>
+  Return the length of the decoded text.
+  
+  If the region can't be decoded, return nil and don't modify the
+  buffer.
+
+  [Suggest]<Not Suggest>
+
+
+[Command] base64-encode-region (BEG END &optional NO-LINE-BREAK)
+  Base64-encode the region between BEG and END.
+
+  Return the length of the encoded text.
+
+  Optional third argument NO-LINE-BREAK means do not break long lines
+  into shorter lines.
+
+  [Suggest]<Not Suggest>
 
 
 ** encoded-text
@@ -815,8 +1005,8 @@ If BOUNDARY is not nil, it is used as message header separator.
 [Function] std11-extract-address-components (string)
   Extract full name and canonical address from STRING.
 
-Returns a list of the form (FULL-NAME CANONICAL-ADDRESS).
-If no name can be extracted, FULL-NAME will be nil.
+  Returns a list of the form (FULL-NAME CANONICAL-ADDRESS).  If no
+  name can be extracted, FULL-NAME will be nil.
 
 
 * SMTP
@@ -826,18 +1016,18 @@ If no name can be extracted, FULL-NAME will be nil.
 (require 'smtp)
 
 
-** Level 1 features
+** Features
 
 [Function] smtp-send-buffer (sender recipients buffer)
+  Send a message.
 
+  SENDER is an envelope sender address.
+  RECIPIENTS is a list of envelope recipient addresses.
+  BUFFER may be a buffer or a buffer name which contains mail message.
 
-* QMTP
-
-** How to use
-
-(require 'qmtp)
-
+  [Suggest]
 
-** Level 1 features
+[Function] smtp-via-smtp (sender recipients buffer)
+  Like `smtp-send-buffer', but sucks in any errors.
 
-[Function] qmtp-send-buffer (sender recipients buffer)
+  [Optional]<Not Suggest>