Re: [RFC] Documentation: --options in man-pages synopsys

2013-10-09 Thread Philip Oakley
From: Loyall, David david.loy...@nebraska.gov Sent: Tuesday, October 08, 2013 3:03 PM As a unix user I'd expect the SYNOPSIS section at the top of the man page to include all options that the command accepts. Mutually exclusive options are expected to be in the form [-q | --progress |

Re: [RFC] Documentation: --options in man-pages synopsys

2013-10-09 Thread Jeff King
On Wed, Oct 09, 2013 at 11:35:19PM +0100, Philip Oakley wrote: As a unix user I'd expect the SYNOPSIS section at the top of the man page to include all options that the command accepts. Mutually exclusive options are expected to be in the form [-q | --progress | --all-progress], such is

RE: [RFC] Documentation: --options in man-pages synopsys

2013-10-08 Thread Loyall, David
As a unix user I'd expect the SYNOPSIS section at the top of the man page to include all options that the command accepts. Mutually exclusive options are expected to be in the form [-q | --progress | --all-progress], such is already done. I believe that you'd be safe in following