[Doc-SIG] syntax vs semantics: implicit --> explicit

[Goodger, David]

GvR wrote:
> I propose that this time around, we should focus on docstrings only,
> and not on authoring other documents, lest we never reach an
> agreement.

Agreed. But how long is a docstring? :> I like to put mini-to-full man-pages
in my programs (accessible through --help), with section headers; perhaps
I'm the exception.

> (Aside: I'd like to know more about why you think Word didn't work for
> you; I wonder if it could be unfamiliarity with advanced Word
> features?

No, I'm quite comfortable with Word and its features (having actually *read*
the fine manual ... some versions ago, I admit).

> When using styles properly, Word is quite a capable
> authoring tool -- depending, of course, on the processing done by the
> publisher.)

It was a matter of ill-defined styles in the publisher's stylesheet, Word
quirks, cross-platform mangling, inter-version incompatibilities (I refuse
to make M$ richer whenever they change a digit), and editorial bungling (I
made sure all my curly quotes were right, and somebody converted them all to
straight-quotes). Plus the stress of an all-nighter. Add a crash or two.

I've never lost work due to an emacs crash!

/DG