Tcl Source Code

View Ticket
Login
Ticket UUID: 14e3c258d9c78725979d688d0e68d8b5627703d6
Title: Tcl's http manpage does not mention other content types can be used with -query
Type: Bug Version: 8.5
Submitter: anonymous Created on: 2014-01-07 15:23:27
Subsystem: 29. http Package Assigned To: nobody
Priority: 5 Medium Severity: Important
Status: Closed Last Modified: 2022-05-30 16:25:05
Resolution: Fixed Closed By: kjnash
    Closed on: 2022-05-30 16:25:05
Description:
The documentation for the -query option specified the following:

This flag causes ::http::geturl to do a POST request that passes the query to the server. The query must be an x-url-encoding formatted query. The ::http::formatQuery procedure can be used to do the formatting.

However this does not make sense of -type is also set. Empirical evidence seems to suggest that if -type is set, then -query can be in other types than x-url-encoding can be given to -query, and will be past as-is. This can be important e.g. when posting REST queries formatted with JSON, such as with the Google URL shortener API: https://developers.google.com/url-shortener/v1/getting_started#shorten

It's a small fix, but marked important as it's not obvious this can be used to do this core functionality.
User Comments: kjnash added on 2022-05-12 01:39:50:

Documentation http(n) changed to add this information. See commit [00c7068494f2c3b7].