Hi, >Am I doing something wrong, or is this a bug? (If it's a bug, any pointers >where in the code it would need to be fixed? I'm more than willing to take a >crack at it...)
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` --------------- ``` >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. I understand it is a bit ugly. But there are no good way at present. Thanks, Takeshi KOMIYA 2018-01-16 1:59 GMT+09:00 <mwoehlke.fl...@gmail.com>: > I'm writing a documentation page that is a sort of index/summary of my > project documentation. Thus, I am using :doc:`page-foo` as section titles. > This works fine in the document proper (the section title is e.g. "Describe > Foo Here"), but in the sidebar table-of-contents, I see the doc name, i.e. > "page-foo". This is obviously not what I want. Am I doing something wrong, > or is this a bug? (If it's a bug, any pointers where in the code it would > need to be fixed? I'm more than willing to take a crack at it...) > > 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.) > > -- > 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 sphinx-users+unsubscr...@googlegroups.com. > To post to this group, send email to sphinx-users@googlegroups.com. > Visit this group at https://groups.google.com/group/sphinx-users. > For more options, visit https://groups.google.com/d/optout. -- 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 sphinx-users+unsubscr...@googlegroups.com. To post to this group, send email to sphinx-users@googlegroups.com. Visit this group at https://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.