On 8/30/22 07:54, Matthew Wilcox wrote: > On Mon, Aug 29, 2022 at 06:31:49PM -0500, frowand.list@xxxxxxxxx wrote: >> From: Frank Rowand <frank.rowand@xxxxxxxx> >> >> 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
