Added some notes on API documentation.
authorRyan C. Gordon <icculus@icculus.org>
Wed, 27 Sep 2017 16:13:00 -0400
changeset 1615 7ee477e62e86
parent 1614 c87a4e04c996
child 1617 67ca4c4f043e
Added some notes on API documentation.
docs/README-API-documentation.txt
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/README-API-documentation.txt	Wed Sep 27 16:13:00 2017 -0400
@@ -0,0 +1,18 @@
+The API documentation is readable in a few ways:
+
+- Read physfs.h; it's _heavily_ documented and the primary source of reference
+  documentation for the library.
+- Run Doxygen over the header, which produces nicer-to-browse documentation in
+  HTML, LaTeX, manpage, etc formats. This is done for you if Doxygen is
+  installed and you build the "docs" target in whatever project files CMake
+  generated for you.
+- Too much trouble? We generated the HTML reference for you, online here:
+
+      https://icculus.org/physfs/docs/
+
+- We would love well-written tutorials for the latest version of PhysicsFS!
+  If you write one, we would love to list it here. Drop me a line about it:
+  icculus@icculus.org ... Thanks!
+
+--ryan.
+