docs: pretty up sysctl/kernel.rst
authorStephen Kitt <steve@sk2.org>
Tue, 18 Feb 2020 12:59:16 +0000 (13:59 +0100)
committerJonathan Corbet <corbet@lwn.net>
Wed, 19 Feb 2020 10:33:59 +0000 (03:33 -0700)
commita3cb66a508528e9082cba8303b4f31767e7743a2
tree4cbc2f409ed796e78402e27b182ed557e9c1a58d
parentfb2511247dc4061fd122d0195838278a4a0b7b59
docs: pretty up sysctl/kernel.rst

This updates sysctl/kernel.rst to use ReStructured Text more fully:
* the list of files is now the table of contents (old entries with no
  corresponding sections are added as empty sections for now);
* code references and commands are formatted as code, except for
  function names which end up linked to the appropriate documentation;
* links are used to point to other documentation and other sections;
* tables are used to make lists of values more readable (as already
  done for some sections);
* in heavily-reworked paragraphs, sentences are wrapped individually,
  to make future diffs easier to read.

The first mention of the kernel version is dropped. The second
mention, saying that the document is accurate for 2.2, is preserved
for now; I will update that once the document really is accurate for a
current kernel release.

Signed-off-by: Stephen Kitt <steve@sk2.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/admin-guide/sysctl/kernel.rst