On 8/30/22 07:54, Matthew Wilcox wrote:
On Mon, Aug 29, 2022 at 06:31:49PM -0500, frowand.list@gmail.com wrote:
From: Frank Rowand frank.rowand@sony.com
Prepare KTAP Specification for the process of creating version 2.
The version will remain "2-rc" until the final commit to complete Version 2. Adding the "-rc" ensures that none of the development versions will be mistaken for the completed version 2.
After this commit, Sphinx complains that we now need more '=' signs:
Documentation/dev-tools/ktap.rst:3: WARNING: Title overline too short.
The Kernel Test Anything Protocol (KTAP), version 2-rc
Hey Frank, you can actually use overlength lines to prevent this kind of problem from occurring. eg, this is perfectly acceptable:
=================================================================== Hi ===================================================================
I wonder if we should prefer this style to avoid the rash of complaints when a headline is changed.
Thanks, that is useful to know. I think it might be a good idea to switch to the longer style at some point before the final version 2 release.
-Frank