RE: [docbook-apps] Annotating program listings - Callouts - Chapter 27. Program listings - minor / nit typo ?

From
Robert Lucente <>
Date
2010-04-25T12:46:26+00:00
ID
Thread
RE: [docbook-apps] Annotating program listings - Callouts - Chapter 27. Program listings - minor / nit typo ?
Yesterday I asked a C language guru and he said that &amp; has nothing to do 
w/ C.

 

I think that there are 2 
possibilities

 

1) The "&amp;" has not been properly escaped from the 
DocBook perspective. This is a possibility because the program listing is not in 
CDATA

 

2) It could be an HTML thing

 

http://htmlhelp.com/reference/html40/entities/special.html

 

Perhaps there are other possibilities ?

 -----Original 
Message-----
From: Bob Stayton 
[mailto:]
Sent: Saturday, April 24, 2010 4:40 
PM
To: Robert Lucente; 

Subject: Re: [docbook-apps] 
Annotating program listings - Callouts - Chapter 27. Program listings - minor / 
nit typo ?

  
Hi Robert,

  
Thanks for taking the time to comment.  No, 
  it isn't a typo.  The programlisting is not in a CDATA section, so any 
  XML characters like & must be escaped as character entities.  That 
  character is intended to be a literal ampersand in the program 
  listing.

  
 

  
If you are asking me if the code itself makes 
  sense with an ampersand, I can't answer that.  I just cut and pasted it 
  from somewhere.  8^)

  
 

  
Bob Stayton
Sagehill Enterprises


  
 

  
 

  
    
----- Original Message ----- 

    
From: 
    Robert 
    Lucente 

    
To:  
    

    
Sent: Saturday, April 24, 2010 12:25 
    PM

    
Subject: [docbook-apps] Annotating 
    program listings - Callouts - Chapter 27. Program listings - minor / nit 
    typo ?

    

    
url: http://www.sagehill.net/docbookxsl/AnnotateListing.html#Callouts

The 
    program listing has

virtual int  parse(MyFetch &amp;fetcher) = 0;

I 
    think that "&amp" is 
    a typo in the above line of code ? 

    
This has probably already been found but just in 
    case.