From nobody Wed Jan 8 19:25:30 2025 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 4YSyYl0BTbz5jmrt for ; Wed, 08 Jan 2025 19:25:31 +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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4YSyYk6H7Lz4LPp; Wed, 8 Jan 2025 19:25:30 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1736364330; 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=DaQcCDFTfRh5iCeb8ZD/IotGEPxSUH3TLtbqnLyXWBs=; b=hQTNOlIvZb6ztvSwZPwj/NOoui/dtjrS3zLevI5ijVAuxUMUyANw8mEW6brFzP6AFnlpX7 z8I1w4BJU453PLrQhDMDqBgPMgyaBi/NHZmzjf4xrBXi15koAt0IjAp/uNcrUyfaO2/sz+ I5bcXeTjqZCUOiRgjUgb7zz+ueQN6amCKVfzw/rBK4/kUDrzcG356jqyhlXDbsI0BZQI6y nQ/hRXLLoLuBhAzRxmhXGdx76pz/aTwqyb5dFt2hpSq1Q8OLyMdkWTli+rgLTlMClz0TEt 72ucDik5cEMSO25m4dYo5R21yscUxrv6IS+KdEugvMI7gMxEYD3TCgmU2t/PYQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1736364330; 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=DaQcCDFTfRh5iCeb8ZD/IotGEPxSUH3TLtbqnLyXWBs=; b=Wugyoa4yzYP9QfdLFkfjblWEE2nGZ2K8Y7DJ8/rHCkB3xeX5fi5nTHz7NbWiX38w4y5vtb i0xNUGUFQghUnoWFTg+OgdYizUqc7rXRzKuMVppUQ1k5Iof86geuiR7DWGVLtLePMuTO6A AmiuoV4Imwb8C1mM4eFZ8Qg/hQ6R6Pyt8lASbt3L+FRgFXkdRctu7Y/PkvnQsjOoeFsMCr lBioE94r8optAgA82pGQeh++qJetE2cxbZYh8jVvRwWYHO9Ir3beGEo3WVmwTckRDvOhKL YKgHwTF9/poLFwcuMOTxe4MCILwjYfm6A5gcc84Al21PJwIgfPK4BomNI36gUA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1736364330; a=rsa-sha256; cv=none; b=ametanFUYK1gaJo+CfN8n39gEglbRZSgzUwBRzp1MJUTkFlbHYVdpUmraeBgDJMa2AFWDn yRcnOOD4Fpba+/1kbNw5sQHi2iF2ySMjUW2GV7wnax0b/VJdTNPSMwjcQpGOW2AADSrmRH 94N5N4nOlISXEyFdS8qLk1hDNepwTlpAygJ1yZKPyh8eLZHYh4eqCivq8SgO1gJH+xQ7i6 uTt/8kkpWfaB/ZXx6AOgxO+4ZM42q6J68raA3dh4Ji0rBksFgTQNRz1X14drX3eeZQ0hp4 XvtG2TcxixCQ/NHYybM0FxdM7z7dFItAxDHXP+p3VYROtTg5VqK6AiHjf+WWZg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4YSyYk5WmFz17rr; Wed, 08 Jan 2025 19:25:30 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 508JPU8h055845; Wed, 8 Jan 2025 19:25:30 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 508JPUr2055842; Wed, 8 Jan 2025 19:25:30 GMT (envelope-from git) Date: Wed, 8 Jan 2025 19:25:30 GMT Message-Id: <202501081925.508JPUr2055842@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 2a7167a53c - main - Handbook: Preface - Upgrade Fourth Edition section 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: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2a7167a53ce1bf89a28fc3e197e6fc80f87a304c Auto-Submitted: auto-generated The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=2a7167a53ce1bf89a28fc3e197e6fc80f87a304c commit 2a7167a53ce1bf89a28fc3e197e6fc80f87a304c Author: Sergio Carlavilla Delgado AuthorDate: 2025-01-08 19:20:45 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2025-01-08 19:20:45 +0000 Handbook: Preface - Upgrade Fourth Edition section The preface section has been updated to incorporate the latest changes made by the Handbook Working Group in preparation for the 4th edition of the Handbook. Thanks to: * arrowd@ * bapt@ * bcr@ * dbaio@ * emaste@ * fernape@ * jrm@ * karels@ * manu@ * mckusick@ * philip@ * The FreeBSD Foundation Special thanks to karels@, whose contributions and influence will be remembered. Sponsored by: Siracusa --- .../content/en/books/handbook/preface/_index.adoc | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/handbook/preface/_index.adoc b/documentation/content/en/books/handbook/preface/_index.adoc index 23f4cd2c19..ef6b26b203 100644 --- a/documentation/content/en/books/handbook/preface/_index.adoc +++ b/documentation/content/en/books/handbook/preface/_index.adoc @@ -63,10 +63,22 @@ These are the major updates since the fourth edition of the Handbook. * The Handbook has been converted from link:https://docbook.org/[Docbook] to link:https://gohugo.io/[Hugo] and link:https://asciidoctor.org/[AsciiDoctor] * The link:https://docs.FreeBSD.org[FreeBSD Documentation Portal] has been created. -* crossref:wayland[wayland,Wayland] has been added with information about installing and configuring Wayland under FreeBSD. +* The crossref:introduction[introduction, Introduction] chapter has been updated to improve the FreeBSD history and fix minor typos. +* The crossref:bsdinstall[bsdinstall, Install] chapter has been updated with an upgraded synopsis, the latest changes to the installer, refreshed images, added alt text to images, and the removal of references to specific versions. +* The crossref:basics[basics, Basics] chapter has updated tables, command outputs, and directory structure per man:hier. +* The crossref:ports[ports, Ports] chapter has been updated and now simplifies package searches, updates software examples (Nginx replaces Apache), improves the man:pkg[8] bootstrap process, and adds new instructions for configuring and managing packages, including blocking and unblocking. +* The crossref:x11[x11, X11] chapter has been updated to reflect the current state of graphics in FreeBSD, remove outdated references to old Intel drivers, configurations, and compiz, and relocate desktop environment instructions (such as KDE Plasma and GNOME) to the Desktop Environments chapter, as these environments now also support Wayland in addition to X11. +* The crossref:wayland[wayland,Wayland] chapter has been added with information about installing and configuring Wayland under FreeBSD. +* The crossref:network[network, Network] chapter has been created to cover basic wired and wireless network configuration, including hostname, DNS, and troubleshooting. Sections on wired networks, wireless, and IPv6 have been moved and updated with improved command outputs, use of sysrc, and better AsciiDoc syntax. +* The crossref:desktop[desktop, Desktop] chapter has been updated with upgraded installation instructions for KDE Plasma, GNOME, XFCE, MATE, Cinnamon, and LXQT, expanded browser options, a new development tools section, and updates to office productivity, document viewers, and finance sections. +* The crossref:multimedia[multimedia, Multimedia] chapter has been reworked with updates to the sound section, new tables for sound mixers, audio players, and video players, guidance on automatic headphone switching, a new conferencing and meetings section, and a revised image scanners section. +* The crossref:linuxemu[linuxemu, Linuxemu] chapter has been improved with updated instructions for setting up a Debian/Ubuntu base system using debootstrap. +* The crossref:config[config, Config] chapter has been renamed for accuracy, with updates to service management, cron and periodic, syslog, power management, and swap sections. A new entry on config files was added, and the outdated tuning section was removed. +* The crossref:security[security, Security] chapter has been updated with enhancements to VPN over IPSec, securing accounts, password hashes, sudo/doas, and OpenSSH/OpenSSL. New sections have been added covering IDS, secure levels, file flags, Capsicum, NFSv4 ACLs, and resource limits. +* The crossref:jails[jails, Jails] chapter has been updated to include details on jail types (Thick, Thin, VNET, and Linux Jails), host system configuration, networking options, the jail configuration file, setup procedures, upgrade methods, resource limits, and different jail managers and container solutions. +* The crossref:mail[mail, Mail] chapter has been updated to include information on DMA, upgrades to Sendmail, instructions for changing DMA and Sendmail to use different MTAs, and the removal of Dialup and Fetchmail sections, along with a reorganization of the chapter. * The crossref:bibliography[bibliography,Bibliography] has been extensively updated. - [[preface-changes-from3]] == Third Edition