id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
15133	:ref: directive in docs where :doc: directive should be used	Aryeh Leib Taurog <vim@…>	nobody	"Using sphinx 1.0.7 I get the following warnings when building the docs:
{{{
/home/altaurog/djangodoc/trunk/docs/ref/signals.txt:15: WARNING: undefined label: topics-auth (if the link has no caption the label must precede a section header)
/home/altaurog/djangodoc/trunk/docs/releases/1.3-beta-1.txt:61: WARNING: undefined label: topics-auth (if the link has no caption the label must precede a section header)
/home/altaurog/djangodoc/trunk/docs/topics/auth.txt:660: WARNING: undefined label: topic-signals (if the link has no caption the label must precede a section header)
}}}

Changing the offending :ref: directives to :doc: directives seems to resolve this issue.  i.e.
{{{
    The :doc:`authentication framework </topics/auth>` sends :ref:`signals when
}}}
Note that the reference in topics/auth.txt should be `</topics/signals>` not `</topic/signals>`"		closed	Documentation	dev		fixed		vim@…	Accepted	0	0	0	0	0	0