From 3c265cd449a6275e4fd34eaffdedb36f2c561d73 Mon Sep 17 00:00:00 2001
From: Kartik Agaram <github@akkartik.com>
Date: Mon, 19 Dec 2016 19:17:32 -0800
Subject: [PATCH] clarify documentation on creating documentation

On Mac OS X El Capitan at least :doc needs an extra explicit build step to be useful.
---
 README.asciidoc | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.asciidoc b/README.asciidoc
index 934c54a1..0633a5e6 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -105,7 +105,8 @@ Kakoune dependencies are:
  * ncurses with wide-characters support (>= 5.3, generally referred to as libncursesw)
  * asciidoc (for the `a2k` tool), to generate man pages
 
-To build, just type *make* in the src directory
+To build, just type *make* in the src directory.
+To generate man pages, type *make doc* in the src directory.
 
 Kakoune can be built on Linux, MacOS, and Cygwin. Due to Kakoune relying heavily
 on being in a Unix-like environment, no native Windows version is planned.