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 247B64575B for ; Sat, 20 Jan 2024 11:32:55 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 1972268D030; Sat, 20 Jan 2024 13:32:53 +0200 (EET) Received: from mail-ej1-f41.google.com (mail-ej1-f41.google.com [209.85.218.41]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 8F92868CE3D for ; Sat, 20 Jan 2024 13:32:46 +0200 (EET) Received: by mail-ej1-f41.google.com with SMTP id a640c23a62f3a-a28bd9ca247so164085366b.1 for ; Sat, 20 Jan 2024 03:32:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1705750365; x=1706355165; darn=ffmpeg.org; h=user-agent:in-reply-to:content-disposition:mime-version:references :mail-followup-to:message-id:subject:to:from:date:from:to:cc:subject :date:message-id:reply-to; bh=143/Kn3/QaaUYskcrEqp3+qQf+2t4N0irU1NPHHpTFs=; b=Tn6DJ1zfJz5nUPaiiljbAj7U1MoX/u2YJ7kMH5wavioCy9lSv2JF23LUANtUohjmNy pJQkyvWPiOjXPtISSYc4F3H4HQx+RHA4t8/zD36nF41eZ6xDFZ2k7JFHgC7RLlvF/G6m 6l1nLqvqOZdqnrzlLi+6NfUjSbfrgeLP956ZlbDzZuENDyd4tHqoq50VToSAjaZrLKuz N8vlsTf9hQB34TtnhW2M+Me4LTLy30yr/noEdIqOk8Oh2k89IH+lS2KJBo5uEoM1I18/ caWaQcGrsrIhkDQxErU+VTV6eQKgLLjnSSFVIVfhJ966efmQ72MwmuDV/b8gBpwKt0AU GkQA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1705750365; x=1706355165; h=user-agent:in-reply-to:content-disposition:mime-version:references :mail-followup-to:message-id:subject:to:from:date:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=143/Kn3/QaaUYskcrEqp3+qQf+2t4N0irU1NPHHpTFs=; b=Dvu2yvR57dPLWWmoAnNTQGU/dX/DokjDiDCHr8kMC6HYvT5ip4NOKktSGEsp8lMa7Z vTJyNLpBz4gkvpxsNXog0ZmbNbzeOTvmnulqQbjBuvyc5idBBTotEfNu3Wvr5xV1K90D +kYA6kZNrrY0RQb0S0gm/qzou+rbQXSRE/ktw2Y/7hTWDLlWP6QdIfUbZ/WOcWPwUAOH LYsLAY4PGu0RKws7EBjTmQCVaXRpCcvE5idfTL+FbO2iJWWQKxseyG/wPEaruvuDkDzJ uqhkUURgIPRzQiUh7b1C8wOdJYugIZ9lYw7bgJ7rMqmlHegU9NEEq0DWIv5Ybb2aIRrE Autw== X-Gm-Message-State: AOJu0Yw8Xt9BCr++dNYdGlU8pxMDEFOfhqh9VLFwbLJpFYe1jTuTD+Bj PWGpOpqoziQsL8R00VNF52k2gXnBqgh//A3CV0selitLCqogg2eNMYZbDDan X-Google-Smtp-Source: AGHT+IEsOs/Ak13FXrK1uA+PFTY0neOjZiuRjtUEugH3fDc6gebT6oWSGsRug7BvFt3se8Y1xcOZTA== X-Received: by 2002:a17:906:bc8a:b0:a28:fdac:c985 with SMTP id lv10-20020a170906bc8a00b00a28fdacc985mr668048ejb.81.1705750364747; Sat, 20 Jan 2024 03:32:44 -0800 (PST) Received: from mariano (dynamic-adsl-84-220-189-10.clienti.tiscali.it. [84.220.189.10]) by smtp.gmail.com with ESMTPSA id k6-20020a170906128600b00a2b0b0fc80esm11258443ejb.193.2024.01.20.03.32.44 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 20 Jan 2024 03:32:44 -0800 (PST) Received: by mariano (Postfix, from userid 1000) id C64E1BFCDC; Sat, 20 Jan 2024 12:32:42 +0100 (CET) Date: Sat, 20 Jan 2024 12:32:42 +0100 From: Stefano Sabatini To: FFmpeg development discussions and patches Message-ID: Mail-Followup-To: FFmpeg development discussions and patches References: <20240105164251.28935-1-anton@khirnov.net> <20240105164251.28935-7-anton@khirnov.net> <170548215151.8914.14196080795223407302@lain.khirnov.net> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <170548215151.8914.14196080795223407302@lain.khirnov.net> User-Agent: Mutt/2.1.4 (2021-12-11) Subject: Re: [FFmpeg-devel] [PATCH 7/8] fftools/ffmpeg_demux: implement -bsf for input 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: On date Wednesday 2024-01-17 10:02:31 +0100, Anton Khirnov wrote: > Quoting Stefano Sabatini (2024-01-06 13:12:19) > > > > This looks spurious, since this suggests the example is about the > > listing, and it's applying a weird order of example/explanation > > (rather than the opposite). Use the @code{-bsfs} option to get the list of bitstream filters. E.g. @example ... The problem here is that "E.g." is placed close to a statement about the listing, therefore it might sound like the example is about the listing (which is not). > I see nothing weird about this order, it's the standard way it is done > in most literature I encounter. I find the reverse order you're > suggesting far more weird and unnatural. When you present an example you usually start with an explanation (what it does) and then present the command, not the other way around. Also the following: -------------------------------------- ffmpeg -bsf:v h264_mp4toannexb -i h264.mp4 -c:v copy -an out.h264 @end example applies the @code{h264_mp4toannexb} bitstream filter (which converts MP4-encapsulated H.264 stream to Annex B) to the @emph{input} video stream. On the other hand, @example ffmpeg -i file.mov -an -vn -bsf:s mov2textsub -c:s copy -f rawvideo sub.txt @end example applies the @code{mov2textsub} bitstream filter (which extracts text from MOV subtitles) to the @emph{output} subtitle stream. Note, however, that since both examples use @code{-c copy}, it matters little whether the filters are applied on input or output - that would change if transcoding was hapenning. --------------------------------------- this makes the reader need to correlate the two examples to figure them out, that's why I reworked the presentation in my suggestion as a more linear sequence of presentation/command/presentation/command. In general examples should focus on how a task can be done, not on the explanation of the command itself. _______________________________________________ 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".