Can somebody please explain this? .. index:: single: formatting, string (%) single: interpolation, string (%) single: string; formatting single: string; interpolation single: printf-style formatting single: sprintf-style formatting single: % formatting single: % interpolation Specifically, what does index mean? What does single vs double vs triple mean? Is there a reference somewhere I can read? -- ~Ethan~
This adds entries to the index of the document -- similar to the index at
the end of a book. I think single vs. double refers to different types of
entries. Check out this page: https://docs.python.org/3/genindex.html
On Fri, Jan 23, 2015 at 3:43 PM, Ethan Furman
Can somebody please explain this?
.. index:: single: formatting, string (%) single: interpolation, string (%) single: string; formatting single: string; interpolation single: printf-style formatting single: sprintf-style formatting single: % formatting single: % interpolation
Specifically, what does index mean? What does single vs double vs triple mean? Is there a reference somewhere I can read?
-- ~Ethan~
_______________________________________________ Python-Dev mailing list Python-Dev@python.org https://mail.python.org/mailman/listinfo/python-dev Unsubscribe: https://mail.python.org/mailman/options/python-dev/guido%40python.org
-- --Guido van Rossum (python.org/~guido)
Hello Ethan, In addition to Guido's suggestion, the Python Developer Guide's Section 7.4.9 should be helpful. Here's a link to Section 7 on Restructured Text https://docs.python.org/devguide/documenting.html#restructuredtext-primer You may also find the Sphinx project documentation helpful if you need additional details. Carol On 23/01/2015 15:55, Guido van Rossum wrote:
This adds entries to the index of the document -- similar to the index at the end of a book. I think single vs. double refers to different types of entries. Check out this page: https://docs.python.org/3/genindex.html
On Fri, Jan 23, 2015 at 3:43 PM, Ethan Furman
mailto:ethan@stoneleaf.us> wrote: Can somebody please explain this?
.. index:: single: formatting, string (%) single: interpolation, string (%) single: string; formatting single: string; interpolation single: printf-style formatting single: sprintf-style formatting single: % formatting single: % interpolation
Specifically, what does index mean? What does single vs double vs triple mean? Is there a reference somewhere I can read?
-- ~Ethan~
_______________________________________________ Python-Dev mailing list Python-Dev@python.org mailto:Python-Dev@python.org https://mail.python.org/mailman/listinfo/python-dev Unsubscribe: https://mail.python.org/mailman/options/python-dev/guido%40python.org
-- --Guido van Rossum (python.org/~guido http://python.org/%7Eguido)
_______________________________________________ Python-Dev mailing list Python-Dev@python.org https://mail.python.org/mailman/listinfo/python-dev Unsubscribe: https://mail.python.org/mailman/options/python-dev/willingc%40willingconsult...
-- *Carol Willing* Developer | Willing Consulting https://willingconsulting.com
On Fri, 23 Jan 2015 15:55:29 -0800, Guido van Rossum
This adds entries to the index of the document -- similar to the index at the end of a book. I think single vs. double refers to different types of entries. Check out this page: https://docs.python.org/3/genindex.html
On Fri, Jan 23, 2015 at 3:43 PM, Ethan Furman
wrote: Can somebody please explain this?
.. index:: single: formatting, string (%) single: interpolation, string (%) single: string; formatting single: string; interpolation single: printf-style formatting single: sprintf-style formatting single: % formatting single: % interpolation
Specifically, what does index mean? What does single vs double vs triple mean? Is there a reference somewhere I can read?
It is explained in the Sphinx documentation: http://sphinx-doc.org/contents.html Specifically: http://sphinx-doc.org/markup/misc.html#directive-index --David
On 1/23/2015 7:15 PM, R. David Murray wrote:
On Fri, 23 Jan 2015 15:55:29 -0800, Guido van Rossum
wrote: This adds entries to the index of the document -- similar to the index at the end of a book. I think single vs. double refers to different types of entries. Check out this page: https://docs.python.org/3/genindex.html
On Fri, Jan 23, 2015 at 3:43 PM, Ethan Furman
wrote: Can somebody please explain this?
.. index:: single: formatting, string (%) single: interpolation, string (%) single: string; formatting single: string; interpolation single: printf-style formatting single: sprintf-style formatting single: % formatting single: % interpolation
Specifically, what does index mean? What does single vs double vs triple mean? Is there a reference somewhere I can read?
It is explained in the Sphinx documentation: http://sphinx-doc.org/contents.html
Specifically:
The devguide has a cpython doc oriented intro to .rst that includes https://docs.python.org/devguide/documenting.html#index-generating-markup -- Terry Jan Reedy
On 01/23/2015 03:43 PM, Ethan Furman wrote:
Can somebody please explain this?
.. index:: single: formatting, string (%) single: interpolation, string (%) single: string; formatting single: string; interpolation single: printf-style formatting single: sprintf-style formatting single: % formatting single: % interpolation
Specifically, what does index mean? What does single vs double vs triple mean? Is there a reference somewhere I can read?
In restructured text (rst), the .. syntax starts a directive. There are a number of built-in directives, and there is the ability to extend the syntax with domain specific directives. That must be the case here (since there doesn't appear to be a built-in directive named index), so we'll need more information about the source of your rst file before we can answer anything about that particular add on directive. Gary Herron -- Dr. Gary Herron Department of Computer Science DigiPen Institute of Technology (425) 895-4418
participants (6)
-
Carol Willing
-
Ethan Furman
-
Gary Herron
-
Guido van Rossum
-
R. David Murray
-
Terry Reedy