public inbox for gcc-cvs@sourceware.org help / color / mirror / Atom feed
From: Martin Liska <marxin@gcc.gnu.org> To: gcc-cvs@gcc.gnu.org Subject: [gcc r13-3984] Revert "sphinx: add update_web_docs_git.py script" Date: Mon, 14 Nov 2022 08:38:32 +0000 (GMT) [thread overview] Message-ID: <20221114083832.6AF483851884@sourceware.org> (raw) https://gcc.gnu.org/g:c909a4af728c7e1b2b93b99effcd7ba6e15290b7 commit r13-3984-gc909a4af728c7e1b2b93b99effcd7ba6e15290b7 Author: Martin Liska <mliska@suse.cz> Date: Sun Nov 13 21:58:31 2022 +0100 Revert "sphinx: add update_web_docs_git.py script" This reverts commit 6373b1fdf75ea0908dfaebdbfc54d8b55b08d409. Diff: --- maintainer-scripts/update_web_docs_git.py | 81 ------------------------------- 1 file changed, 81 deletions(-) diff --git a/maintainer-scripts/update_web_docs_git.py b/maintainer-scripts/update_web_docs_git.py deleted file mode 100755 index f3f59953ac0..00000000000 --- a/maintainer-scripts/update_web_docs_git.py +++ /dev/null @@ -1,81 +0,0 @@ -#!/usr/bin/env python3 - -# Generate documentation from Sphinx files. - -import argparse -import os -import shutil -import subprocess -import tempfile -from pathlib import Path - -GITROOT = '/git/gcc.git' -BUGURL = 'https://gcc.gnu.org/bugs/' - -parser = argparse.ArgumentParser(description='Update web documentation.') -parser.add_argument('output_folder', help='Output folder') -parser.add_argument('--gitrepo', help=f'Git repository (default: {GITROOT})', - default=GITROOT) -parser.add_argument('--sphinx-build', help='Path to sphinx-build binary') -parser.add_argument('-v', '--verbose', action='store_true', - help='Verbose output') -args = parser.parse_args() - - -def find_configs(): - for root, _, files in os.walk('.'): - for f in files: - full = os.path.join(root, f) - if f == 'conf.py': - # find name of the documentation - lines = open(full).read().splitlines() - docname = None - for line in lines: - if line.startswith('name = '): - docname = line.split()[-1].strip("'") - break - assert docname - yield (Path(root).resolve(), docname) - - -with tempfile.TemporaryDirectory() as folder: - print(f'Using {folder} as temporary directory') - os.chdir(folder) - subprocess.check_output(f'git clone {args.gitrepo} --depth=1', shell=True) - os.chdir('gcc') - configs = list(find_configs()) - - # Prepare folders - output = Path(args.output_folder) - if not output.exists(): - output.mkdir() - - temp = Path('tmp').resolve() - temp.mkdir() - - # Prepare default env. variables - childenv = os.environ.copy() - childenv['BUGURL'] = BUGURL - - # Build and copy the documentation - for i, (config_folder, docname) in enumerate(sorted(configs)): - print(f'=== building {i + 1}/{len(configs)}: {docname} ===') - - # Build HTML - cmd = f'make -C doc html SOURCEDIR={config_folder} BUILDDIR={temp}/{docname}' - if args.sphinx_build: - cmd += f' SPHINXBUILD={args.sphinx_build}' - subprocess.run(cmd, shell=True, env=childenv, check=True, - capture_output=not args.verbose) - os.unlink(f'{temp}/{docname}/html/.buildinfo') - shutil.copytree(f'{temp}/{docname}/html', f'{output}/{docname}', - dirs_exist_ok=True) - - # Build PDF - cmd = f'make -C doc latexpdf SOURCEDIR={config_folder} BUILDDIR={temp}/pdf/{docname}' - if args.sphinx_build: - cmd += f' SPHINXBUILD={args.sphinx_build}' - subprocess.run(cmd, shell=True, env=childenv, check=True, - capture_output=not args.verbose) - shutil.copyfile(f'{temp}/pdf/{docname}/latex/{docname}.pdf', - f'{output}/{docname}.pdf')
reply other threads:[~2022-11-14 8:38 UTC|newest] Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=20221114083832.6AF483851884@sourceware.org \ --to=marxin@gcc.gnu.org \ --cc=gcc-cvs@gcc.gnu.org \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).