doc: move notes to manual and clarify the synopsis

Since the README is not intended to be installed to the system it makes
sense to provide the NOTES section in the manual itself which is.

This also expands the SYNOPSIS section to indicate that the usage of sx
should work as a typical chain command.
This commit is contained in:
Earnestly 2018-08-11 14:47:09 +01:00
parent 8d75ae233b
commit 069d745d44
2 changed files with 21 additions and 11 deletions

6
README
View File

@ -34,12 +34,6 @@ INTRODUCTION
For a rationale on why this exists, the author invites the reader to For a rationale on why this exists, the author invites the reader to
look over the source code for both xinit and startx. look over the source code for both xinit and startx.
NOTES
Since the addition of Xorg.wrap it may be necessary to set allowed_users
to anybody in /etc/X11/Xwrapper.config as sx attempts to start clients
from within a subshell and is thusly not considered a console user.
REQUIRES REQUIRES
* Xorg * Xorg

26
sx.1
View File

@ -1,9 +1,9 @@
.TH SX 1 2017-12-09 Linux .TH SX 1 "25 August 2018"
.SH NAME .SH NAME
sx \- start an xorg server sx \- start an xorg server
.SH SYNOPSIS .SH SYNOPSIS
.B sx .B sx
.RI [ client ] .RI [ "command " [ "arguments " ...]]
.SH DESCRIPTION .SH DESCRIPTION
.B sx .B sx
can be used to replace both can be used to replace both
@ -15,8 +15,11 @@ for starting an Xorg server. By default
will attempt execute will attempt execute
.I sxrc .I sxrc
unless a unless a
.I client .I command
argument is provided. argument is provided. The
.I command
may consistent of one or more
.IR arguments .
.SH ENVIRONMENT .SH ENVIRONMENT
.TP .TP
.B XAUTHORITY .B XAUTHORITY
@ -45,7 +48,7 @@ will be used if not set.
.SH FILES .SH FILES
.TP .TP
.B XDG_CONFIG_HOME/sx/sxrc .B XDG_CONFIG_HOME/sx/sxrc
The default client started by The default command started by
.BR sx . .BR sx .
This file must be executable. This file must be executable.
.TP .TP
@ -54,6 +57,19 @@ The default authority used by
.B sx .B sx
if an alternative file is not provided with if an alternative file is not provided with
.BR XAUTHORITY . .BR XAUTHORITY .
.SH NOTES
Since the addition of
.BR Xorg.wrap (1)
it may be necessary to set
.I allowed_users
to
.I anybody
in
.BR \%/etc/X11/Xwrapper.config .
This is due to
.B sx
attempting to run commands from within a subshell and is thusly not considered
a console user.
.SH SOURCE .SH SOURCE
.UR https://github.com/Earnestly/sx .UR https://github.com/Earnestly/sx
.UE .UE