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?

-- ~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 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:

http://sphinx-doc.org/markup/misc.html#directive-index

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