URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=ebb33b2c0aa7392f4c252f8789b8b0830215d40d Author: Eric Engestrom <e...@engestrom.ch> Date: Sun May 3 20:55:55 2020 +0200
post_version.py: update script to the new rST way of things Signed-off-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=8bc055fc527af0bd632608c1a2b8015e86fa781c Author: Eric Engestrom <e...@engestrom.ch> Date: Wed Apr 29 02:02:28 2020 +0200 gen_release_notes.py: update script to the new rST way of things Signed-off-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=9d90791c19ab5aba739e244c0887dd3be09be631 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Mon Apr 20 14:12:36 2020 +0200 docs/release-calendar: restore missing id I'm not sure how this got dropped, but it somehow did during conversion. Let's restore it. Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=8077267026b309d1483faf1dccde558603d2f333 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Mon Apr 20 13:12:12 2020 +0200 bin/perf-annotate-jit.py: update internal reference Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=cd01d0dee1621d21e0a3a325483a1857cd55899b Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Mon Apr 20 13:11:10 2020 +0200 radv: update internal reference Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=7d497e4e0985515056b6c97322e4b21dbc8fbeae Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Mon Apr 20 13:40:10 2020 +0200 docs/relnotes: update internal references I'm not 100% sure if it feels right to update these. I mean, this keeps links working as they should, even if exported to something else than HTML. But it also feels a bit like history revisionism. It's probably the right thing to do, though. Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=f1fe74afb2cd34264078db0b775a63ea3a14af0e Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Mon Apr 20 13:10:12 2020 +0200 docs: update internal references Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=ea91f4769ac347db828f4c6a3a36e7a4bdfee01e Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Mon Apr 20 13:07:37 2020 +0200 README: update references to internal docs These documents are no longer HTML files, so the internal reference should be updated. Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=0b4f5121f02023d9d87641b0fcd90feade78c3da Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Thu Jan 30 19:27:17 2020 +0100 docs: drop news in favour of the introduction as index-page This kind of only makes sense once we have a separate home-page. But I think this is a good way of showing why we should do this; Sphinx doesn't support pagination, because it's not meant as a general-purpose website framewrork. And for documentation, pagination is not really something you need. There's probably a lot more pages that should be moved into a separate webpage, similar to this. In general, I think this should be done for pages that don't relate to the source code too much, e.g isn't needed to understand the code, or for instance explains how to get the source code. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=064fe5f3f44dc102a57aaeaeb2aead5b42fb5589 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Mon May 27 17:12:10 2019 +0200 gitlab-ci: build and deploy docs Dunno if alpine is a good idea. It's what the gitlab docs use for most of their examples, so that's what I've gone with... Can probably be changed to something else if wanted. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=381fc0eca56fbec5c583612ea01bb63ca4f5d9c4 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Sat Apr 18 11:54:11 2020 +0200 docs: include specs into the generated docs Unfortunately, it doesn't seem like there's a way to have sphinx copy this without moving the files, becasue html_extra_path doesn't copy the directory itself when given a directory, only files inside and subdirectories. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=dd3add1b197eef55b2890b91c7e947ce6c0498cb Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Sat Apr 18 11:44:57 2020 +0200 docs: bundle extra files These are documents that are bundled in the root of the website, and contains some useful, extra documentation. Let's include them. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=62abe35e348ec1c72c38bb0e241e74f0b6957589 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Sat Apr 18 12:55:14 2020 +0200 docs: use rst-note for highlighted text Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=29c95ff627b52e7805a14ef99a5241aa406f379e Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Sat Apr 18 11:20:31 2020 +0200 docs: reformat license table as rst table Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=84140a7c06cf7bf587089ed2b068e5ed2a14b80e Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Sat Apr 18 11:07:53 2020 +0200 docs: use rst footnotes instead of manual ones Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=8342fe8302a4462266b1097df0c9823bb166dc41 Author: Laura Ekstrand <la...@jlekstrand.net> Date: Mon Jun 11 15:42:39 2018 -0700 docs: Add the favicon to the new page. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=17aefa73a10abc3221461e801150b5523a810663 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Mon Jun 10 20:15:08 2019 +0200 docs: do not copy source-files to site These docs have publically available sources in the first place, there's no point in including a copy of them here as well. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=21adb67048de1a62775f3859252746268d7c7cd8 Author: Laura Ekstrand <la...@jlekstrand.net> Date: Wed Jun 6 14:43:35 2018 -0700 docs: Remove version. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=54e38882a12862f07173f7e78b40eaa62e509504 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Tue Jun 4 17:29:39 2019 +0200 docs: add xlibdriver to table-of-contents It's not so nice to have a hidden article, so let's add this one to the TOC under "User Topics". Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=14f2a81b6f66e076318472a632b749e98d86f8d6 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Sat Apr 18 12:57:44 2020 +0200 docs: drop open-coded toc for articles Sphinx already provides a proper table-of-contents, so we don't need to roll our own. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=d6be994ef8ed6e81dc069a5cc3c8604619cc9d56 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Tue Jun 4 14:14:13 2019 +0200 docs: use code-blocks Sphinx can syntax-highlight a block if we use the right syntax. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=bf3f0f7a82e44e8a7c34afa6b56cc620619083ee Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Tue Jun 4 10:39:58 2019 +0200 docs: format notes as rst-notes Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=5aea48001fca482155e96d3cb38be231a64b3c39 Author: Laura Ekstrand <la...@jlekstrand.net> Date: Fri May 18 16:28:49 2018 -0700 docs: include meson in the toctree Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=7039310ae3933df6179a787746a4518d89bab8a8 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Mon May 6 14:18:23 2019 +0200 docs: use code-block with caption instead of table Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=dcaab1b311e7817eede82eacf18a8168f2f8475b Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Tue Jun 4 15:15:39 2019 +0200 docs: disable syntax-highlighting by default The default is python, which we don't really do a whole lot of in our docs, so let's just disable to none instead. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=00cd1346bf056dfc0e7c7f75a9a4e64f3715930c Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Thu May 2 23:21:36 2019 +0200 docs: use sphinx Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=0841da2fbb1122997c9fd4db9b2b7196ef815ae6 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Sat Apr 18 12:38:05 2020 +0200 docs: fixup heading-levels I have no idea why pandoc messed up these headers... Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=a71f08b71526a0ca80610db84e460eefbb51f554 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Tue Jun 4 14:14:27 2019 +0200 docs: fixup broken rst This removes a bit of markup, because it seems rst doesn't really support markup on links this way. I'm not sure why Pandoc generates this, but it misrenders. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=841a47fb2869f83b4b92bc9486264bcc0d712475 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Tue Jun 4 16:45:37 2019 +0200 docs: escape trailing underscores properly In reStructuredText, a trailing underscore means a hyperlink reference, but it seems pandoc doesn't get this right for symbols that have already been escaped. So let's manually fix these up. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=2c0707d13dbf17140f776102f8cff22913b1b55a Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Tue Jun 4 16:40:20 2019 +0200 docs: escape asterisks Seems pandoc messed these up, and left out some escpaing. Let's fix it up by hand. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=ceb8084885e75bc13ed32ac98f7f69ca9609006d Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Tue Jun 4 14:14:27 2019 +0200 docs: escape double colons It seems pandoc doesn't really understand that double colons needs to be escaped. So let's fix that up by hand. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=10bd811abc6e3e1f3ee2253f145b39ae8a43865e Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Thu May 2 21:20:51 2019 +0200 docs: fixup botched table Pandoc silently fails on colspan, breaking this table. But rst supports this just fine, so let's just hand-convert this table instead. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=1633174b785dba75ac3e1e1fddc62cc68310dc56 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Sat Apr 18 11:32:07 2020 +0200 docs: delete no longer needed file These files were used by the theming of the old website, and is no longer needed. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=c9c53e304252526914539cacb389c0fc5b7eb8c2 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Sun Apr 19 11:39:28 2020 +0200 TEMP: remove rst-conversion scripts These have now served their purpose, so let's get rid of them again. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=4d066836e3cf307431a74eafcc8a404ce5ccea69 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Fri Jun 12 20:09:42 2020 +0200 docs: convert articles to reructuredtext This uses the previously added scripts to convert the documentation to reStructuredText, which is both easier to read offline, and can be used to generate modern HTML for online documentation. No modification to the generated results have been done. Acked-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=1df5dbf51659000f74ca9511a211a7b026bfa936 Author: Erik Faye-Lund <erik.faye-l...@collabora.com> Date: Mon Jun 10 19:08:35 2019 +0200 TEMP: add rst-conversion scripts This is just a temporary commit, adding the scripts that performs the automated conversion of the docs. The next commit contains the results of the conversion, and the commit following that removes these scripts again. To redo the conversion in the next commit, rebase interactively to edit this commit and delete the next one, and run './update-docs.sh' from the root directory. Then continue the rebasing, and resolve any conflicts that might have occurred in the manual fixes on top. Finally, build the documentation to ensure no further fixups are needed. Reviewed-by: Eric Engestrom <e...@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4630> _______________________________________________ mesa-commit mailing list mesa-commit@lists.freedesktop.org https://lists.freedesktop.org/mailman/listinfo/mesa-commit