From 397fec0152a93629883003b7ba399190e2a33bf6 Mon Sep 17 00:00:00 2001
From: Jan Niggemann <jn@hz6.de>
Date: Tue, 19 Sep 2017 15:49:54 +0200
Subject: [PATCH] documents metadata handling, fixes #647

---
 doc/manual.rst | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/doc/manual.rst b/doc/manual.rst
index b534fd43b..cfbdf3a66 100644
--- a/doc/manual.rst
+++ b/doc/manual.rst
@@ -1075,8 +1075,11 @@ statements originating in functions that match the pattern ``*unlock*``
 
     $ DEBUG_FUNCS=*unlock* restic check
 
-Under the hood: Browse repository objects
------------------------------------------
+Under the hood
+--------------
+
+Browse repository objects
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Internally, a repository stores data of several different types
 described in the `design
@@ -1121,6 +1124,33 @@ objects or its raw content.
       "gid": 20
     }
 
+Metadata handling
+~~~~~~~~~~~~~~~~~
+
+Restic saves and restores most default attributes, including extended attributes like ACLs.
+Sparse files are not handled in a special way yet, and aren't restored.
+
+The following metadata is handled by restic:
+
+- Name
+- Type
+- Mode
+- ModTime
+- AccessTime
+- ChangeTime
+- UID
+- GID
+- User
+- Group
+- Inode
+- Size
+- Links
+- LinkTarget
+- Device
+- Content
+- Subtree
+- ExtendedAttributes
+
 Scripting
 ---------