[TS-4037] various table of contents errors

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: Docs
• Component/s: Documentation
• Assignee: Jon Sime
• Reporter: James Peach
• Created: 23/Nov/15 01:30
• Updated: 23/Mar/16 16:01
• Resolved: 23/Mar/16 16:01

Description

Building the HTML docs on Fedora 22:

...
/opt/home/src/trafficserver.git/doc/admin-guide/configuration/index.en.rst:25: WARNING: toctree contains reference to nonexisting document u'admin-guide/configuration/reverse-proxying.en'
/opt/home/src/trafficserver.git/doc/admin-guide/index.en.rst:27: WARNING: toctree contains reference to nonexisting document u'admin-guide/troubleshooting.en'
/opt/home/src/trafficserver.git/doc/admin-guide/monitoring/monitoring/third-party/index.en.rst:25: WARNING: toctree contains reference to nonexisting document u'admin-guide/monitoring/monitoring/third-party/circonus.en'
/opt/home/src/trafficserver.git/doc/admin-guide/monitoring/monitoring/third-party/index.en.rst:25: WARNING: toctree contains reference to nonexisting document u'admin-guide/monitoring/monitoring/third-party/logstash.en'
/opt/home/src/trafficserver.git/doc/admin-guide/monitoring/monitoring/third-party/index.en.rst:25: WARNING: toctree contains reference to nonexisting document u'admin-guide/monitoring/monitoring/third-party/nagios.en'
/opt/home/src/trafficserver.git/doc/admin-guide/monitoring/monitoring/third-party/index.en.rst:25: WARNING: toctree contains reference to nonexisting document u'admin-guide/monitoring/monitoring/third-party/zabbix.en'
...
/opt/home/src/trafficserver.git/doc/developer-guide/introduction/audience.en.rst:25: WARNING: toctree contains reference to nonexisting document u'developer-guide/introduction/preface/how-to-use-this-book.en'
/opt/home/src/trafficserver.git/doc/developer-guide/introduction/audience.en.rst:25: WARNING: toctree contains reference to nonexisting document u'developer-guide/introduction/preface/typographical-conventions.en'
/opt/home/src/trafficserver.git/doc/developer-guide/plugins/adding-statistics.en.rst:34: WARNING: toctree contains reference to nonexisting document u'developer-guide/plugins/adding-statistics/coupled-statistics.en'
/opt/home/src/trafficserver.git/doc/developer-guide/plugins/adding-statistics.en.rst:34: WARNING: toctree contains reference to nonexisting document u'developer-guide/plugins/adding-statistics/viewing-statistics-using-traffic-line.en'
/opt/home/src/trafficserver.git/doc/developer-guide/plugins/hooks-and-transactions/index.en.rst:157: WARNING: toctree contains reference to nonexisting document u'developer-guide/plugins/hooks-and-transactions/trafficserver-timers.en'
/opt/home/src/trafficserver.git/doc/developer-guide/plugins/new-protocol-plugins.en.rst:None: WARNING: image file not readable: developer-guide/plugins/../static/images/sdk/Protocol_state_diagram.jpg
/opt/home/src/trafficserver.git/doc/developer-guide/plugins/new-protocol-plugins.en.rst:None: WARNING: image file not readable: developer-guide/plugins/../static/images/sdk/protocol_sm_big.jpg
/opt/home/src/trafficserver.git/doc/developer-guide/plugins/new-protocol-plugins.en.rst:None: WARNING: image file not readable: developer-guide/plugins/../static/images/sdk/protocol_evt.jpg
/opt/home/src/trafficserver.git/doc/developer-guide/plugins/new-protocol-plugins.en.rst:None: WARNING: image file not readable: developer-guide/plugins/../static/images/sdk/txn_sm.jpg
/opt/home/src/trafficserver.git/doc/developer-guide/troubleshooting-tips.en.rst:23: WARNING: toctree contains reference to nonexisting document u'developer-guide/troubleshooting-tips/unable-to-debug-tags.en'
/opt/home/src/trafficserver.git/doc/developer-guide/troubleshooting-tips.en.rst:23: WARNING: toctree contains reference to nonexisting document u'developer-guide/troubleshooting-tips/using-a-debugger.en'
/opt/home/src/trafficserver.git/doc/developer-guide/troubleshooting-tips.en.rst:23: WARNING: toctree contains reference to nonexisting document u'developer-guide/troubleshooting-tips/debugging-memory-leaks.en'
...checking consistency... /opt/home/src/trafficserver.git/doc/admin-guide/configuring-traffic-server.en.rst:: WARNING: document isn't included in any toctree
/opt/home/src/trafficserver.git/doc/admin-guide/hierachical-caching.en.rst:: WARNING: document isn't included in any toctree
/opt/home/src/trafficserver.git/doc/admin-guide/transparent-proxy.en.rst:: WARNING: document isn't included in any toctree
/opt/home/src/trafficserver.git/doc/developer-guide/introduction/audience.en.rst:: WARNING: document isn't included in any toctree
/opt/home/src/trafficserver.git/doc/developer-guide/troubleshooting-tips.en.rst:: WARNING: document isn't included in any toctree
/opt/home/src/trafficserver.git/doc/sdk/trafficserver-timers.en.rst:: WARNING: document isn't included in any toctree
...