Re: [FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-29 Thread Stefano Sabatini
On date Wednesday 2024-05-29 11:50:40 +0100, Andrew Sayers wrote: > Posting this separately, as these are practical "how does FFmpeg work" issues > vaguely inspired by recent discussions. > > > *How do namespaces work in FFmpeg?* > > We've talked a bit about function namespaces recently. One re

Re: [FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-29 Thread Andrew Sayers
On Wed, May 29, 2024 at 01:06:30PM +0200, Paul B Mahol wrote: > On Wed, May 29, 2024 at 12:50 PM Andrew Sayers > wrote: > [...] > > *Are AVOptions just command-line options?* > > > > I have trouble with statements like "AVOptions is a framework for options", > > both because it's circular and bec

Re: [FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-29 Thread Paul B Mahol
On Wed, May 29, 2024 at 12:50 PM Andrew Sayers wrote: > Posting this separately, as these are practical "how does FFmpeg work" > issues > vaguely inspired by recent discussions. > > > *How do namespaces work in FFmpeg?* > > We've talked a bit about function namespaces recently. One reason I've >

Re: [FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-29 Thread Andrew Sayers
Posting this separately, as these are practical "how does FFmpeg work" issues vaguely inspired by recent discussions. *How do namespaces work in FFmpeg?* We've talked a bit about function namespaces recently. One reason I've suggested they're a weak signal is because they aren't really addresse

Re: [FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-29 Thread Andrew Sayers
On Tue, May 28, 2024 at 07:24:55PM +0200, Stefano Sabatini wrote: > > I think we start with different assumptions: you assume that most of > the readers are familiar with OOP jargon, and that they will leverage > the OOP jargon to understand the FFmpeg API. I think this is Not exactly. I'm sayin

Re: [FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-28 Thread Stefano Sabatini
On date Sunday 2024-05-26 13:06:52 +0100, Andrew Sayers wrote: > It feels like we've got through most of the mid-level "how FFmpeg works" > stuff, > and now we're left with language choices (e.g "options" vs. "introspection") > and philosophical discussions (e.g. the relationship between contexts

Re: [FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-26 Thread Andrew Sayers
It feels like we've got through most of the mid-level "how FFmpeg works" stuff, and now we're left with language choices (e.g "options" vs. "introspection") and philosophical discussions (e.g. the relationship between contexts and OOP). It's probably best to philosophise first, then come back to la

Re: [FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-25 Thread Stefano Sabatini
On date Wednesday 2024-05-22 17:07:51 +0100, Andrew Sayers wrote: [...] > > > diff --git a/doc/context.md b/doc/context.md > > > new file mode 100644 > > > index 00..fb85b3f366 > > > --- /dev/null > > > +++ b/doc/context.md > > > @@ -0,0 +1,394 @@ > > > +# Introduction to contexts > > > + >

Re: [FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-22 Thread Andrew Sayers
On Wed, May 22, 2024 at 11:31:52AM +0200, Stefano Sabatini wrote: > Sorry for the slow reply. Welcome back :) I've gathered some critiques of my own over the past week, which I'll pepper throughout the reply. Starting with... The document assumes (or is at least designed to be secure against) r

Re: [FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-22 Thread Stefano Sabatini
Sorry for the slow reply. On date Wednesday 2024-05-15 16:54:19 +0100, Andrew Sayers wrote: > Derived from detailed explanations kindly provided by Stefano Sabatini: > https://ffmpeg.org/pipermail/ffmpeg-devel/2024-April/325903.html > --- > doc/context.md | 394 +++

[FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-15 Thread Andrew Sayers
Derived from detailed explanations kindly provided by Stefano Sabatini: https://ffmpeg.org/pipermail/ffmpeg-devel/2024-April/325903.html --- doc/context.md | 394 + 1 file changed, 394 insertions(+) create mode 100644 doc/context.md diff --git a/do

Re: [FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-05 Thread Andrew Sayers
On Sun, May 05, 2024 at 10:31:18AM +0200, Andreas Rheinhardt wrote: > Andrew Sayers: > > Derived from detailed explanations kindly provided by Stefano Sabatini: > > https://ffmpeg.org/pipermail/ffmpeg-devel/2024-April/325903.html > > --- > > doc/context.md | 308 +++

Re: [FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-05-05 Thread Andreas Rheinhardt
Andrew Sayers: > Derived from detailed explanations kindly provided by Stefano Sabatini: > https://ffmpeg.org/pipermail/ffmpeg-devel/2024-April/325903.html > --- > doc/context.md | 308 + > 1 file changed, 308 insertions(+) > create mode 100644 doc/

[FFmpeg-devel] [PATCH v4 1/4] doc: Explain what "context" means

2024-04-29 Thread Andrew Sayers
Derived from detailed explanations kindly provided by Stefano Sabatini: https://ffmpeg.org/pipermail/ffmpeg-devel/2024-April/325903.html --- doc/context.md | 308 + 1 file changed, 308 insertions(+) create mode 100644 doc/context.md diff --git a/do