Re: [Openocd-development] [rfc] improving 'help'... volunteers?

2009-12-01 Thread Zach Welch
On Sat, 2009-11-28 at 15:26 -0800, David Brownell wrote: On Saturday 28 November 2009, Zach Welch wrote: On Sat, 2009-11-28 at 14:07 -0800, David Brownell wrote: On Saturday 28 November 2009, Zach Welch wrote: Next, we should consider updating all help messages to full sentences, so

Re: [Openocd-development] [rfc] improving 'help'... volunteers?

2009-12-01 Thread David Brownell
On Tuesday 01 December 2009, Zach Welch wrote: The use of angle brackets intends to distinguish parameter names from literal arguments.  Thus [foo]  means an optional thing which semantically will be used as a foo, whereas [foo|bar] means you can optionally provide the 'foo' or 'bar'

Re: [Openocd-development] [rfc] improving 'help'... volunteers?

2009-12-01 Thread Zach Welch
On Tue, 2009-12-01 at 14:28 -0800, David Brownell wrote: On Tuesday 01 December 2009, Zach Welch wrote: The use of angle brackets intends to distinguish parameter names from literal arguments. Thus [foo] means an optional thing which semantically will be used as a foo, whereas

Re: [Openocd-development] [rfc] improving 'help'... volunteers?

2009-12-01 Thread Albert ARIBAUD
David Brownell a écrit : On Tuesday 01 December 2009, Zach Welch wrote: The use of angle brackets intends to distinguish parameter names from literal arguments. Thus [foo] means an optional thing which semantically will be used as a foo, whereas [foo|bar] means you can optionally provide

Re: [Openocd-development] [rfc] improving 'help'... volunteers?

2009-11-28 Thread David Brownell
On Saturday 28 November 2009, Zach Welch wrote: Next, we should consider updating all help messages to full sentences, so the new command mode information will follow the final period. And make sure the usage is all strict BNF. I see angle brackets ... and have no idea what's meant; I've seen

Re: [Openocd-development] [rfc] improving 'help'... volunteers?

2009-11-28 Thread Zach Welch
On Sat, 2009-11-28 at 14:07 -0800, David Brownell wrote: On Saturday 28 November 2009, Zach Welch wrote: Next, we should consider updating all help messages to full sentences, so the new command mode information will follow the final period. And make sure the usage is all strict BNF. I

Re: [Openocd-development] [rfc] improving 'help'... volunteers?

2009-11-28 Thread David Brownell
On Saturday 28 November 2009, Zach Welch wrote: On Sat, 2009-11-28 at 14:07 -0800, David Brownell wrote: On Saturday 28 November 2009, Zach Welch wrote: Next, we should consider updating all help messages to full sentences, so the new command mode information will follow the final period.