linux/Documentation
Mauro Carvalho Chehab 93351d4196 scripts: kernel-doc: allow passing desired Sphinx C domain dialect
When kernel-doc is called via kerneldoc.py, there's no need to
auto-detect the Sphinx version, as the Sphinx module already
knows it. So, add an optional parameter to allow changing the
Sphinx dialect.

As kernel-doc can also be manually called, keep the auto-detection
logic if the parameter was not specified. On such case, emit
a warning if sphinx-build can't be found at PATH.

I ended using a suggestion from Joe for using a more readable
regex, instead of using a complex one with a hidden group like:

	m/^(\d+)\.(\d+)(?:\.?(\d+)?)/

in order to get the optional <patch> argument.

Thanks-to: Joe Perches <joe@perches.com>
Suggested-by: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
2020-10-15 07:49:36 +02:00
..
2020-10-14 15:56:58 -07:00
2020-08-05 10:51:40 -07:00
2020-09-14 18:46:54 -07:00
2020-10-13 18:38:32 -07:00
2020-08-05 11:43:47 -07:00
2020-08-11 13:48:02 -07:00
2020-10-14 15:56:58 -07:00
2020-09-09 11:41:20 -06:00
2020-10-13 13:33:16 -05:00
2020-10-14 16:19:42 -07:00
2020-10-14 15:31:58 -07:00
2020-10-14 16:19:42 -07:00
2020-10-13 13:33:16 -05:00
2020-08-11 11:17:45 -07:00
2020-10-14 14:32:52 -07:00
2020-10-14 15:31:58 -07:00