Rename "makerst.py" to "make_rst.py"

This commit is contained in:
Aaron Franke 2021-10-24 01:48:03 -05:00
parent b2ab5cb504
commit 8f05e26198
No known key found for this signature in database
GPG key ID: 40A1750B977E56BF
6 changed files with 10 additions and 8 deletions

View file

@ -48,4 +48,4 @@ jobs:
- name: Documentation checks - name: Documentation checks
run: | run: |
doc/tools/makerst.py --dry-run doc/classes modules doc/tools/make_rst.py --dry-run doc/classes modules

View file

@ -17,7 +17,7 @@ doxygen:
rst: rst:
rm -rf $(OUTPUTDIR)/rst rm -rf $(OUTPUTDIR)/rst
mkdir -p $(OUTPUTDIR)/rst mkdir -p $(OUTPUTDIR)/rst
python3 $(TOOLSDIR)/makerst.py -o $(OUTPUTDIR)/rst $(CLASSES) python3 $(TOOLSDIR)/make_rst.py -o $(OUTPUTDIR)/rst $(CLASSES)
rstjs: rstjs:
rm -rf $(OUTPUTDIR)/rstjs rm -rf $(OUTPUTDIR)/rstjs

View file

@ -1,5 +1,7 @@
#!/usr/bin/env python3 #!/usr/bin/env python3
# This script makes RST files from the XML class reference for use with the online docs.
import argparse import argparse
import os import os
import re import re
@ -399,7 +401,7 @@ def make_rst_class(class_def, state, dry_run, output_dir): # type: (ClassDef, S
# Warn contributors not to edit this file directly # Warn contributors not to edit this file directly
f.write(":github_url: hide\n\n") f.write(":github_url: hide\n\n")
f.write(".. Generated automatically by doc/tools/makerst.py in Godot's source tree.\n") f.write(".. Generated automatically by doc/tools/make_rst.py in Godot's source tree.\n")
f.write(".. DO NOT EDIT THIS FILE, but the " + class_name + ".xml source instead.\n") f.write(".. DO NOT EDIT THIS FILE, but the " + class_name + ".xml source instead.\n")
f.write(".. The source is found in doc/classes or modules/<name>/doc_classes.\n\n") f.write(".. The source is found in doc/classes or modules/<name>/doc_classes.\n\n")

View file

@ -12,8 +12,8 @@ contributors to make sure they comply with our requirements.
`PATH`, or if you want to enable colored output with `pygmentize`. `PATH`, or if you want to enable colored output with `pygmentize`.
- Pre-commit hook for `black`: Applies `black` to the staged Python files - Pre-commit hook for `black`: Applies `black` to the staged Python files
before accepting a commit. before accepting a commit.
- Pre-commit hook for `makerst`: Checks the class reference syntax using - Pre-commit hook for `make_rst`: Checks the class reference syntax using
`makerst.py`. `make_rst.py`.
## Installation ## Installation

View file

@ -14,7 +14,7 @@
# as this script. Hooks should return 0 if successful and nonzero to cancel the # as this script. Hooks should return 0 if successful and nonzero to cancel the
# commit. They are executed in the order in which they are listed. # commit. They are executed in the order in which they are listed.
#HOOKS="pre-commit-compile pre-commit-uncrustify" #HOOKS="pre-commit-compile pre-commit-uncrustify"
HOOKS="pre-commit-clang-format pre-commit-black pre-commit-makerst" HOOKS="pre-commit-clang-format pre-commit-black pre-commit-make-rst"
########################################################### ###########################################################
# There should be no need to change anything below this line. # There should be no need to change anything below this line.

View file

@ -1,6 +1,6 @@
#!/usr/bin/env bash #!/usr/bin/env bash
# Git pre-commit hook that checks the class reference syntax using makerst.py. # Git pre-commit hook that checks the class reference syntax using make_rst.py.
# Workaround because we can't execute the .py file directly on windows # Workaround because we can't execute the .py file directly on windows
PYTHON=python PYTHON=python
@ -9,4 +9,4 @@ if [[ "$py_ver" != "3" ]]; then
PYTHON+=3 PYTHON+=3
fi fi
$PYTHON doc/tools/makerst.py doc/classes modules --dry-run $PYTHON doc/tools/make_rst.py doc/classes modules --dry-run