mirrors/SDL
1
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2025-10-26 12:27:44 +00:00
Code Issues Packages Projects Releases Wiki Activity
17,592 Commits 8 Branches 79 Tags
c48fbbb067bb21e91f0aa300d115b4819947ecc3
Commit Graph

98 Commits

Author SHA1 Message Date
Ryan C. Gordon
ffe4e571d1 wikiheaders: regex hack to make a URL not confuse wikilink genertion. 2024-10-04 15:34:18 -04:00
Ryan C. Gordon
abdd8b4929 wikiheaders: generate wiki redirect pages for individual enumerators. 2024-08-16 23:45:14 -04:00
Sam Lantinga
5e513ecc7f Don't automatically free temporary memory, let the application call SDL_FreeTemporaryMemory() when it's ready. 
Also mark up all functions that return temporary memory with SDL_DECLSPEC_TEMP, to help people implementing language bindings.

Fixes https://github.com/libsdl-org/SDL/issues/10378
 2024-07-26 10:05:03 -07:00
Ryan C. Gordon
2f6e34d2d0 wikiheaders: Added copyright comment to the top of file. 2024-07-22 22:39:09 -04:00
Ryan C. Gordon
7c2329cd78 wikiheaders: Fix C typedef parsing. 
Before, it was treating `typedef struct x x;` as a struct typedef instead of
a datatype typedef. Worse, it was treating `typedef struct x *x` the same!

This might require us to manually clean out some incorrect CategoryAPIStruct
tags that have accumulated in various pages.
 2024-06-15 11:31:17 -04:00
Ryan C. Gordon
c0c0c64a1d wikiheaders: Some quick scripting to make params/return info consistent. 
- Lowercase the first letter of \param and \returns data; in the former case,
  it looks better in the table and Doxyggen (imho), in the latter it's because
  it's inserted after the word "Returns" to make an english sentence on the
  wiki. This is disabled in this commit, but it was useful to turn it on to
  fix up the headers manually.

- Make sure everything ends with punctuation. Inserts a period if there's
  no existing period or exclamation point at the end of the text. This is
  enabled going forward, so we won't have to manage it ourselves.
 2024-06-14 02:08:50 -04:00
Ryan C. Gordon
2ad7c70ac6 documentation: clean up a minor syntax issue. 2024-06-13 18:10:28 -04:00
Ryan C. Gordon
a9d0eaf34a wikiheaders: Warn if a function returns non-void but has no \returns line. 2024-06-13 16:45:59 -04:00
Ryan C. Gordon
97ec4b0937 wikiheaders: fixed to work with not-SDL3 projects. 
(SDL2 still uses DECLSPEC, not SDL_DECLSPEC.)
 2024-06-12 19:30:10 -04:00
Ryan C. Gordon
fe620f0345 wikiheaders: List parameter and return value datatypes. 
This lets them be clickable on the wikipages when they are SDL symbols.

Reference Issue #9236 (the "Missing links" checklist).
Reference Issue #9995.
 2024-06-12 19:30:10 -04:00
Ryan C. Gordon
96bb06d9c7 wikiheaders: Clean out extra blank lines in function declarations on wiki. 
This has been driving me nuts for awhile now.  :)
 2024-06-11 12:37:41 -04:00
Ryan C. Gordon
386aa56711 wikiheaders: Make cleaning out function attributes more generic. 
Changes the wiki page's "Syntax" section from things like...

```c
void SDL_LockMutex(SDL_Mutex *mutex) SDL_ACQUIRE(mutex);
```

...to...

```c
void SDL_LockMutex(SDL_Mutex *mutex);
```
 2024-06-11 12:30:32 -04:00
Ryan C. Gordon
b53f6cf77a wikiheaders: Removed a FIXME comment. 2024-06-11 11:37:45 -04:00
Ryan C. Gordon
8e782602de wikiheaders: Fixes and cleanups to fix SDL_ReportAssertion's wiki page. 2024-06-11 11:29:44 -04:00
Ryan C. Gordon
c3a4b15a74 wikiheaders: Don't present printf-support compiler metadata in wiki. 2024-06-11 10:58:02 -04:00
Sam Lantinga
6f2621438a Renamed DECLSPEC to SDL_DECLSPEC 2024-05-17 17:09:09 -07:00
Ryan C. Gordon
5e6d85b8f0 wikiheaders: bridge wiki Category docs to the headers! 
Did an initial cleanup on the headers and wrote a few pieces of documentation,
but this needs more work to fill out the documentation.
 2024-05-16 11:48:23 -04:00
Sam Lantinga
fbe7e2e6d3 Moved the SDL version back to SDL_version.h 
Added a comment at the top of SDL.h with the current version, for informational purposes
 2024-05-15 14:38:29 -07:00
Sam Lantinga
661f2fc1fc Removed the SDL_Version structure, moved SDL version to SDL.h 
Inspired by https://github.com/libsdl-org/SDL/issues/9788
 2024-05-15 10:43:31 -07:00
Ryan C. Gordon
62a7e419f7 wikiheaders: Automatically categorize API symbols by subsystem. 2024-05-14 13:30:42 -04:00
Ryan C. Gordon
1d2b00efe1 wikiheaders: A few fixes that the SDL2 branch exposed. 2024-05-07 14:23:19 -04:00
Ryan C. Gordon
353001e077 wikiheaders: Fixed LaTeX chapter list and symbol sorting. 2024-05-05 02:44:45 -04:00
Ryan C. Gordon
b181e7b1ca wikiheaders: LaTeX output support. 
Reference Issue #9440.
 2024-05-05 02:03:44 -04:00
Ryan C. Gordon
0768e0e431 wikiheaders: Fixed See Also section in --copy-to-headers. 
This broke when the list bullet markdown was fixed, and then the fixed wiki
data was copied back to the headers.
 2024-05-05 01:53:37 -04:00
Ryan C. Gordon
a16b76cf80 wikiheaders: Markdown should use '-' for unordered lists, not '*'. 2024-05-05 01:22:45 -04:00
Ryan C. Gordon
77f4ffcc79 wikiheaders: Don't list SDL property #defines below functions. 
They will still generate "please refer to" pages, though.
 2024-05-03 13:19:27 -04:00
Ryan C. Gordon
92bd7d99dd wikiheaders: Deal with multiline typedefs. 
This happens more than once with function pointer typedefs.

Reference Issue #9440.
 2024-05-03 13:01:20 -04:00
Ryan C. Gordon
3348d0caaf wikiheaders: Deal with SDLMAIN_DECLSPEC functions. 2024-05-03 09:31:27 -04:00
Ryan C. Gordon
9f842e9b5a wikiheaders: Bind #defines below a function to it, like typedefs. 
This effectively adds the property symbols for various functions to the
function's wiki page.
 2024-05-02 12:49:30 -04:00
Ryan C. Gordon
eb2c9e9235 wikiheaders: added --report-coverage-gaps to see what we aren't covering! 2024-05-01 19:58:21 -04:00
Ryan C. Gordon
12b6c17575 wikiheaders: Generate wiki pages for defines under a typedef. 
These are just there to handle cases where a user stumbles upon a symbol
and punches it into the wiki, so they don't get a 404 for it, but rather
a pointer to where that symbol is relevant.

These pages are generated in the wiki if they don't exist, and are never
overwritten, in case text has been added to them. They are also not bridged
back to the headers or added to the set of manpages.
 2024-04-30 22:47:02 -04:00
Ryan C. Gordon
5481ea4cd4 wikiheaders: manpages See Also sections should specify 3 vs 3type. 2024-04-30 21:46:56 -04:00
Ryan C. Gordon
9210c68c44 wikiheaders: Manpages go in man3 directory, even if they're 3type. 2024-04-30 21:46:56 -04:00
Ryan C. Gordon
2ee1c87eb0 wikiheaders: Fixed preprocessor line check to include #endif. 
Reference Issue #9557.
 2024-04-25 16:46:43 -04:00
Ryan C. Gordon
6b1a98e664 wikiheaders: Allow basic typedefs to pull in some preprocessor logic. 
Reference Issue #9557.

This lets SDL_AudioFormat have the `#if byteorder == lilendian` section.
 2024-04-25 16:44:09 -04:00
Ryan C. Gordon
d29b861a76 wikiheaders: Allow blank lines in post-typedef #define blocks. 
Reference Issue #9557.
 2024-04-25 14:26:49 -04:00
Ryan C. Gordon
2fb024ab8e wikiheaders: Defines directly following a non-struct typedef are documented. 
The idea is that if you have a `typedef Uint32 MyFlags` that has a bunch of
defines that are meant to be bitflags, you can pack them into the same wiki
page automatically.

This only works with `typedef`s that are _not_ struct/union/enums, and it
only pulls in `#define` lines that immediately follow the typedef line.
Even a blank line or a comment will signal to stop including lines for
this page!
 2024-04-25 03:02:27 -04:00
Ryan C. Gordon
21bc72bef1 wikiheaders: Allow parts of the headers to be ignored. 
The specific cases here were SDL_size_mul_overflow_builtin and
SDL_size_add_overflow_builtin, which are forced-inline symbols in
SDL_stdinc.h that have to exist, but aren't really part of the public API,
and thus shouldn't be exported as documentation.
 2024-04-13 22:57:23 -04:00
Ryan C. Gordon
3c86af5901 wikiheaders: Add support for SDL_FORCE_INLINE functions. 2024-04-13 20:08:14 -04:00
Ryan C. Gordon
0df988389c include: Add \since to all documentation that was missing it. 2024-04-11 13:34:29 -04:00
Ryan C. Gordon
af6a4a9e38 wikiheaders: Fixed a silly logic bug. 2024-04-11 08:57:50 -04:00
Ryan C. Gordon
6ccdfffe26 wikiheaders: Fixes to manpage output for datatypes vs functions. 2024-04-11 01:03:07 -04:00
Ryan C. Gordon
5a58b3d97a wikiheaders: Bridge basic typedefs to the wiki! 2024-04-11 00:37:11 -04:00
Ryan C. Gordon
645073961d wikiheaders: Don't mangle Markdown tables in wordwrap. 2024-04-09 00:50:02 -04:00
Ryan C. Gordon
a25d49c162 wikiheaders: Bridge structs, unions, and enums to the wiki! 2024-04-09 00:50:02 -04:00
Ryan C. Gordon
125bbc5e61 wikiheaders: Fixed usage of die(). 
(if there's a newline in the output, it won't print the line in the Perl
script where the failure happened, so fix this in places where it's used
more like an assert than error reporting.)
 2024-04-09 00:50:02 -04:00
Ryan C. Gordon
34f4484f48 wikiheaders: Renamed "Related Functions" section to "See Also" 
It's not all functions now!
 2024-04-09 00:50:01 -04:00
Ryan C. Gordon
dd2780f9fb wikiheaders: Remove trailing whitespace from "brief" description. 2024-04-09 00:50:01 -04:00
Ryan C. Gordon
a26ec343c3 wikiheaders: Bridge macros to the wiki! 2024-04-09 00:50:01 -04:00
Ryan C. Gordon
e055a9fc2d wikiheaders.pl: Report a function's header file name. 2024-03-31 12:56:00 -04:00