On Tue, Mar 9, 2010 at 10:38 PM, Jason McIntyre <j...@kerhand.co.uk> wrote: > > we can talk about it right now, if anyone wants to. > > but let me say again - currently we say what an option does, and note > it is deprecated. you want to note it is deprectaed, and just point to > the now in-vogue option. some people will prefer one wording; others > will prefer the other. but what benefit will it be for use to change a > bunch of files? i don;t think this is a tangible improvement.
I agree with Jason, and see no reason to change our current wording; on the other hand, I think that the most important part of a description is outlining what an option does. Explaining that an option is deprecated is just a side note that helps when choosing what options we should use. One should read the full description of an option to completely understand what it does. I see no benefit in changing these descriptions either.
