Page MenuHomeFreeBSD

sysconf: Remove visual line-break after .Dd in man-pages (ziaee)
AcceptedPublic

Authored by dteske on Wed, Sep 16, 10:05 PM.
Tags
None
Referenced Files
F172227776: D59746.diff
Thu, Sep 17, 1:16 AM
F172227417: D59746.id186923.diff
Thu, Sep 17, 1:10 AM
F172220267: D59746.diff
Wed, Sep 16, 11:29 PM
F172219308: D59746.id186923.diff
Wed, Sep 16, 11:14 PM
Subscribers

Details

Reviewers
ziaee
kfv

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 77004
Build 73887: arc lint + arc unit

Event Timeline

Since it doesn't do anything, it is not necessary to remove them. However, since it doesn't do anything, it is kinda nice to remove them. To clarify, I was not asking you to remove them, I was just asking where you got the idea to do this because I have never seen anyone do this. Usually weird undocumented stuff comes from copying other files, so that's what I was wondering.

This revision is now accepted and ready to land.Thu, Sep 17, 2:33 PM

Since it doesn't do anything, it is not necessary to remove them. However, since it doesn't do anything, it is kinda nice to remove them. To clarify, I was not asking you to remove them, I was just asking where you got the idea to do this because I have never seen anyone do this. Usually weird undocumented stuff comes from copying other files, so that's what I was wondering.

Oh, it occurred to me to introduce a blaring eye-sore to highlight .Dd so it gets bumped, because in the past I have been guilty of straight-up forgetting to bump .Dd (so often so, that I was often reminded that I forgot).

It became so common because I so infrequently updated man-pages that I somehow got it into my head that every single change in any way deserved a golden rule of ALWAYS BUMP .Dd — which I learned from you and imp yesterday that there is a more refined logic to apply.

The visual separator started as a .\” but I didn’t like how that did a kind of encapsulation kinda thing sandwiching .Dd between comments above and a nothing-burger comment below.

So, I started playing. I started looking for things that had no effect that could fill the line. Then I remembered that you could split a long macroized line with backslash and I decided to see if that could work, and wammo!

The one-byte line-fill visual separator was born.