From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <ffmpeg-devel-bounces@ffmpeg.org>
Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100])
	by master.gitmailbox.com (Postfix) with ESMTP id 94097488CE
	for <ffmpegdev@gitmailbox.com>; Sun, 21 Jan 2024 19:15:58 +0000 (UTC)
Received: from [127.0.1.1] (localhost [127.0.0.1])
	by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 0BE0E68CF80;
	Sun, 21 Jan 2024 21:15:56 +0200 (EET)
Received: from mail-ed1-f52.google.com (mail-ed1-f52.google.com
 [209.85.208.52])
 by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id B089A68CB57
 for <ffmpeg-devel@ffmpeg.org>; Sun, 21 Jan 2024 21:15:49 +0200 (EET)
Received: by mail-ed1-f52.google.com with SMTP id
 4fb4d7f45d1cf-55a44bb66d3so2614316a12.1
 for <ffmpeg-devel@ffmpeg.org>; Sun, 21 Jan 2024 11:15:49 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=gmail.com; s=20230601; t=1705864548; x=1706469348; 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=WI4IAcEIdqbJfOevMoppHA3ae6qZhsV2PNRHkjLSwy0=;
 b=FQvt0rtF4+q1kHNBa4Whq5pV8NRTBti4TxYHjfvKJBOq3PvYFBc+wpsiBiT1feQiUq
 Aezd6BLu44FW8+ExIfyR/5zw6jbKRt79psbynUTmMGKHub3ljPwp7dP/GDpTCbuw1D2v
 yjG1V/HKGuW+Iwc6dm+UyfYQoN6+hjrqItzIWAZpFcV1vRTPQtDG8sIgSrRGfRmeEXdt
 cNuN4xcclRmBzuvwBM1evHZoGXXveiAr0WMaDcQ3sXIjby0tBgX+yZgrnkZUwMZGbE3d
 ryqdV8uHCnGJSh1TG2ywSmND7jv1AS8mzLwSqkG+OMW8DzMddQ0Tv7X/e1sZHMql1dHk
 t9Nw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20230601; t=1705864548; x=1706469348;
 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=WI4IAcEIdqbJfOevMoppHA3ae6qZhsV2PNRHkjLSwy0=;
 b=NumvtWqqIRnk6pUMWmoMLBmmVbSIPJMnI829g4iJzMS7RDjCaYvgIWTGwEfgZZANn2
 3gO77gpcmSLApgQ9c7cN8JCnGp+ePppHzrdGI3lf0PMHS6Cgp1gjJkZmFlnobFPCmHRj
 /CWfMhbk6rq21KwLmqaqNE04q1BFVAzQKyxjAEGPxzgNGqaEUKWdVrzh5Olv5EWiTWT7
 aD6Bny6inVHuNsqPooA/ZpGolQezeqdmQYO2hKzBvBCMTPXNd2dErEhCEVVvj6pC+voP
 x19ZVTC8nsZWSWEMOfr1cIPtdww0XbWUe36OWg1btoMA5rxlt+oUns2CkmR06sDHqEgz
 2rzg==
X-Gm-Message-State: AOJu0YwyniE8uLqNoRmztVGB4XNhaxk7HPILtRrpiMvqnjugWjW2tq0F
 L7Xqo0JT33gCa+hEbiqdRVORWBJwzY/29icxY7xqsT40mXJjmARQBltnktqK
X-Google-Smtp-Source: AGHT+IGjGpijvVcHMq2dtXMPPDFfF7FBRrMK4lmxykCnoaEc+WlEDA53UbtclJrsmY8A9HUM/4QSOg==
X-Received: by 2002:aa7:d6c7:0:b0:55a:8cb3:e809 with SMTP id
 x7-20020aa7d6c7000000b0055a8cb3e809mr1557619edr.83.1705864548137; 
 Sun, 21 Jan 2024 11:15:48 -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
 n13-20020a056402060d00b0055a6f7aed17sm2972222edv.34.2024.01.21.11.15.47
 for <ffmpeg-devel@ffmpeg.org>
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Sun, 21 Jan 2024 11:15:47 -0800 (PST)
Received: by mariano (Postfix, from userid 1000)
 id A542EBFCDC; Sun, 21 Jan 2024 20:15:46 +0100 (CET)
Date: Sun, 21 Jan 2024 20:15:46 +0100
From: Stefano Sabatini <stefasab@gmail.com>
To: FFmpeg development discussions and patches <ffmpeg-devel@ffmpeg.org>
Message-ID: <Za1tYtnLsLM6tbR6@mariano>
Mail-Followup-To: FFmpeg development discussions and patches
 <ffmpeg-devel@ffmpeg.org>
References: <20240105164251.28935-1-anton@khirnov.net>
 <20240105164251.28935-7-anton@khirnov.net>
 <ZZlDo/QYPkSV13Qu@mariano>
 <170548215151.8914.14196080795223407302@lain.khirnov.net>
 <ZauvWnPOI+fA9aIn@mariano>
 <170585901625.8914.14881418663136319578@lain.khirnov.net>
 <Za1g61iGHV4X1ojL@mariano>
 <170586210136.8914.15904763128533295371@lain.khirnov.net>
MIME-Version: 1.0
Content-Disposition: inline
In-Reply-To: <170586210136.8914.15904763128533295371@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 <ffmpeg-devel.ffmpeg.org>
List-Unsubscribe: <https://ffmpeg.org/mailman/options/ffmpeg-devel>,
 <mailto:ffmpeg-devel-request@ffmpeg.org?subject=unsubscribe>
List-Archive: <https://ffmpeg.org/pipermail/ffmpeg-devel>
List-Post: <mailto:ffmpeg-devel@ffmpeg.org>
List-Help: <mailto:ffmpeg-devel-request@ffmpeg.org?subject=help>
List-Subscribe: <https://ffmpeg.org/mailman/listinfo/ffmpeg-devel>,
 <mailto:ffmpeg-devel-request@ffmpeg.org?subject=subscribe>
Reply-To: FFmpeg development discussions and patches <ffmpeg-devel@ffmpeg.org>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Errors-To: ffmpeg-devel-bounces@ffmpeg.org
Sender: "ffmpeg-devel" <ffmpeg-devel-bounces@ffmpeg.org>
Archived-At: <https://master.gitmailbox.com/ffmpegdev/Za1tYtnLsLM6tbR6@mariano/>
List-Archive: <https://master.gitmailbox.com/ffmpegdev/>
List-Post: <mailto:ffmpegdev@gitmailbox.com>

On date Sunday 2024-01-21 19:35:01 +0100, Anton Khirnov wrote:
> Quoting Stefano Sabatini (2024-01-21 19:22:35)
> > On date Sunday 2024-01-21 18:43:36 +0100, Anton Khirnov wrote:
> > > Quoting Stefano Sabatini (2024-01-20 12:32:42)
> > [...]
> > > > When you present an example you usually start with an explanation
> > > > (what it does) and then present the command, not the other way around.
> > > 
> > > I don't, neither does most literature I can recall. Typically you first
> > > present a thing, then explain its structure. Explaning the structure of
> > > something the reader has not seen yet is backwards, unnatural, and hard
> > > to understand.
> > 
> > I still don't understand what "literature" you are referring to.
> 
> Various manuals and textbooks I've read.
> 
> > If you see most examples in the FFmpeg docs they are in the form:
> 

> Our documentation is widely considered to be somewhere between atrocious
> and unusable

nah, it's not so bad, also this applies to most documentation

Besides FFmpeg is possibly the most sophisticated existing toolkit in
terms of features/configuration, so this is somehow expected (at least
if you expect a tutorial rather than a reference).

> (and sometimes actively misleading), so the fact that it
> does something in a specific way does not at all mean that it's a good
> idea.

So what do you propose instead? The fact that it is not perfect does
not mean that everything is bad.
_______________________________________________
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".