Hello, doc maintainers:
Could I get some help with the Texinfo compilation which produces
/developer.html, please?
Page <http://ffmpeg.org/developer.html> is a document which has some
section headings displayed in green text, and some subheadings displayed
in grey text. Section headings appear in the Table of Contents, but
subheadings do not. For instance, at
<http://ffmpeg.org/developer.html#Documentation_002fOther>, the section
begins:
------------------------------------------------------------------------
_1.4.3 Documentation/Other_
_Subscribe to the ffmpeg-cvslog mailing list._
__
It is important to do this as the diffs of all commits are sent there
and reviewed by all the other developers. Bugs and possible improvements
or general questions regarding commits are discussed there. We expect
you to react if problems with your code are uncovered.
------------------------------------------------------------------------
I believe this page corresponds to file /doc/developer.html in the
FFmpeg build tree, which is compiled from source in /doc/developer.texi
via "make doc".
When I do "make doc" and generate /doc/developer.html from the current
*master* branch (commit ba98f84), I get a different-looking HTML file.
The section title is in light grey text, and the subheading is missing
entirely. At
<file:///Users/myuser/workspace/ffmpeg/doc/developer.html#Documentation_002fOther>,
the section begins:
------------------------------------------------------------------------
_1.4.3 Documentation/Other_
It is important to do this as the diffs of all commits are sent there
and reviewed by all the other developers. Bugs and possible improvements
or general questions regarding commits are discussed there. We expect
you to react if problems with your code are uncovered.
------------------------------------------------------------------------
The section headings come from @section and @subsection directives. The
subheadings come from @subheading directives. In doc/developer.texi, the
source of this section reads,
------------------------------------------------------------------------
@subsection Documentation/Other
@subheading Subscribe to the ffmpeg-cvslog mailing list.
It is important to do this as the diffs of all commits are sent there and
reviewed by all the other developers. Bugs and possible improvements or
general questions regarding commits are discussed there. We expect you to
react if problems with your code are uncovered.
------------------------------------------------------------------------
So, it appears that when compiling on my local machine, the @subheading
directives are discarded, and the styling differs from what is on
ffmpeg.org.
How can I compile /doc/developer.html from the FFmpeg sources so that:
1. the subheadings are included, and
2. the styling matches what is at ffmpeg.org/developer.html
Thanks in advance for your help. Best regards,
—Jim DeLaHunt
--
--Jim DeLaHunt, j...@jdlh.com http://blog.jdlh.com/ (http://jdlh.com/)
multilingual websites consultant
355-1027 Davie St, Vancouver BC V6E 4L2, Canada
Canada mobile +1-604-376-8953
_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
http://ffmpeg.org/mailman/listinfo/ffmpeg-devel
