git: 774caa9f46 - main - x86-assembly: Fix link to GNU assembler

From: Mitchell Horne <mhorne_at_FreeBSD.org>
Date: Mon, 27 Nov 2023 15:25:29 UTC
The branch main has been updated by mhorne:

URL: https://cgit.FreeBSD.org/doc/commit/?id=774caa9f467665c4fb424e0372f2c797de716a94

commit 774caa9f467665c4fb424e0372f2c797de716a94
Author:     Minsoo Choo <minsoochoo0122@proton.me>
AuthorDate: 2023-11-27 15:08:05 +0000
Commit:     Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2023-11-27 15:19:33 +0000

    x86-assembly: Fix link to GNU assembler
    
    FreeBSD does not include GNU assembler in its base system, so link to
    the devel/binutils package. Also mention llvm-as(1).
    
    PR:             268928
    Reviewed by:    mhorne
    Differential Revision: https://reviews.freebsd.org/D42744
---
 .../content/en/books/developers-handbook/x86/_index.adoc         | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/documentation/content/en/books/developers-handbook/x86/_index.adoc b/documentation/content/en/books/developers-handbook/x86/_index.adoc
index 760493117e..697378e9b5 100644
--- a/documentation/content/en/books/developers-handbook/x86/_index.adoc
+++ b/documentation/content/en/books/developers-handbook/x86/_index.adoc
@@ -79,14 +79,11 @@ Copyright (R) 2000-2001 G. Adam Stanislav. All rights reserved.
 
 The most important tool for assembly language programming is the assembler, the software that converts assembly language code into machine language.
 
-Two very different assemblers are available for FreeBSD.
-One is  man:as[1], which uses the traditional UNIX(R) assembly language syntax.
-It comes with the system.
+Three very different assemblers are available for FreeBSD.
+Both man:llvm-as[1] (included in package:devel/llvm[]) and man:as[1] (included in package:devel/binutils[]) use the traditional UNIX(R) assembly language syntax.
 
-The other is /usr/ports/devel/nasm.
-It uses the Intel syntax.
+On the other hand, man:nasm[1] (installed through package:devel/nasm[]) uses the Intel syntax.
 Its main advantage is that it can assemble code for many operating systems.
-It needs to be installed separately, but is completely free.
 
 This chapter uses nasm syntax because most assembly language programmers coming to FreeBSD from other operating systems will find it easier to understand.
 And, because, quite frankly, that is what I am used to.