Clarify argument names of the script generating the docs

Author: NagyDonat

clang/docs/CMakeLists.txt

@@ -151,7 +151,10 @@ if (LLVM_ENABLE_SPHINX)
     set(aopts_rst_in "${CMAKE_CURRENT_SOURCE_DIR}/${aopts_rst_rel_path}.in")
     add_custom_command(
       OUTPUT ${aopts_rst}
-      COMMAND ${Python3_EXECUTABLE} generate_analyzer_options_docs.py -i ${analyzeroptions_def} -t ${aopts_rst_in} -o ${aopts_rst}
+      COMMAND ${Python3_EXECUTABLE} generate_analyzer_options_docs.py
+              --options-def "${analyzeroptions_def}"
+              --template "${aopts_rst_in}"
+              --out "${aopts_rst}"
       WORKING_DIRECTORY ${docs_tools_dir}
       VERBATIM
       COMMENT "Generating ${aopts_rst}"

clang/docs/tools/generate_analyzer_options_docs.py

@@ -226,17 +226,17 @@ def get_option_list(input_file):
 
 
 p = argparse.ArgumentParser()
-p.add_argument("-i", "--input", help="path to AnalyzerOptions.def")
-p.add_argument("-t", "--template", help="path of template file")
-p.add_argument("-o", "--output", help="path of output file")
+p.add_argument("--options-def", help="path to AnalyzerOptions.def")
+p.add_argument("--template", help="path of template file")
+p.add_argument("--out", help="path of output file")
 opts = p.parse_args()
 
 with open(opts.template, encoding="utf-8") as f:
     doc_template = f.read()
 
 PLACEHOLDER = ".. OPTIONS_LIST_PLACEHOLDER\n"
 
-rst_output = doc_template.replace(PLACEHOLDER, get_option_list(opts.input))
+rst_output = doc_template.replace(PLACEHOLDER, get_option_list(opts.options_def))
 
-with open(opts.output, "w", newline="", encoding="utf-8") as f:
+with open(opts.out, "w", newline="", encoding="utf-8") as f:
     f.write(rst_output)