usr.bin/elf2aout/elf2aout.1
49 ↗	(On Diff #67841)	`.Sh DEPRECATION NOTICE` perhaps?
52 ↗	(On Diff #67841)	"now" seems a bit surprising to me in a man page (as opposed to a release note, news article etc.), what about just `The .Nm utility is deprecated.`?

emaste accepted this revision.Feb 6 2020, 2:26 PM

emaste added a subscriber: rgrimes.

This revision is now accepted and ready to land.Feb 6 2020, 2:26 PM

imp added inline comments.Feb 6 2020, 4:07 PM

usr.bin/elf2aout/elf2aout.1
49 ↗	(On Diff #67841)	Just copied other practice that I found. A quick grep of 12 shows, however, that the other practice I found was wrong. I'll change.
52 ↗	(On Diff #67841)	Just copied other practice. This is verbatim from the vpo deprecation note which I stole from some other man page. i'll hunt down the other places that have this construct.

update, per ed's comments using brooks' wording from 10M nic removal.

This revision now requires review to proceed.Feb 6 2020, 4:26 PM

Harbormaster completed remote builds in B29212: Diff 67873.Feb 6 2020, 4:26 PM

A document describing the language and process of depreicating would be good to have.

usr.bin/elf2aout/elf2aout.1
52 ↗	(On Diff #67841)	I agree with Ed here, now should be stricken from this, and if there are other places those too.

This revision is now accepted and ready to land.Feb 6 2020, 4:26 PM

imp marked 2 inline comments as done.Feb 6 2020, 4:26 PM

imp added inline comments.

usr.bin/elf2aout/elf2aout.1
52 ↗	(On Diff #67841)	Looks like vpo was the only other place. I've fixed that in the MFC and don't see others so I now wonder where I got it...

imp added inline comments.Feb 6 2020, 4:29 PM

usr.bin/elf2aout/elf2aout.1
52 ↗	(On Diff #67841)	The only place I could find it was Note that .Va SENDMAIL_CF is now deprecated. in make.conf.5. I may have seen that in a grep or something... I'll fix that in -current too.

In D23526#516647, @rgrimes wrote:

A document describing the language and process of depreicating would be good to have.

I've just updated
https://wiki.freebsd.org/DeprecationChecklist
a bit to include the recommended language. I'd forgotten I'd created this. Some of the information in here would be good to have in the committer's guide, though.

emaste accepted this revision.Feb 6 2020, 4:46 PM

Closed by commit rS357626: Mark elf2aout as deprecated. (authored by imp). · Explain WhyFeb 6 2020, 5:52 PM

This revision was automatically updated to reflect the committed changes.

imp added a commit: rS357626: Mark elf2aout as deprecated..

Herald added a reviewer: manpages. · View Herald TranscriptFeb 6 2020, 5:52 PM