[Varnish] #1459: Undefined references in documentation
Varnish
varnish-bugs at varnish-cache.org
Thu Mar 20 12:46:33 CET 2014
#1459: Undefined references in documentation
---------------------------+---------------------------------
Reporter: lkarsten | Owner:
Type: defect | Status: new
Priority: low | Milestone: Varnish 4.0 release
Component: documentation | Version: trunk
Severity: normal | Keywords:
---------------------------+---------------------------------
Documentation has a lot of undefined references and prints a lot of
warnings when being built.
{{{
lkarsten at immer:~/work/varnish-cache/doc/sphinx$ make html
sphinx-build -b html -d build/doctrees -D latex_paper_size=a4 .
build/html
Making output directory...
Running Sphinx v1.2.2
loading pickled environment... not yet created
building [html]: targets for 102 source files that are out of date
updating environment: 102 added, 0 changed, 0 removed
reading sources... [100%] whats-new/upgrading
/home/lkarsten/work/varnish-cache/doc/sphinx/installation/bugs.rst:86:
WARNING: Definition list ends without a blank line; unexpected unindent.
/home/lkarsten/work/varnish-cache/doc/sphinx/installation/install.rst:144:
WARNING: Inline literal start-string without end-string.
include/params.rst:511: WARNING: duplicate label ref_param_max_retries,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:532: WARNING: duplicate label
ref_param_pcre_match_limit, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:393: WARNING: duplicate label
ref_param_http_range_support, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:112: WARNING: duplicate label ref_param_cc_command,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:226: WARNING: duplicate label ref_param_default_grace,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:754: WARNING: duplicate label
ref_param_tcp_keepalive_time, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:335: WARNING: duplicate label ref_param_gzip_buffer,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:1025: WARNING: duplicate label ref_param_vsl_space,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:478: WARNING: duplicate label ref_param_lru_interval,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:923: WARNING: duplicate label ref_param_timeout_linger,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:711: WARNING: duplicate label
ref_param_sigsegv_handler, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:444: WARNING: duplicate label
ref_param_idle_send_timeout, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:871: WARNING: duplicate label ref_param_thread_pools,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:357: WARNING: duplicate label ref_param_gzip_memlevel,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:912: WARNING: duplicate label ref_param_timeout_idle,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:490: WARNING: duplicate label ref_param_max_esi_depth,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:174: WARNING: duplicate label
ref_param_critbit_cooloff, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:457: WARNING: duplicate label ref_param_listen_address,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:316: WARNING: duplicate label
ref_param_first_byte_timeout, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:54: WARNING: duplicate label ref_param_ban_dups, other
instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:1056: WARNING: duplicate label
ref_param_workspace_backend, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:888: WARNING: duplicate label
ref_param_thread_queue_limit, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:936: WARNING: duplicate label ref_param_timeout_req,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:380: WARNING: duplicate label ref_param_http_max_hdr,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:1078: WARNING: duplicate label
ref_param_workspace_session, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:305: WARNING: duplicate label
ref_param_fetch_maxchunksize, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:562: WARNING: duplicate label ref_param_pipe_timeout,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:782: WARNING: duplicate label
ref_param_thread_pool_destroy_delay, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:7: WARNING: duplicate label
ref_param_acceptor_sleep_decay, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:500: WARNING: duplicate label ref_param_max_restarts,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:766: WARNING: duplicate label
ref_param_thread_pool_add_delay, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:964: WARNING: duplicate label ref_param_vcc_err_unref,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:63: WARNING: duplicate label ref_param_ban_lurker_age,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:93: WARNING: duplicate label
ref_param_between_bytes_timeout, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:644: WARNING: duplicate label ref_param_prefer_ipv6,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:983: WARNING: duplicate label ref_param_vcl_dir, other
instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:665: WARNING: duplicate label ref_param_send_timeout,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:1047: WARNING: duplicate label ref_param_waiter, other
instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:999: WARNING: duplicate label ref_param_vsl_buffer,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:742: WARNING: duplicate label
ref_param_tcp_keepalive_probes, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:154: WARNING: duplicate label ref_param_clock_skew,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:730: WARNING: duplicate label
ref_param_tcp_keepalive_intvl, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:186: WARNING: duplicate label ref_param_debug, other
instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:467: WARNING: duplicate label ref_param_listen_depth,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:626: WARNING: duplicate label ref_param_pool_vbo, other
instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:701: WARNING: duplicate label ref_param_shortlived,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:121: WARNING: duplicate label ref_param_cli_buffer,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:368: WARNING: duplicate label
ref_param_http_gzip_support, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:541: WARNING: duplicate label
ref_param_pcre_match_limit_recursion, other instance in
/home/lkarsten/work/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:45: WARNING: duplicate label ref_param_auto_restart,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:900: WARNING: duplicate label
ref_param_thread_stats_rate, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:689: WARNING: duplicate label ref_param_shm_reclen,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:829: WARNING: duplicate label
ref_param_thread_pool_min, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:412: WARNING: duplicate label ref_param_http_req_size,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:32: WARNING: duplicate label
ref_param_acceptor_sleep_max, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:144: WARNING: duplicate label ref_param_cli_timeout,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:248: WARNING: duplicate label ref_param_default_ttl,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:293: WARNING: duplicate label
ref_param_fetch_chunksize, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:82: WARNING: duplicate label
ref_param_ban_lurker_sleep, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:1067: WARNING: duplicate label
ref_param_workspace_client, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:237: WARNING: duplicate label ref_param_default_keep,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:721: WARNING: duplicate label
ref_param_syslog_cli_traffic, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:103: WARNING: duplicate label
ref_param_busyobj_worker_cache, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:955: WARNING: duplicate label
ref_param_vcc_allow_inline_c, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:347: WARNING: duplicate label ref_param_gzip_level,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:164: WARNING: duplicate label
ref_param_connect_timeout, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:73: WARNING: duplicate label
ref_param_ban_lurker_batch, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:550: WARNING: duplicate label ref_param_ping_interval,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:590: WARNING: duplicate label ref_param_pool_sess,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:433: WARNING: duplicate label ref_param_http_resp_size,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:1036: WARNING: duplicate label ref_param_vsm_space,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:521: WARNING: duplicate label ref_param_nuke_limit,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:1012: WARNING: duplicate label ref_param_vsl_mask,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:814: WARNING: duplicate label
ref_param_thread_pool_max, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:856: WARNING: duplicate label
ref_param_thread_pool_timeout, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:946: WARNING: duplicate label ref_param_user, other
instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:653: WARNING: duplicate label ref_param_rush_exponent,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:326: WARNING: duplicate label ref_param_group, other
instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:973: WARNING: duplicate label
ref_param_vcc_unsafe_path, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:678: WARNING: duplicate label ref_param_session_max,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:991: WARNING: duplicate label ref_param_vmod_dir, other
instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:797: WARNING: duplicate label
ref_param_thread_pool_fail_delay, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:423: WARNING: duplicate label
ref_param_http_resp_hdr_len, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:844: WARNING: duplicate label
ref_param_thread_pool_stack, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:259: WARNING: duplicate label ref_param_feature, other
instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:1089: WARNING: duplicate label
ref_param_workspace_thread, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:608: WARNING: duplicate label ref_param_pool_vbc, other
instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:133: WARNING: duplicate label ref_param_cli_limit,
other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:402: WARNING: duplicate label
ref_param_http_req_hdr_len, other instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
include/params.rst:19: WARNING: duplicate label
ref_param_acceptor_sleep_incr, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/include/params.rst
include/params.rst:572: WARNING: duplicate label ref_param_pool_req, other
instance in /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst
/home/lkarsten/work/varnish-
cache/doc/sphinx/tutorial/introduction.rst.BACKUP.6207.rst:33: WARNING:
Title underline too short.
This behaviour and most other behaviour can be changed using policies
=======
/home/lkarsten/work/varnish-
cache/doc/sphinx/tutorial/introduction.rst.BACKUP.6207.rst:4: WARNING:
duplicate label tutorial-intro, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/tutorial/introduction.rst
/home/lkarsten/work/varnish-
cache/doc/sphinx/tutorial/introduction.rst.BASE.6207.rst:4: WARNING:
duplicate label tutorial-intro, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/tutorial/introduction.rst.BACKUP.6207.rst
/home/lkarsten/work/varnish-
cache/doc/sphinx/tutorial/introduction.rst.LOCAL.6207.rst:4: WARNING:
duplicate label tutorial-intro, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/tutorial/introduction.rst.BASE.6207.rst
/home/lkarsten/work/varnish-
cache/doc/sphinx/tutorial/introduction.rst.REMOTE.6207.rst:4: WARNING:
duplicate label tutorial-intro, other instance in /home/lkarsten/work
/varnish-cache/doc/sphinx/tutorial/introduction.rst.LOCAL.6207.rst
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/command-
line.rst:19: WARNING: Title underline too short.
'-a' *listen_address*
^^^^^^^^^^^^^^^^^^^
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/command-
line.rst:45: WARNING: Title underline too short.
'-f' *VCL-file* or '-b' *backend*
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/command-
line.rst:45: WARNING: Title underline too short.
'-f' *VCL-file* or '-b' *backend*
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/esi.rst:85:
WARNING: Title underline too short.
Doing ESI on JSON and other non-XML'ish content
----------------------------------------------
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/esi.rst:85:
WARNING: Title underline too short.
Doing ESI on JSON and other non-XML'ish content
----------------------------------------------
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/index.rst:35:
WARNING: toctree contains reference to nonexisting document u'users-
guide/orphans'
/home/lkarsten/work/varnish-cache/doc/sphinx/users-
guide/run_security.rst:171: WARNING: Definition list ends without a blank
line; unexpected unindent.
/home/lkarsten/work/varnish-cache/doc/sphinx/users-
guide/troubleshooting.rst:95: WARNING: Block quote ends without a blank
line; unexpected unindent.
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/vcl.rst:33:
WARNING: toctree contains reference to nonexisting document u'users-
guide/websockets'
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/vcl-
backends.rst:217: WARNING: Definition list ends without a blank line;
unexpected unindent.
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/vcl-
syntax.rst:98: WARNING: Literal block expected; none found.
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/vcl-
syntax.rst:100: ERROR: Unknown target name: "vcl".
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/vcl-
variables.rst:3: WARNING: Title underline too short.
Requests and responses as objects
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/vcl-
variables.rst:32: WARNING: Definition list ends without a blank line;
unexpected unindent.
looking for now-outdated files... none found
pickling environment... done
checking consistency... /home/lkarsten/work/varnish-
cache/doc/sphinx/include/params.rst:: WARNING: document isn't included in
any toctree
/home/lkarsten/work/varnish-
cache/doc/sphinx/include/varnishhist_options.rst:: WARNING: document isn't
included in any toctree
/home/lkarsten/work/varnish-
cache/doc/sphinx/include/varnishhist_synopsis.rst:: WARNING: document
isn't included in any toctree
/home/lkarsten/work/varnish-
cache/doc/sphinx/include/varnishlog_options.rst:: WARNING: document isn't
included in any toctree
/home/lkarsten/work/varnish-
cache/doc/sphinx/include/varnishlog_synopsis.rst:: WARNING: document isn't
included in any toctree
/home/lkarsten/work/varnish-
cache/doc/sphinx/include/varnishncsa_options.rst:: WARNING: document isn't
included in any toctree
/home/lkarsten/work/varnish-
cache/doc/sphinx/include/varnishncsa_synopsis.rst:: WARNING: document
isn't included in any toctree
/home/lkarsten/work/varnish-
cache/doc/sphinx/include/varnishtop_options.rst:: WARNING: document isn't
included in any toctree
/home/lkarsten/work/varnish-
cache/doc/sphinx/include/varnishtop_synopsis.rst:: WARNING: document isn't
included in any toctree
/home/lkarsten/work/varnish-cache/doc/sphinx/reference/vcl_var.rst::
WARNING: document isn't included in any toctree
/home/lkarsten/work/varnish-
cache/doc/sphinx/tutorial/introduction.rst.BACKUP.6207.rst:: WARNING:
document isn't included in any toctree
/home/lkarsten/work/varnish-
cache/doc/sphinx/tutorial/introduction.rst.BASE.6207.rst:: WARNING:
document isn't included in any toctree
/home/lkarsten/work/varnish-
cache/doc/sphinx/tutorial/introduction.rst.LOCAL.6207.rst:: WARNING:
document isn't included in any toctree
/home/lkarsten/work/varnish-
cache/doc/sphinx/tutorial/introduction.rst.REMOTE.6207.rst:: WARNING:
document isn't included in any toctree
/home/lkarsten/work/varnish-cache/doc/sphinx/users-
guide/devicedetection.rst:: WARNING: document isn't included in any
toctree
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/vcl-intro.rst::
WARNING: document isn't included in any toctree
done
preparing documents... done
writing output... [100%] whats-new/upgrading
/home/lkarsten/work/varnish-cache/doc/sphinx/index.rst:25: WARNING:
undefined label: users_guide_index (if the link has no caption the label
must precede a section header)
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/operation-
statistics.rst:27: WARNING: undefined label: ref-varnishtop (if the link
has no caption the label must precede a section header)
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/operation-
statistics.rst:41: WARNING: undefined label: ref-varnishhist (if the link
has no caption the label must precede a section header)
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/operation-
statistics.rst:57: WARNING: undefined label: ref-varnishstat (if the link
has no caption the label must precede a section header)
/home/lkarsten/work/varnish-cache/doc/sphinx/users-guide/vcl-
syntax.rst:105: WARNING: undefined label: vcl-built-in-subs (if the link
has no caption the label must precede a section header)
writing additional files... genindex search
copying static files... done
copying extra files... done
dumping search index... done
dumping object inventory... done
build succeeded, 133 warnings.
Build finished. The HTML pages are in build/html.
}}}
--
Ticket URL: <https://www.varnish-cache.org/trac/ticket/1459>
Varnish <https://varnish-cache.org/>
The Varnish HTTP Accelerator
More information about the varnish-bugs
mailing list