[Bug 223128] Handbook 5.6. The X Display Manager

[bugzilla-noreply at freebsd.org]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=223128

            Bug ID: 223128
           Summary: Handbook 5.6. The X Display Manager
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Documentation
          Assignee: freebsd-doc at FreeBSD.org
          Reporter: sid at bsdmail.com

Here is what I suggest for Chapter 5.6 of the Handbook. It is not in a diff
yet, and it lacks Docbook markup. I would like to send Chapter 5.7 "Desktop
Environments" to its own article, and have the Handbook version of it
simplified for conciseness. Suggestions for fixing configuration directories is
also here.

-5.6. The X Display Manager
+5.6. Desktop Session Management

-Contributed by Seth Kingsley.
+Originally Contributed to by Seth Kingsley.

-Xorg provides an X Display Manager, XDM, which can be used for login session
management.
+Xorg provides an X Display Manager, XDM, and Xinit which can be used for login
session management.

-XDM provides a graphical interface for choosing which display server to
connect to and for entering authorization information such as a login and
password combination.
+XDM provides a graphical interface, and Xinit provides a console interface for
choosing which display server to connect to and for entering authorization
information such as a login and password combination.

-This section demonstrates how to configure the X Display Manager on FreeBSD.
+This section demonstrates how to configure login session management on
FreeBSD.

-5.6.1. Configuring XDM
+5.6.1. Configuration Files

+5.6.1.1. XDM Configuration Files
-The XDM configuration directory is located in /usr/local/lib/X11/xdm.
+The XDM configuration directory is located in /usr/local/etc/X11/xdm.

-Default session script for logins which is run by XDM after a user has logged
in. Normally each user will have a customized session script in ~/.xsession
that overrides this script
+Default session script for logins which is run by XDM after a user has logged
in. This file points to ~/.xsession and other home directory files for
customized settings

+5.6.1.2. Xinit Configuration Files
x11/xinit is used to log into X from the console. Its script file is
/usr/local/etc/X11/xinit, and this can be customized through the directory
/usr/local/etc/x11/xinit.d/ or ~/.xinitrc.

5.6.2. Configuring Remote Access
-To configure XDM to listen for any remote connection, comment out the
DisplayManager.requestPort line in /usr/local/lib/X11/xdm/xdm-config by putting
a ! in front of it:
+To configure XDM to listen for any remote connection, comment out the
DisplayManager.requestPort line in /usr/local/etc/X11/xdm/xdm-config by putting
a ! in front of it:

-To restrict remote access, look at the example entries in
/usr/local/lib/X11/xdm/Xaccess and refer to xdm(1) for further information.
+To restrict remote access, look at the example entries in
/usr/local/etc/X11/xdm/Xaccess and refer to xdm(1) for further information.

+5.6.3. Xsession and Xinit
<para>In your home directory, similar files <filename>.xsession</filename>, or
<filename>.xinitrc</filename> require a minimum of:</para>
<screen><userinput>#!/bin/sh</userinput><useriput>/usr/local/bin/[windowmanager]</userinput></screen>

<para><filename>.xinitrc</filename>'s permissions, at minimum, must be set to
read, and <filename>.xsession</filename>'s permissions must be set to read and
write.</para>
<screen><userinput>chmod ug+rx  ~/.xsession</userinput></screen>

<tip>If you choose to softlink <filename>.xinitrc</filename> to
<filename>.xsession</filename>, then both files must be set to execute and read
permissions.</tip>

<note>If your window manager of choice is capable of displaying custom
wallpapers, and desktop programs, use it instead of Xsession or Xinit.</note>

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