[MPlayer-DOCS] CVS: main/DOCS/xml/en encoding-guide.xml, 1.36, 1.37

Diego Biurrun diego at biurrun.de
Sat Dec 31 12:53:05 CET 2005


On Tue, Dec 27, 2005 at 04:47:16PM -0800, Corey Hickey wrote:
> Diego Biurrun wrote:
> > AFAIU it is considered good style to avoid short forms in written text,
> > but on the other hand it is used as a stylistic device to make texts a
> > little less dry and more conversational.
> > 
> > So yes, I assume the "no short forms" rule could or maybe should be
> > revisited.  What do you think?
> 
> [ explanation ] 
> 
> In the end, it's a matter of style. I don't know if there are any
> formal, generally-accepted documentation rules that prohibit
> contractions, but I prefer to use them now and then in my general writing.

OK, I propose going with the Wanderer's suggestion then: Avoid short
forms in the more formal man page, allow them in the rest of the
documentation where a more informal writing style is adequate.

Diego




More information about the MPlayer-DOCS mailing list