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

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

2013-10-09 Thread Philip Oakley
From: "Loyall, David" 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 | --all-progress], such is alread

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 http://pubs.