From nobody Mon Nov 27 15:25:29 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Sf8Y561THz52q70 for ; Mon, 27 Nov 2023 15:25:29 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Sf8Y55bZzz4N57; Mon, 27 Nov 2023 15:25:29 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1701098729; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=q8laUvl4vbMVODjNfdA1m/f2p27dEfBo1T3HGpYjJvw=; b=WovVj3i5+h1eE7MEZgMCJcVRKvpiFag9mmrNRYfYlqSME+JXCkkFtUyhhHq+p6oEXQu1d8 aBYpDmsY39Q7Ohar+nrNUL2EYYaNyMIz4j6shsw8i1oKXXarV7X9oHD/lQU68SDf7itLny ZVq/0R9wZOc1N+Bg67xSujxVJ7y6bWQ87a9DBFpmfirWT18rsZBmIzOGOoFOT4FoFfPhd9 1gKPOq/rZpxUiFA7QxBrblXKNrjVMaLlj2Ql+tf/gqcfQUKL0XtqAD3Gy/Jw6y+AEL/ZY5 r/vvQ9cuqG/a6M+tCEYpCUPc2EtTe0/npF0qqxb2ZyF9JCPNO/pYa4GCCuQFzw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1701098729; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=q8laUvl4vbMVODjNfdA1m/f2p27dEfBo1T3HGpYjJvw=; b=Skumpuk1hzAljr9z9jLtKj3+ZEVtKI8k+cFo7m6vnWWG3tcCFsGAdx6BXre35rzQfJFHt9 bs2Lv7spuJjhXk1lUczYibRT8KSGDqgSbLwDPASZvFdIdqJk84gvtltsy6dmQ75XgvnCx9 HqjzD/iQm0HVvKVy0MMzKM58Sf8uX4KyVo6sjMv6JJlsRZ2zUXbuJLSNPSErXlHEVh81vk h4tnvl7yDDncVEqRJKMV6BxlJxh05HdjcdRoBiW/9e2g4dKmAbmCjIh1H9zK7bpGWB/FYY CZRQ1HpNpwfpk/rOTXa+NWhbBiq+dmdbzqvmrdCiALcOnLflkyYTdWooMzfauw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1701098729; a=rsa-sha256; cv=none; b=vNR93rPYf00Oj1JoY54jMUUG5Ox6E4KYFvWCDa8UnXkEOIGBh1DEWwTiOOqnezGlzzOe1t rlmdbcMJjaxkctd6FWgs64rWuVWGfxGV4zp/VZ9xS+3yfslpqwKdnnKv/BTMaQL4H9n5/W zK3MkvIxd0jOaSn8gi6Xlo4iomGNPP/MnAKfB/wBD0KaNqoV83A1S8t/OpLkVit2w6OPDv R8u4AZK4cRx0xgmByXWDnQofwQ9dPFz/khZVGiYYPlTvVJjo/vsFWIuyXC9GQ2aPx9KV4v a6bNbQh1izBB252o0Haq9KOV01QMDTBPlBU2pcTT7z7P9XR8RzuhJ7inCs9zhQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Sf8Y54jHlzkXS; Mon, 27 Nov 2023 15:25:29 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 3ARFPTRO097102; Mon, 27 Nov 2023 15:25:29 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 3ARFPTYH097099; Mon, 27 Nov 2023 15:25:29 GMT (envelope-from git) Date: Mon, 27 Nov 2023 15:25:29 GMT Message-Id: <202311271525.3ARFPTYH097099@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Mitchell Horne Subject: git: 774caa9f46 - main - x86-assembly: Fix link to GNU assembler List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: mhorne X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 774caa9f467665c4fb424e0372f2c797de716a94 Auto-Submitted: auto-generated The branch main has been updated by mhorne: URL: https://cgit.FreeBSD.org/doc/commit/?id=774caa9f467665c4fb424e0372f2c797de716a94 commit 774caa9f467665c4fb424e0372f2c797de716a94 Author: Minsoo Choo AuthorDate: 2023-11-27 15:08:05 +0000 Commit: Mitchell Horne 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.