After reading some more documentation, I discovered that substitutions are only available to inline markup only, i guess that rules out the "todo" directive. I think i'll end up using substitutions for undo text instead ("..todo:: |pending| " ).

On 2011.03.28 15:52, Viktoras wrote:
Hello,

I want to make a couple template todos and use them throughout unfinished documentation, something like:

.. |incomplete| todo:: Unfinished documentation.

.. |pending| todo:: Documentation below is covering a broken or incomplete feature.


..and use them throughout documentation to mark places that need attention later in the development process. However, sphinx won't allow such markup (or is it a docutils issue?):

(ERROR/3) Substitution definition contains illegal element:

<target ids="index-1">

.. |incomplete| todo:: Unfinished documentation.

What would be possible solutions to this?



--
Viktoras
www.neglostyti.com

--
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-dev@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to