From 5c1e499faf6db03c7ccd523c0e7ebc817809e8ae Mon Sep 17 00:00:00 2001
From: Fabrice Niessen <(concat "fniessen" at-sign "pirilampo.org")>
Date: Fri, 15 Jan 2016 23:12:10 +0100
Subject: [PATCH] Add tip

---
 README.html | 27 ++++++++++++++++++++++++++-
 README.org  | 22 ++++++++++++++++++----
 2 files changed, 44 insertions(+), 5 deletions(-)

diff --git a/README.html b/README.html
index fb539fc..4078171 100644
--- a/README.html
+++ b/README.html
@@ -2890,6 +2890,27 @@ a paragraph.  However, you can mimic inline comments with export snippets, e.g.,
 <code>@@comment:...@@</code>.
 </p>
 
+</div>
+
+<div class="tip">
+<p>
+If you have tables (for example) that you want to ignore during export, one possibility
+is to use <b>comment blocks</b> or <code>:noexport:</code> subtrees.  Another possibility is to
+<b>use</b> non-exported <b>drawers</b> (see #+OPTIONS: d:).
+</p>
+
+</div>
+
+<p>
+If you want to ignore that part only during export, but still want to
+use keep it active in the buffer, I suggest to use a drawer, with an
+appropriate `org-export-with-drawers&rsquo; value, e.g.,
+</p>
+
+<div class="org-src-container">
+
+<pre class="src src-org"><span class="org-org-meta-line">#+OPTIONS: d:(not "NOEXPORT")</span>
+</pre>
 </div>
 </div>
 </div>
@@ -3552,6 +3573,10 @@ Timestamps: <span class="timestamp-wrapper"><span class="timestamp">[2014-01-16
 <div id="outline-container-orgheadline134" class="outline-4">
 <h4 id="orgheadline134"><span class="done DONE">DONE</span> <span class="priority">[A]</span> Buy GTD book&#xa0;&#xa0;&#xa0;<span class="tag"><span class="online">online</span></span></h4>
 <div class="outline-text-4" id="text-orgheadline134">
+<ul class="org-ul">
+<li>State &ldquo;TODO&rdquo;        -&gt;  &ldquo;DONE&rdquo;       <span class="timestamp-wrapper"><span class="timestamp">[2014-01-16 Thu 09:52]</span></span></li>
+</ul>
+
 <p>
 By default, <code>DONE</code> actions will be collapsed.
 </p>
@@ -3957,7 +3982,7 @@ beer and as in speech.
 <h2 id="orgheadline98">License</h2>
 <div class="outline-text-2" id="text-orgheadline98">
 <p>
-Copyright (C) 2014-2015 Fabrice Niessen.
+Copyright (C) 2014-2016 Fabrice Niessen.
 </p>
 
 <p>
diff --git a/README.org b/README.org
index 74ea233..4e90fbf 100644
--- a/README.org
+++ b/README.org
@@ -524,7 +524,7 @@ You can fill a table from a CSV file using R commands.
   :END:
 #+end_src
 
-This document is available in [[file:org-mode-syntax.org][plain text]], [[file:org-mode-syntax.html][HTML]] and [[file:org-mode-syntax.pdf][PDF]].
+This document is available in [[file:README.org][plain text]], [[file:README.html][HTML]] and [[file:README.pdf][PDF]].
 
 The links are delimited by double square brackets.
 
@@ -1030,6 +1030,20 @@ a paragraph.  However, you can mimic inline comments with export snippets, e.g.,
 ~@@comment:...@@~.
 #+end_note
 
+#+begin_tip
+If you have tables (for example) that you want to ignore during export, one possibility
+is to use *comment blocks* or ~:noexport:~ subtrees.  Another possibility is to
+*use* non-exported *drawers* (see #+OPTIONS: d:).
+#+end_tip
+
+If you want to ignore that part only during export, but still want to
+use keep it active in the buffer, I suggest to use a drawer, with an
+appropriate `org-export-with-drawers' value, e.g.,
+
+#+begin_src org
+,#+OPTIONS: d:(not "NOEXPORT")
+#+end_src
+
 * Substitutions
 
 ** General replacements
@@ -1616,7 +1630,7 @@ beer and as in speech.
 
 * License
 
-Copyright (C) 2014-2015 Fabrice Niessen.
+Copyright (C) 2014-2016 Fabrice Niessen.
 
 Author: Fabrice Niessen \\
 Keywords: org-mode refcard
@@ -1633,7 +1647,7 @@ A PARTICULAR PURPOSE. See the GNU General Public License for more details.
 You should have received a copy of the GNU General Public License along with
 this program. If not, see http://www.gnu.org/licenses/.
 
-#+begin_html
+#+begin_export html
 <a href="http://opensource.org/licenses/GPL-3.0">
   <img src="http://img.shields.io/:license-gpl-blue.svg" alt=":license-gpl-blue.svg" />
 </a>
@@ -1641,7 +1655,7 @@ this program. If not, see http://www.gnu.org/licenses/.
 <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VCVAS6KPDQ4JC&lc=BE&item_number=refcard%2dorg%2dmode&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted">
   <img src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" alt="btn_donate_LG.gif" />
 </a>
-#+end_html
+#+end_export
 
 * Footnotes