Bug 268928

Summary: Developers' Handbook: x86 Assembly Language Programming: The Assembler: outdated
Product: Documentation Reporter: Graham Perrin <grahamperrin>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Some People CC: carlavilla, mhorne, minsoochoo0122, pi
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://github.com/freebsd/freebsd-doc/blob/main/documentation/content/en/books/developers-handbook/x86/_index.adoc#21-the-assembler

Description Graham Perrin freebsd_committer freebsd_triage 2023-01-13 13:36:58 UTC 
<https://old.reddit.com/r/freebsd/comments/10apoa6/-/j461502/?context=2> notes that this part of the Handbook is outdated: 

<https://docs.freebsd.org/en/books/developers-handbook/x86/#x86-the-assembler>

> … Two very different assemblers are available for FreeBSD. One is as(1), 
> which uses the traditional UNIX® assembly language syntax. It comes with 
> the system. …

From <https://www.freshports.org/devel/binutils/> for GNU binary tools: 

> … a collection of binary tools. The main ones are:
> 
> * ld - the GNU linker.
> * as - the GNU assembler.
> 
> …
Comment 1 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-01-28 09:43:38 UTC 
Can you please provide a patch Graham?
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2023-01-29 12:43:35 UTC 
(In reply to Sergio Carlavilla Delgado from comment #1)

Better for a developer to write (or rewrite), I think.
Comment 3 Minsoo Choo 2023-11-24 02:35:45 UTC 
llvm's ld has replaced gnu's ld.
llvm's as, llvm-as(1), is now in the base system. https://man.freebsd.org/cgi/man.cgi?query=llvm-as&apropos=0&sektion=1&manpath=FreeBSD+14.0-RELEASE+and+Ports&arch=default&format=html
Comment 4 Minsoo Choo 2023-11-24 02:43:08 UTC 
https://reviews.freebsd.org/D42744
Comment 5 commit-hook freebsd_committer freebsd_triage 2023-11-27 15:25:54 UTC 
A commit in branch main references this bug:

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(-)
Comment 6 Phantethon 2024-03-12 08:19:05 UTC 
MARKED AS SPAM