aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndre Weissflog <floooh@gmail.com>2018-10-17 20:37:04 +0200
committerAndre Weissflog <floooh@gmail.com>2018-10-17 20:37:04 +0200
commitec44d23fc1369660d36d2f9386238d80d81c1963 (patch)
treec01b560981e53a049c21455183d9561f65178dbc
parent277208aa70796f2ea3674dc8cdc9312c5fb8637c (diff)
sokol_args.h: some header-doc fixes
-rw-r--r--sokol_args.h18
1 files changed, 10 insertions, 8 deletions
diff --git a/sokol_args.h b/sokol_args.h
index 3fbc5cbd..b456777a 100644
--- a/sokol_args.h
+++ b/sokol_args.h
@@ -16,24 +16,26 @@
OVERVIEW
========
- sokol_args.h provides a unified argument parsing API for WebAssembly and
+ sokol_args.h provides a simple unified argument parsing API for WebAssembly and
native apps.
- When running as WebAssembly app, arguments are taken from the URL, for instance:
+ When running as WebAssembly app, arguments are taken from the page URL:
https://floooh.github.io/tiny8bit/kc85.html?type=kc85_3&mod=m022&snapshot=kc85/jungle.kcc
- Providing the same args to a native app would look like this:
+ The same arguments provided to a command line app:
- > kc85 type=kc85_3 mod=m022 snapshot=kc85/jungle.kcc
+ kc85 type=kc85_3 mod=m022 snapshot=kc85/jungle.kcc
ARGUMENT FORMATTING
===================
- On the web platforms, arguments must be formatted as a URL query string
- with special characters 'percent encoded'.
+ On the web platform, arguments must be formatted as a valid URL query string
+ with 'percent encoding' used for special characters.
- Strings are expected to be UTF-8 encoded (see below on how to get UTF-8 encoded
- command line args on Windows).
+ Strings are expected to be UTF-8 encoded (although sokol_args.h doesn't
+ contain any special UTF-8 handling). See below on how to obtain
+ UTF-8 encoded argc/argv values on Windows when using WinMain() as
+ entry point.
On native platforms the following rules must be followed: