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

[George Dunlap]

On Wed, Apr 11, 2018 at 11:37 AM, Ian Jackson <ian.jack...@citrix.com> 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.jack...@eu.citrix.com> 
>> 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  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@lists.xenproject.org
https://lists.xenproject.org/mailman/listinfo/xen-devel

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

[Ian Jackson]

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.jack...@eu.citrix.com> 
> 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  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 ?  If so I can probably work around the lack of a
title by treating the first section specially - but of course then we
are inventing our own weird kind of markdown :-).

Ian.

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

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

[George Dunlap]

On Tue, Apr 10, 2018 at 6:22 PM, Ian Jackson  wrote:
> Signed-off-by: Ian Jackson 
> ---
>  SUPPORT.md | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/SUPPORT.md b/SUPPORT.md
> index e447069..264b23f 100644
> --- a/SUPPORT.md
> +++ b/SUPPORT.md
> @@ -1,4 +1,4 @@
> -# 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?

 -George

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