From 41a6a9b372fb2cb956297cbb6d14b4434bea9599 Mon Sep 17 00:00:00 2001
From: Earnestly <zibeon@googlemail.com>
Date: Wed, 6 Feb 2019 18:54:34 +0000
Subject: [PATCH] doc: include examples and clarify usage

Sometimes people encode logic into files such as Xinitrc which absorbs
command-line arguments that typically control which window manager or
desktop environment to start.

These examples demonstrate how they might do this with sxrc and other
suggestions for reusing ~/.Xinitrc
---
 sx.1 | 27 ++++++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)

diff --git a/sx.1 b/sx.1
index bb42f3d..b631844 100644
--- a/sx.1
+++ b/sx.1
@@ -1,4 +1,4 @@
-.TH SX 1 "21 October 2018"
+.TH SX 1 "6 February 2019" 2.1.1
 .SH NAME
 sx \- start an xorg server
 .SH SYNOPSIS
@@ -10,10 +10,10 @@ can be used to replace both
 .BR xinit (1)
 and
 .BR startx (1)
-for starting an Xorg server.  By default
+for starting an Xorg server with an initial client.  By default
 .B sx
 will attempt to execute
-.I sxrc
+.I \%XDG_CONFIG_HOME/sx/sxrc
 unless a
 .I command
 is provided.  The
@@ -70,6 +70,27 @@ This is due to
 .B sx
 attempting to run commands from within a subshell and is thusly not considered
 a console user.
+.SH EXAMPLES
+Use an existing
+.I .Xinitrc
+by specifying an appropriate interpreter such as
+.BR sh (1)
+or marking it executable with a correct interpreter line:
+.IP
+.EX
+.B sx sh ~/.Xinitrc
+.EE
+.PP
+Pass arguments to the standard
+.I sxrc
+by presenting it to
+.B sx
+as a
+.IR command :
+.IP
+.EX
+.B sx ~/.config/sx/sxrc arg1 arg2
+.EE
 .SH SOURCE
 .UR https://github.com/Earnestly/sx
 .UE