Replace ad-hoc API doc entirely with Doxygen

Makefile

@@ -3,12 +3,3 @@ all:
 	bundle exec jekyll build
 	#bash deploy_benchmarking.sh
 
-doxyjinj:
-	cd _doxygen_pretty && python3 doxyjinj.py struct_file.html ../_includes/liboqs/build/docs/xml/struct_o_q_s___k_e_m.xml 'https://github.com/open-quantum-safe/liboqs/tree/main/' > ../liboqs/api/oqskem.html
-	cd _doxygen_pretty && python3 doxyjinj.py struct_file.html ../_includes/liboqs/build/docs/xml/struct_o_q_s___s_i_g.xml 'https://github.com/open-quantum-safe/liboqs/tree/main/' > ../liboqs/api/oqssig.html
-	cd _doxygen_pretty && python3 doxyjinj.py struct_file.html ../_includes/liboqs/build/docs/xml/struct_o_q_s___s_i_g___s_t_f_l___s_e_c_r_e_t___k_e_y.xml 'https://github.com/open-quantum-safe/liboqs/tree/main/' > ../liboqs/api/oqssig_stfl_secret_key.html
-	cd _doxygen_pretty && python3 doxyjinj.py header_file.html ../_includes/liboqs/build/docs/xml/common_8h.xml 'https://github.com/open-quantum-safe/liboqs/tree/main/' > ../liboqs/api/common.html
-	cd _doxygen_pretty && python3 doxyjinj.py header_file.html ../_includes/liboqs/build/docs/xml/kem_8h.xml 'https://github.com/open-quantum-safe/liboqs/tree/main/' > ../liboqs/api/kem.html
-	cd _doxygen_pretty && python3 doxyjinj.py header_file.html ../_includes/liboqs/build/docs/xml/rand_8h.xml 'https://github.com/open-quantum-safe/liboqs/tree/main/' > ../liboqs/api/rand.html
-	cd _doxygen_pretty && python3 doxyjinj.py header_file.html ../_includes/liboqs/build/docs/xml/sig_8h.xml 'https://github.com/open-quantum-safe/liboqs/tree/main/' > ../liboqs/api/sig.html
-	cd _doxygen_pretty && python3 doxyjinj.py header_file.html ../_includes/liboqs/build/docs/xml/sig__stfl_8h.xml 'https://github.com/open-quantum-safe/liboqs/tree/main/' > ../liboqs/api/sig_stfl.html

README.md

@@ -36,9 +36,6 @@ git commit
 ```
 
 ## Rebuilding API documentation
-
-```bash
-make doxyjinj
-```
-
-Then clean up the diffs so that they have the YML header and don't have their own HTML header / footer.
+API documentation is generated by Doxygen and served under the path `/liboqs/api/doxygen`.
+A simple page is served at `/liboqs/api` to provide an explicit link to the documentation.
+See [`gen-c-api-docs.sh`](./gen-c-api-docs.sh) for details.