Merge pull request asciidoctor#231 from mojavelinux/issue-229

resolves asciidoctor#229 fix XML-friendly callout example

docs/_includes/callout-xml.adoc

@@ -4,21 +4,21 @@ Included in:
 - user-manual: callouts: XML-friendly callouts
 ////
 
-XML doesn't have line comments, so our "tuck the callout behind a line comment" trick doesn't work here.
+XML doesn't have line comments, so our ``tuck the callout behind a line comment'' trick doesn't work here.
 To use callouts in XML, you must place the callout's angled brackets around the the XML comment and callout number.
 
 Here's how it appears in a listing:
 
-[source]
+[source,subs="specialcharacters"]
 ....
-include::ex-callout.adoc[tags=non-xml]
+include::ex-callout.adoc[tags=source-xml]
 ....
 
 Here's how it looks when rendered:
 
 ====
-include::ex-callout.adoc[tags=non-xml]
+include::ex-callout.adoc[tags=source-xml]
 ====
 
-Notice the comment is gone.
+Notice the comment has been replaced with a circled number that cannot be selected.
 Now both you and the reader can copy and paste XML source code containing callouts without worrying about errors.

docs/_includes/ex-callout.adoc

@@ -16,15 +16,15 @@ line of code  ;; <3>
 <3> A callout behind a line comment for Clojure.
 // end::b-nonselect[]
 
-// tag::non-xml[]
+// tag::source-xml[]
 [source,xml]
 ----
 <section>
   <title>Section Title</title> <!--1-->
 </section>
 ----
 <1> The section title is required.
-// end::non-xml[]
+// end::source-xml[]
 
 // tag::b-src[]
 [source,ruby]

docs/asciidoc-syntax-quick-reference.adoc

@@ -677,12 +677,12 @@ include::{includedir}/ex-callout.adoc[tags=b-nonselect]
 [listing, subs="specialcharacters"]
 .XML code block with a non-selectable callout
 ....
-include::{includedir}/ex-callout.adoc[tags=non-xml]
+include::{includedir}/ex-callout.adoc[tags=source-xml]
 ....
 
 [.result]
 ====
-include::{includedir}/ex-callout.adoc[tags=non-xml]
+include::{includedir}/ex-callout.adoc[tags=source-xml]
 ====
 
 [listing]