Some work on the XviD section:

- better divx5bvop description
- "new" (no)packed and (no)closed_gop options explained
- more appropriate wordings


git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@13895 b3059339-0415-0410-9bf9-f77b7e298cf2

2 files changed, 62 insertions, 23 deletions

diff --git a/DOCS/man/en/mplayer.1 b/DOCS/man/en/mplayer.1
index e79d7b6c37..518222e17c 100644
--- a/DOCS/man/en/mplayer.1
+++ b/DOCS/man/en/mplayer.1
@@ -33,7 +33,7 @@
 .\" Title
 .\" --------------------------------------------------------------------------
 .
-.TH MPlayer 1 "2004-11-02" "The MPlayer Project" "The Movie Player"
+.TH MPlayer 1 "2004-11-07" "The MPlayer Project" "The Movie Player"
 .
 .SH NAME
 mplayer  \- movie player
@@ -6495,8 +6495,8 @@ Use 4 motion vectors per macroblock.
 This might give better compression, but slows down encoding.
 .br
 .I WARNING:
-This option is deprecated in XviD-1.0.x, as all is now taken care of
-by the me_quality option.
+As of XviD-1.0.x, this option is no longer available separately, and its
+functionality is included in the me_quality option.
 When me_quality > 4, 4mv is activated.
 .
 .TP
@@ -6525,7 +6525,7 @@ CBR mode: min & max quantizer for all frames (default: 2\-31)
 2pass mode: min & max quantizer for I/\:P-frames (default: 2\-31/\:2\-31)
 .br
 .I WARNING:
-This option is deprecated in XviD-1.0.x, and is replaced by the
+As of XviD-1.0.x, this option is replaced by the
 [min|max]_[i|p|b]quant options.
 .
 .TP
@@ -6544,8 +6544,7 @@ For low bitrates, the smoothing of H.263 will give you less block noise.
 When using custom matrices, MPEG must be used.
 .br
 .I WARNING:
-This option is deprecated in XviD-1.0.x, and is replaced by the quant_type
-option.
+As of XviD-1.0.x, this option is replaced by the quant_type option.
 .
 .TP
 .B mod_quant
@@ -6557,7 +6556,7 @@ This will generate an illegal bitstream, and most likely not be decodable
 by any MPEG4 decoder besides libavcodec or XviD.
 .br
 .I WARNING:
-This option is deprecated in XviD-1.0.x.
+As of XviD-1.0.x, this option is no longer available.
 .
 .TP
 .B keyframe_boost=<0\-1000>
@@ -6579,6 +6578,14 @@ The last I-frame will get treated normally.
 (default: 30, 2pass mode only)
 .
 .TP
+.B divx5bvop
+Generate DivX5 compatible B-frames (default: on).
+This seems to be mandatory only for old versions of DivX's decoder.
+.br
+.I WARNING:
+As of XviD-1.0.x, this option is replaced by the closed_gop option.
+.
+.TP
 .B (no)greyscale
 Make XviD discard chroma planes so the encoded video is greyscale only.
 Note that this does not speed up encoding, it just prevents chroma data
@@ -6597,7 +6604,12 @@ releases of XviD 1.0.x (api4).
 .
 .TP
 .B (no)packed
-Create a bitstream which can be decoded delay-free.
+This option is meant to solve frame-order issues when encoding to
+container formats like AVI that cannot cope with out-of-order frames.
+In practise, most decoders (both software and hardware) are able to deal
+with frame-order themselves, and may get confused when this option is
+turned on, so you can safely leave if off, unless you really know what
+you are doing.
 .br
 .I WARNING:
 This will generate an illegal bitstream, and will not be
@@ -6608,10 +6620,6 @@ This will also store a fake DivX version in the file so the bug
 autodetection of some decoders might be confused.
 .
 .TP
-.B divx5bvop
-Generate DivX5 compatible B-frames (default: on).
-.
-.TP
 .B max_bframes=<0\-4>
 Maximum number of B-frames to put between I/\:P-frames (default: 0).
 .
@@ -6635,6 +6643,14 @@ The higher the value, the higher the probability of B-frames being used.
 (default: 0)
 .
 .TP
+.B (no)closed_gop
+This option tells XviD to close every GOP (Group Of Pictures bounded
+by two I-frames), which makes GOPs independent from each other.
+This just implies that the last frame of the GOP is eiter a P-frame or a
+N-frame but not a B-frame.
+It is usually a good idea to turn this option on (default: on).
+.
+.TP
 .B frame_drop_ratio=<0\-100> (max_bframes=0 only)
 This setting allows the creation of variable framerate video streams.
 The value of the setting specifies a threshold under which, if the
diff --git a/DOCS/man/fr/mplayer.1 b/DOCS/man/fr/mplayer.1
index 70686d25ad..2f623443b1 100644
--- a/DOCS/man/fr/mplayer.1
+++ b/DOCS/man/fr/mplayer.1
@@ -1,4 +1,4 @@
-.\" synced with 1.800
+.\" synced with 1.801
 .\" MPlayer (C) 2000-2004 MPlayer Team
 .\" This man page was/is done by Gabucino, Diego Biurrun, Jonas Jermann
 .\" Traduction: Nicolas Le Gaillart < nicolas AT legaillart.com >
@@ -35,7 +35,7 @@
 .\" Titre
 .\" --------------------------------------------------------------------------
 .
-.TH MPlayer 1 "2 Novembre 2004" "The MPlayer Project" "Le Lecteur Vidéo"
+.TH MPlayer 1 "7 Novembre 2004" "The MPlayer Project" "Le Lecteur Vidéo"
 .
 .SH NAME
 mplayer  \- Lecteur vidéo
@@ -3010,7 +3010,7 @@ Transforme le flux vidéo en une séquence d'images YUV 4:2:0 non compressées
 et les stocke dans un fichier nommé 'stream.yuv' dans le répertoire courant.
 Ce format est identique à celui employé par la suite mjpegtools, ce qui peut
 vous être utile pour retraiter cette vidéo avec cette suite.
-Ne que gère les formats YV12, RGB (24 bits/pixel) et BGR (24 bits/pixel).
+Ne gère que les formats YV12, RGB (24 bits/pixel) et BGR (24 bits/pixel).
 .PD 0
 .RSs
 .IPs interlaced
@@ -6785,6 +6785,7 @@ redimentionnement adapté à ce genre de vidéo, ce qui se fait avec
 .B 4mv\ \ \ \ 
 Utilise 4 vecteurs de mouvement par macro-bloc.
 Peut améliorer la compressibilité mais ralenti l'encodage.
+.br
 .I ATTENTION\ :
 Cette option n'existe plus séparément avec XviD 1.0.x, mais est activée
 automatiquement quand me_quality > 4.
@@ -6816,7 +6817,7 @@ mode 2passes\ : quantificateur min & max pour trames-I/\:P
 (par défaut\ : 2\-31/\:2\-31)
 .br
 .I ATTENTION\ :
-Cette option est dépassée avec XviD-1.0.x, où elle est remplacée par les
+À partir de XviD-1.0.x, cette option est remplacée par les
 options [min|max]_[i|p|b]quant.
 .
 .TP
@@ -6837,19 +6838,20 @@ image où les macro-blocs se verront moins.
 Si vous utilisez vos propres matrices de quantization, vous devez
 utiliser MPEG.
 .I ATTENTION\ :
-Cette option est dépassée avec XviD-1.0.x, où elle est remplacée par l'option
+À partir de XviD-1.0.x, cette option est remplacée par l'option
 quant_type.
 .
 .TP
 .B mod_quant
 Décide  trame par trame d'utiliser ou non les quantificateurs MPEG ou H.263.
+.br
 .I ATTENTION\ :
 Cette option génèrera un flux vidéo incompatible avec la norme MPEG4.
 Ainsi, ne pourrez-vous vraisemblablement le lire qu'avec libavcodec ou XviD.
 (mode 2passes uniquement)
 .br
 .I ATTENTION\ :
-Cette option n'existe plus avec XviD-1.0.x.
+Cette option n'existe plus à partir de XviD-1.0.x.
 .
 .TP
 .B keyframe_boost=<0\-1000>
@@ -6871,6 +6873,15 @@ La dernière trame-clé est traitée normalement.
 (défaut\ : 0, mode 2passes uniquement)
 .
 .TP
+.B divx5bvop
+Génère des trames-B compatibles DivX5 (par défaut\ : on).
+Ceci ne semble nécessaire qu'avec de vieilles versions du décodeur de DivX.
+.br
+.I ATTENTION\ :
+À partir de XviD-1.0.x, cette option est remplacée par l'option
+closed_gop.
+.
+.TP
 .B (no)greyscale
 Indique à XviD de ne pas enregistrer l'information de chroma pour que la
 vidéo produite ne soit qu'en noir & blanc.
@@ -6890,7 +6901,14 @@ stables 1.0.x de XviD (api4).
 .
 .TP
 .B (no)packed
-Crée un flux de bits pouvant être décodé sans délais.
+Cette option a pour but de résoudre les problèmes de l'ordre des trames
+lorsque l'encodage est fait vers un container comme AVI qui ne gère pas
+les trames dans le désordre.
+En pratique, la plupart des décodeurs (autant logiciels que matériels)
+sont capables de gérer les trames dans le désordre eux-même, et peuvent
+même être gênés lorsque cette option est activée, c'est pourquoi vous
+pouvez sans problème laisser cette option désactivée, à moins de savoir
+précisément ce que vous faites.
 .br
 .I ATTENTION\ :
 Ceci engendrera un flux de bits illégal vis à vis de la norme MPEG4,
@@ -6901,10 +6919,6 @@ Ceci ajoutera également une fausse version de divx dans le fichier donc
 l'autodétection de bogues risque de ne pas fonctionner.
 .
 .TP
-.B divx5bvop
-Génère des trames-B compatibles DivX5 (par défaut\ : on).
-.
-.TP
 .B max_bframes=<0\-4>
 Nombre maximum de trames-B à insérer entre les trames-I/\:P (par défaut\ : 0).
 .
@@ -6928,6 +6942,15 @@ Plus la valeur est haute, plus la probabilité que la trame générée soit
 une trame-B est forte (par défaut\ : 0).
 .
 .TP
+.B (no)closed_gop
+Cette option demande à XviD de fermer chaque GOP (Group Of Pictures\ :
+Groupe D'Images encadrées par deux trames-I), ce qui signifie que chaque
+GOP sera indépendant des GOP suivants.
+Ceci implique que la dernière trame du GOP est soit une trame-P ou une
+trame-N, mais pas une trame-B.
+Il est plutôt recommandé d'activer cette option (par défaut\ : activé)
+.
+.TP
 .B frame_drop_ratio=<0\-100> (max_bframes=0 uniquement)
 Cette option vous permet de créer les flux vidéo à débit de trame variable.
 Le paramètre définit un seuil en dessous duquel, si la différence