GNU Emacs Manual

23.2: Mail Header Fields

A header field in the mail buffer starts with a field name at the beginning of a line, terminated by a colon. Upper and lower case are equivalent in field names (and in mailing addresses also). After the colon and optional whitespace comes the contents of the field.

You can use any name you like for a header field, but normally people use only standard field names with accepted meanings. Here is a table of fields commonly used in outgoing messages.

`To'

This field contains the mailing addresses to which the message is addressed.

`Subject'

The contents of the `Subject' field should be a piece of text that says what the message is about. The reason `Subject' fields are useful is that most mail-reading programs can provide a summary of messages, listing the subject of each message but not its text.

`CC'

This field contains additional mailing addresses to send the message to, but whose readers should not regard the message as addressed to them.

`BCC'

This field contains additional mailing addresses to send the message to, which should not appear in the header of the message actually sent. Copies sent this way are called blind carbon copies.

To send a blind carbon copy of every outgoing message to yourself, set the variable mail-self-blind to t.

`FCC'

This field contains the name of one file and directs Emacs to append a copy of the message to that file when you send the message. If the file is in Rmail format, Emacs writes the message to Rmail format; otherwise, Emacs writes the message in system mail file format.

To put a fixed file name as in `FCC' field each time you start editing an outgoing message, set the variable mail-archive-file-name to that file name. Unless you remove the `FCC' field before sending, the message will be written into that file when it is sent.

`From'

Use the `From' field to say who you are, when the account you are using to send the mail is not your own. The contents of the `From' field should be a valid mailing address, since replies will normally go there. If you don't specify the `From' field yourself, Emacs uses the value of user-mail-address as the default.

`Reply-to'

Use this field to direct replies to a different address. Most mail-reading programs (including Rmail) automatically send replies to the `Reply-to' address in preference to the `From' address. By adding a `Reply-to' field to your header, you can work around any problems your `From' address may cause for replies.

To put a fixed `Reply-to' address into every outgoing message, set the variable mail-default-reply-to to that address (as a string). Then mail initializes the message with a `Reply-to' field as specified. You can delete or alter that header field before you send the message, if you wish. When Emacs starts up, if the environment variable REPLYTO is set, mail-default-reply-to is initialized from that environment variable.

`In-reply-to'

This field contains a piece of text describing a message you are replying to. Some mail systems can use this information to correlate related pieces of mail. Normally this field is filled in by Rmail when you reply to a message in Rmail, and you never need to think about it (see Rmail).

The `To', `CC', `BCC' and `FCC' fields can appear any number of times, to specify many places to send the message. The `To', `CC', and `BCC' fields can have continuation lines. All the lines starting with whitespace, following the line on which the field starts, are considered part of the field. For example,

To: foo@here.net, this@there.net,
  me@gnu.cambridge.mass.usa.earth.spiral3281

When you send the message, if you didn't write a `From' field yourself, Emacs puts in one for you. The variable mail-from-style controls the format:

nil

Just the email address, as in `king@grassland.com'.

parens

Both email address and full name, as in `king@grassland.com (Elvis Parsley)'.

angles

Both email address and full name, as in `Elvis Parsley <king@grassland.com>'.