Commit Graph

252 Commits

Author SHA1 Message Date
Bill Currie 777ce56cf3 [doc] Enable MathJax
Nice. Very nice.
2020-03-07 17:48:19 +09:00
Bill Currie a55b9544ac Improve handling of pr_argc
It is now set to 0 when progs are loaded and every time
PR_ExecuteProgram() returns. This takes care of the default case, but
when setting parameters, pr_argc needs to be set correctly in case a
vararg function is called.
2020-02-25 17:36:29 +09:00
Bill Currie 729ac22267 Make qw connection sequence visible
Black lines with transparent background on a black backdrop...
2020-02-11 15:54:45 +09:00
Bill Currie bdf2443d01 Fix ambiguous image file name warnings
Most of the warnings are due to a bug in doxygen (fixed in 1.8.17,
but...), however some were legit due to overzealous image search paths
wildly including the doxygen output tree.
2020-02-11 15:27:32 +09:00
Bill Currie 9248e8cf01 Update for doxygen 1.8.16 2020-02-11 15:22:42 +09:00
Bill Currie b38a6bb7a4 Get the dynamic imt docs into doxygen.
I need to rewrite the whole key binding documentation at some stage, but
this will make things easier.
2016-01-04 17:24:51 +09:00
Bill Currie c25fd410a5 Update doxygen config files for 1.8.9.1 2016-01-04 11:17:09 +09:00
Bill Currie 8b9f513883 Correct a spelling mistake. 2015-08-09 18:24:17 +09:00
Jeff Teunissen bdb221c1d7 Make the docs better for people blessed with sight
Under certain conditions, language keywords for code examples were being
shown in the same color as the background. This...didn't work out well.
2014-10-16 13:49:43 -04:00
Bill Currie cb448f21b5 Update for doxygen 1.8.5 2014-01-28 16:22:05 +09:00
Bill Currie 831f84a47b Add my vkb config script.
It's a bit ugly, but it does nicely demonstrate what can be done with QF's
input system.
2013-01-29 16:40:46 +09:00
Bill Currie 3e38c4aa48 Merge branch 'qfcc-cse'
qfcc now does local common subexpression elimination. It seems to work, but
is optional (default off): use -O to enable. Also, uninitialized variable
detection is finally back :)

The progs engine now has very basic valgrind-like functionality for
checking pointer accesses. Enable with pr_boundscheck 2
2012-12-13 20:17:28 +09:00
Bill Currie 054d902d3a Document alias defs.
The diagram showing the basics of how alias defs work is in a spearate file
because it created to much clutter in the header file.
2012-12-09 19:43:12 +09:00
Bill Currie 215856045f Clean up some bitrot in docstrap.
The configuration file had been renamed.

Also, mention docstrap in INSTALL and make the documentaion configure check
for the required tools (doxygen, dot (graphvis), mscgen, and transfig).
2012-12-06 11:50:29 +09:00
Bill Currie f8f01fc9fb Change glx to x11 in the examples. 2012-08-12 09:20:20 +09:00
Bill Currie f1854c85b2 Fix some doxygen warnings and errors. 2012-07-15 07:39:50 +09:00
Bill Currie edf4ea84a1 Update the doxygen config for 1.8 2012-06-28 18:01:17 +09:00
Bill Currie bc1b483525 Nuke the rcsid stuff.
It's pretty useless in git.
2012-04-22 10:56:32 +09:00
Bill Currie b13a2b6dbd Move screenshots to $fs_userpath/QF.
I got tired of screenshots getting scatter across the tree. ShotsPath in
the dirconf can override this.
2012-01-05 17:07:27 +09:00
Jeff Teunissen e9ab230626 Docs: minor cleanups 2011-12-15 00:13:56 -05:00
Jeff Teunissen 69aa6c0e7e Work around an apparent Doxygen 1.7.6 bug.
For some reason, the construct \c " in config.dox makes the custom \QF
command fail to work for the rest of the file, and escaping the quote
doesn't help. Work around for now by using words.
2011-12-14 23:06:36 -05:00
Jeff Teunissen 1c590116af Docs: make sure the nav-tree is black, dammit. 2011-12-14 23:02:21 -05:00
Bill Currie d32fa834cc Make links to the cvar/cmd lists. 2011-12-11 18:40:02 +09:00
Bill Currie 8bab548d16 Make the hud type configurable via dirconf.
Currently only "id", "hipnotic" and "rogue" are supported (anything else is
treated as "id"). Has no effect in quakeworld (good thing too: changing
gamedirs is a little broken).
2011-09-11 08:13:26 +09:00
Bill Currie 8c67a872c6 Add the gib docs to make dist. 2011-09-09 17:29:13 +09:00
Bill Currie 272e955f18 Fix the version reporting.
$Id doesn't work in git, and didn't really report the right version anyway.
2011-09-08 19:11:43 +09:00
Bill Currie 6f4d918c66 Begin documenting sound and tidy up specifications. 2011-09-08 14:38:57 +09:00
Bill Currie 1dda097c65 Document the command line console command interface. 2011-09-08 13:06:11 +09:00
Bill Currie 79cec9d7b5 Create a template file for our documentation. 2011-09-08 11:46:46 +09:00
Bill Currie e72d4923aa Finish up the docs for cvars and config files.
For now, anyway :)
2011-09-08 10:28:48 +09:00
Bill Currie 6a7b316572 Put my text editing vim settings into the docs.
Vim's autoformating doesn't like our style of comments, so I have to force
it to do what I want. Having to set the appropriate options every time I
edit a file got to be a RPITA, so time to get the computer to do it for me
:)
2011-09-08 10:17:58 +09:00
Bill Currie 1e827485ef Do some work on the user documentation.
Also document part of the cvar api.
2011-09-07 21:08:37 +09:00
Jeff Teunissen a56f6b2e37 Docs: switch to SVG for the .fig files, add borders around imgs
Self-explanatory, really.
2011-08-23 01:39:40 -04:00
Bill Currie 8b23e0e7f0 Fix yet another typo :P 2011-08-20 20:26:41 +09:00
Bill Currie d14eff6c76 Run the docs through aspell. 2011-08-20 19:55:54 +09:00
Bill Currie 373f136fe6 Fix a typo. 2011-08-20 19:39:47 +09:00
Bill Currie f49a41b4b2 Comment on our lack of mp3 support. 2011-08-20 19:31:01 +09:00
Bill Currie 46f9c9b105 Document QF's tracklists. 2011-08-20 19:24:14 +09:00
Bill Currie 6268bd2965 Tweak the property list docs a little. 2011-08-20 19:23:31 +09:00
Bill Currie a759a5a376 Make the property-list documentation useful for users. 2011-08-20 16:29:59 +09:00
Bill Currie 14c23879b1 Add a shortcut for QuakeForge.
I got tired of typing QuakeForge all the time, and to ensure consistency,
made it so \QF or @QF will expand to QuakeForge in the generated docs.
2011-08-20 16:11:24 +09:00
Bill Currie 605d60167d Rename the doxygen formatted text files.
So I don't have to keep duplicating file names all over the place, I've
decided to use the "dox" extension on text files that are formatted for
doxygen processing. This way, doxygen can search for them using wildcards,
and unformated text files won't cause any headaches.
2011-08-20 13:35:51 +09:00
Bill Currie f7b52e0e15 Convert and link INSTALL into our doxygen docs. 2011-08-16 14:17:17 +09:00
Bill Currie d6dc09d9f9 Re-enable the buglist. 2011-07-29 13:36:50 +09:00
Jeff Teunissen c7c646a53f Makefile portability fixes
Allow our makefiles to build with non-GNU 'make' implementations.
Required some renaming of not-really-QuakeC source to .r to get it right.
2011-07-25 17:22:44 -04:00
Jeff Teunissen 30040d4d14 update doxygen 1.7.4 layout format
They added an "intro" key, which I don't grok yet. When I find out WTF
it means, I'll probably add some text.
2011-07-25 17:22:44 -04:00
Jeff Teunissen 5ef92009f0 Switch to SVG images for docs.
Doxygen 1.7.3 added support for SVG output from dot, so let's use it.
2011-07-25 17:22:44 -04:00
Jeff Teunissen 9d2a3d2545 Docs: Re-enable bolding
also, make CODE tags bold, to help them stand out a little more.
2011-07-25 17:22:44 -04:00
Bill Currie d910c14935 Clean up some doxygen warnings. 2011-07-10 19:12:07 +09:00
Jeff Teunissen 26bfc4b394 Fix parameter names in documentation bodies
In \param sections within function/etc. docs, argument names were being
displayed with the same formatting they are in the prototype...very ugly
on the background they're on. Make 'em white.
2011-07-09 23:30:09 -04:00