Return-Path: <tomi.ollila@iki.fi>
X-Original-To: notmuch@notmuchmail.org
Delivered-To: notmuch@notmuchmail.org
Received: from localhost (localhost [127.0.0.1])
	by olra.theworths.org (Postfix) with ESMTP id 05C9A431FAF
	for <notmuch@notmuchmail.org>; Thu, 26 Apr 2012 23:29:02 -0700 (PDT)
X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
X-Spam-Flag: NO
X-Spam-Score: 0
X-Spam-Level: 
X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]
	autolearn=disabled
Received: from olra.theworths.org ([127.0.0.1])
	by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id FzPEON074PHm for <notmuch@notmuchmail.org>;
	Thu, 26 Apr 2012 23:29:01 -0700 (PDT)
Received: from guru.guru-group.fi (guru-group.fi [87.108.86.66])
	by olra.theworths.org (Postfix) with ESMTP id 07FF5431FAE
	for <notmuch@notmuchmail.org>; Thu, 26 Apr 2012 23:29:00 -0700 (PDT)
Received: by guru.guru-group.fi (Postfix, from userid 501)
	id 8EF5568055; Fri, 27 Apr 2012 09:28:55 +0300 (EEST)
From: Tomi Ollila <tomi.ollila@iki.fi>
To: Jameson Graef Rollins <jrollins@finestructure.net>,
 notmuch@notmuchmail.org
Subject: Re: [PATCH 3/3] NEWS: Insert markdown formatting commands
In-Reply-To: <87ipgm439w.fsf@servo.finestructure.net>
References: <1335469951-22477-1-git-send-email-tomi.ollila@iki.fi>
	<1335469951-22477-3-git-send-email-tomi.ollila@iki.fi>
	<87ipgm439w.fsf@servo.finestructure.net>
User-Agent: Notmuch/0.12+128~g512e176 (http://notmuchmail.org) Emacs/23.3.1
	(x86_64-unknown-linux-gnu)
X-Face: HhBM'cA~<r"^Xv\KRN0P{vn'Y"Kd;zg_y3S[4)KSN~s?O\"QPoL
	$[Xv_BD:i/F$WiEWax}R(MPS`^UaptOGD`*/=@\1lKoVa9tnrg0TW?"r7aRtgk[F
	!)g;OY^,BjTbr)Np:%c_o'jj,Z
Date: Fri, 27 Apr 2012 09:28:55 +0300
Message-ID: <m2haw53cyg.fsf@guru.guru-group.fi>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-BeenThere: notmuch@notmuchmail.org
X-Mailman-Version: 2.1.13
Precedence: list
List-Id: "Use and development of the notmuch mail system."
	<notmuch.notmuchmail.org>
List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,
	<mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
List-Archive: <http://notmuchmail.org/pipermail/notmuch>
List-Post: <mailto:notmuch@notmuchmail.org>
List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,
	<mailto:notmuch-request@notmuchmail.org?subject=subscribe>
X-List-Received-Date: Fri, 27 Apr 2012 06:29:02 -0000

On Fri, Apr 27 2012, Jameson Graef Rollins <jrollins@finestructure.net> wrote:

> On Thu, Apr 26 2012, Tomi Ollila <tomi.ollila@iki.fi> wrote:
>> To make updating the notmuchmail.org wiki 'news' section more
>> straightforward the content of the NEWS file has now been brought
>> to almost the same as the *.mdwn files in the wiki page.
>>
>> The changes are basically insertion of mdwn formatting "commands".
>>
>> More effort has been put into formatting the newer release entries
>> (0.12, 0.11 & 0.10) than older. Commit to format 0.13 entries will
>> be made available separately.
>
> Can we please just make NEWS a directory, which each release getting
> it's own file?  That would obviously make porting to the wiki trivial.

Splitting to separate files is trivial, but that unfortunately is not enough.

Currently there are 3 other things to do:

1) Concatenate lines which start from beginning to line together and
addn '###' to the beginning of it (level 3 header) -- with some execptions.

2) Due to the markdown bug in notmuchmail implementation all lines
that are indented by 2 spaces the indentation is dropped (otherwise
some lines convert incorrectly)

3) Convert '*' -sequences to '`*`' -sequences.

I'll be providing the tool I'm using to do the conversion when the source
for it is ready.


Reading just one NEWS file is easier to everyone who downloads the
tarball. And it is no difference to edit a section in just one NEWS
file compared to separate file when thinking merge conflicts.

> jamie.

Tomi