Update HISTORY sections by requested changes from r362809.
PR: 223520, 223521
gbe on Jul 5 2020, 7:36 AM.Authored by
I do not believe we normally document this type of information in the HISTORY section of manual pages. The history sections of these man pages are already rich with information, especially when you add the history included in the Authors section.
Sorry, I was thinking that the original text was gone; I see that it is here. It is still misleading, or at least poorly worded, to say that these commands "appeared" in FreeBSD 1.0. Essentially every command in 4.4BSD-Lite was also in FreeBSD 1.0, but we don't bother saying so; it adds no useful information. The reference to 1.0 should be deleted.
I have no objection to it, but it is still not totally factual, more than likely it was "intergrated" into FreeBSD Current/Head when it was at 12 and merged back to stable/11 and first appeared in a FreeBSD release at 11.1. I still do not see any added value to the history of mandoc by this change, and it just makes FreeBSD have a local diff to the mandoc from witch it was derived. Speaking of which, shouldn't this be on a vendor branch?
The local patch is a valid point. Recently I had a small conversation with email@example.com about the integration of this change in the upstream sources, which he refuses. So if we would integrate that change we would have to reapply it every time we update mandoc.
The original PRs 223520 and 223521 were from wosch@ who pointed out that some history was lost since he has written makewhatis some time ago.
I would like to put this again to discussion, because I don't know how much hassle local patches generate.