A RetroSearch Logo

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

Search Query:

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

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

[Python-Dev] PEP 287: reStructuredText Standard Docstring Format [Python-Dev] PEP 287: reStructuredText Standard Docstring FormatSamuele Pedroni pedroni@inf.ethz.ch
Thu, 4 Apr 2002 22:15:35 +0200
[me]
> The only thing I found relevant in the PEP are
> (does this fact means something?):
> 
> 
>     - Markup that isolates a Python identifier: interpreted text.
> 
>     - Markup that isolates a Python identifier and specifies its type:
>       interpreted text with roles.
> 

Ok there's another relevant bit:

    - Markup for "tagged lists" or "label lists": field lists.

      ... They may be used to implement docstring
      semantics, such as identifying parameters, exceptions raised,
      etc.; such usage is beyond the scope of this PEP.

how many eons would pass before we see a PEP about
those *relevant* issues? Presumably JavaDoc is a good
start point for this <wink>.

More or less JavaDoc tags would map to fields, except @see
and @link that would use `interp-text` and
the various ref/links forms.

regards.








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