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 9EB3E488A8 for ; Sun, 21 Jan 2024 18:22:48 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id BDA9068D032; Sun, 21 Jan 2024 20:22:45 +0200 (EET) Received: from mail-ej1-f48.google.com (mail-ej1-f48.google.com [209.85.218.48]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id CB4EC68C7D1 for ; Sun, 21 Jan 2024 20:22:38 +0200 (EET) Received: by mail-ej1-f48.google.com with SMTP id a640c23a62f3a-a2d348d213dso216608466b.0 for ; Sun, 21 Jan 2024 10:22:38 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1705861358; x=1706466158; 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=AgC3StoY8GLbU/WgATwm8X9y+pyexCVrk7wszZrsQhQ=; b=QHOY0UaeBnOMFSZIuFifjxL8Qyot9uSY5MA6KtSvaUSM9eotTTHU6+sTav9xNrweoX srQIpU+0//LOs7TAHds3lyyP4cqv3RlenRyTW8pt2iteY6Cv5QUblCuMvgl0EfTb7NNL tcS1IouiPS7+aHVs/Lc20uETgfzte0s557fpihbM2tzEr7zrwtC6j23EGRtTHlgZd6C+ pAm5ZTyYjg9qf6tLgsKXSRLtJ1bQveHsxY7gkKnw1L4N9m0Wb26QMI0teppunHgdOpBN qpHqAQB/4OFHtn+fIqe/Vh8Wb7x3Uvh8IIN/gtUjo9pLg99jlKSIHSbLxz0eYG4ZA7zG sqzA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1705861358; x=1706466158; 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=AgC3StoY8GLbU/WgATwm8X9y+pyexCVrk7wszZrsQhQ=; b=GoI4S801Z53dcR9wPBBHTUOlnZtxD19c5k/ibGhqMJM/5KQEPqqQzWjrY+gpiZIFzK H4edETkfSs8sYZqnuVw2QTZ6RoTn91RMZcBJD7iZPRjdpvleV1NbNMRr/hE00CS1+zZQ IZVOohZqxPp5Dc5YTlsi+dLGqrhBLtqPgc9zKOc3gP5nLnrvsliyXMXoypJnC/g8wRC/ 6kfP4yAn93THqJheImvabmeg33e5R7Ba5JnPbLBwj2T54Ylugr+28tFDtFck37CaqnO6 EiUd/u+WjMJbT4d4YrYzOAkc3dz1KfyyLGVlcjIORy96MfkFJYIC5tH3xFl9AgcLjGhN oHlQ== X-Gm-Message-State: AOJu0Yy8Kf4B5COnsY/GkGvMBf1NdYDe9p+QR0MvarjqqASujOlyzO8a hxJ7d2lDXcgJNX2VnKcKd/3/U8lb/iNJiONmvdofTxn5/eR70VnW13ZrsWg8 X-Google-Smtp-Source: AGHT+IE+4Tp3YTyt+AOP+IrU3c4Vr6Z9wd1NTalLBcOY3GZ5GSnqE+WpF9aLlw9iW97eyUumuLQB5A== X-Received: by 2002:a17:907:b9d4:b0:a2d:2a2d:61b8 with SMTP id xa20-20020a170907b9d400b00a2d2a2d61b8mr1581093ejc.72.1705861357483; Sun, 21 Jan 2024 10:22:37 -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 c13-20020a170906170d00b00a2c047c6847sm12554644eje.113.2024.01.21.10.22.36 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 21 Jan 2024 10:22:36 -0800 (PST) Received: by mariano (Postfix, from userid 1000) id A1184BFCDC; Sun, 21 Jan 2024 19:22:35 +0100 (CET) Date: Sun, 21 Jan 2024 19:22:35 +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> <170585901625.8914.14881418663136319578@lain.khirnov.net> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <170585901625.8914.14881418663136319578@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 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. If you see most examples in the FFmpeg docs they are in the form: @item This does this and that...: @example ... @end example An explanation is presented *before* introducing the example itself, in other words plain English before the actual command/code. _______________________________________________ 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".