tempest pdf-doc build failed with Dimension too large

[Ghanshyam Mann]

Tempest pdf doc build includes the sample config file which is large in size and end up with
error 'Dimension too large'

- https://zuul.opendev.org/t/openstack/build/84d73ec987d04c05acc54b231d33067e/log/sphinx-build-pdf.log#1874

Its happening while adding new config option in https://review.opendev.org/#/c/686073/ which means we are at the edge of pdf build limit.

Instead of including the giant sample config which is nothing but a single code block we should add the reference of config options.

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.opendev.org/739262

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.opendev.org/739262
Committed: https://git.openstack.org/cgit/openstack/tempest/commit/?id=aaaafbb5b8ab04b6f1c6e8a7f1c1df2044984470
Submitter: Zuul
Branch: master

commit aaaafbb5b8ab04b6f1c6e8a7f1c1df2044984470
Author: Ghanshyam Mann <email address hidden>
Date: Fri Jul 3 11:24:43 2020 -0500

    Fix pdf-doc build by skiping the sample file

    Tempest pdf doc build includes the sample config
    file which is large in size and end up with
    error 'Dimension too large'

    - https://zuul.opendev.org/t/openstack/build/84d73ec987d04c05acc54b231d33067e/log/sphinx-build-pdf.log#1874

    Its happening while adding new config option in
    https://review.opendev.org/#/c/686073/ which means we
    are at the edge of pdf build limit.

    We should not include the sample config file as part
    of pdf build.

    Change-Id: I59383505989705d35d86b19b5c1aaafebd2bd307
    Closes-Bug: #1886212

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/tempest 25.0.1 release.