From 80b27bde5e4eff1ed11dc6c84e3fbe99ae34f038 Mon Sep 17 00:00:00 2001
From: Pascal de Bruijn <pmjdebruijn@pcode.nl>
Date: Thu, 20 Jul 2017 18:13:39 +0200
Subject: [PATCH] pragma: add minimalist message pragma documentation

documents 6e93c1ba7332c55eb2067d7be6d20050912ef27d
---
 doc/cc65.sgml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/doc/cc65.sgml b/doc/cc65.sgml
index 3689c0b35..cd94f50ac 100644
--- a/doc/cc65.sgml
+++ b/doc/cc65.sgml
@@ -1119,6 +1119,23 @@ parameter with the <tt/#pragma/.
   remembered and output as a whole when translation is finished.
 
 
+<sect1><tt>#pragma message (&lt;message&gt;)</tt><label id="pragma-message"><p>
+
+  This pragma is used to display informational messages at compile-time.
+
+  The message intented to be displayed must be a string literal.
+
+  Example:
+  <tscreen><verb>
+        #pragma message ("in a bottle")
+  </verb></tscreen>
+
+  Results in the compiler outputting the following to stderr:
+  <tscreen><verb>
+        example.c(42): Note: in a bottle
+  </verb></tscreen>
+
+
 <sect1><tt>#pragma optimize ([push,] on|off)</tt><label id="pragma-optimize"><p>
 
   Switch optimization on or off. If the argument is "off", optimization is
-- 
2.39.5