[Geany-Users] TWiki Lexer / Folder / Highlighter:The From header

[rhkramer at gmail.com]

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 at gmail.com>
To: Mary Doe <mdoe at gmail.com>
Subject: initial notes
Date: Fri Jun 25 23:34:59 2011
Delivered-To: mdoe at 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 at 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 at gmail.com>;
        Wed, 04 Feb 2015 04:06:39 -0800 (PST)