Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://mail.python.org/pipermail/python-dev/2002-April/022449.html below:

[Python-Dev] PEP 287: reStructuredText Standard Docstring Format

• Previous message: [Python-Dev] PEP 287: reStructuredText Standard Docstring Format
• Next message: [Python-Dev] PEP 287: reStructuredText Standard Docstring Format
• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

From: Samuele Pedroni <pedroni@inf.ethz.ch>
>From David Abrahams <david.abrahams@rcn.com>
> > 
> > Is it just me, or are docstrings less-convenient than comments? Any
> > thought given to reST-processing a module's comments?
> > 
> 
> Maybe it's just me but I would be more happy to optionally
> be able to write reST inside comments instead of docstrings
> and have it extracted from there. That means
> the comment would take the place of the secondary
> docstring.
> 

that means optionally e.g:

# identifiable heavy reST 
#
def f(...
  """plain text or light reST"""

vs.

def f(..
  """plain text or light reST"""
  """heavy reST"""

regards.

• Previous message: [Python-Dev] PEP 287: reStructuredText Standard Docstring Format
• Next message: [Python-Dev] PEP 287: reStructuredText Standard Docstring Format
• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4