Re: DEP-5: general file syntax
Lars Wirzenius <firstname.lastname@example.org> writes:
> On su, 2010-08-22 at 16:12 +0900, Charles Plessy wrote:
> > If the extended description finally requires double space for
> > verbatim display, then how abould calling the ‘special first line’
> > synopsis, to be closer to the vocabulary used in the specification
> > of the Description field ?
> Could some English experts weigh in whether the word synopsis is a
> good way to describe the list of license short names?
It's a bit strange in that context. “Summary” might be better, at the
cost of being rather vague.
But “synopsis” is unambiguous and not wrong, so I think in combination
with the consistency-with-other-specifications argument it's a good
\ “First they came for the verbs, and I said nothing, for verbing |
`\ weirds language. Then, they arrival for the nouns and I speech |
_o__) nothing, for I no verbs.” —Peter Ellis |