The From header is a multiline header that marks the beginning of a TWiki record.
The From header is very much like and compatible with the mbox file From header. Among other things, it allows TWiki records to be treated as emails in various other software (specifically, kmail, nmail, and kate (using my TWiki highlighter)).
An optional "morF" line, the next From header, or the EOF mark the end of a TWiki record.
There can be non-TWiki record text matter between a morF line and the start of the next TWiki record, or before the first TWiki record, or between a morF line and the end of the file.
The first line of a From header: * starts with "From" starting at the 1st position of a line, followed by a space * the next entity on the line can be either a single word without quotes, or a phrase within double quotes * the next entity on the line is a date and time in the format: Wed Jun 24 23:34:59 2011
The From line can be followed by any number of header lines with a format like:
<keyword>: <text>
A header line starting with 8 spaces is a continuation of the previous line.
For purposes of TWiki (to make the From header work in kmail, nmail, and kate) that group of lines must include at least one Date: line and at least one Subject: line. It may include any number of other <keyword>: <text> lines, or additional Date: or Subject: lines.
The From header is ended by a blank line.
Here are some examples of From headers (with a sample morF line just to remember that morF lines exist and must be handled):
From "this is a test" Wed Jun 24 23:34:59 2011 Subject: initial notes Date: Fri Jun 25 23:34:59 2011
morF
From testing Wed Jun 24 23:34:59 2011 Subject: initial notes Date: Fri Jun 25 23:34:59 2011
From "this is a test" Wed Jun 24 23:34:59 2011 From: John Doe jdoe06@gmail.com To: Mary Doe mdoe@gmail.com Subject: initial notes Date: Fri Jun 25 23:34:59 2011 Delivered-To: mdoe@gmail.com Received: by 10.202.71.88 with SMTP id u85csp532197oia; Wed, 4 Feb 2015 04:06:40 -0800 (PST) X-Received: by 10.66.124.225 with SMTP id ml1mr45317489pab.142.1423051599997; Wed, 04 Feb 2015 04:06:39 -0800 (PST) Return-Path: eagle@gopusamedia.com Received: from mx2.gopusamedia.com (mx2.gopusamedia.com. [65.17.233.201]) by mx.google.com with ESMTP id xy10si1804601pac.209.2015.02.04.04.06.39 for mdoe@gmail.com; Wed, 04 Feb 2015 04:06:39 -0800 (PST)