MapServer pdf broken

[warmerdam]

The link to the MapServer 5.6.3 documentation PDF (​http://www.mapserver.org/MapServer.pdf) gives a file that is apparently broken according to xpdf and Adobe Acrobat:

warmerda@gdal64[3]% xpdf MapServer.pdf 
Error: PDF file is damaged - attempting to reconstruct xref table...
Error: Couldn't find trailer dictionary
Error: Couldn't read xref table
warmerda@gdal64[4]% ls -l MapServer.pdf 
-rw-r--r-- 1 warmerda warmerda 2078103 2010-06-11 10:58 MapServer.pdf

[warmerdam]

bump?

[jmckenna]

• spent some time digging into this today
• the cause was the use of the ".. deprecated::" directive in some of the files
  • this example is valid rST but causes the pdflatex builder to break:

      GAP [int]
        .. deprecated:: 6.0
    
        This keyword has been deprecated in version 6.0. It has been replaced by the same keyword in the :ref:`STYLE`.
    

  • this is the workaround:

      GAP [int]
        This keyword has been deprecated in version 6.0. It has been replaced by the same keyword in the :ref:`STYLE`.
    
        .. deprecated:: 6.0
    

For some reason when using definition lists, the deprecated directive cannot be placed directly after the definition term, for pdf output.

The live PDF is fixed: ​http://www.mapserver.org/MapServer.pdf

[hobu]

Jeff,

Can you file a bug on this with Georg? ​http://bitbucket.org/birkenfeld/sphinx The buildup to the 1.0 final is happening still, and it would probably make it in. The latex builder is used by lots of people.

Howard

[jmckenna]

Good idea, I filed it in their tracker (​http://bitbucket.org/jespern/bitbucket/issue/1989/). Let's see what they say.