On 2013-06-07, Kristin Barber wrote:

> [-- Type: text/plain, Encoding: quoted-printable --]

> Of course, thank you for the response!

> Here is a minimal exmaple:

> class Instruction:
>     """
>         Instruction
>         =========== 
>         This is a container class for information about an instruction.
>     """
>     def __init__(self, mnemonic, opcode, address, disassembly, parent):

>         self.mnemonic = mnemonic

> I would like for there to be a section heading for each individual class 
> within a module -- but this gives the error that I mentioned before.

You indent the docstring content, this seems to put it in a quote, where
headings are not allowed. Does it work if you unindent?

class Instruction:
    """
    Instruction
    =========== 
    This is a container class for information about an instruction.
    """
    def __init__(self, mnemonic, opcode, address, disassembly, parent):

        self.mnemonic = mnemonic
        ...



>> section headings are only allowed as "first level" elements, 
>> i.e. not inside directives, block quotes, or any other block-level 
>> element. 
>> http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#sections 

Günter

-- 
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 http://groups.google.com/group/sphinx-users?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to