[Doc-SIG] Re: DPS file extensions

[David Goodger]

After reconsidering Tony's original question and the ensuing
discussion:

> Could I suggest that we coin a standard extension for DPS/reST files?

I withdraw my objections to using a filename extension for
reStructuredText files (be it .rst, .rest, .restxt, .rstxt, .rtxt,
.rst.txt, .rest.txt, whatever), but I am loathe to *require* such an
extension. As an individual preference, sure, go ahead, but I think
I'll adopt wait-and-see. I'd rather not change the extensions of the
files in */spec/, because people won't know what to make of them,
whereas with .txt its obvious on first sight.

In Python-source mode (see? more than just docstrings ;-),
__docformat__ contains the name of the markup language. Filename
extensions don't apply here.

When processing standalone plaintext files, the user ought to know
what s/he's got. A specific filename extension would be useful here,
but a pain to the casual Windows and Mac user (no double-clicking
to edit).

-- 
David Goodger    goodger@users.sourceforge.net    Open-source projects:
 - Python Docstring Processing System: http://docstring.sourceforge.net
 - reStructuredText: http://structuredtext.sourceforge.net
 - The Go Tools Project: http://gotools.sourceforge.net