Come faccio a evitare che Sphinx ignori l'avviso GPL nella mia docstring?

Question

Sto usando Sphinx per documentare il mio pacchetto Python. Quando uso la direttiva automodule sul mio modulo:

.. automodule:: mymodule 
:members: 

viene stampato tutto, compreso il bando GPL nella docstring. C'è un modo per dire a Sphinx di ignorare la docstring/GPL o dovrei lasciarlo incluso nella documentazione?

Answer 1

Mi sono imbattuto nello stesso problema solo ora e l'ho risolto spostando l'avviso di licenza dalla docstring e in un blocco di commenti regolare nella parte superiore del file.

Ad esempio:

# Copyright 2013 Example, inc. All rights reserved. 
# 
# License ... 
# ... 
# ... 

""" This is the module docstring. 

Description of the module here. 

Etc, etc. 

""" 

import .... 
...