On Tuesday, January 16, 2018 at 10:18:24 AM UTC-5, Komiya Takeshi wrote:
>
> I don't know this is a bug or not. But I feel it internally contains
> infinite loop problem.
>
> I wonder what is happened with following document sets.
> ```
> # a.rst
> :doc:`b`
> ---------------
> ```
> ```
> #b.rst
> :doc:`a`
> ---------------
> ```
>
I would guess that is already broken. The document bodies would still need
to resolve this, and would still be unable to do so.
Unless there is a strong opinion that this is *not* a bug, I think I'm
going to report it as a bug, since seeing "page-foo" in the TOC, but
"Describe Foo Here" in the body, is really strange.
> >On a possibly related note, I also observed that :doc: does not include
> automatic section numbering. Is this intended? Is there a way to change
> this behavior? (I really want to use a reference here, as the section
> number is subject to change, while the document name is more stable.)
>
> :doc: role only refers the title of document. So it does not contain
> section number.
> So please use :numref: role.
>
...but :numref: does not work on documents. Maybe :doc: should be extended
to support `{number}: {name}` a la :numref:?
--
Matthew
--
You received this message because you are subscribed to the Google Groups
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.
