Messages in this thread | | | Date | Tue, 30 Aug 2022 10:06:35 -0500 | Subject | Re: [PATCH v3 1/2] ktap_v2: change version to 2-rc in KTAP specification | From | Frank Rowand <> |
| |
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
| |