buildman: Convert documentation to rST

Convert the buildman documentation to rST format and include it in the
'build' section.

Signed-off-by: Simon Glass <sjg@chromium.org>
Reviewed-by: Quentin Schulz <foss+uboot@0leil.net>
This commit is contained in:
Simon Glass 2022-11-09 19:14:43 -07:00
parent b38da15a05
commit 74df491051
7 changed files with 1413 additions and 1353 deletions

1
doc/build/buildman.rst vendored Symbolic link
View file

@ -0,0 +1 @@
../../tools/buildman/buildman.rst

1
doc/build/index.rst vendored
View file

@ -11,3 +11,4 @@ Build U-Boot
clang
docker
tools
buildman

File diff suppressed because it is too large Load diff

1
tools/buildman/README.rst Symbolic link
View file

@ -0,0 +1 @@
buildman.rst

1406
tools/buildman/buildman.rst Normal file

File diff suppressed because it is too large Load diff

View file

@ -136,8 +136,8 @@ def DoBuildman(options, args, toolchains=None, make_func=None, brds=None,
if options.full_help:
tools.print_full_help(
os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])), 'README')
)
os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])),
'README.rst'))
return 0
gitutil.setup()

View file

@ -249,7 +249,7 @@ class TestFunctional(unittest.TestCase):
def testFullHelp(self):
command.test_result = None
result = self._RunBuildman('-H')
help_file = os.path.join(self._buildman_dir, 'README')
help_file = os.path.join(self._buildman_dir, 'README.rst')
# Remove possible extraneous strings
extra = '::::::::::::::\n' + help_file + '\n::::::::::::::\n'
gothelp = result.stdout.replace(extra, '')
@ -260,7 +260,7 @@ class TestFunctional(unittest.TestCase):
def testHelp(self):
command.test_result = None
result = self._RunBuildman('-h')
help_file = os.path.join(self._buildman_dir, 'README')
help_file = os.path.join(self._buildman_dir, 'README.rst')
self.assertTrue(len(result.stdout) > 1000)
self.assertEqual(0, len(result.stderr))
self.assertEqual(0, result.return_code)