svn commit: r295169 - head/usr.sbin/sysrc

[Devin Teske]

Author: dteske
Date: Tue Feb  2 21:58:17 2016
New Revision: 295169
URL: https://svnweb.freebsd.org/changeset/base/295169

Log:
  Replace (Qo \  Qc) with (Qo (space) Qc)
  
  When using col(1) piped to vim(1) as pager for man(1), the former sequence
  of (Qo \  Qc) renders as "" without the space. Replace with (Qo (space) Qc)
  which renders properly in more (all?) pagers.

Modified:
  head/usr.sbin/sysrc/sysrc.8

Modified: head/usr.sbin/sysrc/sysrc.8
==
--- head/usr.sbin/sysrc/sysrc.8 Tue Feb  2 21:17:25 2016(r295168)
+++ head/usr.sbin/sysrc/sysrc.8 Tue Feb  2 21:58:17 2016(r295169)
@@ -1,4 +1,4 @@
-.\" Copyright (c) 2011-2015 Devin Teske
+.\" Copyright (c) 2011-2016 Devin Teske
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd September 12, 2015
+.Dd February 2, 2016
 .Dt SYSRC 8
 .Os
 .Sh NAME
@@ -255,7 +255,7 @@ When using the
 .Ql key+=value
 syntax to add items to existing values,
 the first character of the value is taken as the delimiter separating items
-.Pq usually Qo \  Qc or Qo , Qc .
+.Pq usually Qo (space) Qc or Qo , Qc .
 For example, in the following statement:
 .Bl -item -offset indent
 .It
___
svn-src-head@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-head
To unsubscribe, send any mail to "svn-src-head-unsubscr...@freebsd.org"

Re: svn commit: r295169 - head/usr.sbin/sysrc

[Benjamin Kaduk]

On Tue, Feb 2, 2016 at 3:58 PM, Devin Teske  wrote:

> Author: dteske
> Date: Tue Feb  2 21:58:17 2016
> New Revision: 295169
> URL: https://svnweb.freebsd.org/changeset/base/295169
>
> Log:
>   Replace (Qo \  Qc) with (Qo (space) Qc)
>
>   When using col(1) piped to vim(1) as pager for man(1), the former
> sequence
>   of (Qo \  Qc) renders as "" without the space. Replace with (Qo (space)
> Qc)
>   which renders properly in more (all?) pagers.
>

mdoc(7) also suggests using double-quotes (" ") to escape literal spaces;
did you try that?

-Ben
___
svn-src-head@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-head
To unsubscribe, send any mail to "svn-src-head-unsubscr...@freebsd.org"

Re: svn commit: r295169 - head/usr.sbin/sysrc

[Devin Teske]

On Tue, 2016-02-02 at 16:03 -0600, Benjamin Kaduk wrote:
> On Tue, Feb 2, 2016 at 3:58 PM, Devin Teske 
> wrote:
> > Author: dteske
> > Date: Tue Feb  2 21:58:17 2016
> > New Revision: 295169
> > URL: https://svnweb.freebsd.org/changeset/base/295169
> > 
> > Log:
> >   Replace (Qo \  Qc) with (Qo (space) Qc)
> > 
> >   When using col(1) piped to vim(1) as pager for man(1), the former
> > sequence
> >   of (Qo \  Qc) renders as "" without the space. Replace with (Qo
> > (space) Qc)
> >   which renders properly in more (all?) pagers.
> mdoc(7) also suggests using double-quotes (" ") to escape literal
> spaces; did you try that?
Did not try -- tried just now and it works. Will update with a commit.
However... /me opens "man mdoc"
(20 minutes later; confused as to where)
I've read mdoc(7) several times and have never seen such a
clarification.
(which I might add; would be mighty useful if you can find it)
-- 
Devin
___
svn-src-head@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-head
To unsubscribe, send any mail to "svn-src-head-unsubscr...@freebsd.org"

Re: svn commit: r295169 - head/usr.sbin/sysrc

[Baptiste Daroussin]

On Tue, Feb 02, 2016 at 03:50:45PM -0800, Devin Teske wrote:
> On Tue, 2016-02-02 at 16:03 -0600, Benjamin Kaduk wrote:
> > On Tue, Feb 2, 2016 at 3:58 PM, Devin Teske 
> > wrote:
> > > Author: dteske
> > > Date: Tue Feb  2 21:58:17 2016
> > > New Revision: 295169
> > > URL: https://svnweb.freebsd.org/changeset/base/295169
> > > 
> > > Log:
> > >   Replace (Qo \  Qc) with (Qo (space) Qc)
> > > 
> > >   When using col(1) piped to vim(1) as pager for man(1), the former
> > > sequence
> > >   of (Qo \  Qc) renders as "" without the space. Replace with (Qo
> > > (space) Qc)
> > >   which renders properly in more (all?) pagers.
> > mdoc(7) also suggests using double-quotes (" ") to escape literal
> > spaces; did you try that?
> Did not try -- tried just now and it works. Will update with a commit.
> However... /me opens "man mdoc"
> (20 minutes later; confused as to where)
> I've read mdoc(7) several times and have never seen such a
> clarification.
> (which I might add; would be mighty useful if you can find it)

If one updates mdoc man page please upstream the change first!

Best regards,
Bapt


signature.asc
Description: PGP signature

Re: svn commit: r295169 - head/usr.sbin/sysrc

[Benjamin Kaduk]

On Tue, Feb 2, 2016 at 5:50 PM, Devin Teske  wrote:

> On Tue, 2016-02-02 at 16:03 -0600, Benjamin Kaduk wrote:
>
> On Tue, Feb 2, 2016 at 3:58 PM, Devin Teske  wrote:
>
> Author: dteske
> Date: Tue Feb  2 21:58:17 2016
> New Revision: 295169
> URL: https://svnweb.freebsd.org/changeset/base/295169
>
> Log:
>   Replace (Qo \  Qc) with (Qo (space) Qc)
>
>   When using col(1) piped to vim(1) as pager for man(1), the former
> sequence
>   of (Qo \  Qc) renders as "" without the space. Replace with (Qo (space)
> Qc)
>   which renders properly in more (all?) pagers.
>
>
> mdoc(7) also suggests using double-quotes (" ") to escape literal spaces;
> did you try that?
>
>
> Did not try -- tried just now and it works. Will update with a commit.
>
> However... /me opens "man mdoc"
> (20 minutes later; confused as to where)
>
> I've read mdoc(7) several times and have never seen such a clarification.
> (which I might add; would be mighty useful if you can find it)
>
>
The shame is on me; I had opened the system mdoc(7) on OS X, which is
actually groff_mdoc(7).  There is a subsection therein "Passing Space
Characters in an Argument" which has the text in question.  I guess I need
to spend more time with the mdocml mdoc(7) to get used to what it contains
(and does not contain).

Sorry for sending you down the wrong rabbit hole...

-Ben
___
svn-src-head@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-head
To unsubscribe, send any mail to "svn-src-head-unsubscr...@freebsd.org"

Re: svn commit: r295169 - head/usr.sbin/sysrc

[Devin Teske]

On Tue, 2016-02-02 at 21:40 -0600, Benjamin Kaduk wrote:
> On Tue, Feb 2, 2016 at 5:50 PM, Devin Teske 
> wrote:
> > On Tue, 2016-02-02 at 16:03 -0600, Benjamin Kaduk wrote:
> > > On Tue, Feb 2, 2016 at 3:58 PM, Devin Teske 
> > > wrote:
> > > > Author: dteske
> > > > Date: Tue Feb  2 21:58:17 2016
> > > > New Revision: 295169
> > > > URL: https://svnweb.freebsd.org/changeset/base/295169
> > > > 
> > > > Log:
> > > >   Replace (Qo \  Qc) with (Qo (space) Qc)
> > > > 
> > > >   When using col(1) piped to vim(1) as pager for man(1), the
> > > > former sequence
> > > >   of (Qo \  Qc) renders as "" without the space. Replace with
> > > > (Qo (space) Qc)
> > > >   which renders properly in more (all?) pagers.
> > > mdoc(7) also suggests using double-quotes (" ") to escape literal
> > > spaces; did you try that?
> > Did not try -- tried just now and it works. Will update with a
> > commit.
> > 
> > However... /me opens "man mdoc"
> > (20 minutes later; confused as to where)
> > 
> > I've read mdoc(7) several times and have never seen such a
> > clarification.
> > (which I might add; would be mighty useful if you can find it)
> > 
> > 
> The shame is on me; I had opened the system mdoc(7) on OS X, which is
> actually groff_mdoc(7).  There is a subsection therein "Passing Space
> Characters in an Argument" which has the text in question.  I guess I
> need to spend more time with the mdocml mdoc(7) to get used to what
> it contains (and does not contain).
> 
> Sorry for sending you down the wrong rabbit hole...
Funny thing was, your suggestion absolutely worked. Learned something
our mdoc(7) doesn't document but supports.
-- 
Devin
___
svn-src-head@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-head
To unsubscribe, send any mail to "svn-src-head-unsubscr...@freebsd.org"