Network Working Group                                           M. Sirbu
Request for Comments:  1049                                          CMU
                                                             March 1988

          A CONTENT-TYPE HEADER FIELD FOR INTERNET MESSAGES

STATUS OF THIS MEMO

  This RFC suggests proposed additions to the Internet Mail Protocol,
  RFC-822, for the Internet community, and requests discussion and
  suggestions for improvements.  Distribution of this memo is
  unlimited.

ABSTRACT

  A standardized Content-type field allows mail reading systems to
  automatically identify the type of a structured message body and to
  process it for display accordingly.  The structured message body must
  still conform to the RFC-822 requirements concerning allowable
  characters.  A mail reading system need not take any specific action
  upon receiving a message with a valid Content-Type header field.  The
  ability to recognize this field and invoke the appropriate display
  process accordingly will, however, improve the readability of
  messages, and allow the exchange of messages containing mathematical
  symbols, or foreign language characters.

                            Table of Contents

  1. Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . 1
  2. Problems with Structured Messages . . . . . . . . . . . . . . . 3
  3. The Content-type Header Field . . . . . . . . . . . . . . . . . 5
       3.1. Type Values  . . . . . . . . . . . . . . . . . . . . . . 5
       3.2. Version Number . . . . . . . . . . . . . . . . . . . . . 6
       3.3. Resource Reference . . . . . . . . . . . . . . . . . . . 6
       3.4. Comment. . . . . . . . . . . . . . . . . . . . . . . . . 7
  4. Conclusion  . . . . . . . . . . . . . . . . . . . . . . . . . . 7

1. Introduction

  As defined in RFC-822, [2], an electronic mail message consists of a
  number of defined header fields, some containing structured
  information (e.g., date, addresses), and a message body consisting of
  an unstructured string of ASCII characters.

  The success of the Internet mail system has led to a desire to use
  the mail system for sending around information with a greater degree
  of structure, while remaining within the constraints imposed by the
  limited character set.  A prime example is the use of mail to send a



Sirbu                                                           [Page 1]

RFC 1049                   Mail Content Type                  March 1988


  document with embedded TROFF formatting commands.  A more
  sophisticated example would be a message body encoded in a Page
  Description Language (PDL) such as Postscript.  In both cases, simply
  mapping the ASCII characters to the screen or printer in the usual
  fashion will not render the document image intended by the sender; an
  additional processing step is required to produce an image of the
  message text on a display device or a piece of paper.

  In both of these examples, the message body contains only the legal
  character set, but the content has a structure which produces some
  desirable result after appropriate processing by the recipient.  If a
  message header field could be used to indicate the structuring
  technique used in the message body, then a sophisticated mail system
  could use such a field to automatically invoke the appropriate
  processing of the message body.  For example, a header field which
  indicated that the message body was encoded using Postscript could be
  used to direct a mail system running under Sun Microsystem's NEWS
  window manager to process the Postscript to produce the appropriate
  page image on the screen.

  Private header fields (beginning with "X-") are already being used by
  some systems to affect such a result (e.g., the Andrew Message System
  developed at Carnegie Mellon University).  However, the widespread
  use of such techniques will require general agreement on the name and
  allowed parameter values for a header field to be used for this
  purpose.

  We propose that a new header field, "Content-type:"  be recognized as
  the standard field for indicating the structure of the message body.
  The contents of the "Content-Type:"  field are parameters which
  specify what type of structure is used in the message body.

  Note that we are not proposing that the message body contain anything
  other than ASCII characters as specified in RFC-822.  Whatever
  structuring is contained in the message body must be represented
  using only the allowed ASCII characters.  Thus, this proposal should
  have no impact on existing mailers, only on mail reading systems.

  At the same time, this restriction eliminates the use of more general
  structuring techniques such as Abstract Syntax Notation, (CCITT
  Recommendation X.409) as used in the X.400 messaging standard, which
  are octet-oriented.

  This is not the first proposal for structuring message bodies.
  RFC-767 discusses a proposed technique for structuring multi-media
  mail messages.  We are also aware that many users already employ mail
  to send TROFF, SCRIBE, TEX, Postscript or other structured
  information.  Such postprocessing as is required must be invoked



Sirbu                                                           [Page 2]

RFC 1049                   Mail Content Type                  March 1988


  manually by the message recipient who looks at the message text
  displayed as conventional ASCII and recognizes that it is structured
  in some way that requires additional processing to be properly
  rendered.  Our proposal is designed to facilitate automatic
  processing of messages by a mail reading system.

2. Problems with Structured Messages

  Once we introduce the notion that a message body might require some
  processing other than simply painting the characters to the screen we
  raise a number of fundamental questions.  These generally arise due
  to the certainty that some receiving systems will have the facilities
  to process the received message and some will not.  The problem is
  what to do in the presence of systems with different levels of
  capability.

  First, we must recognize that the purpose of structured messages is
  to be able to send types of information, ultimately intended for
  human consumption, not expressable in plain ASCII.  Thus, there is no
  way in plain ASCII to send the italics, boldface, or greek characters
  that can be expressed in Postscript.  If some different processing is
  necessary to render these glyphs, then that is the minimum price to
  be paid in order to send them at all.

  Second, by insisting that the message body contain only ASCII, we
  insure that it will not "break" current mail reading systems which
  are not equipped to process the structure; the result on the screen
  may not be readily interpretable by the human reader, however.

  If a message sender knows that the recipient cannot process
  Postscript, he or she may prefer that the message be revised to
  eliminate the use of italics and boldface, rather than appear
  incomprehensible.  If Postscript is being used because the message
  contains passages in Greek, there may be no suitable ASCII
  equivalent, however.

  Ideally, the details of structuring the message (or not) to conform
  to the capabilities of the recipient system could be completely
  hidden from the message sender.  The distributed Internet mail system
  would somehow determine the capabilities of the recipient system, and
  convert the message automatically; or, if there was no way to send
  Greek text in ASCII, inform the sender that his message could not be
  transmitted.








Sirbu                                                           [Page 3]

RFC 1049                   Mail Content Type                  March 1988


  In practice, this is a difficult task.  There are three possible
  approaches:

     1. Each mail system maintains a database of capabilities of
        remote systems it knows how to send to.  Such a database
        would be very difficult to keep up to date.

     2. The mail transport service negotiates with the receiving
        system as to its capabilities.  If the receiving system
        cannot support the specified content type, the mail is
        transformed into conventional ASCII before transmission.
        This would require changes to all existing SMTP
        implementations, and could not be implemented in the case
        where RFC-822 type messages are being forwarded via Bitnet or
        other networks which do not implement SMTP.

     3. An expanded directory service maintains information on mail
        processing capabilities of receiving hosts.  This eliminates
        the need for real-time negotiation with the final
        destination, but still requires direct interaction with the
        directory service.  Since directory querying is part of mail
        sending as opposed to mail composing/reading systems, this
        requires changes to existing mailers as well as a major
        change to the domain name directory service.

  We note in passing that the X.400 protocol implements approach number
  2, and that the Draft Recommendations for X.DS, the Directory
  Service, would support option 3.

  In the interest of facilitating early usage of structured messages,
  we choose not to recommend any of the three approaches described
  above at the present time.  In a forthcoming RFC we will propose a
  solution based on option 2, requiring modification to mailers to
  support negotiation over capabilities.  For the present, then, users
  would be obliged to keep their own private list of capabilities of
  recipients and to take care that they do not send Postscript, TROFF
  or other structured messages to recipients who cannot process them.
  The penalty for failure to do so will be the frustration of the
  recipient in trying to read a raw Postscript or TROFF file painted on
  his or her screen.  Some System Administrators may attempt to
  implement option 1 for the benefit of their users, but this does not
  impose a requirement for changes on any other mail system.

  We recognize that the long-term solution must require changes to
  mailers.  However, in order to begin now to standardize the header
  fields, and to facilitate experimentation, we issue the present RFC.





Sirbu                                                           [Page 4]

RFC 1049                   Mail Content Type                  March 1988


3. The Content-type Header Field

  Whatever structuring technique is specified by the Content-type
  field, it must be known precisely to both the sender and the
  recipient of the message in order for the message to be properly
  interpreted.  In general, this means that the allowed parameter
  values for the Content-type:  field must identify a well-defined,
  standardized, document structuring technique.  We do not preclude,
  however, the use of a Content-type:  parameter value to specify a
  private structuring technique known only to the sender and the
  recipient.

  More precisely, we propose that the Content-type:  header field
  consist of up to four parameter values.  The first, or type parameter
  names the structuring technique; the second, optional, parameter is a
  version number, ver-num, which indicates a particular version or
  revision of the standardized structuring technique.  The third
  parameter is a resource reference, resource-ref, which may indicate a
  standard database of information to be used in interpreting the
  structured document.  The last parameter is a comment.

  In the Extended Backus Naur Form of RFC-822, we have:

  Content-Type:= type [";" ver-num [";" 1#resource-ref]] [comment]

3.1. Type Values

  Initially, the type parameter would be limited to the following set
  of values:

  type:=           "POSTSCRIPT"/"SCRIBE"/"SGML"/"TEX"/"TROFF"/
                   "DVI"/"X-"atom

  These values are not case sensitive.  POSTSCRIPT, Postscript, and
  POStscriPT are all equivalent.

  POSTSCRIPT      Indicates the enclosed document consists of
                  information encoded using the Postscript Page
                  Definition Language developed by Adobe Systems,
                  Inc. [1]

  SCRIBE          Indicates the document contains embedded formatting
                  information according to the syntax used by the
                  Scribe document formatting language distributed by
                  the Unilogic Corporation. [6]

  SGML            Indicates the document contains structuring
                  information to according the rules specified for



Sirbu                                                           [Page 5]

RFC 1049                   Mail Content Type                  March 1988


                  the Standard Generalized Markup Language, IS 8879,
                  as published by the International Organization for
                  Standardization. [3] Documents structured according
                  to the ISO DIS 8613--Office Docment Architecture and
                  Interchange Format--may also be encoded using SGML
                  syntax.

  TEX             Indicates the document contains embedded formatting
                  information according to the syntax of the TEX
                  document production language. [4]

  TROFF           Indicates the document contains embedded formatting
                  information according to the syntax specified for the
                  TROFF formatting package developed by AT&T Bell
                  Laboratories. [5]

  DVI             Indicates the document contains information according
                  to the device independent file format produced by
                  TROFF or TEX.

  "X-"atom        Any type value beginning with the characters "X-" is
                  a private value.

3.2. Version Number

  Since standard structuring techniques in fact evolve over time, we
  leave room for specifying a version number for the content type.
  Valid values will depend upon the type parameter.

  ver-num:=      local-part

    In particular, we have the following valid values:

    For type=POSTSCRIPT

  ver-num:= "1.0"/"2.0"/"null"

    For type=SCRIBE

  ver-num:= "3"/"4"/"5"/"null"

    For type=SGML

  ver-num:="IS.8879.1986"/"null"

3.3. Resource Reference

  resource-ref:=  local-part



Sirbu                                                           [Page 6]

RFC 1049                   Mail Content Type                  March 1988


  As Apple has demonstrated with their implementation of the
  Laserwriter, a very general document structuring technique can be
  made more efficient by defining a set of macros or other similar
  resources to be used in interpreting any transmitted stream.  The
  Macintosh transmits a LaserPrep file to the Laserwriter containing
  font and macro definitions which can be called upon by subsequent
  documents.  The result is that documents as sent to the Laserwriter
  are considerably more compact than if they had to include the
  LaserPrep file each time.  The Resource Reference parameter allows
  specification of a well known resource, such as a LaserPrep file,
  which should be used by the receiving system when processing the
  message.

  Resource references could also include macro packages for use with
  TEX or references to preprocessors such as eqn and tbl for use with
  troff.  Allowed values will vary according to the type parameter.

    In particular, we propose the following values:

    For type = POSTSCRIPT

  resource-ref:=  "laserprep2.9"/"laserprep3.0"/"laserprep3.1"/
                  "laserprep4.0"/local-part

    For type = TROFF

  resource-ref:=  "eqn"/"tbl"/"me"/local-part

3.4. Comment

  The comment field can be any additional comment text the user
  desires.  Comments are enclosed in parentheses as specified in
  RFC-822.

4. Conclusion

  A standardized Content-type field allows mail reading systems to
  automatically identify the type of a structured message body and to
  process it for display accordingly.  The strcutured message body must
  still conform to the RFC-822 requirements concerning allowable
  characters.  A mail reading system need not take any specific action
  upon receiving a message with valid Content-Type header field.  The
  ability to recognize this field and invoke the appropriate display
  process accordingly will, however, improve the readability of
  messages, and allow the exchange of messages containing mathematical
  symbols, or foreign language characters.





Sirbu                                                           [Page 7]

RFC 1049                   Mail Content Type                  March 1988


  In the near term, the major use of a Content-Type:  header field is
  likely to be for designating the message body as containing a Page
  Definition Language representation such as Postscript.

  Additional type values shall be registered with Internet Assigned
  Numbers Coordinator at USC-ISI.  Please contact:

                  Joyce K. Reynolds
                  USC Information Sciences Institute
                  4676 Admiralty Way
                  Marina del Rey, CA  90292-6695

                  213-822-1511    [email protected]

                               REFERENCES

  1.  Adobe Systems, Inc.  Postscript Language Reference Manual.
      Addison-Wesley, Reading, Mass., 1985.

  2.  Crocker, David H.  RFC-822:  Standard for the Format of ARPA
      Internet Text Messages.  Network Information Center,
      August 13, 1982.

  3.  ISO TC97/SC18.  Standard Generalized Markup Language.
      Tech. Rept. DIS 8879, ISO, 1986.

  4.  Knuth, Donald E.  The TEXbook.  Addison-Wesley, Reading, Mass.,
      1984.

  5.  Ossanna, Joseph F. NROFF/TROFF User's Manual.  Bell
      Laboratories, Murray Hill, New Jersey, 1976.  Computing Science
      Technical Report No.54.

  6.  Unilogic.  SCRIBE Document Production Software.  Unilogic, 1985.
      Fourth Edition.
















Sirbu                                                           [Page 8]