Re: svn commit: r358891 - head/share/man/man5

2020-03-11 Thread Ed Maste
On Wed, 11 Mar 2020 at 16:42, Ian Lepore  wrote:
>
> Well, my point is that it looked better because there were 3 extra
> spaces, so you can get that spacing by adding 3 extra chars to the
> column headings in the .Bl line.  They don't have be "Sy " at the
> front, I think just spaces at the end of each heading (inside the
> quotes) would do it.

Oh, good point - thanks. Intentional extra space to improve the
rendered output would be better than an unintended side effect, but
anyhow I think it's not worth changing it again.
___
svn-src-all@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"


Re: svn commit: r358891 - head/share/man/man5

2020-03-11 Thread Ian Lepore
On Wed, 2020-03-11 at 16:37 -0400, Ed Maste wrote:
> On Wed, 11 Mar 2020 at 16:27, Ian Lepore  wrote:
> > 
> > With, there are 3 extra spaces.  "Sy ".
> 
> Right, I mean the extraneous Sy had the side effect of improving (in
> my opinion) the rendered table. Anyhow, they're removed now.

Well, my point is that it looked better because there were 3 extra
spaces, so you can get that spacing by adding 3 extra chars to the
column headings in the .Bl line.  They don't have be "Sy " at the
front, I think just spaces at the end of each heading (inside the
quotes) would do it.

-- Ian

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


Re: svn commit: r358891 - head/share/man/man5

2020-03-11 Thread Ed Maste
On Wed, 11 Mar 2020 at 16:27, Ian Lepore  wrote:
>
> With, there are 3 extra spaces.  "Sy ".

Right, I mean the extraneous Sy had the side effect of improving (in
my opinion) the rendered table. Anyhow, they're removed now.
___
svn-src-all@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"


Re: svn commit: r358891 - head/share/man/man5

2020-03-11 Thread Ian Lepore
On Wed, 2020-03-11 at 16:01 -0400, Ed Maste wrote:
> On Wed, 11 Mar 2020 at 15:07, Mateusz Piotrowski <0...@freebsd.org>
> wrote:
> > 
> > Hi,
> > 
> > On 3/11/20 7:15 PM, Ed Maste wrote:
> > > Author: emaste
> > > Date: Wed Mar 11 18:15:18 2020
> > > New Revision: 358891
> > > URL: https://svnweb.freebsd.org/changeset/base/358891
> > > 
> > > Log:
> > >elf.5: start documenting ELF note sections
> > 
> > ...
> > > Modified: head/share/man/man5/elf.5
> > > =
> > > =
> > > --- head/share/man/man5/elf.5 Wed Mar 11 15:12:31
> > > 2020(r358890)
> > > +++ head/share/man/man5/elf.5 Wed Mar 11 18:15:18
> > > 2020(r358891)
> > > @@ -24,7 +24,7 @@
> > 
> > ...
> > > +.Bl -column -offset indent "Sy Field" "Sy Size" "Sy Description"
> > 
> > The "Sy" macros can be dropped from those strings specifying the
> > width
> > of columns. They are not expanded there anyway.
> 
> Interesting, thanks for the note. I probably copied them from arch.7,
> so it might need similar treatment.
> 
> They did have a side-effect of putting more space between columns
> though; with extra Sy:
> 
>Field   Size   Description
>namesz  32 bitsSize of name
>descsz  32 bitsSize of desc
>type32 bitsOS-dependent note type
>namenamesz Null-terminated originator name
>descdescsz OS-dependent note data
> 
> Without:
> 
>FieldSizeDescription
>namesz   32 bits Size of name
>descsz   32 bits Size of desc
>type 32 bits OS-dependent note type
>name namesz  Null-terminated originator name
>desc descsz  OS-dependent note data

With, there are 3 extra spaces.  "Sy ".

-- Ian

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


Re: svn commit: r358891 - head/share/man/man5

2020-03-11 Thread Ed Maste
On Wed, 11 Mar 2020 at 15:07, Mateusz Piotrowski <0...@freebsd.org> wrote:
>
> Hi,
>
> On 3/11/20 7:15 PM, Ed Maste wrote:
> > Author: emaste
> > Date: Wed Mar 11 18:15:18 2020
> > New Revision: 358891
> > URL: https://svnweb.freebsd.org/changeset/base/358891
> >
> > Log:
> >elf.5: start documenting ELF note sections
> ...
> > Modified: head/share/man/man5/elf.5
> > ==
> > --- head/share/man/man5/elf.5 Wed Mar 11 15:12:31 2020(r358890)
> > +++ head/share/man/man5/elf.5 Wed Mar 11 18:15:18 2020(r358891)
> > @@ -24,7 +24,7 @@
> ...
> > +.Bl -column -offset indent "Sy Field" "Sy Size" "Sy Description"
>
> The "Sy" macros can be dropped from those strings specifying the width
> of columns. They are not expanded there anyway.

Interesting, thanks for the note. I probably copied them from arch.7,
so it might need similar treatment.

They did have a side-effect of putting more space between columns
though; with extra Sy:

   Field   Size   Description
   namesz  32 bitsSize of name
   descsz  32 bitsSize of desc
   type32 bitsOS-dependent note type
   namenamesz Null-terminated originator name
   descdescsz OS-dependent note data

Without:

   FieldSizeDescription
   namesz   32 bits Size of name
   descsz   32 bits Size of desc
   type 32 bits OS-dependent note type
   name namesz  Null-terminated originator name
   desc descsz  OS-dependent note data
___
svn-src-all@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"


Re: svn commit: r358891 - head/share/man/man5

2020-03-11 Thread Mateusz Piotrowski

Hi,

On 3/11/20 7:15 PM, Ed Maste wrote:

Author: emaste
Date: Wed Mar 11 18:15:18 2020
New Revision: 358891
URL: https://svnweb.freebsd.org/changeset/base/358891

Log:
   elf.5: start documenting ELF note sections

...

Modified: head/share/man/man5/elf.5
==
--- head/share/man/man5/elf.5   Wed Mar 11 15:12:31 2020(r358890)
+++ head/share/man/man5/elf.5   Wed Mar 11 18:15:18 2020(r358891)
@@ -24,7 +24,7 @@

...

+.Bl -column -offset indent "Sy Field" "Sy Size" "Sy Description"


The "Sy" macros can be dropped from those strings specifying the width 
of columns. They are not expanded there anyway.


Cheers,

Mateusz Piotrowski


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