From 716406bd9d789f2d0ba4d2ccba08380f1b3476e9 Mon Sep 17 00:00:00 2001
From: maxice8 <thinkabit.ukim@gmail.com>
Date: Mon, 27 Aug 2018 18:04:04 -0300
Subject: [PATCH] Manual.md: document preserve variable

[ci skip]
---
 Manual.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/Manual.md b/Manual.md
index 2d95d4ef215..de8d1cf4bb9 100644
--- a/Manual.md
+++ b/Manual.md
@@ -607,6 +607,12 @@ that contain Makefile.PL files that need to be processes for the package to work
 used in the perl-module build_style and has no use outside of it.
 Example: `perl_configure_dirs="blob/bob foo/blah"`
 
+- `preserve` If set, files owned by the package in the system are not removed when
+the package is updated, reinstalled or removed. This is mostly useful for kernel packages
+that shouldn't remove the kernel files when they are removed in case it might break the
+user's booting and module loading. Otherwise in the majority of cases it should not be
+used.
+
 <a id="explain_depends"></a>
 #### About the many types of `depends` variable.