Re: [PATCH v2] doc: convert printk-formats.txt to rst
From: Markus Heiser
Date: Thu Dec 07 2017 - 02:45:23 EST
> Am 07.12.2017 um 06:49 schrieb Tobin C. Harding <me@xxxxxxxx>:
>
> Documentation/printk-formats.txt is a candidate for conversion to
> ReStructuredText format. Some effort has already been made to do this
> conversion even thought the suffix is currently .txt
>
[...]
>
> Signed-off-by: Tobin C. Harding <me@xxxxxxxx>
> ---
>
> v2:
> - Revert to use ASCII table.
> - Implement (or revert) changes as suggested by Randy Dunlap.
> - Change file location to core-api/ (inc required index changes)
> - Remove some of the double back ticks.
>
> Last two suggested by Jonathan Corbet.
>
Hm, can't apply v2 on Jon's docs-next .. is the v2 patch on top of your v1?
If so, please take a look at our fabulously ;) documentation ..
https://www.kernel.org/doc/html/latest/process/submitting-patches.html
"""
When you submit or resubmit a patch or patch series, include the complete patch description and justification for it. Donât just say that this is version N of the patch (series). Donât expect the subsystem maintainer to refer back to earlier patch versions or referenced URLs to find the patch description and put that into the patch. I.e., the patch (series) and its description should be self-contained. This benefits both the maintainers and reviewers. Some reviewers probably didnât even receive earlier versions of the patch.
"""
-- Markus --