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 E817B488B4 for ; Sun, 21 Jan 2024 18:35:11 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 174BE68CD6D; Sun, 21 Jan 2024 20:35:09 +0200 (EET) Received: from mail0.khirnov.net (red.khirnov.net [176.97.15.12]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id AB46B68C919 for ; Sun, 21 Jan 2024 20:35:02 +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=bxoPhYzY; dkim-atps=neutral Received: from localhost (localhost [IPv6:::1]) by mail0.khirnov.net (Postfix) with ESMTP id 72F5C2405F2 for ; Sun, 21 Jan 2024 19:35:02 +0100 (CET) Received: from mail0.khirnov.net ([IPv6:::1]) by localhost (mail0.khirnov.net [IPv6:::1]) (amavis, port 10024) with ESMTP id 041i5mT_spwM for ; Sun, 21 Jan 2024 19:35:01 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=khirnov.net; s=mail; t=1705862101; bh=pI3phIHORq0BkhmDU9V+1jvCryo2yfIwx30QkYFwlVE=; h=Subject:From:To:In-Reply-To:References:Date:From; b=bxoPhYzYvaB68DkLjjuc9jtDm4oCH7AOUWDgHEgaDrOvHAxqsqbTrnQAajLGyAjg4 UkHGrDDg5nLl4Skpho+XZTzI3W7IuPVhpMFZjh0ilqSL4qKg/7WrQl3Mwex1RP0aZv aAVoio6yL2E3AP1jVMEEo9NQVUG2jli3Z2XPcpWM9u3zGSZw/+0tteRJVId8ti2sfs MzQ86bDQWQXIbZp5SI2zacBnDMDrwEWvgUBDvj/y8sSOgPPaAPQgLBiPFIAwPRgaXK 8wZyUQV2L5leI9KLswx5IoHmoligLy7VwqBUdiuenry1rj+bG/z03ElefmGtgLvLqg hH2oSZfKYQUbw== 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 857332404E5 for ; Sun, 21 Jan 2024 19:35:01 +0100 (CET) Received: by lain.khirnov.net (Postfix, from userid 1000) id 60BF91601B9; Sun, 21 Jan 2024 19:35:01 +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> Mail-Followup-To: FFmpeg development discussions and patches Date: Sun, 21 Jan 2024 19:35:01 +0100 Message-ID: <170586210136.8914.15904763128533295371@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 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 (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. I have also personally seen (and fixed) countless instances of mindlessly perpetuated cargo cults in it. -- 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".