From 82e62209d696dcb082bd67e227dd5fe30256c776 Mon Sep 17 00:00:00 2001
From: Lauri Kasanen <cand@gmx.com>
Date: Mon, 1 May 2017 19:50:01 +0300
Subject: [PATCH] Document pragma trampoline

---
 doc/cc65.sgml | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/doc/cc65.sgml b/doc/cc65.sgml
index 24b37133e..99ddfc82d 100644
--- a/doc/cc65.sgml
+++ b/doc/cc65.sgml
@@ -1209,6 +1209,31 @@ parameter with the <tt/#pragma/.
   The <tt/#pragma/ understands the push and pop parameters as explained above.
 
 
+<sect1><tt>#pragma trampoline (&lt;push&rt;, &lt;name&gt;, &lt;value&gt;)</tt><label id="pragma-trampoline"><p>
+
+  This pragma sets a trampoline for functions. The name is either
+  a function returning void and taking no parameters, or the address
+  of an array in memory (for a RAM trampoline). The value is an
+  8-bit number that's set to tmp4.
+
+  The address of the function is passed in ptr4.
+
+  This is useful for example with banked memory, to automatically
+  switch banks to where this function resides, and then restore
+  the bank when it returns.
+
+  The <tt/#pragma/ requires the push and pop parameters as explained above.
+
+  Example:
+  <tscreen><verb>
+	void mytrampoline(void);
+
+        #pragma trampoline (push, mytrampoline, 0)
+        void somefunc(void);
+        #pragma trampoline (pop)
+  </verb></tscreen>
+
+
 <sect1><tt>#pragma warn (name, [push,] on|off)</tt><label id="pragma-warn"><p>
 
   Switch compiler warnings on or off. "name" is the name of a warning (see the
-- 
2.39.5