From 3eb4d99971cddb6827c439fdbf378247db39edf5 Mon Sep 17 00:00:00 2001 From: Debian Multimedia Maintainers Date: Thu, 10 Nov 2022 13:55:28 +0100 Subject: [PATCH] make Doxygen documentation reproducible Origin: Debian Bug: https://github.com/juce-framework/JUCE/issues/1148 Last-Update: 2022-11-10 Python's os.listdir() returns the entries in an undefined order, which in turn makes the generated documentation unreproducible. this patch just sorts the entries returned by os.listdir() Last-Update: 2022-11-10 Gbp-Pq: Name reproducible_docs.patch --- docs/doxygen/process_source_files.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/doxygen/process_source_files.py b/docs/doxygen/process_source_files.py index c38135da..85ec8ee2 100644 --- a/docs/doxygen/process_source_files.py +++ b/docs/doxygen/process_source_files.py @@ -87,7 +87,7 @@ if __name__ == "__main__": juce_modules = args.subdirs.split(",") else: juce_modules = [] - for item in os.listdir(args.source_dir): + for item in sorted(os.listdir(args.source_dir)): if os.path.isdir(os.path.join(args.source_dir, item)): juce_modules.append(item) @@ -136,7 +136,7 @@ if __name__ == "__main__": # Create a list of the directories in the module that we can use as # subgroups and create the Doxygen group hierarchy string. - dir_contents = os.listdir(module_path) + dir_contents = sorted(os.listdir(module_path)) # Ignore "native" folders as these are excluded by doxygen. try: dir_contents.remove("native") -- 2.30.2