X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=FLIM-API.en;h=533ce5d80e73066b00e0552286f40541a99bd5f1;hb=fd286d9c7f55d1b60bbbae790e3887d7e7ee28b8;hp=ed2a2fd57155596ef440987ebf2f152db327ec49;hpb=a55777116ab99c182ba55824eedde84e616c2bd7;p=elisp%2Fflim.git diff --git a/FLIM-API.en b/FLIM-API.en index ed2a2fd..533ce5d 100644 --- a/FLIM-API.en +++ b/FLIM-API.en @@ -1,6 +1,6 @@ FLIM (Faithful Library about Internet Message) API Version 1.14 - Draft Release 2 + Draft Release 3 * Notation @@ -200,12 +200,11 @@ ULEVEL specifies implementation level: (Usage: SEMI 1.14 MIME-View) -[Function] mime-entity-encoding (entity &optional default-encoding) +[Function] mime-entity-encoding (entity) 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 valid Content-Transfer-Encoding field, + return nil. [Suggest] (Usage: SEMI 1.14 MIME-View) @@ -499,8 +498,7 @@ and return parsed it. [Suggest] -[Function] [Function] eword-decode-header (&optional code-conversion - separator) +[Function] eword-decode-header (&optional code-conversion separator) As same as `mime-decode-header-in-buffer', q.v. Note that @@ -877,136 +875,157 @@ and return parsed it. [Required] -* MIME Field parsing +* MIME Field ** How to use (require 'mime) -** Level 2 features +** Parsing [Variable] mime-field-parser-alist Alist to specify field parser. - -[Function] mime-parse-Content-Type (string) - Parse STRING as field-body of Content-Type field. - -Return value is - (PRIMARY-TYPE SUBTYPE (NAME1 . VALUE1)(NAME2 . VALUE2) ...) -or nil. PRIMARY-TYPE and SUBTYPE are symbol and NAME_n and VALUE_n -are string. + [Suggest] -[Function] mime-read-Content-Type () - Read field-body of Content-Type field from current-buffer, -and return parsed it. Format of return value is as same as -`mime-parse-Content-Type'. +[Function] mime-parse-msg-id (tokens) + Parse TOKENS as msg-id of Content-Id or Message-Id field. + [Suggest] -[Function] mime-parse-Content-Disposition (string) - Parse STRING as field-body of Content-Disposition field. +[Function] mime-uri-parse-cid (string) + Parse STRING as cid URI. -[Function] mime-read-Content-Disposition () - Read field-body of Content-Disposition field from current-buffer, -and return parsed it. + [Suggest] [Function] mime-parse-Content-Transfer-Encoding (string) Parse STRING as field-body of Content-Transfer-Encoding field. + If STRING is not a valid Content-Transfer-Encoding field, + return nil. + + [Suggest] -[Function] mime-read-Content-Transfer-Encoding (&optional default-encoding) +[Function] mime-read-Content-Transfer-Encoding () Read field-body of Content-Transfer-Encoding field from -current-buffer, and return it. + current-buffer, and return it. -If is is not found, return DEFAULT-ENCODING. + [Suggest] -[Function] mime-parse-msg-id (tokens) - Parse TOKENS as msg-id of Content-Id or Message-Id field. +* STD 11 +** How to use -[Function] mime-uri-parse-cid (string) - Parse STRING as cid URI. +(require 'std11) -* STD 11 parsing +** Header -** How to use +[Function] std11-narrow-to-header (&optional boundary) + Narrow to the message header. -(require 'std11) + If BOUNDARY is not nil, it is used as message header separator. + + [Required] -** Level 1 features +** Field [Function] std11-fetch-field (name) Return the value of the header field NAME. -The buffer is expected to be narrowed to just the headers of the message. + The buffer is expected to be narrowed to just the headers of the + message. - -[Function] std11-narrow-to-header (&optional boundary) - Narrow to the message header. - -If BOUNDARY is not nil, it is used as message header separator. + [Required] [Function] std11-field-body (name &optional boundary) Return the value of the header field NAME. -If BOUNDARY is not nil, it is used as message header separator. + If BOUNDARY is not nil, it is used as message header separator. + + [Required] [Function] std11-unfold-string (string) Unfold STRING as message header field. + [Required] + -** Level 2 features +** Lexical Analysis [Function] std11-lexical-analyze (string &optional analyzer start) Analyze STRING as lexical tokens of STD 11. + [Suggest] + + +** Address [Function] std11-address-string (address) Return string of address part from parsed ADDRESS of RFC 822. + [Suggest] + [Function] std11-full-name-string (address) Return string of full-name part from parsed ADDRESS of RFC 822. - -[Function] std11-msg-id-string (msg-id) - Return string from parsed MSG-ID of RFC 822. - - -[Function] std11-fill-msg-id-list-string (string &optional column) - Fill list of msg-id in STRING, and return the result. + [Suggest] [Function] std11-parse-address-string (string) Parse STRING as mail address. + [Suggest] + [Function] std11-parse-addresses-string (string) Parse STRING as mail address list. + [Suggest] + + +[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. + + [Suggest] + + +** Message-ID + +[Function] std11-msg-id-string (msg-id) + Return string from parsed MSG-ID of RFC 822. + + [Suggest] + [Function] std11-parse-msg-id-string (string) Parse STRING as msg-id. + [Suggest] + [Function] std11-parse-msg-ids-string (string) Parse STRING as `*(phrase / msg-id)'. + [Suggest] -[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. +[Function] std11-fill-msg-id-list-string (string &optional column) + Fill list of msg-id in STRING, and return the result. + + [Suggest] * SMTP @@ -1027,6 +1046,7 @@ If BOUNDARY is not nil, it is used as message header separator. [Suggest] + [Function] smtp-via-smtp (sender recipients buffer) Like `smtp-send-buffer', but sucks in any errors.