as: add deprecation notice to the man page

In the future FreeBSD will ship without GNU binutils 2.17.50.  Add a
note advising users who require GNU as to install the binutils port
or package.

Note that on armv7, arm64, amd64, i386 we currently ship only two
binutils tools (as and objdump).  A deprecation notice was added to
objdump's man page some time ago.

PR:		233611
Discussed with:	jhb
MFC after:	1 week
Relnotes:	Yes
Sponsored by:	The FreeBSD Foundation
This commit is contained in:
Ed Maste 2019-08-01 19:01:27 +00:00
parent 1033464925
commit 7959685201
2 changed files with 7 additions and 0 deletions

View File

@ -1295,6 +1295,9 @@ computer-readable series of instructions. Different versions of
@section The GNU Assembler
@c man begin DESCRIPTION
@sc{gnu} @command{as} will be removed from a future version of the
FreeBSD base system. Users who require
@sc{gnu} @command{as} are advised to install the binutils port or package.
@sc{gnu} @command{as} is really a family of assemblers.
@ifclear GENERIC

View File

@ -293,6 +293,10 @@ as [\fB\-a\fR[\fBcdhlns\fR][=\fIfile\fR]] [\fB\-\-alternate\fR] [\fB\-D\fR]
[\fB\-\-rename\-section\fR \fIoldname\fR=\fInewname\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\s-1GNU\s0 \fBas\fR will be removed from a future version of the
FreeBSD base system. Users who require
\&\s-1GNU\s0 \fBas\fR are advised to install the binutils port or package.
.PP
\&\s-1GNU\s0 \fBas\fR is really a family of assemblers.
If you use (or have used) the \s-1GNU\s0 assembler on one architecture, you
should find a fairly similar environment when you use it on another