Bug 110230

Summary:	"Read the documentation here" link on https://www.mesa3d.org/sourcedocs.html is a 404 error
Product:	Mesa	Reporter:	Laurent <laurentduroisin>
Component:	Other	Assignee:	mesa-dev
Status:	RESOLVED INVALID	QA Contact:	mesa-dev
Severity:	normal
Priority:	medium	CC:	a9016009
Version:	git
Hardware:	x86-64 (AMD64)
OS:	Linux (All)
Whiteboard:
i915 platform:		i915 features:

Description Laurent 2019-03-24 11:35:04 UTC

I downloaded the source code of mesa to try to fix the problem by myself, but I can't generate the documentation :

make
doxygen main.doxy
make: doxygen: Command not found
Makefile:7: recipe for target 'main.tag' failed
make: *** [main.tag] Error 127

And it's quite difficult to see where shader output operations and swap buffers operation are performed in all this code without documentation. :/

Comment 1 Andre Klapper 2019-03-24 13:13:33 UTC

> make: doxygen: Command not found

The obvious question for any "Command not found" output is: 
Do you have doxygen installed? Which version? In which path?

Comment 2 Laurent 2019-03-24 14:42:58 UTC

Ah this is something I have to install apart.

Ok I've installed doxygen and now it worked.

Comment 3 Laurent 2019-03-24 14:49:57 UTC

But the link is not correct, this gives me an url not found error :

https://www.mesa3d.org/doxygen/main/index.html

Comment 4 Andre Klapper 2019-03-24 14:56:38 UTC

If some incorrect link is given somewhere please explain where that incorrect link is given.
Nobody can fix something without clear steps to reproduce...

Comment 5 Laurent 2019-03-24 14:58:59 UTC

Here :

https://www.mesa3d.org/sourcedocs.html

Comment 6 Andre Klapper 2019-03-24 15:39:10 UTC

Thanks a lot for the clarification! Confirming.

Comment 7 Eric Engestrom 2019-03-25 10:43:01 UTC

The sentence starts with "If you're reading this page from your local copy of Mesa, [...]", which is evidently not true when not reading it from your local copy but from the website instead.

Comment 8 Laurent 2019-03-25 12:52:16 UTC

Ok but there isn't any source documentation generated in the mesa folder when I run doxygen command is it normal ? It seems it only point to links for reading the documentation.

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.