Re: [Xen-devel] [PATCH 5/5] SUPPORT.md: Document the new text ordering rule
On 13/04/2018, 11:31, "Ian Jackson" wrote:
Lars Kurth writes ("Re: [PATCH 5/5] SUPPORT.md: Document the new text
ordering rule"):
...
> +In each case, descriptions which expand on the name of a feature as
> +provided in the section heading, precede the Status indications.
>
> The following is a little clearer
> s/, descriptions which expand on the name of a feature as provided in the
section heading,/, descriptions which describe the feature in the section
heading in more detail,/
I used the wording I did because the word "description" is very
elastic, and might well be thought to include things that we intend as
caveats.
I don't mind either way. Just something which sounded odd.
Lars
___
Xen-devel mailing list
Xen-devel@lists.xenproject.org
https://lists.xenproject.org/mailman/listinfo/xen-devel
Re: [Xen-devel] [PATCH 5/5] SUPPORT.md: Document the new text ordering rule
Lars Kurth writes ("Re: [PATCH 5/5] SUPPORT.md: Document the new text ordering
rule"):
...
> +In each case, descriptions which expand on the name of a feature as
> +provided in the section heading, precede the Status indications.
>
> The following is a little clearer
> s/, descriptions which expand on the name of a feature as provided in the
> section heading,/, descriptions which describe the feature in the section
> heading in more detail,/
I used the wording I did because the word "description" is very
elastic, and might well be thought to include things that we intend as
caveats.
Ian.
___
Xen-devel mailing list
Xen-devel@lists.xenproject.org
https://lists.xenproject.org/mailman/listinfo/xen-devel
Re: [Xen-devel] [PATCH 5/5] SUPPORT.md: Document the new text ordering rule
On 12/04/2018, 19:26, "Ian Jackson" wrote: Signed-off-by: Ian Jackson --- SUPPORT.md | 5 + 1 file changed, 5 insertions(+) diff --git a/SUPPORT.md b/SUPPORT.md index 5ae84cf..098262b 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -725,6 +725,11 @@ The file is in markdown format. The machine-readable fragments are markdown literals containing RFC-822-like (deb822-like) data. +In each case, descriptions which expand on the name of a feature as +provided in the section heading, precede the Status indications. The following is a little clearer s/, descriptions which expand on the name of a feature as provided in the section heading,/, descriptions which describe the feature in the section heading in more detail,/ +Any paragraphs which follow the Status indication are caveats or +qualifications of the information provided in Status fields. + ## Keys found in the Feature Support subsections ### Status Acked-by: Lars Kurth ___ Xen-devel mailing list Xen-devel@lists.xenproject.org https://lists.xenproject.org/mailman/listinfo/xen-devel
[Xen-devel] [PATCH 5/5] SUPPORT.md: Document the new text ordering rule
Signed-off-by: Ian Jackson --- SUPPORT.md | 5 + 1 file changed, 5 insertions(+) diff --git a/SUPPORT.md b/SUPPORT.md index 5ae84cf..098262b 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -725,6 +725,11 @@ The file is in markdown format. The machine-readable fragments are markdown literals containing RFC-822-like (deb822-like) data. +In each case, descriptions which expand on the name of a feature as +provided in the section heading, precede the Status indications. +Any paragraphs which follow the Status indication are caveats or +qualifications of the information provided in Status fields. + ## Keys found in the Feature Support subsections ### Status -- 2.1.4 ___ Xen-devel mailing list Xen-devel@lists.xenproject.org https://lists.xenproject.org/mailman/listinfo/xen-devel
