From 1cee39117ef66dcef9e7cfe0491a005d1f65468e Mon Sep 17 00:00:00 2001
From: Steven Liu <lingjiujianke@gmail.com>
Date: Sat, 24 Sep 2016 20:27:43 +0800
Subject: [PATCH] doc/muxers: add hls_segment_size option document

and make an sample introduce how to use hls_segment_size.

Signed-off-by: Steven Liu <lingjiujianke@gmail.com>
---
 doc/muxers.texi | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/doc/muxers.texi b/doc/muxers.texi
index 27eb9a0..033fd6f 100644
--- a/doc/muxers.texi
+++ b/doc/muxers.texi
@@ -431,6 +431,19 @@ ffmpeg in.nut -hls_segment_filename 'file%03d.ts' out.m3u8
 This example will produce the playlist, @file{out.m3u8}, and segment files:
 @file{file000.ts}, @file{file001.ts}, @file{file002.ts}, etc.
 
+@item hls_segment_size @var{integer}
+Set maximum size per segment media file (in bytes). Useful to reduce
+the number of individual segment media files produced by combining
+segments into one or more larger files. The resulting playlist will
+support @code{#EXT-X-VERSION:4} and will specify segments using byte
+ranges to refer to the proper location in the associated media file.
+Note that this does not affect the number of segments in the playlist,
+but the number of resulting media files that the segments refer to.
+@example
+ffmpeg in.nut -hls_segment_size 2000000 out.m3u8
+@end example
+In this example each segment media file size will be roughly 2000000 bytes.
+
 @item use_localtime
 Use strftime on @var{filename} to expand the segment filename with localtime.
 The segment number (%d) is not available in this mode.
-- 
2.7.4 (Apple Git-66)

