Unescaped literal left braces are deprecated and a warning was added in
Perl 5.22.

This silences some deprecation warnings

Reviewed-by: Michael Niedermayer <michaelni@gmx.at>
Signed-off-by: James Almer <jamrial@gmail.com>

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

Intermixing =encoding utf-8 in the file can confuse some pod2man
implementations.

Makes it working better for our documentation purposes.

docs say:
'A document having more than one "=encoding" line should be considered an error. '

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

Inspired by GCC r86635.

This is more consistent with other man pages. For example in `man git`,
all the "git-help(1)" kind of cross refs are bold.

Signed-off-by: Timothy Gu <timothygu99@gmail.com>
Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

Fix potential spurious substitution.

The variable "$section" was replaced by "$chapter".

This allows to name an internal reference in the POD/MAN output.

Ignore @c man begin ... @c man end comments, rely on @chapter for marking
the beginning of the various manual top level sections.

This allows us to write markup which is not dependent on the specific
texi2pod.pl implementation.

This change causes a few rendering issues, which will be fixed in further
patches.

Ignore the other arguments, which have not to be processed by the POD
renderer.

With these commands it is possible to add HTML and non-HTML snippets,
which will be useful for the "See Also" manual chapters.

I cannot find a reason for such a rule, which was resulting in badly
escaped filtergraph snippets.

Fix trac ticket #1610.

The script was previously run with perl -w through the shebang
command. Now that the script is executed through direct perl invocation
the -w in the shebang command is ignored. This patch re-enables "use
warnings" whatever way the script is invoked.

Idea-By: jamal <jamrial@gmail.com>

This allows specifying additional directories to search for
@include files.

Signed-off-by: Mans Rullgard <mans@mansr.com>

texi2pod.pl

This allows to use the @xref{} command for the HTML output.

Originally committed as revision 25854 to svn://svn.ffmpeg.org/ffmpeg/trunk

placed, and not only if inside @c man begin/end sections.

Originally committed as revision 23544 to svn://svn.ffmpeg.org/ffmpeg/trunk

generated document following the same order as that used in the texi
file.

Also allow rendering of *all* the sections, not only a limited
predefined subset.

Originally committed as revision 23543 to svn://svn.ffmpeg.org/ffmpeg/trunk

outputs the section if WORDS has been defined in the list of options
flags.

The meaning of this rule is not clear, and not used by the FFmpeg
documentation system anyway.

Originally committed as revision 23542 to svn://svn.ffmpeg.org/ffmpeg/trunk

the corresponding sections in the man page have been renamed that way.

Originally committed as revision 23493 to svn://svn.ffmpeg.org/ffmpeg/trunk

or texinfo command for specifying how to generate @item marks, and
make it use by default the mark symbol "*".

This is consistent with texinfo docs:
"If you don't specify a mark command, the default is `@bullet'."

Originally committed as revision 23408 to svn://svn.ffmpeg.org/ffmpeg/trunk

Originally committed as revision 4842 to svn://svn.ffmpeg.org/ffmpeg/trunk

Originally committed as revision 4764 to svn://svn.ffmpeg.org/ffmpeg/trunk

Originally committed as revision 4749 to svn://svn.ffmpeg.org/ffmpeg/trunk

Originally committed as revision 2136 to svn://svn.ffmpeg.org/ffmpeg/trunk