git: d102df7b72 - main - Move wayland section to its own chapter
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Wed, 02 Nov 2022 15:10:46 UTC
The branch main has been updated by carlavilla:
URL: https://cgit.FreeBSD.org/doc/commit/?id=d102df7b721c74b82720164dafa772931d179d62
commit d102df7b721c74b82720164dafa772931d179d62
Author: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2022-11-02 15:08:35 +0000
Commit: Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2022-11-02 15:08:35 +0000
Move wayland section to its own chapter
No changes, only move the content from X11 to a new chapter
Patch by: trhodes@, with some minor changes from
carlavilla@
Differential Revision: https://reviews.freebsd.org/D35099
---
.../books/handbook/advanced-networking/_index.adoc | 6 +-
.../content/en/books/handbook/audit/_index.adoc | 6 +-
.../en/books/handbook/bibliography/_index.adoc | 2 +-
documentation/content/en/books/handbook/book.adoc | 2 +
.../content/en/books/handbook/boot/_index.adoc | 6 +-
.../content/en/books/handbook/colophon.adoc | 2 +-
.../content/en/books/handbook/config/_index.adoc | 6 +-
.../en/books/handbook/cutting-edge/_index.adoc | 6 +-
.../content/en/books/handbook/desktop/_index.adoc | 6 +-
.../content/en/books/handbook/disks/_index.adoc | 6 +-
.../content/en/books/handbook/dtrace/_index.adoc | 6 +-
.../en/books/handbook/eresources/_index.adoc | 2 +-
.../en/books/handbook/filesystems/_index.adoc | 6 +-
.../en/books/handbook/firewalls/_index.adoc | 6 +-
.../content/en/books/handbook/geom/_index.adoc | 6 +-
.../content/en/books/handbook/glossary.adoc | 2 +-
.../content/en/books/handbook/jails/_index.adoc | 6 +-
.../en/books/handbook/kernelconfig/_index.adoc | 6 +-
.../content/en/books/handbook/l10n/_index.adoc | 6 +-
.../content/en/books/handbook/linuxemu/_index.adoc | 6 +-
.../content/en/books/handbook/mac/_index.adoc | 6 +-
.../content/en/books/handbook/mail/_index.adoc | 6 +-
.../content/en/books/handbook/mirrors/_index.adoc | 2 +-
.../en/books/handbook/multimedia/_index.adoc | 6 +-
.../en/books/handbook/network-servers/_index.adoc | 6 +-
.../content/en/books/handbook/partii.adoc | 4 +-
.../content/en/books/handbook/partiii.adoc | 2 +-
.../content/en/books/handbook/partiv.adoc | 2 +-
documentation/content/en/books/handbook/partv.adoc | 2 +-
.../content/en/books/handbook/pgpkeys/_index.adoc | 2 +-
.../en/books/handbook/ppp-and-slip/_index.adoc | 6 +-
.../content/en/books/handbook/printing/_index.adoc | 6 +-
.../content/en/books/handbook/security/_index.adoc | 6 +-
.../en/books/handbook/serialcomms/_index.adoc | 6 +-
.../en/books/handbook/usb-device-mode/_index.adoc | 6 +-
.../en/books/handbook/virtualization/_index.adoc | 6 +-
.../content/en/books/handbook/wayland/_index.adoc | 696 +++++++++++++++++++++
.../content/en/books/handbook/wine/_index.adoc | 6 +-
.../content/en/books/handbook/x11/_index.adoc | 640 +------------------
.../content/en/books/handbook/zfs/_index.adoc | 6 +-
40 files changed, 791 insertions(+), 731 deletions(-)
diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc
index a966aabcf8..08bc6af194 100644
--- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc
+++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 32. Advanced Networking
+title: Chapter 33. Advanced Networking
part: IV. Network Communication
prev: books/handbook/firewalls
next: books/handbook/partv
description: "Advanced networking in FreeBSD: basics of gateways and routes, CARP, how to configure multiple VLANs on FreeBSD, etc"
tags: ["Advanced Networking", "Handbook", "gateway", "routes", "wireless", "tethering", "bluetooth", "bridging", "ipv6", "CARP", "VLAN"]
showBookMenu: true
-weight: 37
+weight: 38
path: "/books/handbook/"
aliases: ["/en/books/handbook/network-routing/","/en/books/handbook/network-wireless/","/en/books/handbook/network-usb-tethering/","/en/books/handbook/network-bluetooth/","/en/books/handbook/network-bridging/","/en/books/handbook/network-aggregation/","/en/books/handbook/network-diskless/","/en/books/handbook/network-ipv6/","/en/books/handbook/carp/","/en/books/handbook/network-vlan/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/network-routing/","/en/books/handbook/network-wire
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 32
+:sectnumoffset: 33
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/audit/_index.adoc b/documentation/content/en/books/handbook/audit/_index.adoc
index 3fe0aa79d2..a0cd834008 100644
--- a/documentation/content/en/books/handbook/audit/_index.adoc
+++ b/documentation/content/en/books/handbook/audit/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 17. Security Event Auditing
+title: Chapter 18. Security Event Auditing
part: Part III. System Administration
prev: books/handbook/mac
next: books/handbook/disks
description: FreeBSD security event auditing supports reliable, fine-grained, and configurable logging of a variety of security-relevant system events, including logins, configuration changes, and file and network access
tags: ["audit", "terms", "configuration", "guide", "audit trails"]
showBookMenu: true
-weight: 21
+weight: 22
path: "/books/handbook/"
aliases: ["/en/books/handbook/audit-inline-glossary/","/en/books/handbook/audit-config/","/en/books/handbook/audit-administration/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/audit-inline-glossary/","/en/books/handbook/audit-
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 17
+:sectnumoffset: 18
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/bibliography/_index.adoc b/documentation/content/en/books/handbook/bibliography/_index.adoc
index fcdb2ef741..66af09677b 100644
--- a/documentation/content/en/books/handbook/bibliography/_index.adoc
+++ b/documentation/content/en/books/handbook/bibliography/_index.adoc
@@ -6,7 +6,7 @@ next: books/handbook/eresources
description: FreeBSD Handbook Bibliography
tags: ["appendix", "bibliography", "handbook", "books", "guides", "security", "periodicals", "journals", "magazines"]
showBookMenu: true
-weight: 40
+weight: 41
path: "/books/handbook/"
aliases: ["/en/books/handbook/bibliography-userguides/","/en/books/handbook/bibliography-adminguides/","/en/books/handbook/bibliography-programmers/","/en/books/handbook/bibliography-osinternals/","/en/books/handbook/bibliography-security/","/en/books/handbook/bibliography-hardware/","/en/books/handbook/bibliography-history/","/en/books/handbook/bibliography-journals/"]
---
diff --git a/documentation/content/en/books/handbook/book.adoc b/documentation/content/en/books/handbook/book.adoc
index 48e624eb9c..3b27da0223 100644
--- a/documentation/content/en/books/handbook/book.adoc
+++ b/documentation/content/en/books/handbook/book.adoc
@@ -70,6 +70,8 @@ include::{chapters-path}ports/_index.adoc[leveloffset=+1]
include::{chapters-path}x11/_index.adoc[leveloffset=+1]
+include::{chapters-path}wayland/_index.adoc[leveloffset=+1]
+
// Section two
include::{chapters-path}partii.adoc[]
diff --git a/documentation/content/en/books/handbook/boot/_index.adoc b/documentation/content/en/books/handbook/boot/_index.adoc
index d7c161b3eb..58069f900b 100644
--- a/documentation/content/en/books/handbook/boot/_index.adoc
+++ b/documentation/content/en/books/handbook/boot/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 13. The FreeBSD Booting Process
+title: Chapter 14. The FreeBSD Booting Process
part: Part III. System Administration
prev: books/handbook/config
next: books/handbook/security
description: An introduction to the FreeBSD Booting Process, demonstrates how to customize the FreeBSD boot process, including everything that happens until the FreeBSD kernel has started, probed for devices, and started init
tags: ["boot", "boot process", "device hints", "x86", "amd64", "MBR", "GPT", "UEFI", "bsdlabel", "boot0", "Single-User Mode", "Multi-User Mode"]
showBookMenu: true
-weight: 17
+weight: 18
path: "/books/handbook/"
aliases: ["/en/books/handbook/boot-introduction/","/en/books/handbook/boot-splash/","/en/books/handbook/device-hints/","/en/books/handbook/boot-shutdown/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/boot-introduction/","/en/books/handbook/boot-splas
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 13
+:sectnumoffset: 14
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/colophon.adoc b/documentation/content/en/books/handbook/colophon.adoc
index 576df53fd4..877cdd0a7c 100644
--- a/documentation/content/en/books/handbook/colophon.adoc
+++ b/documentation/content/en/books/handbook/colophon.adoc
@@ -3,7 +3,7 @@ title: Colophon
prev: books/handbook/glossary
description: FreeBSD Handbook Colophon
showBookMenu: true
-weight: 44
+weight: 45
path: "/books/handbook/"
---
diff --git a/documentation/content/en/books/handbook/config/_index.adoc b/documentation/content/en/books/handbook/config/_index.adoc
index 41f7a54660..be1b87125f 100644
--- a/documentation/content/en/books/handbook/config/_index.adoc
+++ b/documentation/content/en/books/handbook/config/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 12. Configuration and Tuning
+title: Chapter 13. Configuration and Tuning
part: Part III. System Administration
prev: books/handbook/partiii
next: books/handbook/boot
description: This chapter explains much of the FreeBSD configuration process, including some of the parameters which can be set to tune a FreeBSD system.
tags: ["configuration", "tuning", "services", "cron", "virtual hosts", "logging", "configuration files", "sysctl", "tuning disks", "kernel limits", "swap", "power management"]
showBookMenu: true
-weight: 16
+weight: 17
path: "/books/handbook/"
aliases: ["/en/books/handbook/configtuning-starting-services/","/en/books/handbook/configtuning-cron/","/en/books/handbook/configtuning-rcd/","/en/books/handbook/config-network-setup/","/en/books/handbook/configtuning-virtual-hosts/","/en/books/handbook/configtuning-syslog/","/en/books/handbook/configtuning-configfiles/","/en/books/handbook/configtuning-sysctl/","/en/books/handbook/configtuning-disk/","/en/books/handbook/configtuning-kernel-limits/","/en/books/handbook/adding-swap-space/","/en/books/handbook/acpi-overview/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/configtuning-starting-services/","/en/books/handbo
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 12
+:sectnumoffset: 13
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/cutting-edge/_index.adoc b/documentation/content/en/books/handbook/cutting-edge/_index.adoc
index 6d122c2ae7..7ad3692bc1 100644
--- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 24. Updating and Upgrading FreeBSD
+title: Chapter 25. Updating and Upgrading FreeBSD
part: Part III. System Administration
prev: books/handbook/l10n
next: books/handbook/dtrace
description: Information about how to keep a FreeBSD system up-to-date with freebsd-update or Git, how to rebuild and reinstall the entire base system, etc
tags: ["updating", "upgrading", "documentation", "FreeBSD-STABLE", "FreeBSD-CURRENT", "Security Patches"]
showBookMenu: true
-weight: 28
+weight: 29
path: "/books/handbook/"
aliases: ["/en/books/handbook/updating-upgrading-freebsdupdate/","/en/books/handbook/updating-upgrading-documentation/","/en/books/handbook/current-stable/","/en/books/handbook/makeworld/","/en/books/handbook/small-lan/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/updating-upgrading-freebsdupdate/","/en/books/hand
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 24
+:sectnumoffset: 25
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/desktop/_index.adoc b/documentation/content/en/books/handbook/desktop/_index.adoc
index 9a3c59cc21..09b108ac25 100644
--- a/documentation/content/en/books/handbook/desktop/_index.adoc
+++ b/documentation/content/en/books/handbook/desktop/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 6. Desktop Applications
+title: Chapter 7. Desktop Applications
part: Part II. Common Tasks
prev: books/handbook/partii
next: books/handbook/multimedia
description: This chapter demonstrates how to install numerous desktop applications, including web browsers, productivity software, document viewers, and financial software
tags: ["desktop", "browsers", "firefox", "chromium", "productivity", "calligra", "AbiWord", "LibreOffice", "GIMP", "Xpdf", "gv", "Geeqie", "ePDFView", "okular", "Finance", "GnuCash", "Gnumeric", "KMyMoney"]
showBookMenu: true
-weight: 9
+weight: 10
path: "/books/handbook/"
aliases: ["/en/books/handbook/desktop-browsers/","/en/books/handbook/desktop-productivity/","/en/books/handbook/desktop-viewers/","/en/books/handbook/desktop-finance/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/desktop-browsers/","/en/books/handbook/desktop-pro
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 6
+:sectnumoffset: 7
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/disks/_index.adoc b/documentation/content/en/books/handbook/disks/_index.adoc
index 6c8e1a1fbe..a81e915556 100644
--- a/documentation/content/en/books/handbook/disks/_index.adoc
+++ b/documentation/content/en/books/handbook/disks/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 18. Storage
+title: Chapter 19. Storage
part: Part III. System Administration
prev: books/handbook/audit
next: books/handbook/geom
description: This chapter covers the use of disks and storage media in FreeBSD. This includes SCSI and IDE disks, CD and DVD media, memory-backed disks, and USB storage devices.
tags: ["storage", "disks", "gpart", "mount", "quotas", "encrypt", "GPT", "cdrecord", "NTFS", "quotas", "swap", "HAST", "CD", "DVD", "resizing", "growing"]
showBookMenu: true
-weight: 22
+weight: 23
path: "/books/handbook/"
aliases: ["/en/books/handbook/disks-adding/","/en/books/handbook/disks-growing/","/en/books/handbook/usb-disks/","/en/books/handbook/creating-cds/","/en/books/handbook/creating-dvds/","/en/books/handbook/floppies/","/en/books/handbook/backup-basics/","/en/books/handbook/disks-virtual/","/en/books/handbook/snapshots/","/en/books/handbook/quotas/","/en/books/handbook/disks-encrypting/","/en/books/handbook/swap-encrypting/","/en/books/handbook/disks-hast/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/disks-adding/","/en/books/handbook/disks-growing/"
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 18
+:sectnumoffset: 19
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/dtrace/_index.adoc b/documentation/content/en/books/handbook/dtrace/_index.adoc
index b0b64eae67..d4d32250c8 100644
--- a/documentation/content/en/books/handbook/dtrace/_index.adoc
+++ b/documentation/content/en/books/handbook/dtrace/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 25. DTrace
+title: Chapter 26. DTrace
part: Part III. System Administration
prev: books/handbook/cutting-edge
next: books/handbook/usb-device-mode
description: This chapter explains how to use DTrace in FreeBSD
tags: ["DTrace", "features", "guide", "tutorial", "kldload"]
showBookMenu: true
-weight: 29
+weight: 30
path: "/books/handbook/"
aliases: ["/en/books/handbook/dtrace-implementation/","/en/books/handbook/dtrace-enable/","/en/books/handbook/dtrace-using/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/dtrace-implementation/","/en/books/handbook/dtrace
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 25
+:sectnumoffset: 26
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/eresources/_index.adoc b/documentation/content/en/books/handbook/eresources/_index.adoc
index 242430a65f..569086c609 100644
--- a/documentation/content/en/books/handbook/eresources/_index.adoc
+++ b/documentation/content/en/books/handbook/eresources/_index.adoc
@@ -6,7 +6,7 @@ next: books/handbook/pgpkeys
description: FreeBSD additional resources on internet like websites, mailing lists, mirrors, etc
tags: ["eresources", "Websites", "Mailing Lists", "Usenet", "Newsgroups"]
showBookMenu: true
-weight: 41
+weight: 42
path: "/books/handbook/"
aliases: ["/en/books/handbook/eresources-mail/","/en/books/handbook/eresources-news/","/en/books/handbook/eresources-web/"]
---
diff --git a/documentation/content/en/books/handbook/filesystems/_index.adoc b/documentation/content/en/books/handbook/filesystems/_index.adoc
index 7bd7cc8e8b..20f67375db 100644
--- a/documentation/content/en/books/handbook/filesystems/_index.adoc
+++ b/documentation/content/en/books/handbook/filesystems/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 21. Other File Systems
+title: Chapter 22. Other File Systems
part: Part III. System Administration
prev: books/handbook/zfs
next: books/handbook/virtualization
description: This chapter shows the other filesystems supported by FreeBSD
tags: ["filesystem", "ext2", "ext3", "ext4", "ext2fs"]
showBookMenu: true
-weight: 25
+weight: 26
path: "/books/handbook/"
aliases: ["/en/books/handbook/filesystems-linux/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/filesystems-linux/"]
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 21
+:sectnumoffset: 22
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/firewalls/_index.adoc b/documentation/content/en/books/handbook/firewalls/_index.adoc
index 5def3126ee..99d8a50ed6 100644
--- a/documentation/content/en/books/handbook/firewalls/_index.adoc
+++ b/documentation/content/en/books/handbook/firewalls/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 31. Firewalls
+title: Chapter 32. Firewalls
part: IV. Network Communication
prev: books/handbook/network-servers
next: books/handbook/advanced-networking
description: "FreeBSD has three firewalls built into the base system: PF, IPFW, and IPFILTER. This chapter covers how to define packet filtering rules, the differences between the firewalls built into FreeBSD and how to use them"
tags: ["firewall", "pf", "ipfw", "ipfilter", "blacklistd", "filtering"]
showBookMenu: true
-weight: 36
+weight: 37
path: "/books/handbook/"
aliases: ["/en/books/handbook/firewalls-concepts/","/en/books/handbook/firewalls-pf/","/en/books/handbook/firewalls-ipfw/","/en/books/handbook/firewalls-ipf/","/en/books/handbook/firewalls-blacklistd/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/firewalls-concepts/","/en/books/handbook/firewalls
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 31
+:sectnumoffset: 32
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/geom/_index.adoc b/documentation/content/en/books/handbook/geom/_index.adoc
index 00156eeeba..f58cb82b66 100644
--- a/documentation/content/en/books/handbook/geom/_index.adoc
+++ b/documentation/content/en/books/handbook/geom/_index.adoc
@@ -1,12 +1,12 @@
---
-title: "Chapter 19. GEOM: Modular Disk Transformation Framework"
+title: "Chapter 20. GEOM: Modular Disk Transformation Framework"
part: Part III. System Administration
prev: books/handbook/disks
next: books/handbook/zfs
description: In FreeBSD, the GEOM framework permits access and control to classes, such as Master Boot Records and BSD labels, through the use of providers, or the disk devices in /dev.
tags: ["GEOM", "RAID", "RAID0", "RAID1", "RAID3", "Striping", "bsdlabel", "newfs", "labelling", "UFS", "journaling"]
showBookMenu: true
-weight: 23
+weight: 24
path: "/books/handbook/"
aliases: ["/en/books/handbook/geom-striping/","/en/books/handbook/geom-mirror/","/en/books/handbook/geom-raid3/","/en/books/handbook/geom-graid/","/en/books/handbook/geom-ggate/","/en/books/handbook/geom-glabel/","/en/books/handbook/geom-gjournal/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/geom-striping/","/en/books/handbook/geom-mirror/",
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 19
+:sectnumoffset: 20
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/glossary.adoc b/documentation/content/en/books/handbook/glossary.adoc
index b6fab1a47f..745929f36b 100644
--- a/documentation/content/en/books/handbook/glossary.adoc
+++ b/documentation/content/en/books/handbook/glossary.adoc
@@ -4,7 +4,7 @@ prev: books/handbook/pgpkeys
next: books/handbook/colophon
description: FreeBSD Handbook Glossary
showBookMenu: true
-weight: 43
+weight: 44
path: "/books/handbook/"
---
diff --git a/documentation/content/en/books/handbook/jails/_index.adoc b/documentation/content/en/books/handbook/jails/_index.adoc
index 5b2d469e0b..fea4c5fd0f 100644
--- a/documentation/content/en/books/handbook/jails/_index.adoc
+++ b/documentation/content/en/books/handbook/jails/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 15. Jails
+title: Chapter 16. Jails
part: Part III. System Administration
prev: books/handbook/security
next: books/handbook/mac
description: Jails improve on the concept of the traditional chroot environment in several ways
tags: ["jails", "creating", "managing", "updating", "ezjail"]
showBookMenu: true
-weight: 19
+weight: 20
path: "/books/handbook/"
aliases: ["/en/books/handbook/jails-terms/","/en/books/handbook/jails-build/","/en/books/handbook/jails-tuning/","/en/books/handbook/jails-application/","/en/books/handbook/jails-ezjail/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/jails-terms/","/en/books/handbook/jails-build/","/
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 15
+:sectnumoffset: 16
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/kernelconfig/_index.adoc b/documentation/content/en/books/handbook/kernelconfig/_index.adoc
index 9d60e80b12..a16db8cd37 100644
--- a/documentation/content/en/books/handbook/kernelconfig/_index.adoc
+++ b/documentation/content/en/books/handbook/kernelconfig/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 8. Configuring the FreeBSD Kernel
+title: Chapter 9. Configuring the FreeBSD Kernel
part: Part II. Common Tasks
prev: books/handbook/multimedia
next: books/handbook/printing
description: This chapter covers how to configure the FreeBSD Kernel. When to build a custom kernel, how to take a hardware inventory, how to customize a kernel configuration file, etc
tags: ["configuring", "kernel", "custom kernel", "hardware requirements", "pciconf"]
showBookMenu: true
-weight: 11
+weight: 12
path: "/books/handbook/"
aliases: ["/en/books/handbook/kernelconfig-custom-kernel/","/en/books/handbook/kernelconfig-devices/","/en/books/handbook/kernelconfig-config/","/en/books/handbook/kernelconfig-building/","/en/books/handbook/kernelconfig-trouble/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/kernelconfig-custom-kernel/","/en/books/handbook/k
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 8
+:sectnumoffset: 9
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/l10n/_index.adoc b/documentation/content/en/books/handbook/l10n/_index.adoc
index 3c9fd677de..63defa74d0 100644
--- a/documentation/content/en/books/handbook/l10n/_index.adoc
+++ b/documentation/content/en/books/handbook/l10n/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 23. Localization - i18n/L10n Usage and Setup
+title: Chapter 24. Localization - i18n/L10n Usage and Setup
part: Part III. System Administration
prev: books/handbook/virtualization
next: books/handbook/cutting-edge
description: FreeBSD supports localization into many languages, allowing users to view, input, or process data in non-English languages
tags: ["i18n", "L10n", "localization", "Locale", "LANG", "MM_CHARSET", "cap_mkdb"]
showBookMenu: true
-weight: 27
+weight: 28
path: "/books/handbook/"
aliases: ["/en/books/handbook/using-localization/","/en/books/handbook/l10n-compiling/","/en/books/handbook/lang-setup/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/using-localization/","/en/books/handbook/l10n-comp
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 23
+:sectnumoffset: 24
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/linuxemu/_index.adoc b/documentation/content/en/books/handbook/linuxemu/_index.adoc
index abc5018877..a420ef75e8 100644
--- a/documentation/content/en/books/handbook/linuxemu/_index.adoc
+++ b/documentation/content/en/books/handbook/linuxemu/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 10. Linux Binary Compatibility
+title: Chapter 11. Linux Binary Compatibility
part: Part II. Common Tasks
prev: books/handbook/printing
next: books/handbook/wine
description: FreeBSD provides binary compatibility with Linux, allowing users to install and run most Linux binaries on a FreeBSD system without having to first modify the binary
tags: ["linux", "linuxulator", "emulation", "binary", "compatibility"]
showBookMenu: true
-weight: 13
+weight: 14
path: "/books/handbook/"
aliases: ["/en/books/handbook/linuxemu-lbc-install/","/en/books/handbook/linuxemu-advanced/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/linuxemu-lbc-install/","/en/books/handbook/linuxem
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 10
+:sectnumoffset: 11
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/mac/_index.adoc b/documentation/content/en/books/handbook/mac/_index.adoc
index f9c038505e..549ee7989e 100644
--- a/documentation/content/en/books/handbook/mac/_index.adoc
+++ b/documentation/content/en/books/handbook/mac/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 16. Mandatory Access Control
+title: Chapter 17. Mandatory Access Control
part: Part III. System Administration
prev: books/handbook/jails
next: books/handbook/audit
description: "This chapter focuses on the MAC framework and the set of pluggable security policy modules FreeBSD provides for enabling various security mechanisms"
tags: ["MAC", "labels", "security", "configuration", "nagios"]
showBookMenu: true
-weight: 20
+weight: 21
path: "/books/handbook/"
aliases: ["/en/books/handbook/mac-inline-glossary/","/en/books/handbook/mac-understandlabel/","/en/books/handbook/mac-planning/","/en/books/handbook/mac-policies/","/en/books/handbook/mac-userlocked/","/en/books/handbook/mac-implementing/","/en/books/handbook/mac-troubleshoot/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/mac-inline-glossary/","/en/books/handbook/mac-unde
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 16
+:sectnumoffset: 17
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/mail/_index.adoc b/documentation/content/en/books/handbook/mail/_index.adoc
index 9f4fd08ab9..0c7563255f 100644
--- a/documentation/content/en/books/handbook/mail/_index.adoc
+++ b/documentation/content/en/books/handbook/mail/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 29. Electronic Mail
+title: Chapter 30. Electronic Mail
part: IV. Network Communication
prev: books/handbook/ppp-and-slip
next: books/handbook/network-servers
description: This chapter provides a basic introduction to running a mail server on FreeBSD, as well as an introduction to sending and receiving email using FreeBSD
tags: ["mail", "sendmail", "MTA", "SMTP", "user agents", "fetchmail", "procmail", "alpine", "mut"]
showBookMenu: true
-weight: 34
+weight: 35
path: "/books/handbook/"
aliases: ["/en/books/handbook/mail-using/","/en/books/handbook/sendmail/","/en/books/handbook/mail-changingmta/","/en/books/handbook/mail-trouble/","/en/books/handbook/mail-advanced/","/en/books/handbook/outgoing-only/","/en/books/handbook/SMTP-dialup/","/en/books/handbook/SMTP-Auth/","/en/books/handbook/mail-agents/","/en/books/handbook/mail-fetchmail/","/en/books/handbook/mail-procmail/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/mail-using/","/en/books/handbook/sendmail/","/en/b
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 29
+:sectnumoffset: 30
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/mirrors/_index.adoc b/documentation/content/en/books/handbook/mirrors/_index.adoc
index 34a866c3b1..56f81269bd 100644
--- a/documentation/content/en/books/handbook/mirrors/_index.adoc
+++ b/documentation/content/en/books/handbook/mirrors/_index.adoc
@@ -6,7 +6,7 @@ next: books/handbook/bibliography
description: "How to get FreeBSD: CD and DVD sets, FTP sites and how to install and use Git"
tags: ["Obtaining", "CD", "DVD", "FTP", "Git"]
showBookMenu: true
-weight: 39
+weight: 40
path: "/books/handbook/"
aliases: ["/en/books/handbook/mirrors-ftp/","/en/books/handbook/svn/","/en/books/handbook/mirrors-rsync/"]
---
diff --git a/documentation/content/en/books/handbook/multimedia/_index.adoc b/documentation/content/en/books/handbook/multimedia/_index.adoc
index d9c3d90eca..17fffb9ea4 100644
--- a/documentation/content/en/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/en/books/handbook/multimedia/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 7. Multimedia
+title: Chapter 8. Multimedia
part: Part II. Common Tasks
prev: books/handbook/desktop
next: books/handbook/kernelconfig
description: FreeBSD supports a wide variety of sound cards, allowing users to enjoy high fidelity output from a FreeBSD system
tags: ["multimedia", "sound card", "MP3", "MythTV", "scanner", "SANE"]
showBookMenu: true
-weight: 10
+weight: 11
path: "/books/handbook/"
aliases: ["/en/books/handbook/sound-setup/","/en/books/handbook/sound-mp3/","/en/books/handbook/video-playback/","/en/books/handbook/tvcard/","/en/books/handbook/mythtv/","/en/books/handbook/scanners/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/sound-setup/","/en/books/handbook/sound-mp3/","/en
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 7
+:sectnumoffset: 8
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/network-servers/_index.adoc b/documentation/content/en/books/handbook/network-servers/_index.adoc
index 0b405b4562..8e63d6c90b 100644
--- a/documentation/content/en/books/handbook/network-servers/_index.adoc
+++ b/documentation/content/en/books/handbook/network-servers/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 30. Network Servers
+title: Chapter 31. Network Servers
part: IV. Network Communication
prev: books/handbook/mail
next: books/handbook/firewalls
description: This chapter covers some of the more frequently used network services on UNIX systems
tags: ["network", "servers", "inetd", "NFS", "NIS", "LDAP", "DHCP", "DNS", "Apache HTTP", "FTP", "Samba", "NTP", "iSCSI"]
showBookMenu: true
-weight: 35
+weight: 36
path: "/books/handbook/"
aliases: ["/en/books/handbook/network-inetd/","/en/books/handbook/network-nfs/","/en/books/handbook/network-nis/","/en/books/handbook/network-ldap/","/en/books/handbook/network-dhcp/","/en/books/handbook/network-dns/","/en/books/handbook/network-apache/","/en/books/handbook/network-ftp/","/en/books/handbook/network-samba/","/en/books/handbook/network-ntp/","/en/books/handbook/network-iscsi/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/network-inetd/","/en/books/handbook/network-nfs/",
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 30
+:sectnumoffset: 31
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/partii.adoc b/documentation/content/en/books/handbook/partii.adoc
index 2558af057a..4d2526bb5d 100644
--- a/documentation/content/en/books/handbook/partii.adoc
+++ b/documentation/content/en/books/handbook/partii.adoc
@@ -1,9 +1,9 @@
---
title: Part II. Common Tasks
-prev: books/handbook/x11
+prev: books/handbook/wayland
next: books/handbook/desktop
showBookMenu: true
-weight: 8
+weight: 9
path: "/books/handbook/"
---
diff --git a/documentation/content/en/books/handbook/partiii.adoc b/documentation/content/en/books/handbook/partiii.adoc
index a2277e833f..77b0b12f0e 100644
--- a/documentation/content/en/books/handbook/partiii.adoc
+++ b/documentation/content/en/books/handbook/partiii.adoc
@@ -3,7 +3,7 @@ title: Part III. System Administration
prev: books/handbook/linuxemu
next: books/handbook/config
showBookMenu: true
-weight: 15
+weight: 16
path: "/books/handbook/"
---
diff --git a/documentation/content/en/books/handbook/partiv.adoc b/documentation/content/en/books/handbook/partiv.adoc
index 82ca5a561d..5ccdb202c5 100644
--- a/documentation/content/en/books/handbook/partiv.adoc
+++ b/documentation/content/en/books/handbook/partiv.adoc
@@ -3,7 +3,7 @@ title: Part IV. Network Communication
prev: books/handbook/usb-device-mode
next: books/handbook/serialcomms
showBookMenu: true
-weight: 31
+weight: 32
path: "/books/handbook/"
---
diff --git a/documentation/content/en/books/handbook/partv.adoc b/documentation/content/en/books/handbook/partv.adoc
index 9bd4e82b40..bc547b0e86 100644
--- a/documentation/content/en/books/handbook/partv.adoc
+++ b/documentation/content/en/books/handbook/partv.adoc
@@ -3,7 +3,7 @@ title: Part V. Appendices
prev: books/handbook/advanced-networking
next: books/handbook/mirrors
showBookMenu: true
-weight: 38
+weight: 39
path: "/books/handbook/"
---
diff --git a/documentation/content/en/books/handbook/pgpkeys/_index.adoc b/documentation/content/en/books/handbook/pgpkeys/_index.adoc
index a28e097bdc..3b5bbdde39 100644
--- a/documentation/content/en/books/handbook/pgpkeys/_index.adoc
+++ b/documentation/content/en/books/handbook/pgpkeys/_index.adoc
@@ -6,7 +6,7 @@ next: books/handbook/glossary
description: List of OpenPGP keys of the FreeBSD officers are shown here
tags: ["OpenGPG", "keys", "officers"]
showBookMenu: true
-weight: 42
+weight: 43
path: "/books/handbook/"
---
diff --git a/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc b/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc
index 5cbeb6c645..a59b5786ef 100644
--- a/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc
+++ b/documentation/content/en/books/handbook/ppp-and-slip/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 28. PPP
+title: Chapter 29. PPP
part: IV. Network Communication
prev: books/handbook/serialcomms
next: books/handbook/mail
description: FreeBSD supports the Point-to-Point (PPP) protocol which can be used to establish a network or Internet connection using a dial-up modem
tags: ["PPP", "PPPoE", "PPPoA", "modem"]
showBookMenu: true
-weight: 33
+weight: 34
path: "/books/handbook/"
aliases: ["/en/books/handbook/userppp/","/en/books/handbook/ppp-troubleshoot/","/en/books/handbook/pppoe/","/en/books/handbook/pppoa/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/userppp/","/en/books/handbook/ppp-troubleshoot/","
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 28
+:sectnumoffset: 29
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/printing/_index.adoc b/documentation/content/en/books/handbook/printing/_index.adoc
index 9ca74bf04b..e69a8d6863 100644
--- a/documentation/content/en/books/handbook/printing/_index.adoc
+++ b/documentation/content/en/books/handbook/printing/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 9. Printing
+title: Chapter 10. Printing
part: Part II. Common Tasks
prev: books/handbook/kernelconfig
next: books/handbook/linuxemu
description: This chapter covers the printing system in FreeBSD
tags: ["printing", "CUPS", "LPD", "PostScript", "PDLs", "HPLIP", "LPRng"]
showBookMenu: true
-weight: 12
+weight: 13
path: "/books/handbook/"
aliases: ["/en/books/handbook/printing-connections/","/en/books/handbook/printing-pdls/","/en/books/handbook/printing-direct/","/en/books/handbook/printing-lpd/","/en/books/handbook/printing-other/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/printing-connections/","/en/books/handbook/printin
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 9
+:sectnumoffset: 10
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/security/_index.adoc b/documentation/content/en/books/handbook/security/_index.adoc
index d700fd0565..c4c5d44506 100644
--- a/documentation/content/en/books/handbook/security/_index.adoc
+++ b/documentation/content/en/books/handbook/security/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 14. Security
+title: Chapter 15. Security
part: Part III. System Administration
prev: books/handbook/boot
next: books/handbook/jails
description: Hundreds of standard practices have been authored about how to secure systems and networks, and as a user of FreeBSD, understanding how to protect against attacks and intruders is a must
tags: ["security", "one-time passwords", "TCP Wrapper", "Kerberos", "OpenSSL", "IPsec", "OpenSSH", "ACL", "advisories", "sudo", "doas", "monitoring"]
showBookMenu: true
-weight: 18
+weight: 19
path: "/books/handbook/"
aliases: ["/en/books/handbook/security-intro/","/en/books/handbook/one-time-passwords/","/en/books/handbook/tcpwrappers/","/en/books/handbook/kerberos5/","/en/books/handbook/openssl/","/en/books/handbook/ipsec/","/en/books/handbook/openssh/","/en/books/handbook/fs-acl/","/en/books/handbook/security-pkg/","/en/books/handbook/security-advisories/","/en/books/handbook/security-accounting/","/en/books/handbook/security-resourcelimits/","/en/books/handbook/security-sudo/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/security-intro/","/en/books/handbook/one-time-pass
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 14
+:sectnumoffset: 15
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/serialcomms/_index.adoc b/documentation/content/en/books/handbook/serialcomms/_index.adoc
index f9a72195b2..83562bab2d 100644
--- a/documentation/content/en/books/handbook/serialcomms/_index.adoc
+++ b/documentation/content/en/books/handbook/serialcomms/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 27. Serial Communications
+title: Chapter 28. Serial Communications
part: Part IV. Network Communication
prev: books/handbook/partiv
next: books/handbook/ppp-and-slip
description: This chapter covers some of the ways serial communications can be used on FreeBSD
tags: ["serial", "communications", "terminal", "modem", "console"]
showBookMenu: true
-weight: 32
+weight: 33
path: "/books/handbook/"
aliases: ["/en/books/handbook/serial/","/en/books/handbook/term/","/en/books/handbook/dialup/","/en/books/handbook/dialout/","/en/books/handbook/serialconsole-setup/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/serial/","/en/books/handbook/term/","/en/books/han
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 27
+:sectnumoffset: 28
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/usb-device-mode/_index.adoc b/documentation/content/en/books/handbook/usb-device-mode/_index.adoc
index 085cb9b995..7a7e2113a7 100644
--- a/documentation/content/en/books/handbook/usb-device-mode/_index.adoc
+++ b/documentation/content/en/books/handbook/usb-device-mode/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 26. USB Device Mode / USB OTG
+title: Chapter 27. USB Device Mode / USB OTG
part: Part III. System Administration
prev: books/handbook/dtrace
next: books/handbook/partiv
description: This chapter covers the use of USB Device Mode and USB On The Go (USB OTG) in FreeBSD
tags: ["OTG", "USB"]
showBookMenu: true
-weight: 30
+weight: 31
path: "/books/handbook/"
aliases: ["/en/books/handbook/usb-device-mode-terminals/","/en/books/handbook/usb-device-mode-network/","/en/books/handbook/usb-device-mode-storage/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/usb-device-mode-terminals/","/en/books/handbook/us
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 26
+:sectnumoffset: 27
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/virtualization/_index.adoc b/documentation/content/en/books/handbook/virtualization/_index.adoc
index bdb5570ce9..78daa5799d 100644
--- a/documentation/content/en/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/en/books/handbook/virtualization/_index.adoc
@@ -1,12 +1,12 @@
---
-title: Chapter 22. Virtualization
+title: Chapter 23. Virtualization
part: Part III. System Administration
prev: books/handbook/filesystems
next: books/handbook/l10n
description: Virtualization software allows multiple operating systems to run simultaneously on the same computer
tags: ["virtualization", "Parallels", "VMware", "VirtualBox", "bhyve", "XEN"]
showBookMenu: true
-weight: 26
+weight: 27
path: "/books/handbook/"
aliases: ["/en/books/handbook/virtualization-guest-parallels/","/en/books/handbook/virtualization-guest-virtualpc/","/en/books/handbook/virtualization-guest-vmware/","/en/books/handbook/virtualization-guest-virtualbox/","/en/books/handbook/virtualization-host-virtualbox/","/en/books/handbook/virtualization-host-bhyve/","/en/books/handbook/virtualization-host-xen/"]
---
@@ -19,7 +19,7 @@ aliases: ["/en/books/handbook/virtualization-guest-parallels/","/en/books/handbo
:icons: font
:sectnums:
:sectnumlevels: 6
-:sectnumoffset: 22
+:sectnumoffset: 23
:partnums:
:source-highlighter: rouge
:experimental:
diff --git a/documentation/content/en/books/handbook/wayland/_index.adoc b/documentation/content/en/books/handbook/wayland/_index.adoc
new file mode 100644
index 0000000000..0e7387ad5d
--- /dev/null
+++ b/documentation/content/en/books/handbook/wayland/_index.adoc
@@ -0,0 +1,696 @@
+---
+title: Chapter 6. Wayland
+part: Part I. Getting Started
+prev: books/handbook/x11
+next: books/handbook/partii
+description: This chapter describes how to install and configure Wayland and compositors on FreeBSD, which provides a graphical user environment
+tags: ["Wayland", "XWayland", "KDE", "Plasma", "Xfce", "Gnome", "Intel", "AMD", "NVIDIA", "Wayfire", "Sway", "Hikari"]
+showBookMenu: true
+weight: 8
+path: "/books/handbook/"
+---
+
+[[wayland]]
+= Wayland on FreeBSD
+:doctype: book
+:toc: macro
+:toclevels: 1
+:icons: font
+:sectnums:
+:sectnumlevels: 6
+:sectnumoffset: 6
+:partnums:
+:source-highlighter: rouge
+:experimental:
+:images-path: books/handbook/wayland/
+
+ifdef::env-beastie[]
+ifdef::backend-html5[]
+:imagesdir: ../../../../images/{images-path}
+endif::[]
+ifndef::book[]
+include::shared/authors.adoc[]
+include::shared/mirrors.adoc[]
+include::shared/releases.adoc[]
+include::shared/attributes/attributes-{{% lang %}}.adoc[]
+include::shared/{{% lang %}}/teams.adoc[]
+include::shared/{{% lang %}}/mailing-lists.adoc[]
+include::shared/{{% lang %}}/urls.adoc[]
+toc::[]
+endif::[]
+ifdef::backend-pdf,backend-epub3[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+endif::[]
+
+ifndef::env-beastie[]
+toc::[]
+include::../../../../../shared/asciidoctor.adoc[]
+endif::[]
+
+[[wayland-synopsis]]
+== Wayland Synopsis
+Wayland is a new display server, but it differs from Xorg in several important ways.
+First, Wayland is only a protocol that acts as an intermediary between clients using a different mechanism which removes the dependency on an X server.
+Xorg includes both the X11 protocol, used to run remote displays and the X server will accept connections and display windows.
+Under Wayland, the compositor or window manager provides the display server instead of a traditional X server.
+
+Since Wayland is not an X server, traditional X screen connections will need to utilize other methods such as VNC or RDP for remote desktop management.
+Second, Wayland can manage composite communications between clients and a compositor as a separate entity which does not need to support the X protocols.
+
+Wayland is relatively new, and not all software has been updated to run natively without `Xwayland` support.
+Because Wayland does not provide the X server, and expects compositors to provide that support, X11 window managers that do not yet support Wayland will require that `Xwayland` is not started with the `-rootless` parameter.
+The `-rootless` parameter, when removed, will restore X11 window manager support.
+
+[NOTE]
+====
+The current NVidia driver should work with most wl-roots compositors, but it may be a little unstable and not support all features at this time.
+Volunteers to help work on the NVidia DRM are requested.
+====
+
+Currently, a lot of software will function with minimal issues on Wayland, including Firefox.
+And a few desktops are also available, such as the Compiz Fusion replacement, known as Wayfire, and the i3 window manager replacement, Sway.
+
+[NOTE]
+====
*** 1332 LINES SKIPPED ***