From 4d39a98ffecd63b3e3b27c79315f5923df16344a Mon Sep 17 00:00:00 2001
From: Juan RP <xtraeme@gmail.com>
Date: Sat, 28 Dec 2013 12:21:09 +0100
Subject: [PATCH] doc/manual.txt: improve build options section.

---
 doc/manual.txt | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/doc/manual.txt b/doc/manual.txt
index 207810e504c..0e43444d750 100644
--- a/doc/manual.txt
+++ b/doc/manual.txt
@@ -456,6 +456,10 @@ build_style=gnu-configure
 build_options="png"
 desc_option_png="Enable support for PNG images"
 
+# To build the package by default with the `png` option:
+#
+# build_options_default="png"
+
 if [ "$build_option_png" ]; then
 	configure_args+=" --with-png"
 	makedepends+=" libpng-devel"
@@ -466,6 +470,30 @@ fi
 
 -----------------------------------------------------------------------
 
+The supported build options for a source package can be shown with xbps-src:
+
+---------------------------
+$ xbps-src show-options foo
+---------------------------
+
+Build options can be enabled with the `-o` flag of xbps-src:
+
+--------------------------------
+$ xbps-src -o option,option1 foo
+--------------------------------
+
+Build options can be disabled by prefixing them with `~`:
+
+----------------------------------
+$ xbps-src -o ~option,~option1 foo
+----------------------------------
+
+Both ways can be used together to enable and/or disable multiple options
+at the same time with xbps-src:
+
+------------------------------------------
+$ xbps-src -o option,~option1,~option2 foo
+------------------------------------------
 
 Contributing via git
 ~~~~~~~~~~~~~~~~~~~~