On Thu, Apr 18, 2024 at 11:22:09AM +0100, Andrew Sayers wrote:
> On 18/04/2024 10:13, epirat07@gmail.com wrote:
> > On 18 Apr 2024, at 9:52, Stefano Sabatini wrote:
> > > On date Wednesday 2024-04-17 17:24:02 +0100, Andrew Sayers wrote:
> > > > On 17/04/2024 14:58, Michael Niedermayer wrote:
> > > [...]
> > > > I've occasionally tried getting into ffmpeg for over a decade now, and have
> > > > lurked here for the past few months as I put in the effort to grok it.
> > > > On behalf of people who could contribute but don't, I'd like to suggest
> > > > ffmpeg focus on *learnability*.
> > > > 
> [...]
> > > > But other issues seem like quick wins - for example I've lost count of
> > > > all the times I typed two functions into Google, spent hours trying to
> > > > make them work together, then finally realised I was looking at the
> > > > documentation for 3.0 in one tab and 5.0 in the other.  Surely you can
> > > > just add a line to the top of the documentation like "click here to see
> > > > the trunk version of this file"?
> > > Functions are documented in doxygen, so they depend on the major.minor
> > > version, while you seem to refer to the FFmpeg version. Also on the
> > > website we usually only have the latest mainline documentation, so I
> > > don't understand how can you have different versions in different tabs
> > > (unless you didn't update that tab since months/years).
> > Thats not true and same things has happened to me multiple times,
> > thats why I always have to check the URL to make sure the docs
> > are the ones for master or latest release I am working with.
> > 
> > For example see this ancient documentation here:
> > https://ffmpeg.org/doxygen/1.2/index.html
> 
> I'm glad I'm not the only one making that mistake!  In fact, older versions
> don't just exist, they're often the first link in Google.  For example,
> typing "avformat_init_output" into Google and clicking on the first link
> takes me to [1] (version 3.2).
> 
> The website doesn't have documentation for 6.1 or 7.0 ([2] and [3]),

the docs for master are generated by a cronjob
the docs for releases are manually generated,
thx for reminding me about it, ive generated the 6.1 and 7.0 ones now


[...]
> Without getting too far off-topic, I would also be interested in knowing how
> docs are actually generated in practice. I've tried generating documentation

its just running doxygen with a Doxyfile
the Doxyfile is not  doc/Doxyfile from git because that could be a security
issue. But its a very similar file

thx

[...]
-- 
Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB

Dictatorship: All citizens are under surveillance, all their steps and
actions recorded, for the politicians to enforce control.
Democracy: All politicians are under surveillance, all their steps and
actions recorded, for the citizens to enforce control.