From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100]) by master.gitmailbox.com (Postfix) with ESMTP id 792BC45C77 for ; Thu, 30 Mar 2023 08:37:46 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id ABD9D68C5C4; Thu, 30 Mar 2023 11:37:43 +0300 (EEST) Received: from mail0.khirnov.net (red.khirnov.net [176.97.15.12]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id E9C9268C5C3 for ; Thu, 30 Mar 2023 11:37:36 +0300 (EEST) Received: from localhost (localhost [IPv6:::1]) by mail0.khirnov.net (Postfix) with ESMTP id 705F62404EE for ; Thu, 30 Mar 2023 10:37:36 +0200 (CEST) Received: from mail0.khirnov.net ([IPv6:::1]) by localhost (mail0.khirnov.net [IPv6:::1]) (amavisd-new, port 10024) with ESMTP id 7_Nt789LkEyP for ; Thu, 30 Mar 2023 10:37:35 +0200 (CEST) Received: from lain.khirnov.net (lain.khirnov.net [IPv6:2001:67c:1138:4306::3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "lain.khirnov.net", Issuer "smtp.khirnov.net SMTP CA" (verified OK)) by mail0.khirnov.net (Postfix) with ESMTPS id 871862404EC for ; Thu, 30 Mar 2023 10:37:35 +0200 (CEST) Received: by lain.khirnov.net (Postfix, from userid 1000) id 66F351601B2; Thu, 30 Mar 2023 10:37:34 +0200 (CEST) From: Anton Khirnov To: FFmpeg development discussions and patches In-Reply-To: <20230328232223.GR26811@mariano> References: <20230327002253.96051-1-stefasab@gmail.com> <47d095a4-5c13-b5a1-358a-0e002eb54c9e@gyani.pro> <20230328232223.GR26811@mariano> Mail-Followup-To: FFmpeg development discussions and patches Date: Thu, 30 Mar 2023 10:37:34 +0200 Message-ID: <168016545439.27013.17034819429371553493@lain.khirnov.net> User-Agent: alot/0.8.1 MIME-Version: 1.0 Subject: Re: [FFmpeg-devel] [PATCH] doc/ffmpeg: slightly rework introductory examples X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" Archived-At: List-Archive: List-Post: Quoting Stefano Sabatini (2023-03-29 01:22:23) > On date Monday 2023-03-27 10:59:34 +0530, Gyan Doshi wrote: > > > > > > On 2023-03-27 05:52 am, Stefano Sabatini wrote: > > > In particular, add a sentence to introduce the example, and add a simpler starting example. > > > > > > Address issue: > > > http://trac.ffmpeg.org/ticket/8730 > > > --- > > > doc/ffmpeg.texi | 16 ++++++++++++---- > > > 1 file changed, 12 insertions(+), 4 deletions(-) > > > > > > diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi > > > index adfc2726ff..68a6bc6e22 100644 > > > --- a/doc/ffmpeg.texi > > > +++ b/doc/ffmpeg.texi > > > @@ -49,22 +49,30 @@ Do not mix input and output files -- first specify all input files, then all > > > output files. Also do not mix options which belong to different files. All > > > options apply ONLY to the next input or output file and are reset between files. > > > +Some simple examples follow. > > > + > > > @itemize > > > @item > > > -To set the video bitrate of the output file to 64 kbit/s: > > > +Convert an input media file to a different format: > > > +@example > > > +ffmpeg -i input.avi output.avi > > > > It's not clear that the output is a different format. > > A different extension, maybe. > > Done with a fer more changes. > > From a92d8f8152cce3e349d21732248c6ccdecd000df Mon Sep 17 00:00:00 2001 > From: Stefano Sabatini > Date: Mon, 27 Mar 2023 02:22:28 +0200 > Subject: [PATCH 1/3] doc/ffmpeg: slightly rework introductory examples > > In particular, add a sentence to introduce the example, and add a > simpler starting example with no options. > > Also use different format for input.avi and output.mp4, to convey > that the conversion also works on the container format. > > Address issue: > http://trac.ffmpeg.org/ticket/8730 > --- > doc/ffmpeg.texi | 23 ++++++++++++++++------- > 1 file changed, 16 insertions(+), 7 deletions(-) > > diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi > index adfc2726ff..33dc271b8d 100644 > --- a/doc/ffmpeg.texi > +++ b/doc/ffmpeg.texi > @@ -49,24 +49,33 @@ Do not mix input and output files -- first specify all input files, then all > output files. Also do not mix options which belong to different files. All > options apply ONLY to the next input or output file and are reset between files. > > +Some simple examples follow. > + > @itemize > @item > -To set the video bitrate of the output file to 64 kbit/s: > +Convert an input media file to a different format, by re-encoding media streams > +to the target format: IMO 'to the target format' confuses people about what exactly 'format' means and how does it relate to 'container' and 'codec' used elsewhere in the manual. I'd just drop that part. -- Anton Khirnov _______________________________________________ ffmpeg-devel mailing list ffmpeg-devel@ffmpeg.org https://ffmpeg.org/mailman/listinfo/ffmpeg-devel To unsubscribe, visit link above, or email ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".