Commit Graph

258 Commits

Author SHA1 Message Date
Bill Currie 32a395a8d5 [dox] Fix up some doxygen issues
I found a few doxygen related patches in my git stash and while testing
them, found a few doc issues.
2022-04-13 14:17:58 +09:00
Bill Currie e9e54d08c0 [gamecode] Rename func_t to pr_func_t
Even more consistency.
2022-01-18 15:36:58 +09:00
Bill Currie 0fb3167858 [doc] Fix some typos 2021-03-29 19:02:22 +09:00
Bill Currie 07b869d1bf Fix some doxygen warnings 2021-01-22 15:23:04 +09:00
Bill Currie 55c1ed124d [doxygen] Fix some missed issues for doc building 2020-12-24 15:52:32 +09:00
Bill Currie 6d5ffa9f8e [build] Move to non-recursive make
There's still some cleanup to do, but everything seems to be working
nicely: `make -j` works, `make distcheck` passes. There is probably
plenty of bitrot in the package directories (RPM, debian), though.

The vc project files have been removed since those versions are way out
of date and quakeforge is pretty much dependent on gcc now anyway.

Most of the old Makefile.am files  are now Makemodule.am.  This should
allow for new Makefile.am files that allow local building (to be added
on an as-needed bases).  The current remaining Makefile.am files are for
standalone sub-projects.a

The installable bins are currently built in the top-level build
directory. This may change if the clutter gets to be too much.

While this does make a noticeable difference in build times, the main
reason for the switch was to take care of the growing dependency issues:
now it's possible to build tools for code generation (eg, using qfcc and
ruamoko programs for code-gen).
2020-06-25 11:35:37 +09:00
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