headers
Nicolas George | 23 Jul 2012 15:04
Favicon

[PATCH 1/2] faq: disambiguate "join".


Signed-off-by: Nicolas George <nicolas.george <at> normalesup.org>
---
 doc/faq.texi |   45 ++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 42 insertions(+), 3 deletions(-)

diff --git a/doc/faq.texi b/doc/faq.texi
index d10faa1..93ba105 100644
--- a/doc/faq.texi
+++ b/doc/faq.texi
 <at>  <at>  -213,8 +213,46  <at>  <at>  For ANY other help on Avisynth, please visit the

  <at> section How can I join video files?

-A few multimedia containers (MPEG-1, MPEG-2 PS, DV) allow to join video files by
-merely concatenating them.
+To "join" video files is quite ambiguous. Using accurate words will make
+finding resources easier. To join video files may mean:
+
+ <at> itemize
+
+ <at> item
+To put them one after the other: this is called to  <at> emph{concatenate} them
+(in short: concat) and is addressed
+ <at> ref{How can I concatenate video files, in this very faq}.
+
+ <at> item
+To put them together in the same file, to let the user choose between the
+different versions (example: different audio languages): this is called to
+ <at> emph{multiplex} them together (in short: mux), and is done by simply using
(Continue reading)

Permalink | Reply |
headers
Nicolas George | 23 Jul 2012 15:04
Favicon

[PATCH 2/2] faq: suggest the concat filter.


Signed-off-by: Nicolas George <nicolas.george <at> normalesup.org>
---
 doc/faq.texi |   11 +++++++++++
 1 file changed, 11 insertions(+)

The page on the website does not yet have the section on the concat filter;
I assume it is handled by a crontab sometime in the night.

diff --git a/doc/faq.texi b/doc/faq.texi
index 93ba105..cc3a7f0 100644
--- a/doc/faq.texi
+++ b/doc/faq.texi
 <at>  <at>  -251,6 +251,15  <at>  <at>  the other; it can be done using the
  <at> anchor{How can I concatenate video files}
  <at> section How can I concatenate video files?

+There are several solutions, depending on the exact circumstances.
+
+ <at> subsection Concatenating using filters
+
+FFmpeg has a  <at> url{http://ffmpeg.org/ffmpeg.html#concat-1,  <at> code{concat}}
+filter designed specifically for that, with examples in the documentation.
+
+ <at> subsection Concatenating at the file level
+
 A few multimedia containers (MPEG-1, MPEG-2 PS, DV) allow to concatenate
 video by merely concatenating the files them.

 <at>  <at>  -290,6 +299,8  <at>  <at>  cat intermediate1.mpg intermediate2.mpg |\
(Continue reading)

Permalink | Reply |
headers
Stefano Sabatini | 23 Jul 2012 15:47
Picon

Re: [PATCH 2/2] faq: suggest the concat filter.

On date Monday 2012-07-23 15:04:58 +0200, Nicolas George encoded:
> 
> Signed-off-by: Nicolas George <nicolas.george <at> normalesup.org>
> ---
>  doc/faq.texi |   11 +++++++++++
>  1 file changed, 11 insertions(+)
> 
> 
> The page on the website does not yet have the section on the concat filter;
> I assume it is handled by a crontab sometime in the night.
> 
> 
> diff --git a/doc/faq.texi b/doc/faq.texi
> index 93ba105..cc3a7f0 100644
> --- a/doc/faq.texi
> +++ b/doc/faq.texi
>  <at>  <at>  -251,6 +251,15  <at>  <at>  the other; it can be done using the
>   <at> anchor{How can I concatenate video files}
>   <at> section How can I concatenate video files?
>  
> +There are several solutions, depending on the exact circumstances.
> +
> + <at> subsection Concatenating using filters
> +

> +FFmpeg has a  <at> url{http://ffmpeg.org/ffmpeg.html#concat-1,  <at> code{concat}}

I believe it is better to use an xref, so you don't depend on the
internal URL which may change depending on texi2html.
(Continue reading)

Permalink | Reply |
headers
Nicolas George | 28 Jul 2012 18:14
Favicon

Re: [PATCH 2/2] faq: suggest the concat filter.

Le sextidi 6 thermidor, an CCXX, Stefano Sabatini a écrit :
> I believe it is better to use an xref, so you don't depend on the
> internal URL which may change depending on texi2html.

Unfortunately, that is not possible: the FAQ is compiled completely
separately from the rest of the documentation, and thus can not see
references to it at all.

> Looks good otherwise, thanks.

Thanks, I'll push in a few minutes.

Regards,

--

-- 
  Nicolas George

_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel <at> ffmpeg.org
http://ffmpeg.org/mailman/listinfo/ffmpeg-devel
Permalink | Reply |
headers
Stefano Sabatini | 23 Jul 2012 15:44
Picon

Re: [PATCH 1/2] faq: disambiguate "join".

On date Monday 2012-07-23 15:04:57 +0200, Nicolas George encoded:
> 
> Signed-off-by: Nicolas George <nicolas.george <at> normalesup.org>
> ---
>  doc/faq.texi |   45 ++++++++++++++++++++++++++++++++++++++++++---
>  1 file changed, 42 insertions(+), 3 deletions(-)
> 
> diff --git a/doc/faq.texi b/doc/faq.texi
> index d10faa1..93ba105 100644
> --- a/doc/faq.texi
> +++ b/doc/faq.texi
>  <at>  <at>  -213,8 +213,46  <at>  <at>  For ANY other help on Avisynth, please visit the
>  
>   <at> section How can I join video files?
>  
> -A few multimedia containers (MPEG-1, MPEG-2 PS, DV) allow to join video files by
> -merely concatenating them.
> +To "join" video files is quite ambiguous. Using accurate words will make
> +finding resources easier. To join video files may mean:
> +
> + <at> itemize
> +
> + <at> item
> +To put them one after the other: this is called to  <at> emph{concatenate} them
> +(in short: concat) and is addressed
> + <at> ref{How can I concatenate video files, in this very faq}.
> +
> + <at> item
> +To put them together in the same file, to let the user choose between the
> +different versions (example: different audio languages): this is called to
(Continue reading)

Permalink | Reply |
headers
Alexander Strasser | 24 Jul 2012 00:57
Picon

Re: [PATCH 1/2] faq: disambiguate "join".

Hi Nicolas,

  just a few (nit) comments. I like the clarification and additional
documentation. Consider to address my comments depending on your
motivation and agreement.

Nicolas George wrote:
> Signed-off-by: Nicolas George <nicolas.george <at> normalesup.org>
> ---
>  doc/faq.texi |   45 ++++++++++++++++++++++++++++++++++++++++++---
>  1 file changed, 42 insertions(+), 3 deletions(-)
> 
> diff --git a/doc/faq.texi b/doc/faq.texi
> index d10faa1..93ba105 100644
> --- a/doc/faq.texi
> +++ b/doc/faq.texi
>  <at>  <at>  -213,8 +213,46  <at>  <at>  For ANY other help on Avisynth, please visit the
>  
>   <at> section How can I join video files?
>  
> -A few multimedia containers (MPEG-1, MPEG-2 PS, DV) allow to join video files by
> -merely concatenating them.
> +To "join" video files is quite ambiguous. Using accurate words will make
> +finding resources easier. To join video files may mean:

  IMHO sounds a bit too teacher-like (sorry, really no pun intended). Maybe:

    To "join" video files is quite ambiguous. The following list explains
    the different kinds of "joining" and points out how those are addressed
    in FFmpeg. To join video files may mean:
(Continue reading)

Permalink | Reply |
headers
Nicolas George | 28 Jul 2012 18:24
Favicon

Re: [PATCH 1/2] faq: disambiguate "join".

Le septidi 7 thermidor, an CCXX, Alexander Strasser a écrit :
>   IMHO sounds a bit too teacher-like (sorry, really no pun intended). Maybe:
> 
>     To "join" video files is quite ambiguous. The following list explains
>     the different kinds of "joining" and points out how those are addressed
>     in FFmpeg. To join video files may mean:
> 
> Or similar. No strong opinion on this one...

I changed it to adopt your wording.

>   Is there a preposition missing between above and below? "in"?

I had the same impression when re-reading it, but in fact on: the
preposition is hidden in the text of the link, with texinfo's strange
syntax.

>   "using ... options to ffmpeg" sounds odd. Maybe  "giving ... options to",
> or "invoking ffmpeg with ... options".
> 
>   Maybe native English speakers can clarify. I am not so please take my
> comments with a grain of salt.

Changed like that.

> Good work on making the FAQ more useful,

Thanks, pushed both patches.

Regards,
(Continue reading)

Permalink | Reply |

Gmane