[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Xen-devel] [PATCH 3/7] SUPPORT.md: Syntax: Provide a title rather than a spurious empty section



On Wed, Apr 11, 2018 at 11:37 AM, Ian Jackson <ian.jackson@xxxxxxxxxx> wrote:
> George Dunlap writes ("Re: [Xen-devel] [PATCH 3/7] SUPPORT.md: Syntax: 
> Provide a title rather than a spurious empty section"):
>> On Tue, Apr 10, 2018 at 6:22 PM, Ian Jackson <ian.jackson@xxxxxxxxxxxxx> 
>> wrote:
>> > -# Support statement for this release
>> > +% Support statement for this release
>>
>> By doing this we're more or less committing to pandoc's dialect of
>> Markdown, yes?
>
> I think so, yes.  There doesn't seem to be a way to define the
> document title in a way that's the same across markdown processors.
>
> markdown(1) just spits the `%' out as a literal (and indeed it doesn't
> generate a <head> element at all).
>
> I should perhaps have mentioned this issue in the commit message.
>
> We already have a lot of .pandoc files in docs/.  Do you think this is
> bad for SUPPORT.md ?

Well I've been poking around a bit, and now I'm persuaded that pandoc
markdown is a reasonable dialect to commit to. :-)  As you say, we
want to have a title and there doesn't seem to be a way to do that
which is common across markdown dialects.

 -George

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxxx
https://lists.xenproject.org/mailman/listinfo/xen-devel

 


Rackspace

Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.