mime-en.texi

   1 \input texinfo.tex
   2 @setfilename mime-en.info
   3 @settitle{FLIM 1.9 Manual about MIME Features}
   4 @titlepage
   5 @title FLIM 1.9 Manual about MIME Features
   6 @author MORIOKA Tomohiko <morioka@@jaist.ac.jp>
   7 @subtitle 1998/07/01
   8 @end titlepage
   9 @node Top, Introduction, (dir), (dir)
  10 @top FLIM 1.9 Manual about MIME Features
  11
  12 @ifinfo
  13
  14 This file documents MIME features of FLIM, a Internet message
  15 parsing/encoding library for GNU Emacs.
  16 @end ifinfo
  17
  18 @menu
  19 * Introduction::                What is FLIM?
  20 * How to use::                  How to use MIME features
  21 * Entity::                      Message and Entity
  22 * Content-Type::                Information of Content-Type field
  23 * Content-Disposition::         Information of Content-Disposition field
  24 * Content-Transfer-Encoding::   Encoding Method
  25 * encoded-word::                Network representation of header
  26 * custom::                      Various Customization
  27 * Appendix::
  28 * Concept Index::
  29 * Function Index::
  30 * Variable Index::
  31 @end menu
  32
  33 @node Introduction, How to use, Top, Top
  34 @chapter What is FLIM?
  35
  36 FLIM is a library to provide basic features about message
  37 representation or encoding.
  38
  39
  40 @node How to use, Entity, Introduction, Top
  41 @chapter How to use MIME features
  42
  43 Please eval following to use MIME features provided by FLIM:
  44
  45 @lisp
  46 (require 'mime)
  47 @end lisp
  48
  49
  50
  51 @node Entity, Content-Type, How to use, Top
  52 @chapter Message and Entity
  53 @cindex mime-entity
  54 @cindex entity
  55
  56 According to RFC 2045 (@ref{RFC 2045}), `The term ``entity'', refers
  57 specifically to the MIME-defined header fields and contents of either a
  58 message or one of the parts in the body of a multipart entity.'  In this
  59 document, the term @strong{entity} indicates all of header fields and
  60 body.@refill
  61
  62 The definition of RFC 2045 indicates that a MIME message is a tree, and
  63 each node of the tree is an entity.  Namely MIME extends message to tree
  64 structure.@refill
  65
  66 FLIM uses @strong{mime-entity} structure to represent
  67 information of entity.  In this document, it is called simply
  68 `mime-entity'.
  69
  70
  71 @menu
  72 * Entity creation::             Functions to create mime-entity
  73 * Entity hierarchy::            Features about message tree
  74 * Entity Attributes::           Functions about attributes of mime-entity
  75 * Entity-header::               Information of entity header
  76 * Entity-content::              Contents of Entity
  77 * Entity buffer::               Entity as buffer representation
  78 * mm-backend::                  Entity representations and implementations
  79 @end menu
  80
  81 @node Entity creation, Entity hierarchy, Entity, Entity
  82 @section Functions to create mime-entity
  83
  84 @defun mime-open-entity &optional  type location
  85
  86 Open an entity and return it.@refill
  87
  88 @var{type} is representation-type. (cf. @ref{mm-backend}) @refill
  89
  90 @var{location} is location of entity.  Specification of it is depended
  91 on representation-type.
  92 @end defun
  93
  94
  95 @defun mime-parse-buffer &optional  buffer type
  96
  97 Parse @var{buffer} as message, and set the result to buffer local
  98 variable @code{mime-message-structure} of @var{buffer} as
  99 mime-entity.@refill
 100
 101 If @var{buffer} is omitted, current buffer is used.@refill
 102
 103 @var{type} is representation-type of created
 104 mime-entity. (cf. @ref{mm-backend}) Default value is @var{buffer}.
 105 @end defun
 106
 107
 108
 109 @node Entity hierarchy, Entity Attributes, Entity creation, Entity
 110 @section Features about message tree
 111 @cindex node-id
 112 @cindex entity-number
 113 @cindex message
 114 @cindex root-entity
 115
 116 Structure of a MIME message is tree.@refill
 117
 118 In the tree, root node is the entity indicates all of the message.  In
 119 this document, it is called @strong{root-entity} or @strong{message}.
 120 In FLIM, it is indicated by buffer local variable
 121 @code{mime-message-structure}.@refill
 122
 123 Each entity except root-entity has a parent.  An entity may have
 124 children.  We can indicate an entity by relative position from a base
 125 entity, based on the parent-child relationship.@refill
 126
 127 In addition, we can indicate an entity by absolute position of the
 128 message.@refill
 129
 130 Each entity, which is a node of the tree, can be numbered by
 131 depth and left-to-right order of the depth.
 132 @example
 133
 134                               +-------+
 135                               |  nil  |
 136                               +---+---+
 137               +-------------------+-------------------+
 138             +-+-+               +-+-+               +-+-+
 139             | 0 |               | 1 |               | 2 |
 140             +-+-+               +-+-+               +-+-+
 141               |         +---------+---------+         |
 142            +--+--+   +--+--+   +--+--+   +--+--+   +--+--+
 143            | 0.0 |   | 1.0 |   | 1.1 |   | 1.2 |   | 2.0 |
 144            +-----+   +-----+   +-----+   +-----+   +-----+
 145 @end example
 146
 147 Namely, if depth of a node is n, the node has a node-number, which is
 148 consists of n integers.  In this document, it is called
 149 @strong{entity-number}.  An entity-number is represented by list of
 150 integer, like @code{(1 2 3)}.@refill
 151
 152 mime-entity has also @strong{node-id}.  A node-id is represented by
 153 reversed list of entity-number.  For example, node-id corresponding with
 154 1.2.3 is @code{(3 2 1)}.@refill
 155
 156 Each entity can be indicated by entity-number or node-id in
 157 @code{mime-message-structure}.
 158
 159 @defvar mime-message-structure
 160
 161 Buffer local variable to store mime-entity structure of message.
 162 @end defvar
 163
 164
 165 @defun mime-entity-children entity
 166
 167 Return list of entities included in the @var{entity}.
 168 @end defun
 169
 170
 171 @defun mime-entity-parent entity  &optional  message
 172
 173 Return parent entity of the @var{entity}.@refill
 174
 175 If @var{message} is specified, it is regarded as root instead of
 176 @code{mime-message-structure}.
 177 @end defun
 178
 179
 180 @defun mime-root-entity-p entity
 181
 182 Return non-@code{nil} if @var{entity} is root entity (message).
 183 @end defun
 184
 185
 186 @defun mime-entity-node-id entity
 187
 188 Return node-id of @var{entity}.
 189 @end defun
 190
 191
 192 @defun mime-entity-number entity
 193
 194 Return entity-number of @var{entity}.
 195 @end defun
 196
 197
 198 @defun mime-find-entity-from-number entity-number  &optional  message
 199
 200 Return entity from @var{entity-number} in @var{message}.@refill
 201
 202 If @var{message} is not specified, @code{mime-message-structure} is
 203 used.
 204 @end defun
 205
 206
 207 @defun mime-find-entity-from-node-id entity-node-id  &optional  message
 208
 209 Return entity from @var{entity-node-id} in @var{message}.@refill
 210
 211 If @var{message} is not specified, @code{mime-message-structure} is
 212 used.
 213 @end defun
 214
 215
 216
 217 @node Entity Attributes, Entity-header, Entity hierarchy, Entity
 218 @section Functions about attributes of mime-entity
 219
 220 @defun mime-entity-content-type entity
 221
 222 Return content-type of @var{entity}.  (cf. @ref{mime-content-type})
 223 @end defun
 224
 225
 226 @defun mime-entity-content-disposition entity
 227
 228 Return content-disposition of
 229 @var{entity}. (cf. @ref{mime-content-disposition})
 230 @end defun
 231
 232
 233 @defun mime-entity-filename entity
 234
 235 Return file name of @var{entity}.
 236 @end defun
 237
 238
 239 @defun mime-entity-encoding entity  &optional  default-encoding
 240
 241 Return content-transfer-encoding of @var{entity}.
 242 (cf. @ref{Content-Transfer-Encoding}) @refill
 243
 244 If the @var{entity} does not have Content-Transfer-Encoding field, this
 245 function returns @var{default-encoding}.  If it is nil, @code{"7bit"} is
 246 used as default value.
 247 @end defun
 248
 249
 250 @defun mime-entity-cooked-p entity
 251
 252 Return non-nil if contents of @var{entity} has been already
 253 code-converted.
 254 @end defun
 255
 256
 257
 258 @node Entity-header, Entity-content, Entity Attributes, Entity
 259 @section Information of entity header
 260
 261 @defun mime-fetch-field field-name  &optional  entity
 262
 263 Return field-body of @var{field-name} field in header of
 264 @var{entity}.@refill
 265
 266 The results is network representation.@refill
 267
 268 If @var{entity} is omitted, @code{mime-message-structure} is used as
 269 default value.@refill
 270
 271 If @var{field-name} field is not found, this function returns
 272 @code{nil}.
 273 @end defun
 274
 275
 276 @defun mime-read-field field-name  &optional  entity
 277
 278 Parse @var{field-name} field in header of @var{entity}, and return the
 279 result.@refill
 280
 281 Format of result is depended on kind of field.  For non-structured
 282 field, this function returns string.  For structured field, it returns
 283 list corresponding with structure of the field.@refill
 284
 285 Strings in the result will be converted to internal representation of
 286 Emacs.@refill
 287
 288 If @var{entity} is omitted, @code{mime-message-structure} is used as
 289 default value.@refill
 290
 291 If @var{field-name} field is not found, this function returns
 292 @code{nil}.
 293 @end defun
 294
 295
 296 @defun mime-insert-decoded-header entity  &optional  invisible-fields visible-fields
 297
 298 Insert before point a decoded contents of header of @var{entity}.@refill
 299
 300 @var{invisible-fields} is list of regexps to match field-name to hide.
 301 @var{visible-fields} is list of regexps to match field-name to
 302 hide.@refill
 303
 304 If a field-name is matched with some elements of @var{invisible-fields}
 305 and matched with none of @var{visible-fields}, this function don't
 306 insert the field.
 307 @end defun
 308
 309
 310
 311 @node Entity-content, Entity buffer, Entity-header, Entity
 312 @section Contents of Entity
 313
 314 @defun mime-entity-content entity
 315
 316 Return content of @var{entity} as byte sequence.
 317 @end defun
 318
 319
 320 @defun mime-write-entity-content entity filename
 321
 322 Write content of @var{entity} into @var{filename}.
 323 @end defun
 324
 325
 326 @defun mime-write-entity entity filename
 327
 328 Write representation of @var{entity} into @var{filename}.
 329 @end defun
 330
 331
 332 @defun mime-write-entity-body entity filename
 333
 334 Write body of @var{entity} into @var{filename}.
 335 @end defun
 336
 337
 338
 339 @node Entity buffer, mm-backend, Entity-content, Entity
 340 @section Entity as buffer representation
 341
 342 @defun mime-entity-buffer entity
 343
 344 Return buffer, which contains @var{entity}.
 345 @end defun
 346
 347
 348 @defun mime-entity-point-min entity
 349
 350 Return the start point of @var{entity} in the buffer which contains
 351 @var{entity}.
 352 @end defun
 353
 354
 355 @defun mime-entity-point-max entity
 356
 357 Return the end point of @var{entity} in the buffer which contains
 358 @var{entity}.
 359 @end defun
 360
 361
 362 @defun mime-entity-header-start entity
 363
 364 Return the start point of header of @var{entity} in the buffer which
 365 contains @var{entity}.
 366 @end defun
 367
 368
 369 @defun mime-entity-header-end entity
 370
 371 Return the end point of header of @var{entity} in the buffer which
 372 contains @var{entity}.
 373 @end defun
 374
 375
 376 @defun mime-entity-body-start entity
 377
 378 Return the start point of body of @var{entity} in the buffer which
 379 contains @var{entity}.
 380 @end defun
 381
 382
 383 @defun mime-entity-body-end entity
 384
 385 Return the end point of body of @var{entity} in the buffer which
 386 contains @var{entity}.
 387 @end defun
 388
 389
 390
 391 @node mm-backend,  , Entity buffer, Entity
 392 @section Entity representations and implementations
 393 @cindex mm-backend
 394 @cindex entity processing method
 395 @cindex representation-type
 396
 397 Entity is an abstraction.  It is designed to use various data
 398 representations for their purposes.@refill
 399
 400 Each entity has @strong{representation-type}.  It must be specified when
 401 an entity is created. (cf. @ref{Entity Creation}) @refill
 402
 403 Functions about entity are implemented by request processing to the
 404 entity.  Each entity knows its representation-type.  Each entity calls
 405 processing function corresponding with the representation-type.  Such
 406 kind of function is called @strong{entity processing method}.  A module,
 407 consists of them corresponding with a representation-type, is called
 408 @strong{mm-backend}.@refill
 409
 410 Module name of each mm-backend consists of the prefix @code{mm}
 411 and its representation-type.  The module is required automatically
 412 when its entity is created at first.
 413
 414
 415 @menu
 416 * Request for entity::          Message-passing for entity
 417 * mm-backend module::           How to make mm-backend
 418 @end menu
 419
 420 @node Request for entity, mm-backend module, mm-backend, mm-backend
 421 @subsection Message-passing for entity
 422
 423 @defun mime-entity-send entity message  &rest  args
 424
 425 Send @var{message} to @var{entity} with @var{args}, and return the
 426 result.@refill
 427
 428 @var{args} is arguments of the @var{message}.
 429 @end defun
 430
 431
 432
 433 @node mm-backend module,  , Request for entity, mm-backend
 434 @subsection How to make mm-backend
 435
 436 (It is not written yet, sorry. (^_^;)@refill
 437
 438 (Please read mm*.el)
 439
 440
 441 @node Content-Type, Content-Disposition, Entity, Top
 442 @chapter Information of Content-Type field
 443 @cindex mime-content-type
 444 @cindex Content-Type field
 445
 446 @strong{Content-Type field} is a field to indicate kind of contents or
 447 data format, such as media-type (@ref{media-type}) and MIME charset.  It
 448 is defined in RFC 2045 (@ref{RFC 2045}).
 449
 450 @noindent
 451 @strong{[Memo]}
 452 @quotation
 453
 454 Historically, Content-Type field was proposed in RFC 1049.  In it,
 455 Content-Type did not distinguish type and subtype, and there are no
 456 mechanism to represent kind of character code like MIME charset.
 457 @end quotation
 458
 459
 460 FLIM provides parser for Content-Type field and structure
 461 @strong{mime-content-type} to store information of
 462 Content-Type field.
 463
 464
 465 @menu
 466 * Content-Type field::          Format of Content-Type field
 467 * mime-content-type::           mime-content-type structure
 468 * Content-Type parser::         Parser
 469 * Content-Type utility::        Utility functions
 470 @end menu
 471
 472 @node Content-Type field, mime-content-type, Content-Type, Content-Type
 473 @section Format of Content-Type field
 474 @cindex parameter
 475 @cindex subtype
 476 @cindex type
 477
 478 Content-Type \e$BMs$N7A<0$O0J2<$N$h$&$KDj5A$5$l$F$$$^$9!'\e(B
 479
 480 @quotation
 481 ``Content-Type'' ``:'' @strong{type} ``/''
 482 @strong{subtype} *( ``;'' @strong{parameter} )
 483 @end quotation
 484
 485 \e$BNc$($P!"\e(B
 486
 487 @quotation
 488 @example
 489 Content-Type: image/jpeg
 490 @end example
 491 @end quotation
 492
 493 @noindent
 494 \e$B$d\e(B
 495
 496 @quotation
 497 @example
 498 Content-Type: text/plain; charset=iso-2022-jp
 499 @end example
 500 @end quotation
 501
 502 @noindent
 503 \e$B$J$I$N$h$&$KMQ$$$i$l$^$9!#\e(B
 504
 505 \e$B$3$3$G!"\e(B`type' \e$B$H\e(B `subtype' \e$B$O\e(B entity \e$B$N7A<0$r<($9$b$N$G!"N><T$rAm>N$7\e(B
 506 \e$B$F!"\e(B`media-type' \e$B$H8F$V$3$H$K$7$^$9!#>e5-$NNc$K$*$1$k\e(B `image/jpeg' \e$B$d\e(B
 507 `text/plain' \e$B$O\e(B media-type \e$B$N#1$D$G$9!#\e(B
 508
 509 @noindent
 510 @strong{[Memo]}
 511 @quotation
 512
 513 Content-Type \e$BMs$N$J$$\e(B entity \e$B$O\e(B
 514
 515 @quotation
 516 @example
 517 Content-Type: text/plain; charset=us-ascii
 518 @end example
 519 @end quotation
 520
 521 @noindent
 522 \e$B$H$7$F2r<a$5$l$k!#\e(B(cf. @ref{us-ascii})
 523 @end quotation
 524
 525
 526
 527 @node mime-content-type, Content-Type parser, Content-Type field, Content-Type
 528 @section mime-content-type structure
 529
 530 @deffn{Structure} mime-content-type
 531
 532 Content-Type \e$BMs$N>pJs$r3JG<$9$k$?$a$N9=B$BN!#\e(B@refill
 533
 534 \e$B$3$N9=B$BN$r;2>H$9$k$K$O\e(B @code{mime-content-type-\e$BMWAGL>\e(B} \e$B$H$$$&L>A0$N;2\e(B
 535 \e$B>H4X?t$rMQ$$$k!#\e(B@refill
 536
 537 \e$B$3$N9=B$BN$NMWAG$O0J2<$NDL$j$G$"$k!'\e(B
 538
 539 @table @var
 540 @item primary-type
 541 media-type \e$B$N<g7?\e(B (symbol).
 542
 543 @item subtype
 544 media-type \e$B$NI{7?\e(B (symbol).
 545
 546 @item parameters
 547 Content-Type \e$BMs$N\e(B parameter (\e$BO"A[\e(B list).
 548
 549 @end table
 550 @end deffn
 551
 552
 553 @defun make-mime-content-type type subtype
 554            &optional  parameters
 555
 556 content-type \e$B$N@8@.;R!#\e(B
 557 @end defun
 558
 559
 560 @defun mime-content-type-parameter content-type parameter
 561
 562 @var{content-type} \e$B$N\e(B @var{parameter} \e$B$NCM$rJV$9!#\e(B
 563 @end defun
 564
 565
 566
 567 @node Content-Type parser, Content-Type utility, mime-content-type, Content-Type
 568 @section Parser
 569
 570 @defun mime-parse-Content-Type string
 571
 572 @var{string} \e$B$r\e(B content-type \e$B$H$7$F2r@O$7$?7k2L$rJV$9!#\e(B
 573 @end defun
 574
 575
 576 @defun mime-read-Content-Type
 577
 578 \e$B8=:_$N\e(B buffer \e$B$N\e(B Content-Type \e$BMs$rFI$_<h$j!"2r@O$7$?7k2L$rJV$9!#\e(B@refill
 579
 580 Content-Type \e$BMs$,B8:_$7$J$$>l9g$O\e(B nil \e$B$rJV$9!#\e(B
 581 @end defun
 582
 583
 584
 585 @node Content-Type utility,  , Content-Type parser, Content-Type
 586 @section Utility functions
 587
 588 @defun mime-type/subtype-string type  &optional  subtype
 589
 590 Return type/subtype string from @var{type} and @var{subtype}.
 591 @end defun
 592
 593
 594
 595 @node Content-Disposition, Content-Transfer-Encoding, Content-Type, Top
 596 @chapter Information of Content-Disposition field
 597 @cindex mime-content-disposition
 598 @cindex RFC 2183
 599 @cindex Standards Track
 600 @cindex Content-Disposition \e$BMs\e(B
 601
 602 @strong{Content-Disposition \e$BMs\e(B} \e$B$O\e(B entity \e$B$NI=<($d\e(B file \e$BL>$J$I\e(B
 603 \e$B$NB0@-$K$J$I$K4X$9$k>pJs$r5-=R$9$k$?$a$N$b$N$G$9!#\e(B
 604
 605
 606 @noindent
 607 [RFC 2183]
 608 @quotation
 609 S. Dorner, K. Moore and R. Troost, ``Communicating Presentation
 610 Information in Internet Messages: The Content-Disposition Header'',
 611 August 1997, Standards Track.
 612 @end quotation
 613
 614 FLIM \e$B$O\e(B Content-Disposition \e$BMs$r9=J82r@O$9$k4X?t$H\e(B Content-Disposition
 615 \e$BMs$N2r@O7k2L$r3JG<$9$k9=B$BN\e(B
 616 @strong{mime-content-disposition} \e$B$rDs6!$7$^$9!#\e(B
 617
 618
 619 @menu
 620 * mime-content-disposition::    mime-content-disposition structure
 621 * Content-Disposition parser::  Parser for Content-Disposition field
 622 @end menu
 623
 624 @node mime-content-disposition, Content-Disposition parser, Content-Disposition, Content-Disposition
 625 @section mime-content-disposition structure
 626
 627 @deffn{Structure} mime-content-disposition
 628
 629 Content-Disposition \e$BMs$N2r@O7k2L$r<}$a$k$?$a$N9=B$BN!#\e(B@refill
 630
 631 \e$B$3$N9=B$BN$r;2>H$9$k$K$O\e(B @code{mime-content-disposition-\e$BMWAGL>\e(B} \e$B$H$$$&L>\e(B
 632 \e$BA0$N;2>H4X?t$rMQ$$$k!#\e(B@refill
 633
 634 \e$B$3$N9=B$BN$NMWAG$O0J2<$NDL$j$G$"$k!'\e(B
 635
 636 @table @var
 637 @item disposition-type
 638 disposition-type (symbol).
 639
 640 @item parameters
 641 Content-Disposition \e$BMs$N\e(B parameter (\e$BO"A[\e(B list).
 642
 643 @end table
 644 @end deffn
 645
 646
 647 @defun mime-content-disposition-parameter content-disposition parameter
 648
 649 @var{content-disposition} \e$B$N\e(B @var{parameter} \e$B$NCM$rJV$9!#\e(B
 650 @end defun
 651
 652
 653 @defun mime-content-disposition-filename content-disposition
 654
 655 @var{content-disposition} \e$B$N\e(B filename \e$B$NCM$rJV$9!#\e(B
 656 @end defun
 657
 658
 659
 660 @node Content-Disposition parser,  , mime-content-disposition, Content-Disposition
 661 @section Parser for Content-Disposition field
 662
 663 @defun mime-parse-Content-Disposition string
 664
 665 @var{string} \e$B$r\e(B content-disposition \e$B$H$7$F2r@O$7$?7k2L$rJV$9!#\e(B
 666 @end defun
 667
 668
 669 @defun mime-read-Content-Disposition
 670
 671 \e$B8=:_$N\e(B buffer \e$B$N\e(B Content-Disposition \e$BMs$rFI$_<h$j!"2r@O$7$?7k2L$rJV$9!#\e(B
 672 @refill
 673
 674 Content-Disposition \e$BMs$,B8:_$7$J$$>l9g$O\e(B nil \e$B$rJV$9!#\e(B
 675 @end defun
 676
 677
 678
 679 @node Content-Transfer-Encoding, encoded-word, Content-Disposition, Top
 680 @chapter Encoding Method
 681 @cindex Content-Transfer-Encoding \e$BMs\e(B
 682
 683 @strong{Content-Transfer-Encoding \e$BMs\e(B} \e$B$O\e(B entity \e$B$NId9f2=K!$r5-=R$9$k$?$a\e(B
 684 \e$B$N$b$N$G$9!#\e(B@refill
 685
 686 FLIM \e$B$G$O\e(B Content-Transfer-Encoding \e$BMs$r9=J82r@O$9$k4X?t$rDs6!$7$^$9!#$3\e(B
 687 \e$B$l$i$N4X?t$O\e(B Content-Transfer-Encoding \e$BMs$N>pJs$OJ8;zNs$GI=8=$7$^$9!#\e(B
 688 @refill
 689
 690 \e$B$^$?!"\e(BContent-Transfer-Encoding \e$B$K4p$E$$$FId9f2=!&I|9f2=$r9T$&4X?t$bDs\e(B
 691 \e$B6!$5$l$^$9!#\e(B
 692
 693
 694 @menu
 695 * Content-Transfer-Encoding parser::  Parser
 696 * Region encoder/decoder::      Region encoding/decoding
 697 * String encoder/decoder::      String encoding/decoding
 698 * File encoder/decoder::        File encoding/decoding
 699 @end menu
 700
 701 @node Content-Transfer-Encoding parser, Region encoder/decoder, Content-Transfer-Encoding, Content-Transfer-Encoding
 702 @section Parser
 703
 704 @defun mime-parse-Content-Transfer-Encoding string
 705
 706 @var{string} \e$B$r\e(B content-transfer-encoding \e$B$H$7$F2r@O$7$?7k2L$rJV$9!#\e(B
 707 @end defun
 708
 709
 710 @defun mime-read-Content-Transfer-Encoding &optional default-encoding
 711
 712 \e$B8=:_$N\e(B buffer \e$B$N\e(B Content-Transfer-Encoding \e$BMs$rFI$_<h$j!"2r@O$7$?7k2L$r\e(B
 713 \e$BJV$9!#\e(B@refill
 714
 715 Content-Transfer-Encoding \e$BMs$,B8:_$7$J$$>l9g$O\e(B@var{default-encoding} \e$B$r\e(B
 716 \e$BJV$9!#\e(B
 717 @end defun
 718
 719
 720
 721 @node Region encoder/decoder, String encoder/decoder, Content-Transfer-Encoding parser, Content-Transfer-Encoding
 722 @section Region encoding/decoding
 723
 724 @defun mime-encode-region start end encoding
 725
 726 Encode region @var{start} to @var{end} of current buffer using
 727 @var{encoding}.
 728 @end defun
 729
 730
 731 @defun mime-decode-region start end encoding
 732
 733 Decode region @var{start} to @var{end} of current buffer using
 734 @var{encoding}.
 735 @end defun
 736
 737
 738 @defvar mime-encoding-method-alist
 739
 740 Alist of encoding vs. corresponding method to encode region.@refill
 741
 742 Each element looks like @code{(STRING . FUNCTION)} or @code{(STRING
 743 . nil)}.  @var{string} is content-transfer-encoding.  @code{function} is
 744 region encoder and @code{nil} means not to encode.
 745 @end defvar
 746
 747
 748 @defvar mime-decoding-method-alist
 749
 750 Alist of encoding vs. corresponding method to decode region.@refill
 751
 752 Each element looks like @code{(STRING . FUNCTION)} or @code{(STRING
 753 . nil)}.  @var{string} is content-transfer-encoding.  @code{function} is
 754 region decoder and @code{nil} means not to decode.
 755 @end defvar
 756
 757
 758
 759 @node String encoder/decoder, File encoder/decoder, Region encoder/decoder, Content-Transfer-Encoding
 760 @section String encoding/decoding
 761
 762 @defun mime-decode-string string encoding
 763
 764 @var{string} \e$B$r\e(B @var{encoding} \e$B$H$7$FI|9f$7$?7k2L$rJV$7$^$9!#\e(B
 765 @end defun
 766
 767
 768 @defvar mime-string-decoding-method-alist
 769
 770 Alist of encoding vs. corresponding method to decode string.@refill
 771
 772 Each element looks like @code{(STRING . FUNCTION)}.  STRING is
 773 content-transfer-encoding.  FUNCTION is string decoder.
 774 @end defvar
 775
 776
 777
 778 @node File encoder/decoder,  , String encoder/decoder, Content-Transfer-Encoding
 779 @section File encoding/decoding
 780
 781 @defun mime-insert-encoded-file filename encoding
 782
 783 Insert file @var{FILENAME} encoded by @var{ENCODING} format.
 784 @end defun
 785
 786
 787 @defun mime-write-decoded-region start end filename encoding
 788
 789 Decode and write current region encoded by @var{encoding} into
 790 @var{filename}.@refill
 791
 792 @var{start} and @var{end} are buffer positions.
 793 @end defun
 794
 795
 796 @defvar mime-file-encoding-method-alist
 797
 798 Alist of encoding vs. corresponding method to insert encoded
 799 file.@refill
 800
 801 Each element looks like @code{(STRING . FUNCTION)}.  STRING is
 802 content-transfer-encoding.  FUNCTION is function to insert encoded file.
 803 @end defvar
 804
 805
 806 @defvar mime-file-decoding-method-alist
 807
 808 Alist of encoding vs. corresponding method to write decoded region to
 809 file.@refill
 810
 811 Each element looks like @code{(STRING . FUNCTION)}.  STRING is
 812 content-transfer-encoding.  FUNCTION is function to write decoded region
 813 to file.
 814 @end defvar
 815
 816
 817
 818 @node encoded-word, custom, Content-Transfer-Encoding, Top
 819 @chapter Network representation of header
 820 @cindex RFC 2047
 821 @cindex Standards Track
 822 @cindex RFC 2047
 823
 824 encoded-word \e$B$O\e(B header \e$B$GHs\e(B ASCII (@ref{ASCII}) \e$BJ8;z$rI=8=$9$k$?$a$N7A<0\e(B
 825 \e$B$G!"\e(B@strong{RFC 2047} \e$B$GDj5A$5$l$F$$$^$9!#\e(B@refill
 826
 827
 828 @noindent
 829 [RFC 2047]
 830 @quotation
 831 K. Moore, ``MIME (Multipurpose Internet Mail Extensions) Part Three:
 832 Message Header Extensions for Non-ASCII Text'', November 1996, Standards
 833 Track (obsolete RFC 1521,1522,1590).
 834 @end quotation
 835
 836 \e$B$^$?!"9T57$N0-$$$3$H$@$H8@$($^$9$,!"\e(Bencoded-word \e$B$rMQ$$$:$KHs\e(B ASCII
 837 (@ref{ASCII}) \e$BJ8;z$r\e(B header \e$B$KF~$l$?5-;v$bB8:_$7$^$9!#\e(B@refill
 838
 839 FLIM \e$B$O$3$l$i$rId9f2=!&I|9f2=$9$k5!G=$rDs6!$7$^$9!#\e(B
 840
 841
 842 @menu
 843 * Header encoder/decoder::      Header encoding/decoding
 844 @end menu
 845
 846 @node Header encoder/decoder,  , encoded-word, encoded-word
 847 @section Header encoding/decoding
 848
 849 @defun eword-encode-header &optional  code-conversion separator
 850
 851 Decode MIME encoded-words in header fields.@refill
 852
 853 If @var{code-conversion} is @code{nil}, it decodes only encoded-words.
 854 If it is mime-charset, it decodes non-ASCII bit patterns as the
 855 mime-charset.  Otherwise it decodes non-ASCII bit patterns as the
 856 default-mime-charset.@refill
 857
 858 If @var{separator} is not nil, it is used as header separator.
 859 @end defun
 860
 861
 862 @defun eword-encode-header &optional  code-conversion
 863
 864 Encode header fields to network representation, such as MIME
 865 encoded-word.@refill
 866
 867 It refer variable @code{eword-field-encoding-method-alist}.
 868 @end defun
 869
 870
 871
 872 @node custom, Appendix, encoded-word, Top
 873 @chapter Various Customization
 874
 875 @deffn{group} mime
 876
 877 MIME \e$B4XO"5!G=$K4X$9$k\e(B group.@refill
 878
 879 @code{mail} \e$B$H\e(B @code{news} \e$B$KB0$9$k!#\e(B
 880 @end deffn
 881
 882
 883 @defvar default-mime-charset
 884
 885 \e$BE,@Z$J\e(B MIME charset (@ref{MIME charset}) \e$B$,8+$D$+$i$J$+$C$?>l9g$KMQ$$$i\e(B
 886 \e$B$l$k\e(BMIME charset.@refill
 887
 888 \e$BK\Mh$O\e(B APEL \e$B$NJQ?t$G$"$k!#\e(B
 889 @end defvar
 890
 891
 892 @defvar mime-temp-directory
 893
 894 MIME \e$B5!G=$K4X$9$k<BAu$,0l;~E*$K;HMQ$9$k\e(B file \e$B$r:n@.$9$k\e(B
 895 directory.@refill
 896
 897 \e$B4D6-JQ?t\e(B @code{MIME_TMP_DIR}, @code{TM_TMP_DIR}, @code{TMPDIR},
 898 @code{TMP} \e$B$b$7$/$O\e(B @code{TEMP} \e$B$,@_Dj$5$l$F$$$?>l9g!"$=$l$r=i4|CM$H$7$F\e(B
 899 \e$BMQ$$$k!#2?$b@_Dj$5$l$F$$$J$$>l9g!"\e(B@code{"/tmp/"} \e$B$rMQ$$$k!#\e(B
 900 @end defvar
 901
 902
 903
 904 @node Appendix, Concept Index, custom, Top
 905 @chapter Appendix
 906
 907
 908 @menu
 909 * Glossary::
 910 * Bug report::                  How to report bugs
 911 * CVS::                         CVS based development
 912 * History::                     History of FLIM
 913 @end menu
 914
 915 @node Glossary, Bug report, Appendix, Appendix
 916 @section Glossary
 917
 918
 919 @menu
 920 * 7bit::
 921 * 8bit::
 922 * ASCII::
 923 * Base64::
 924 * binary::
 925 * coded character set::         Coded character set, Character code
 926 * media-type::
 927 * message::
 928 * MIME::
 929 * MIME charset::
 930 * MTA::
 931 * MUA::
 932 * Quoted-Printable::
 933 * RFC 822::
 934 * RFC 1036::
 935 * RFC 2045::
 936 * RFC 2046::
 937 * RFC 2048::
 938 * RFC 2049::
 939 * plain text::
 940 * us-ascii::
 941 @end menu
 942
 943 @node 7bit, 8bit, Glossary, Glossary
 944 @subsection 7bit
 945 @cindex 7bit (textual) string
 946 @cindex 7bit data
 947 @cindex 7bit
 948
 949 @strong{7bit} means any integer between 0 .. 127.@refill
 950
 951 Any data represented by 7bit integers is called @strong{7bit data}.@refill
 952
 953 Textual string consisted of Control characters between 0 .. 31 and 127,
 954 and space represented by 32, and graphic characters between 33 .. 236
 955 are called @strong{7bit (textual) string}.@refill
 956
 957 Conventional Internet MTA (@ref{MTA}) can translate 7bit data, so it is
 958 no need to translate by Quoted-Printable (@ref{Quoted-Printable}) or
 959 Base64 (@ref{Base64}) for 7bit data.@refill
 960
 961 However if there are too long lines, it can not translate by 7bit MTA
 962 even if it is 7bit data.  RFC 821 (@ref{RFC 821}) and RFC 2045 (@ref{RFC 2045}) require lines in 7bit data must be less than 998 bytes.  So if a
 963 ``7bit data'' has a line more than 999 bytes, it is regarded as binary
 964 (@ref{binary}).  For example, Postscript file should be encoded by
 965 Quoted-Printable.
 966
 967
 968 @node 8bit, ASCII, 7bit, Glossary
 969 @subsection 8bit
 970 @cindex 8bit (textual) string
 971 @cindex 8bit data
 972 @cindex 8bit
 973
 974 @strong{8bit} means any integer between 0 .. 255.@refill
 975
 976 Any data represented by 8bit integers is called @strong{8bit data}.@refill
 977
 978 Textual string consisted of Control characters between 0 .. 31, 127, and
 979 128 .. 159, and space represented by 32, and graphic characters between
 980 33 .. 236 and 160 .. 255 are called @strong{8bit (textual) string}.@refill
 981
 982 For example, iso-8859-1 (@ref{iso-8859-1}) or euc-kr (@ref{euc-kr}) are
 983 coded-character-set represented by 8bit textual string.@refill
 984
 985 Traditional Internet MTA (@ref{MTA}) can translate only 7bit
 986 (@ref{7bit}) data, so if a 8bit data will be translated such MTA, it
 987 must be encoded by Quoted-Printable (@ref{Quoted-Printable}) or Base64
 988 (@ref{Base64}).@refill
 989
 990 However 8bit MTA are increasing today.@refill
 991
 992 However if there are too long lines, it can not translate by 8bit MTA
 993 even if it is 8bit data.  RFC 2045 (@ref{RFC 2045}) require lines in
 994 8bit data must be less than 998 bytes.  So if a ``8bit data'' has a line
 995 more than 999 bytes, it is regarded as binary (@ref{binary}), so it must
 996 be encoded by Base64 or Quoted-Printable.
 997
 998
 999 @node ASCII, Base64, 8bit, Glossary
1000 @subsection ASCII
1001 @cindex ANSI X3.4:1986
1002 @cindex ASCII
1003 @cindex ASCII
1004
1005 @strong{ASCII} is a 94-character set contains primary latin characters
1006 (A-Z, a-z), numbers and some characters.  It is a standard of the United
1007 States of America.  It is a variant of ISO 646 (@ref{ISO 646}).
1008
1009
1010 @noindent
1011 [ASCII]
1012 @quotation
1013 ``Coded Character Set -- 7-Bit American Standard Code for Information
1014 Interchange'', ANSI X3.4:1986.
1015 @end quotation
1016
1017
1018
1019 @node Base64, binary, ASCII, Glossary
1020 @subsection Base64
1021 @cindex pad
1022 @cindex Base64
1023
1024 @strong{Base64} is a transfer encoding method of MIME (@ref{MIME})
1025 defined in RFC 2045 (@ref{RFC 2045}).@refill
1026
1027 The encoding process represents 24-bit groups of input bits as output
1028 strings of 4 encoded characters.  Encoded characters represent integer 0
1029 .. 63 or @strong{pad}.  Base64 data must be 4 * n bytes, so pad is used
1030 to adjust size.@refill
1031
1032 These 65 characters are subset of all versions of ISO 646, including
1033 US-ASCII, and all versions of EBCDIC.  So it is safe even if it is
1034 translated by non-Internet gateways.
1035
1036
1037 @node binary, coded character set, Base64, Glossary
1038 @subsection binary
1039 @cindex binary
1040
1041 Any byte stream is called @strong{binary}.@refill
1042
1043 It does not require structureof lines.  It differs from from 8bit
1044 (@ref{8bit}).@refill
1045
1046 In addition, if line structured data contain too long line (more than
1047 998 bytes), it is regarded as binary.
1048
1049
1050 @node coded character set, media-type, binary, Glossary
1051 @subsection Coded character set, Character code
1052
1053 A set of unambiguous rules that establishes a character set and the
1054 one-to-one relationship between the characters of the set and their
1055 bit combinations.
1056
1057
1058 @node media-type, message, coded character set, Glossary
1059 @subsection media-type
1060 @cindex x-token
1061 @cindex message
1062 @cindex multipart
1063 @cindex application
1064 @cindex video
1065 @cindex audio
1066 @cindex image
1067 @cindex text
1068 @cindex subtype
1069 @cindex type
1070 @cindex media-type
1071
1072 @strong{media-type} specifies the nature of the data in the body of MIME
1073 (@ref{MIME}) entity (@ref{entity}).  It consists of @strong{type} and
1074 @strong{subtype}.  It is defined in RFC 2046 (@ref{RFC 2046}).@refill
1075
1076 Currently there are following standard primary-types:
1077
1078 @itemize @bullet
1079 @item
1080 @strong{text}
1081 @item
1082 @strong{image}
1083 @item
1084 @strong{audio}
1085 @item
1086 @strong{video}
1087 @item
1088 @strong{application}
1089 @item
1090 @strong{multipart} (@ref{multipart})
1091 @item
1092 @strong{message}
1093 @end itemize
1094
1095
1096 And there are various subtypes, for example, application/octet-stream,
1097 audio/basic, image/jpeg, multipart/mixed (@ref{multipart/mixed}),
1098 text/plain (@ref{text/plain}), video/mpeg...  @refill
1099
1100 You can refer registered media types at MEDIA TYPES
1101 (ftp://ftp.isi.edu/in-notes/iana/assignments/media-types).@refill
1102
1103 In addition, you can use private type or subtype using @strong{x-token},
1104 which as the prefix `x-'.  However you can not use them in
1105 public.@refill
1106
1107 (cf. @ref{Content-Type field})
1108
1109
1110
1111 @node message, MIME, media-type, Glossary
1112 @subsection message
1113
1114 In this document, it means mail defined in RFC 822 (@ref{RFC 822}) and
1115 news message defined in RFC 1036 (@ref{RFC 1036}).
1116
1117
1118 @node MIME, MIME charset, message, Glossary
1119 @subsection MIME
1120 @cindex Multipurpose Internet Mail Extensions
1121
1122 MIME stands for @strong{Multipurpose Internet Mail Extensions}, it is an
1123 extension for RFC 822 (@ref{RFC 822}).@refill
1124
1125 According to RFC 2045:@refill
1126
1127 STD 11, RFC 822, defines a message representation protocol specifying
1128 considerable detail about US-ASCII message headers, and leaves the
1129 message content, or message body, as flat US-ASCII text.  This set of
1130 documents, collectively called the Multipurpose Internet Mail
1131 Extensions, or MIME, redefines the format of messages to allow for
1132
1133 @enumerate
1134 @item
1135 textual message bodies in character sets other than US-ASCII,
1136 @item
1137 an extensible set of different formats for non-textual message
1138 bodies,
1139 @item
1140 multi-part message bodies, and
1141 @item
1142 textual header information in character sets other than US-ASCII.
1143 @end enumerate
1144
1145
1146 It is defined in RFC 2045 (@ref{RFC 2045}), RFC 2046 (@ref{RFC 2046}),
1147 RFC 2047 (@ref{encoded-word}), RFC 2048 (@ref{RFC 2048}) and RFC 2049
1148 (@ref{RFC 2049}).
1149
1150
1151 @node MIME charset, MTA, MIME, Glossary
1152 @subsection MIME charset
1153
1154 Coded character set (@ref{coded character set}) used in Content-Type
1155 field (@ref{Content-Type field}) or charset parameter of encoded-word
1156 (@ref{encoded-word}).@refill
1157
1158 It is defined in RFC 2045 (@ref{RFC 2045}).@refill
1159
1160 iso-2022-jp (@ref{iso-2022-jp}) or euc-kr (@ref{euc-kr}) are kinds of
1161 it.  (In this document, MIME charsets are written by small letters to
1162 distinguish graphic character set (@ref{graphic character set}).  For
1163 example, ISO 8859-1 is a graphic character set, and iso-8859-1 is a MIME
1164 charset)
1165
1166
1167 @node MTA, MUA, MIME charset, Glossary
1168 @subsection MTA
1169 @cindex Message Transfer Agent
1170
1171 @strong{Message Transfer Agent}.  It means mail transfer programs
1172 (ex. sendmail) and news servers.@refill
1173
1174 (cf. @ref{MUA})
1175
1176
1177
1178 @node MUA, Quoted-Printable, MTA, Glossary
1179 @subsection MUA
1180 @cindex Message User Agent
1181
1182 @strong{Message User Agent}.  It means mail readers and news
1183 readers.@refill
1184
1185 (cf. @ref{MTA})
1186
1187
1188
1189 @node Quoted-Printable, RFC 822, MUA, Glossary
1190 @subsection Quoted-Printable
1191 @cindex Quoted-Printable
1192
1193 @strong{Quoted-Printable} is a transfer encoding method of MIME
1194 (@ref{MIME}) defined in RFC 2045 (@ref{RFC 2045}).@refill
1195
1196 If the data being encoded are mostly US-ASCII text, the encoded form of
1197 the data remains largely recognizable by humans.@refill
1198
1199 (cf. @ref{Base64})
1200
1201
1202
1203 @node RFC 822, RFC 1036, Quoted-Printable, Glossary
1204 @subsection RFC 822
1205 @cindex RFC 822
1206 @cindex STD 11
1207 @cindex Internet mail
1208 @cindex Internet message
1209 @cindex message header
1210
1211 A RFC defines format of Internet mail message, mainly @strong{message header}.
1212
1213 @noindent
1214 @strong{[Memo]}
1215 @quotation
1216
1217 news message is based on RFC 822, so @strong{Internet message} may be
1218 more suitable than @strong{Internet mail} .
1219 @end quotation
1220
1221
1222
1223 @noindent
1224 [RFC 822]
1225 @quotation
1226 D. Crocker, ``Standard for the Format of ARPA Internet Text Messages'',
1227 August 1982, STD 11.
1228 @end quotation
1229
1230
1231
1232 @node RFC 1036, RFC 2045, RFC 822, Glossary
1233 @subsection RFC 1036
1234 @cindex RFC 1036
1235 @cindex USENET
1236
1237 A RFC defines format of USENET message.  It is a subset of RFC 822
1238 (@ref{RFC 822}).  It is not Internet standard, but a lot of netnews
1239 excepting Usenet uses it.
1240
1241
1242 @noindent
1243 [USENET: RFC 1036]
1244 @quotation
1245 M. Horton and R. Adams, ``Standard for Interchange of USENET Messages'',
1246 December 1987, (obsolete RFC 850).
1247 @end quotation
1248
1249
1250
1251 @node RFC 2045, RFC 2046, RFC 1036, Glossary
1252 @subsection RFC 2045
1253 @cindex RFC 2045
1254 @cindex Standards Track
1255
1256
1257 @noindent
1258 [RFC 2045]
1259 @quotation
1260 N. Freed and N. Borenstein, ``Multipurpose Internet Mail Extensions
1261 (MIME) Part One: Format of Internet Message Bodies'', November 1996,
1262 Standards Track (obsolete RFC 1521, 1522, 1590).
1263 @end quotation
1264
1265
1266
1267 @node RFC 2046, RFC 2048, RFC 2045, Glossary
1268 @subsection RFC 2046
1269 @cindex RFC 2046
1270 @cindex Standards Track
1271
1272
1273 @noindent
1274 [RFC 2046]
1275 @quotation
1276 N. Freed and N. Borenstein, ``Multipurpose Internet Mail Extensions
1277 (MIME) Part Two: Media Types'', November 1996, Standards Track (obsolete
1278 RFC 1521, 1522, 1590).
1279 @end quotation
1280
1281
1282
1283 @node RFC 2048, RFC 2049, RFC 2046, Glossary
1284 @subsection RFC 2048
1285 @cindex RFC 2048
1286 @cindex Standards Track
1287
1288
1289 @noindent
1290 [RFC 2048]
1291 @quotation
1292 N. Freed, J. Klensin and J. Postel, ``Multipurpose Internet Mail
1293 Extensions (MIME) Part Four: Registration Procedures'', November 1996,
1294 Standards Track (obsolete RFC 1521, 1522, 1590).
1295 @end quotation
1296
1297
1298
1299 @node RFC 2049, plain text, RFC 2048, Glossary
1300 @subsection RFC 2049
1301 @cindex RFC 2049
1302 @cindex Standards Track
1303
1304
1305 @noindent
1306 [RFC 2049]
1307 @quotation
1308 N. Freed and N. Borenstein, ``Multipurpose Internet Mail Extensions
1309 (MIME) Part Five: Conformance Criteria and Examples'', November 1996,
1310 Standards Track (obsolete RFC 1521, 1522, 1590).
1311 @end quotation
1312
1313
1314
1315 @node plain text, us-ascii, RFC 2049, Glossary
1316 @subsection plain text
1317
1318 A textual data represented by only coded character set (@ref{coded character set}).  It does not have information about font or
1319 typesetting.  (cf. @ref{text/plain})
1320
1321
1322
1323 @node us-ascii,  , plain text, Glossary
1324 @subsection us-ascii
1325 @cindex ASCII
1326 @cindex us-ascii
1327
1328 A MIME charset (@ref{MIME charset}) for primary Latin script mainly
1329 written by English or other languages.@refill
1330
1331 It is a 7bit coded character set (@ref{coded character set}) based on
1332 ISO 2022 (@ref{ISO 2022}), it contains only ASCII (@ref{ASCII}) and code
1333 extension (@ref{code extension}) is not allowed.@refill
1334
1335 It is standard coded character set of Internet mail.  If MIME charset is
1336 not specified, @strong{us-ascii} is used as default.@refill
1337
1338 In addition, @strong{ASCII} of RFC 822 (@ref{RFC 822}) should be
1339 interpreted as us-ascii.
1340
1341
1342 @node Bug report, CVS, Glossary, Appendix
1343 @section How to report bugs
1344 @cindex good bug report
1345
1346 If you write bug-reports and/or suggestions for improvement, please
1347 send them to the tm Mailing List:
1348
1349 @itemize @bullet
1350 @item
1351  Japanese <bug-tm-ja@@chamonix.jaist.ac.jp>
1352 @item
1353  English <bug-tm-en@@chamonix.jaist.ac.jp>
1354 @end itemize
1355
1356
1357 Notice that, we do not welcome bug reports about too old version.  Bugs
1358 in old version might be fixed.  So please try latest version at
1359 first.@refill
1360
1361 You should write @strong{good bug report}.  If you write only ``FLIM
1362 does not work'', we can not find such situations.  At least, you should
1363 write name, type, variants and version of OS, emacs, APEL, FLIM, SEMI
1364 and MUA, and setting.  In addition, if error occurs, to send backtrace
1365 is very important. (cf. @ref{(emacs)Bugs}) @refill
1366
1367 Bug may not appear only your environment, but also in a lot of
1368 environment (otherwise it might not bug).  Therefor if you send mail
1369 to author directly, we must write a lot of mails.  So please send mail
1370 to address for tm bugs instead of author.
1371
1372 Via the tm ML, you can report FLIM bugs, obtain the latest release of
1373 FLIM, and discuss future enhancements to FLIM.  To join the tm ML,
1374 send empty e-mail to:
1375
1376 @itemize @bullet
1377 @item
1378  Japanese <tm-ja-help@@chamonix.jaist.ac.jp>
1379 @item
1380  English  <tm-en-help@@chamonix.jaist.ac.jp>
1381 @end itemize
1382
1383
1384
1385 @node CVS, History, Bug report, Appendix
1386 @section CVS based development
1387
1388 FLIM \e$B$N\e(B file \e$B$O\e(B CVS \e$B$r;H$C$F4IM}$5$l$F$$$^$9!#$3$N$?$a!"0J2<$NJ}K!$G:G\e(B
1389 \e$B?7$N\e(B FLIM \e$B$rF~<j$9$k$3$H$,$G$-$^$9!'\e(B
1390
1391 @example
1392 (0) cvs login
1393
1394     % cvs -d :pserver:anonymous@@chamonix.jaist.ac.jp:/hare/cvs/root \
1395         login
1396
1397     CVS password: [CR] # NULL string
1398
1399 (1) checkout
1400
1401     % cvs -d :pserver:anonymous@@chamonix.jaist.ac.jp:/hare/cvs/root \
1402         checkout [-r TAG] flim
1403 @end example
1404
1405
1406 CVS \e$B$rMQ$$$?3+H/$K;22C$7$?$$J}$O\e(B
1407
1408 @itemize @bullet
1409 @item
1410  <cvs@@chamonix.jaist.ac.jp>
1411 @end itemize
1412
1413 @noindent
1414 \e$B$^$G!"\e(Baccount \e$BL>$H\e(B UNIX \e$B$N\e(B passwd \e$B$HF1$87A<0$N\e(B crypt \e$B2=$5$l$?\e(B password
1415 \e$B$r1h$($F8fO"Mm$/$@$5$$!#\e(B
1416
1417
1418 @node History,  , CVS, Appendix
1419 @section History of FLIM
1420
1421 FLIM \e$B$N\e(B code \e$B$N:G8E$NItJ,$O\e(B \e$B1]JB\e(B \e$B;LCR\e(B \e$B;a$,=q$$$?\e(B @file{mime.el}\e$B$K5/8;$7\e(B
1422 \e$B$^$9!#$3$N>.$5$J\e(B program \e$B$O\e(B Nemacs \e$B$GF0:n$9$k\e(B iso-2022-jp \e$B$N\e(B B-encoding
1423 \e$B@lMQ$N\e(B encoded-word \e$B$NI|9f2=%W%m%0%i%`$G$7$?!#\e(B@refill
1424
1425 \e$B$=$N8e!"<i2,\e(B \e$BCNI'\e(B \e$B$O\e(B @file{mime.el} \e$B$r85$K\e(B@file{tiny-mime.el} \e$B$H$$$&%W%m\e(B
1426 \e$B%0%i%`$r=q$-$^$9!#$3$l$O!"\e(BNemacs \e$B$H\e(B Mule \e$B$GF0:n$9$k\e(B encoded-word \e$B$NId9f\e(B
1427 \e$B2=!&I|9f2=%W%m%0%i%`$G$7$?!#\e(B@file{tiny-mime.el} \e$B$O\e(B B-encoding \e$B$@$1$G$J$/\e(B
1428 Q-encoding \e$B$b\e(Bsupport \e$B$7!"$^$?!"\e(BMULE \e$B$G07$&$3$H$,$G$-$k$5$^$6$^$J\e(B MIME
1429 charset (@ref{MIME charset}) \e$B$rF1;~$K;H$&$3$H$,$G$-$^$7$?!#$3$N;~!"\e(B
1430 Nemacs \e$B$H\e(B Mule \e$B$NAPJ}$r\e(B support \e$B$9$k$?$a$KMQ$$$i$l$?%F%/%K%C%/$O8e$K\e(B emu
1431 package \e$B$K$^$H$a$i$l$^$9!#\e(B@refill
1432
1433 \e$B$3$N:"!"<i2,\e(B \e$BCNI'\e(B \e$B$O\e(B @file{tiny-mime.el} \e$B$r$5$^$6$^$J\e(B MUA \e$B$G;H$&$?$a$N@_\e(B
1434 \e$BDj=8$bG[I[$7$F$$$^$7$?$,!"$=$l$i$O8e$K\e(B@file{tiny-mime.el} \e$B$H$H$b$K#1$D$N\e(B
1435 package \e$B$K$^$H$a$i$l!"\e(Btm \e$B$H$$$&L>A0$GG[I[$5$l$^$9!#\e(B@refill
1436
1437 \e$B<i2,\e(B \e$BCNI'\e(B \e$B$O$d$,$F!"\e(BMIME message \e$B$r1\Mw$9$k$?$a$N%W%m%0%i%`$G$"$k\e(B
1438 @file{tm-body.el} \e$B$r=q$-$^$9!#$3$l$O!"$9$0$K\e(B@file{tm-view.el} \e$B$H$$$&L>A0\e(B
1439 \e$B$KJQ$o$j$^$7$?$,!"$d$,$F!"$3$l$,\e(B@file{tiny-mime.el} \e$B$KBe$o$C$F!"\e(Btm \e$B$NCf\e(B
1440 \e$B3K$H$J$j$^$9!#\e(B@refill
1441
1442 @file{tm-view.el} \e$B$OEvA3!"\e(BContent-Transfer-Encoding \e$B$r07$&I,MW$,$"$j$^$9!#\e(B
1443 \e$B$3$NL\E*$N$?$a$K!"\e(BMEL \e$B$,@0Hw$5$l$O$8$a$^$7$?!#\e(BBase64 \e$B$K4X$7$F$O\e(B
1444 @file{tiny-mime.el} \e$B$N\e(B code \e$B$,0\$5$l!"$^$?!"?7$?$K\e(BQuoted-Printable \e$B$N\e(B
1445 code \e$B$,DI2C$5$l$^$7$?!#$3$l$i$,\e(B@file{mel-b.el} \e$B$H\e(B @file{mel-q.el} \e$B$K$J$j\e(B
1446 \e$B$^$7$?!#\e(B@refill
1447
1448 \e$B$^$?!"8e$K!"<i2,\e(B \e$BCNI'\e(B \e$B$K$h$C$F\e(B uuencode \e$BMQ$N\e(B @file{mel-u.el} \e$B$,DI2C$5$l!"\e(B
1449 \e$B$=$N8e$K!">.NS\e(B \e$B=$J?\e(B \e$B;a$K$h$C$F\e(B x-gzip64 \e$BMQ$N\e(B@file{mel-g.el} \e$B$,DI2C$5$l$^\e(B
1450 \e$B$7$?!#\e(B@refill
1451
1452 tm \e$B$G$O8e$K!"<i2,\e(B \e$BCNI'\e(B \e$B$K$h$C$F\e(B @file{tiny-mime.el} \e$B$N:F<BAu$,9T$o$l!"$3\e(B
1453 \e$B$N2aDx$G!"\e(BSTD 11 \e$B$N\e(B parser \e$B$,=q$+$l$^$7$?!#$3$l$O!"8=:_$N\e(B
1454 @file{std11.el} \e$B$KEv$?$j$^$9!#$^$?!"$3$N2aDx$G\e(B @file{tiny-mime.el} \e$B$OI|\e(B
1455 \e$B9f2=$r9T$&\e(B @file{tm-ew-d.el} \e$B$HId9f2=$r9T$&\e(B @file{tm-ew-e.el} \e$B$KJ,$1$i$l\e(B
1456 \e$B$^$7$?!#$3$NN><T$,8=:_$N\e(B @file{eword-decode.el} \e$B$H\e(B
1457 @file{eword-encode.el} \e$B$N@hAD$KEv$?$j$^$9!#\e(B@refill
1458
1459 \e$B8e$K!"<i2,\e(B \e$BCNI'\e(B \e$B$i$K$h$C$F\e(B tm \e$B$NA4LL=q$-49$(:n6H$,9T$o$l!"$3$N2aDx$G!"\e(Btm
1460 \e$B$O\e(B APEL, MEL, SEMI, EMH, RMAIL-MIME, Gnus-MIME \e$B$J$I$KJ,$1$i$l$^$7$?!#$3\e(B
1461 \e$B$N$&$A$N\e(B MEL \e$B$,\e(B FLIM \e$B$ND>@\$N@hAD$KEv$?$j$^$9!#\e(B@refill
1462
1463 \e$B8e$K!"\e(BAPEL \e$B$+$i\e(B @file{std11.el} \e$B$,0\$5$l!"$^$?!"\e(B@file{mailcap.el},
1464 @file{eword-decode.el} \e$B$*$h$S\e(B @file{eword-encode.el} \e$B$,\e(B SEMI \e$B$+$i0\$5$l!"\e(B
1465 package \e$B$NL>A0$,\e(B FLIM\e$B$H$J$j$^$9!#\e(B@refill
1466
1467 \e$B$3$ND>A0$+$iEDCf\e(B \e$BE/\e(B \e$B;a$,$h$j\e(B RFC \e$B$KCi<B$J<BAu$r=q$-;O$a!"$3$l$O!"8=:_!"\e(B
1468 FLIM \e$B$N;^$G$"$k\e(B ``FLIM-FLAM'' \e$B$H$J$C$F$$$^$9!#\e(B
1469
1470
1471 @node Concept Index, Function Index, Appendix, Top
1472 @chapter Concept Index
1473
1474 @printindex cp
1475
1476 @node Function Index, Variable Index, Concept Index, Top
1477 @chapter Function Index
1478
1479 @printindex fn
1480
1481 @node Variable Index,  , Function Index, Top
1482 @chapter Variable Index
1483
1484 @printindex vr
1485 @bye