On 4/18/2024 4:50 PM, Michael Niedermayer wrote:
On Thu, Apr 18, 2024 at 11:22:09AM +0100, Andrew Sayers wrote:
On 18/04/2024 10:13, epira...@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
I updated https://ffmpeg.org/documentation.html with links to them.
[...]
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
[...]
_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel
To unsubscribe, visit link above, or email
ffmpeg-devel-requ...@ffmpeg.org with subject "unsubscribe".
_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel
To unsubscribe, visit link above, or email
ffmpeg-devel-requ...@ffmpeg.org with subject "unsubscribe".