Re: mdoc(7) .Sq Fl for a dash

2013-07-16 Thread Jason McIntyre
On Tue, Jul 16, 2013 at 01:42:13PM +0200, J??r??mie Courr??ges-Anglas wrote: > > \- is afaik treated correctly in all the cases I described above, except > for a very small number of groff versions, when in an UTF-8 locale or > using ps/pdf (there you can get an unicode minus sign). This case was

Re: mdoc(7) .Sq Fl for a dash

2013-07-16 Thread Jérémie Courrèges-Anglas
Hi, Jason McIntyre writes: > On Tue, Jul 16, 2013 at 12:36:32AM +0200, Jérémie Courrèges-Anglas wrote: >> >> >> >> Fl may seem wrong because we're talking about an argument, but I don't >> >> think a bare `-' (a hyphen) would be better. We're talking about an >> >> ascii minus sign here; mando

Re: mdoc(7) .Sq Fl for a dash

2013-07-16 Thread Jason McIntyre
On Tue, Jul 16, 2013 at 09:50:14AM +0200, Jan Stary wrote: > On Jul 16 07:52:50, j...@kerhand.co.uk wrote: > > for oldrdist, i also > > used Sq instead of Dq for "-". > > It uses .Dq everywhere else. > For consistency, should we replace them all with .Sq? > no. what we tend to do is use Sq for s

Re: mdoc(7) .Sq Fl for a dash

2013-07-16 Thread Jan Stary
On Jul 16 07:52:50, j...@kerhand.co.uk wrote: > for oldrdist, i also > used Sq instead of Dq for "-". It uses .Dq everywhere else. For consistency, should we replace them all with .Sq? Index: oldrdist.1 === RCS file: /cvs/src/usr.bin

Re: mdoc(7) .Sq Fl for a dash

2013-07-15 Thread Jason McIntyre
On Tue, Jul 16, 2013 at 12:38:42AM +0200, Jan Stary wrote: > > Index: oldrdist.1 > === > RCS file: /cvs/src/usr.bin/oldrdist/oldrdist.1,v > retrieving revision 1.20 > diff -u -p -u -p -r1.20 oldrdist.1 > --- oldrdist.13 Sep 20

Re: mdoc(7) .Sq Fl for a dash

2013-07-15 Thread Jason McIntyre
On Tue, Jul 16, 2013 at 12:36:32AM +0200, J??r??mie Courr??ges-Anglas wrote: > >> > >> Fl may seem wrong because we're talking about an argument, but I don't > >> think a bare `-' (a hyphen) would be better. We're talking about an > >> ascii minus sign here; mandoc_char(7) says a minus sign can b

Re: mdoc(7) .Sq Fl for a dash

2013-07-15 Thread Jérémie Courrèges-Anglas
Jason McIntyre writes: > On Mon, Jul 15, 2013 at 11:34:53PM +0200, Jérémie Courrèges-Anglas wrote: >> Jason McIntyre writes: >> >> > On Mon, Jul 15, 2013 at 07:53:04PM +0200, Jan Stary wrote: >> >> Some of the manpages, e.g. crontab(1), >> >> markup the folklore phrase >> >> >> >> named file

Re: mdoc(7) .Sq Fl for a dash

2013-07-15 Thread Jan Stary
On Jul 15 23:24:40, j...@kerhand.co.uk wrote: > i think the previous suggestion (If the -f option is not specified) is > clearer. > > > Why cannot this be just > > .Pq Sq - > > > it should be. so roll this into your diff. Index: oldrdist.1 ===

Re: mdoc(7) .Sq Fl for a dash

2013-07-15 Thread Jason McIntyre
On Mon, Jul 15, 2013 at 11:53:38PM +0200, Jan Stary wrote: > > > > for oldrdist, "-" is actually the argument to -f. so it's not an option, > > as far as i can see. just the manual seems to blur things by documenting > > "If either the -f or `-' option is not specified", whereas above, the > > tex

Re: mdoc(7) .Sq Fl for a dash

2013-07-15 Thread Jason McIntyre
On Mon, Jul 15, 2013 at 11:34:53PM +0200, J??r??mie Courr??ges-Anglas wrote: > Jason McIntyre writes: > > > On Mon, Jul 15, 2013 at 07:53:04PM +0200, Jan Stary wrote: > >> Some of the manpages, e.g. crontab(1), > >> markup the folklore phrase > >> > >>named file, or standard input > >>if

Re: mdoc(7) .Sq Fl for a dash

2013-07-15 Thread Jan Stary
On Jul 15 21:46:21, j...@kerhand.co.uk wrote: > On Mon, Jul 15, 2013 at 07:53:04PM +0200, Jan Stary wrote: > > Some of the manpages, e.g. crontab(1), > > markup the folklore phrase > > > > named file, or standard input > > if the pseudo-filename `-' is given > > > > as > > > > named

Re: mdoc(7) .Sq Fl for a dash

2013-07-15 Thread Jérémie Courrèges-Anglas
Jason McIntyre writes: > On Mon, Jul 15, 2013 at 07:53:04PM +0200, Jan Stary wrote: >> Some of the manpages, e.g. crontab(1), >> markup the folklore phrase >> >> named file, or standard input >> if the pseudo-filename `-' is given >> >> as >> >> named file, or standard input >>

Re: mdoc(7) .Sq Fl for a dash

2013-07-15 Thread Jason McIntyre
On Mon, Jul 15, 2013 at 07:53:04PM +0200, Jan Stary wrote: > Some of the manpages, e.g. crontab(1), > markup the folklore phrase > > named file, or standard input > if the pseudo-filename `-' is given > > as > > named file, or standard input > if the pseudo-filename >

mdoc(7) .Sq Fl for a dash

2013-07-15 Thread Jan Stary
Some of the manpages, e.g. crontab(1), markup the folklore phrase named file, or standard input if the pseudo-filename `-' is given as named file, or standard input if the pseudo-filename .Sq Fl is given. Is this correct semantic markup? IMHO not: