From 399b6b1b5b07368ecbc1c51c758b5e6c398759af Mon Sep 17 00:00:00 2001
From: Juan RP <xtraeme@gmail.com>
Date: Sun, 18 Jan 2015 13:01:33 +0100
Subject: README: explain how to ignore updates for pkgs built with custom
 options.

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

(limited to 'README.md')

diff --git a/README.md b/README.md
index df9225b7bdf..d317929676b 100644
--- a/README.md
+++ b/README.md
@@ -92,6 +92,12 @@ The build options can also be shown for binary packages via `xbps-query(8)`:
 
     $ xbps-query -R --property=build-options foo
 
+> NOTE: if you build a package with a custom option, and that package is available
+in an official void repository, an update will ignore those options. Put that package
+on `hold` mode via `xbps-pkgdb(8)`, i.e `xbps-pkgdb -m hold foo` to ignore updates
+with `xbps-install -u`. Once the package is on `hold`, the only way to update it
+is by declaring it explicitely: `xbps-install -u foo`.
+
 Permanent global package build options can be set via `XBPS_PKG_OPTIONS` variable in the
 `etc/conf` configuration file. Per package build options can be set via
 `XBPS_PKG_OPTIONS_<pkgname>`.
-- 
cgit v1.2.3