Many hyperlinks are disabled.
Use anonymous login
to enable hyperlinks.
Overview
Comment: | More documentation improvements. |
---|---|
Downloads: | Tarball | ZIP archive |
Timelines: | family | ancestors | descendants | both | trunk |
Files: | files | file ages | folders |
SHA3-256: |
984d973c348166817bce9715dfcb0224 |
User & Date: | drh 2019-03-07 14:49:20.380 |
Context
2019-03-08
| ||
00:08 | Add the forgotten helloworld.md documentation file. (check-in: 5f79eb875f user: drh tags: trunk) | |
2019-03-07
| ||
14:49 | More documentation improvements. (check-in: 984d973c34 user: drh tags: trunk) | |
14:37 | Further documentation refinements. (check-in: 271766c541 user: drh tags: trunk) | |
Changes
Changes to README.md.
︙ | ︙ | |||
18 19 20 21 22 23 24 25 26 27 28 29 30 31 | ------------- * ["Hello World!" App (6 lines of code)](/doc/trunk/docs/helloworld.md) * [Introduction To Writing Wapp Applications](/doc/trunk/docs/intro.md) * [Quick Reference](/doc/trunk/docs/quickref.md) * [Wapp Parameters](/doc/trunk/docs/params.md) * [Wapp Commands](/doc/trunk/docs/commands.md) * [URL Mapping](/doc/trunk/docs/urlmapping.md) * [Security Features](/doc/trunk/docs/security.md) * [How To Compile wapptclsh - Or Not](/doc/trunk/docs/compiling.md) * [Limitations of Wapp](/doc/trunk/docs/limitations.md) * [Example Applications](/file/examples) * [Real-World Uses Of Wapp](/doc/trunk/docs/usageexamples.md) * [Debugging Hints](/doc/trunk/docs/debughints.md) | > | 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 | ------------- * ["Hello World!" App (6 lines of code)](/doc/trunk/docs/helloworld.md) * [Introduction To Writing Wapp Applications](/doc/trunk/docs/intro.md) * [Quick Reference](/doc/trunk/docs/quickref.md) * [Wapp Parameters](/doc/trunk/docs/params.md) * [Wapp Commands](/doc/trunk/docs/commands.md) * [CGI Parameters](/doc/trunk/docs/quickref.md#cgiparams) * [URL Mapping](/doc/trunk/docs/urlmapping.md) * [Security Features](/doc/trunk/docs/security.md) * [How To Compile wapptclsh - Or Not](/doc/trunk/docs/compiling.md) * [Limitations of Wapp](/doc/trunk/docs/limitations.md) * [Example Applications](/file/examples) * [Real-World Uses Of Wapp](/doc/trunk/docs/usageexamples.md) * [Debugging Hints](/doc/trunk/docs/debughints.md) |
Changes to docs/params.md.
︙ | ︙ | |||
129 130 131 132 133 134 135 | If query parameters can have side effects, then you should omit the wapp-allow-xorigin-params call. Only invoke wapp-allow-xorigin-params for web pages that only query information. Do not invoke wapp-allow-xorigin-params on pages where the parameters can be used to change server-side state. | > | | 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 | If query parameters can have side effects, then you should omit the wapp-allow-xorigin-params call. Only invoke wapp-allow-xorigin-params for web pages that only query information. Do not invoke wapp-allow-xorigin-params on pages where the parameters can be used to change server-side state. <a name='cgidetail'></a> 3.0 CGI Parameter Details [(Quick reference)](quickref.md#cgiparams) ------------------------- The CGI parameters in Wapp describe the HTTP request that is to be answered and the execution environment. These parameter look like CGI environment variables. To prevent environment information from overlapping and overwriting query parameters, all the environment information uses upper-case names and all query parameters |
︙ | ︙ | |||
274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 | > http://example.com/cgi-bin/script/method/extra/path?q1=5 \_________/\_____________/\________________/ \__/ | | | | HTTP_HOST SCRIPT_NAME PATH_INFO `-- QUERY_STRING > http://example.com/cgi-bin/script/method/extra/path?q1=5 \_______________________________/ \____/ \________/ | | | BASE_URL PATH_HEAD PATH_TAIL > http://example.com/cgi-bin/script/method/extra/path?q1=5 | > > > > > > | | | | 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 | > http://example.com/cgi-bin/script/method/extra/path?q1=5 \_________/\_____________/\________________/ \__/ | | | | HTTP_HOST SCRIPT_NAME PATH_INFO `-- QUERY_STRING > http://example.com/cgi-bin/script/method/extra/path?q1=5 \_________/\_______________________________/ \__/ | | | HTTP_HOST REQUEST_URI `-- QUERY_STRING > http://example.com/cgi-bin/script/method/extra/path?q1=5 \_______________________________/ \____/ \________/ | | | BASE_URL PATH_HEAD PATH_TAIL > http://example.com/cgi-bin/script/method/extra/path?q1=5 \______________________________________/ \________/ | | SELF_URL PATH_TAIL ### 3.2 Undefined Parameters When Using SCGI on Nginx Some of the CGI parameters are undefined by default when using CGI mode with Nginx. If these CGI parameters are needed by the application, then values must be assigned in the Nginx configuration file. For example: |
︙ | ︙ |
Changes to docs/quickref.md.
︙ | ︙ | |||
41 42 43 44 45 46 47 | |**wapp-content-security-policy** _POLICY_|→|Set the CSP for the current page| |**wapp-debug-env**|→|Return a text description of the Wapp environment| |**wapp** {_TEXT_}|→|Append _TEXT_ without substitution| |**wapp-unsafe** _TEXT_|→|Append _TEXT_ that contains nothing that needs to be escaped| <a name="cgiparams"></a> | | | 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 | |**wapp-content-security-policy** _POLICY_|→|Set the CSP for the current page| |**wapp-debug-env**|→|Return a text description of the Wapp environment| |**wapp** {_TEXT_}|→|Append _TEXT_ without substitution| |**wapp-unsafe** _TEXT_|→|Append _TEXT_ that contains nothing that needs to be escaped| <a name="cgiparams"></a> 3.0 CGI Parameters [(More detail)](params.md#cgidetail) ------------------ > |BASE\_URL|→|URL for the Wapp script without a method| |CONTENT|→|Raw (unparsed) POST content| |CONTENT\_LENGTH|→|Number of bytes of raw, unparsed POST content| |CONTENT\_TYPE|→|Mimetype of the POST content| |
︙ | ︙ | |||
73 74 75 76 77 78 79 | 4.0 URL Parsing --------------- Assuming "env.tcl" is the name of the Wapp application script: > https://wapp.tcl.tk/demo/env.tcl/abc/def/ghi?a=5&b=22.425#point42 | | | | | | < > | 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 | 4.0 URL Parsing --------------- Assuming "env.tcl" is the name of the Wapp application script: > https://wapp.tcl.tk/demo/env.tcl/abc/def/ghi?a=5&b=22.425#point42 \_________/\___________/\__________/ \__________/ | | | | HTTP_HOST SCRIPT_NAME PATH_INFO QUERY_STRING > https://wapp.tcl.tk/demo/env.tcl/abc/def/ghi?a=5&b=22.425#point42 \______________________________/ \_/ \_____/ | | | BASE_URL PATH_HEAD `-- PATH_TAIL > https://wapp.tcl.tk/demo/env.tcl/abc/def/ghi?a=5&b=22.425#point42 \__________________________________/ \__________/ | | SELF_URL QUERY_STRING > SCRIPT_FILENAME := DOCUMENT_ROOT + SCRIPT_NAME |