Hi,

[...]
> The Article Title
> =================
>
> The First Section
> -----------------
>
> .Bad Callouts
> [source,java]
> ----
> public class MyClass { <1>
>
>  public void someMethod() { <2>
>        }
> }

The source is passed through the markup filter *before* being scanned
for callouts.  If the filter adds any markup to <1> then it won't be
seen by the scanner. Hence the warning.

> ----
>
> <1> callout 1
> <2> callout 2
>
>
> .Good Callouts
> [source,java]
> ----
> public class MyClass { // <1>
>
>  public void someMethod() { // <2>
>        }
> }

Since the callout is in a comment the character sequence <1> isn't
disrupted by the filter so it is still recognised by asciidoc.

The need to put callouts in comments is documented here
http://www.methods.co.nz/asciidoc/userguide.html#_including_callouts_in_included_code

Cheers
Lex

-- 
You received this message because you are subscribed to the Google Groups 
"asciidoc" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/asciidoc?hl=en.

Reply via email to