From 0adb36346c18ab316f86f2ba52729257ac63284d Mon Sep 17 00:00:00 2001
From: Allan McRae <allan@archlinux.org>
Date: Thu, 19 Jul 2018 12:51:07 +1000
Subject: Revert "Deprecate --root in favour of --sysroot"

The use of --sysroot in the real world has flagged some issues that need
addressing.  Undeprecate --root for now.

This reverts commit a278356f75866f89232e3e6230bbf9fb2dc1893c.

Signed-off-by: Allan McRae <allan@archlinux.org>
---
 doc/pacman.8.asciidoc | 10 ++++++++++
 1 file changed, 10 insertions(+)

(limited to 'doc/pacman.8.asciidoc')

diff --git a/doc/pacman.8.asciidoc b/doc/pacman.8.asciidoc
index b6f4dd76..66483bcb 100644
--- a/doc/pacman.8.asciidoc
+++ b/doc/pacman.8.asciidoc
@@ -130,6 +130,16 @@ Options
 	*NOTE*: If specified, this is an absolute path, and the root path is
 	not automatically prepended.
 
+*-r, \--root* <path>::
+	Specify an alternative installation root (default is `/`). This should
+	not be used as a way to install software into `/usr/local` instead of
+	`/usr`.
+	*NOTE*: If database path or log file are not specified on either the
+	command line or in linkman:pacman.conf[5], their default location will
+	be inside this root path.
+	*NOTE*: This option is not suitable for performing operations on a mounted
+	guest system. See '\--sysroot' instead.
+
 *-v, \--verbose*::
 	Output paths such as as the Root, Conf File, DB Path, Cache Dirs, etc.
 
-- 
cgit v1.2.3-54-g00ecf

