[i-g-t] docs: limit the number of subtests listed

Commit Message

Thomas Wood March 25, 2015, 2:41 p.m. UTC

Avoid producing longs lists of subtests in the documentation and instead
provide instructions on how to obtain the full list.

Signed-off-by: Thomas Wood <[e-mail]>
---
 docs/reference/intel-gpu-tools/Makefile.am | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

Patch

diff --git a/docs/reference/intel-gpu-tools/Makefile.am b/docs/reference/intel-gpu-tools/Makefile.am
index 0f10eaa..fa19701 100644
--- a/docs/reference/intel-gpu-tools/Makefile.am
+++ b/docs/reference/intel-gpu-tools/Makefile.am
@@ -46,13 +46,21 @@  xml/igt_test_programs_%_description.xml: $(TESTLISTS)
 		echo "]]></para>" >> $@; \
 		if ./$$testprog --list-subtests > /dev/null ; then \
 			echo "<refsect3><title>Subtests</title>" >> $@; \
-			echo "<simplelist>" >> $@; \
-			for subtest in `./$$testprog --list-subtests`; do \
-				echo "<member>" >> $@; \
-				echo "$$subtest" | perl -pe 's/\b$(KEYWORDS)\b/<acronym>\1<\/acronym>/g' >> $@; \
-				echo "</member>" >> $@; \
-			done; \
-			echo "</simplelist></refsect3>" >> $@; \
+			subtest_list=`./$$testprog --list-subtests`; \
+			subtest_count=`echo $$subtest_list | wc -w`; \
+			if [ $$subtest_count -gt 100 ]; then \
+				echo "<para>This test has over 100 subtests. " >> $@; \
+				echo "Run <command>$$test</command> <option>--list-subtests</option> to list them.</para>" >> $@; \
+			else \
+				echo "<simplelist>" >> $@; \
+				for subtest in $$subtest_list; do \
+					echo "<member>" >> $@; \
+					echo "$$subtest" | perl -pe 's/\b$(KEYWORDS)\b/<acronym>\1<\/acronym>/g' >> $@; \
+					echo "</member>" >> $@; \
+				done; \
+				echo "</simplelist>" >> $@; \
+			fi; \
+			echo "</refsect3>" >> $@; \
 		fi; \
 		echo "</refsect2>" >> $@; \
 	done;