#15133: :ref: directive in docs where :doc: directve should be used
---------------------------------------------------+------------------------
Reporter: Aryeh Leib Taurog <[email protected]> | Owner: nobody
Status: new | Milestone:
Component: Documentation | Version: SVN
Keywords: | Stage: Unreviewed
Has_patch: 0 |
---------------------------------------------------+------------------------
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>`
--
Ticket URL: <http://code.djangoproject.com/ticket/15133>
Django <http://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en.