From 005f2c74ef2c3b5bc69d863b9883f94e39839624 Mon Sep 17 00:00:00 2001
From: Tomas Pospisek <tpo_hp@sourcepole.ch>
Date: Mon, 25 Jun 2018 21:16:33 +0200
Subject: document the XDG_SEAT_PATH environment variable

Fixes: https://github.com/CanonicalLtd/lightdm/issues/27
---
 data/dm-tool.1 | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/data/dm-tool.1 b/data/dm-tool.1
index d8aa8bdf..f7d8596b 100644
--- a/data/dm-tool.1
+++ b/data/dm-tool.1
@@ -13,6 +13,7 @@ dm-tool \- a tool to control the display manager
 .SH DESCRIPTION
 .B dm-tool
 is a tool to communicate with the LightDM display manager.
+.TP
 .SH OPTIONS
 .TP
 .B \-h, \-\-help
@@ -58,5 +59,18 @@ Connect an existing X server to the display manager.
 .TP
 .B add-seat TYPE [NAME=VALUE...]
 Add a dynamic seat.
+.SH ENVIRONMENT
+.TP
+.B XDG_SEAT_PATH
+Used by dm-tool to determine in which display manager session it's running. When executing
+.B dm-tool
+outside of a display-manager use its
+.B list-seats
+command to show active sessions and set the session to connect to with:
+.B export XDG_SEAT_PATH=/org/freedesktop/DesktopManager/SeatX
+where
+.B SeatX
+is one of the listed sessions.
+.
 .SH SEE ALSO
 .BR lightdm (1)
-- 
cgit v1.2.1