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 E05D748906 for ; Mon, 22 Jan 2024 08:57:45 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 28D3068D0A4; Mon, 22 Jan 2024 10:57:42 +0200 (EET) Received: from mail0.khirnov.net (red.khirnov.net [176.97.15.12]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 5C56B68CEFD for ; Mon, 22 Jan 2024 10:57:36 +0200 (EET) Authentication-Results: mail0.khirnov.net; dkim=pass (2048-bit key; unprotected) header.d=khirnov.net header.i=@khirnov.net header.a=rsa-sha256 header.s=mail header.b=HSjPUv8m; dkim-atps=neutral Received: from localhost (localhost [IPv6:::1]) by mail0.khirnov.net (Postfix) with ESMTP id C74D32405F2 for ; Mon, 22 Jan 2024 09:57:35 +0100 (CET) Received: from mail0.khirnov.net ([IPv6:::1]) by localhost (mail0.khirnov.net [IPv6:::1]) (amavis, port 10024) with ESMTP id rXKp3IJYA1ty for ; Mon, 22 Jan 2024 09:57:35 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=khirnov.net; s=mail; t=1705913855; bh=yw6OU3Wj0zrkJobyUC3YfJmS83FC5oFWUGwl9inTJT0=; h=Subject:From:To:In-Reply-To:References:Date:From; b=HSjPUv8mO80AqSw/mNdASOkZP9gnZEx30wqHjYEIPMwVCikTAtyBVnjo+NgeX1oCC kixwLQ9Bg/u4sRLVUfX24C+RnQbAazpsCOQbYPjONGPIwceXVM0ZG0vbjb455f0zq0 A0RUnea2igo0YGCN+ae3u8xI9GINuwXWu0TrD3Do2K5PnXOHaoG3Nlm30fjZC4yWBq b+JmWQMD/Z5yX3lHkQIbtg6evuQDq4Lz1BgR/aQuJLIr/q6y1TFhcAF2r7mZckP8pv mZdECOWE+1is/OSQrvH/T3zDcRdo6D9ibY9iAwqIrglzTljM2C8RPru4M7tvZFyALQ irId2XwG2927A== 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 243E02404E5 for ; Mon, 22 Jan 2024 09:57:35 +0100 (CET) Received: by lain.khirnov.net (Postfix, from userid 1000) id 661901601B9; Mon, 22 Jan 2024 09:57:27 +0100 (CET) From: Anton Khirnov To: FFmpeg development discussions and patches In-Reply-To: References: <20240105164251.28935-1-anton@khirnov.net> <20240105164251.28935-7-anton@khirnov.net> <170548215151.8914.14196080795223407302@lain.khirnov.net> <170585901625.8914.14881418663136319578@lain.khirnov.net> <170586210136.8914.15904763128533295371@lain.khirnov.net> Mail-Followup-To: FFmpeg development discussions and patches Date: Mon, 22 Jan 2024 09:57:27 +0100 Message-ID: <170591384739.8914.1768446965607573773@lain.khirnov.net> User-Agent: alot/0.8.1 MIME-Version: 1.0 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: Quoting Stefano Sabatini (2024-01-21 20:15:46) > 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). I wouldn't be so sure. E.g. Qt has a bigger and more complex API than ours, yet its documentation is more complete and coherent. > > (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. I'm not saying everything is bad. I'm saying this specific way of writing examples is bad and should be changed. Which is what I'm doing in this patch. -- 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".