diff options
Diffstat (limited to 'documentation/content/en/books/handbook/preface/_index.adoc')
| -rw-r--r-- | documentation/content/en/books/handbook/preface/_index.adoc | 56 |
1 files changed, 45 insertions, 11 deletions
diff --git a/documentation/content/en/books/handbook/preface/_index.adoc b/documentation/content/en/books/handbook/preface/_index.adoc index 07a2ad9a5d..b25f3960d8 100644 --- a/documentation/content/en/books/handbook/preface/_index.adoc +++ b/documentation/content/en/books/handbook/preface/_index.adoc @@ -6,7 +6,8 @@ description: The FreeBSD newcomer will find that the first section of this book tags: ["preface", "audience", "organization", "conventions", "acknowledgments"] showBookMenu: true weight: 1 -path: "/books/handbook/" +params: + path: "/books/handbook/preface/" --- [preface] @@ -55,21 +56,45 @@ Some of these chapters may recommend that you do some prior reading, and this is For a list of additional sources of information, please see crossref:bibliography[bibliography,Bibliography]. +[[preface-changes-from4]] +== Fourth Edition + +The current version of the Handbook represents the cumulative effort of a working group that has been reviewing and updating all Handbook content. +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. +* 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]] -== Changes from the Third Edition +== Third Edition The current online version of the Handbook represents the cumulative effort of many hundreds of contributors over the past 10 years. The following are some of the significant changes since the two volume third edition was published in 2004: * crossref:wine[wine,WINE] has been added with information about how to run Windows(R) applications on FreeBSD. * crossref:dtrace[dtrace,DTrace] has been added with information about the powerful DTrace performance analysis tool. -* crossref:filesystems[filesystems,Other File Systems] has been added with information about non-native file systems in FreeBSD, such as ZFS from Sun(TM). +* crossref:filesystems[filesystems,Other File Systems] have been added with information about non-native file systems in FreeBSD, such as ZFS from Sun(TM). * crossref:audit[audit,Security Event Auditing] has been added to cover the new auditing capabilities in FreeBSD and explain its use. * crossref:virtualization[virtualization,Virtualization] has been added with information about installing FreeBSD on virtualization software. * crossref:bsdinstall[bsdinstall,Installing FreeBSD] has been added to cover installation of FreeBSD using the new installation utility, bsdinstall. [[preface-changes-from2]] -== Changes from the Second Edition (2004) +== Second Edition (2004) The third edition was the culmination of over two years of work by the dedicated members of the FreeBSD Documentation Project. The printed edition grew to such a size that it was necessary to publish as two separate volumes. @@ -87,7 +112,7 @@ The following are the major changes in this new edition: * A number of aesthetic improvements have been made to the tables and figures throughout the book. [[preface-changes]] -== Changes from the First Edition (2001) +== First Edition (2001) The second edition was the culmination of over two years of work by the dedicated members of the FreeBSD Documentation Project. The following were the major changes in this edition: @@ -140,6 +165,9 @@ Covers the installation of third-party software with both FreeBSD's innovative " _crossref:x11[x11,The X Window System]_:: Describes the X Window System in general and using X11 on FreeBSD in particular. Also describes common desktop environments such as KDE and GNOME. +_crossref:wayland[wayland,Wayland]_:: +Describes the Wayland display server in general and using Wayland on FreeBSD in particular. Also describes common compositors such as Wayfire, Hikari and Sway. + _crossref:desktop[desktop,Desktop Applications]_:: Lists some common desktop applications, such as web browsers and productivity suites, and describes how to install them on FreeBSD. @@ -155,6 +183,9 @@ Describes managing printers on FreeBSD, including information about banner pages _crossref:linuxemu[linuxemu,Linux® Binary Compatibility]_:: Describes the Linux(R) compatibility features of FreeBSD. Also provides detailed installation instructions for many popular Linux(R) applications such as Oracle(R) and Mathematica(R). +_crossref:wine[wine,WINE]_:: +Describes WINE and provides detailed installation instructions. Also describes how WINE operates, how to install a GUI helper, how to run Windows(R) applications on FreeBSD, and offers other tips and solutions. + _crossref:config[config-tuning,Configuration and Tuning]_:: Describes the parameters available for system administrators to tune a FreeBSD system for optimum performance. Also describes the various configuration files used in FreeBSD and where to find them. @@ -179,8 +210,11 @@ Describes how to manage storage media and filesystems with FreeBSD. This include _crossref:geom[geom,GEOM: Modular Disk Transformation Framework]_:: Describes what the GEOM framework in FreeBSD is and how to configure various supported RAID levels. +_crossref:zfs[zfs,The OpenZFS storage platform]_:: +Describes the OpenZFS storage platform and provides a quick-start guide and information about advanced topics running OpenZFS under FreeBSD. + _crossref:filesystems[filesystems,Other File Systems]_:: -Examines support of non-native file systems in FreeBSD, like the Z File System from Sun(TM). +Examines support for non-native file systems under FreeBSD like ext2, ext3 and ext4. _crossref:virtualization[virtualization,Virtualization]_:: Describes what virtualization systems offer, and how they can be used with FreeBSD. @@ -192,13 +226,13 @@ _crossref:cutting-edge[updating-upgrading,Updating and Upgrading FreeBSD]_:: Explains the differences between FreeBSD-STABLE, FreeBSD-CURRENT, and FreeBSD releases. Describes which users would benefit from tracking a development system and outlines that process. Covers the methods users may take to update their system to the latest security release. _crossref:dtrace[dtrace,DTrace]_:: -Describes how to configure and use the DTrace tool from Sun(TM) in FreeBSD. Dynamic tracing can help locate performance issues, by performing real time system analysis. +Describes how to configure and use the DTrace tool from Sun(TM) on FreeBSD. Dynamic tracing can help locate performance issues, by performing real time system analysis. -_crossref:serialcomms[serialcomms,Serial Communications]_:: -Explains how to connect terminals and modems to your FreeBSD system for both dial in and dial out connections. +_crossref:usb-device-mode[usb-device-mode,USB Device Mode / USB OTG]_:: +Explains the use of USB Device Mode and USB On The Go (USB OTG) on FreeBSD. _crossref:ppp-and-slip[ppp-and-slip,PPP]_:: -Describes how to use PPP to connect to remote systems with FreeBSD. +Describes how to use PPP to connect to remote systems in FreeBSD. _crossref:mail[mail,Electronic Mail]_:: Explains the different components of an email server and dives into simple configuration topics for the most popular mail server software: sendmail. @@ -238,7 +272,7 @@ An _italic_ font is used for filenames, URLs, emphasized text, and the first usa `Monospace`:: A `monospaced` font is used for error messages, commands, environment variables, names of ports, hostnames, user names, group names, device names, variables, and code fragments. -Bold:: +*Bold*:: A *bold* font is used for applications, commands, and keys. [[preface-conv-commands]] |