Re: [docbook-apps] Programlistingco issue

[David Cramer <david@thingbag.net>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 06/21/2012 04:53 PM, Carlos Araya wrote:
> We had an earlier conversation about using area spec with 
> programlistingco and how it would not work giving coordinates, and 
> arrived to examples like the one below:
...
> When switching to Jing as my validator I get the following error
> for all the programco examples.
> 
> /Users/carlos/experiment/docbook-epub/docbook-howto.xml:76:17:
> error: element "programlisting" not allowed yet; missing required
> element "areaspec"
> 
> I've worked around this by inserting a dummy areaspec tag and its 
> children. Is there a way for me to eliminate the need to have
> areaspec as part of programlistinco? Is there a reason why I need
> to have the areaspec in an example that doesn't use them? Am I
> missing anything?

Hi Carlos,
I don't know the details of the previous discussion, but we only use
<programlistingco> when we're also xincluding the code sample in (with
parse="text"). That way we can define the line and column number at
which the callout should appear in the code listing.

If we've got a code listing directly in the DocBook file, we instead
add <co> elements like you do in the example above. In that case, the
programlistingco element is not needed.

I believe you have to have the callout extensions set up for the
areaspec method to work.

As usual, Bob's book [1] has lots of valuable information.

David

[1] http://www.sagehill.net/docbookxsl/AnnotateListing.html
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJP45zTAAoJEMHeSXG7afUhh+cIAIA7Gzpbfjld0tmtLhmQOzlA
+8fzPKHw6R48YGMl/6s202kojRo6RAb2cKI19T3zinVDQBTuDGDsDZwPB0y/D25R
YUvNGwca2mLC/8SxeZwXTDWWOSKRjRt2KKnr4dNok/D+fB/O9Tr8+xqaBhmDB7sw
kQLUacNqkFYV05mdSMddmPbgVqHmm6CNHsJGTCkjstVSk5RDvcGqkhcDkAIOreGz
ZFbna/bbCvexZcfb6dvxfyKMRrgfz0C3OjtjxaWwQ4hU6Mm3ckQe4mpDHX2RKpXA
hhBaoDHVoA2LFFLjhMO8EiJaeZVENVZSJELLts9x4DxnMJez1EQ6rYJNShaJSXA=
=u+qo
-----END PGP SIGNATURE-----