[FFmpeg-trac] #3867(documentation:closed): PDF documentation fails to build on LINUX.

[FFmpeg]

#3867: PDF documentation fails to build on LINUX.
-------------------------------------+-------------------------------------
             Reporter:  cjg          |                    Owner:
                 Type:  enhancement  |                   Status:  closed
             Priority:  normal       |                Component:
              Version:  git-master   |  documentation
             Keywords:               |               Resolution:  wontfix
             Blocking:               |               Blocked By:
Analyzed by developer:  0            |  Reproduced by developer:  0
-------------------------------------+-------------------------------------
Changes (by gajjanag):

 * cc: gajjanagadde@… (added)
 * status:  new => closed
 * resolution:   => wontfix


Comment:

 As above thread points out, the texinfo manual says that the
 \backslashchar{} should not be needed for the .texi files in ffmpeg:
 http://www.gnu.org/software/texinfo/manual/texinfo/html_node/Inserting-a-Backslash.html.

 This is clearly an acknowledged bug in texinfo that is being actively
 worked on: http://lists.gnu.org/archive/html/bug-
 texinfo/2015-06/msg00001.html and link therein. It is painful, and shows
 the cruft of old legacy stuff, subtle incompatibilities, etc.

 In short, I am closing this as a wontfix for the following reasons:
 1. pdf is not even officially supported by ffmpeg.
 2. If you still really want to generate pdf, you can use wkhtmltopdf. I
 tested on a few html files, and the results are definitely quite good.
 3, As detailed above, this is an upstream bug of texinfo. If you want to
 generate pdf from texi, please file an upstream ticket.
 4. Working around upstream bug has little value compared to the work
 needed in light of the above, and the thread showing a tentative
 workaround in comment 11.

--
Ticket URL: <https://trac.ffmpeg.org/ticket/3867#comment:12>
FFmpeg <https://ffmpeg.org>
FFmpeg issue tracker