[Bug 263782] Use sysrc instead of manually editing rc.conf throughout the FreeBSD Handbook for simplicity and consistency

From: <bugzilla-noreply_at_freebsd.org>
Date: Fri, 06 May 2022 22:47:01 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=263782

--- Comment #2 from PauAmma <pauamma@gundo.com> ---
Comment on attachment 233758
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=233758
X11 section - rc.conf replacement(s)

>diff --git a/documentation/content/en/books/handbook/x11/_index.adoc b/documentation/content/en/books/handbook/x11/_index.adoc
>index 8a9269cdcf..9aa05ef7a9 100644
>--- a/documentation/content/en/books/handbook/x11/_index.adoc
>+++ b/documentation/content/en/books/handbook/x11/_index.adoc
>@@ -942,11 +942,11 @@ Refer to <<x11-wm-gnome>> for instructions on how to configure the GNOME Display
> === Configuring XDM
> 
> To install XDM, use the package:x11/xdm[] package or port.
>-Once installed, XDM can be configured to run when the machine boots up by adding the following line to [.filename]#/etc/rc.conf#:
>+Once installed, XDM can be configured to run when the machine boots up by using sysrc:

man:sysrc[8] to make it a link to the web-based manual page.

>@@ -1046,28 +1046,28 @@ proc           /proc       procfs  rw  0   0
> 
> GNOME uses D-Bus for a message bus and hardware abstraction.
> These applications are automatically installed as dependencies of GNOME.
>-Enable them in [.filename]#/etc/rc.conf# so they will be started when the system boots:
>+Enable them with sysrc so they will be started when the system boots:
> 
> [.programlisting]
> ....
>-dbus_enable="YES"
>+sysrc dbus_enable="YES"

Same.
> 
> After installation, configure Xorg to start GNOME.
> The easiest way to do this is to enable the GNOME Display Manager, GDM, which is installed as part of the GNOME package or port.
>-It can be enabled by adding this line to [.filename]#/etc/rc.conf#:
>+It can be enabled by using sysrc:

And again.
> 
> [.programlisting]
> ....
>-gdm_enable="YES"
>+sysrc gdm_enable="YES"
> ....
> 
> It is often desirable to also start all GNOME services.
>-To achieve this, add a second line to [.filename]#/etc/rc.conf#:
>+To achieve this, use sysrc:

etc. (You get the idea.)
> 
> [.programlisting]
> ....
>-gnome_enable="YES"
>+sysrc gnome_enable="YES"
> ....
> 
> GDM will start automatically when the system boots.
>@@ -1124,11 +1124,11 @@ proc           /proc       procfs  rw  0   0
> 
> KDE uses D-Bus for a message bus and hardware abstraction.
> These applications are automatically installed as dependencies of KDE.
>-Enable them in [.filename]#/etc/rc.conf# so they will be started when the system boots:
>+Enable them with sysrc so they will be started when the system boots:
> 
> [.programlisting]
> ....
>-dbus_enable="YES"
>+sysrc dbus_enable="YES"
> ....
> 
> Since KDE Plasma 5, the KDE Display Manager, KDM is no longer developed.
>@@ -1140,11 +1140,11 @@ To install it, type:
> # pkg install x11/sddm
> ....
> 
>-Add this line to [.filename]#/etc/rc.conf#:
>+Use sysrc to enable:
> 
> [.programlisting]
> ....
>-sddm_enable="YES"
>+sysrc sddm_enable="YES"
> ....
> 
> A second method for launching KDE Plasma is to type `startx` from the command line.
>@@ -1191,11 +1191,11 @@ Alternatively, to build the port:
> 
> Xfce uses D-Bus for a message bus.
> This application is automatically installed as dependency of Xfce.
>-Enable it in [.filename]#/etc/rc.conf# so it will be started when the system boots:
>+Enable it with sysrc so it will be started when the system boots:
> 
> [.programlisting]
> ....
>-dbus_enable="YES"
>+sysrc dbus_enable="YES"
> ....
> 
> Unlike GNOME or KDE, Xfce does not provide its own login manager.

-- 
You are receiving this mail because:
You are the assignee for the bug.