Re: Man page that explains the file format of man pages?

2013-08-13 Thread Evan Root
Extended Backus-Naur Form! That is exactly what I was looking for Andreas. Thank you. I really didn't know what this was called or if there was a formal definition or not. Lol, the wikipedia page says that it does not have a single dialect. The IEEE standard is a good reference for quirks of the

Re: Man page that explains the file format of man pages?

2013-08-13 Thread Andres Perera
he's not talking about the source level mandoc/man macros the subject is about the SYNOPSIS section language for utilities e.g. in ``grep [ file ]'' the [ ] operator signifies 0 or 1 in ``rm file...'' the ... operator signifies 1 or more On Tue, Aug 13, 2013 at 2:58 AM, Jan Stary wrote: >> O

Re: Man page that explains the file format of man pages?

2013-08-13 Thread Jan Stary
> On Mon, Aug 12, 2013 at 9:21 PM, Anthony J. Bentley wrote: > > Evan Root writes: > > > Hello Misc, > > > I tried man 5 man for an explanation of the synopsis section of the man > > > page and it says there isn't a manual for the file format conventions of > > > manual pages. Sometimes I have dif

Re: Man page that explains the file format of man pages?

2013-08-12 Thread Andres Perera
On Mon, Aug 12, 2013 at 11:49 PM, Evan Root wrote: > I think that this post on stack exchange presents my question better.. the > answers are all pretty short and non-committal though. > http://stackoverflow.com/questions/8716047/is-there-a-specification-for-a-man-pages-synopsis-section the best

Re: Man page that explains the file format of man pages?

2013-08-12 Thread Evan Root
I don't think you understood. I am not looking to write a man page. I was just wondering if the system came with an explanation of the manual page synopsis section language syntax. Sometimes I get confused by the language and am not sure if I understand the synopsis sections of the man pages. Also

Re: Man page that explains the file format of man pages?

2013-08-12 Thread Anthony J. Bentley
Evan Root writes: > Hello Misc, > I tried man 5 man for an explanation of the synopsis section of the man > page and it says there isn't a manual for the file format conventions of > manual pages. Sometimes I have difficulty with the syntax of the synopsis > sections, is there a document I can ref