docs(API): make API TOCs easier to use

This commit is contained in:
Victor Wheeler
2025-05-19 15:38:18 -06:00
committed by Liam Howatt
parent 0944979a51
commit b5dc0418ea
+2 -2
View File
@@ -397,7 +397,7 @@ def _build_one_local_dictionary(local_dict, remote_dict):
""" """
for symbol in remote_dict: for symbol in remote_dict:
# Note: symbol `None` is actually a valid symbol in the # Note: symbol `None` is actually a valid symbol in the
# `enums` dictionary, containing all enumvalue symbols # `enums` dictionary, containing all enum-value symbols
# for enums without names. # for enums without names.
if symbol is None or not symbol.startswith('_lv'): if symbol is None or not symbol.startswith('_lv'):
loc_symbol = symbol loc_symbol = symbol
@@ -587,7 +587,7 @@ def _create_rst_files_for_dir(src_root_dir_len: int,
f.write(subdir_stem + '\n') f.write(subdir_stem + '\n')
f.write(section_line) f.write(section_line)
f.write('\n') f.write('\n')
f.write('.. toctree::\n :maxdepth: 2\n\n') f.write('.. toctree::\n :maxdepth: 1\n\n')
# One entry per `.rst` file # One entry per `.rst` file
for h_file in elig_h_files: for h_file in elig_h_files: