Skip to content

Commit

Permalink
add information about curl -F option without outer quote IQSS#4510
Browse files Browse the repository at this point in the history
What this PR does / why we need it:
Add information about problem with curl -F option without outer quote for curl 7.56.0 and higher versions. IQSS#4510
Which issue(s) this PR closes:
IQSS#4510
Special notes for your reviewer:
None.
Suggestions on how to test this:
None.
Does this PR introduce a user interface change? If mockups are available, please link/include them here:
No.
Is there a release notes update needed for this change?:
No.
Additional documentation:
  • Loading branch information
KimJinYeon committed Jun 19, 2023
1 parent 4538d03 commit 501ad42
Showing 1 changed file with 14 additions and 0 deletions.
14 changes: 14 additions & 0 deletions doc/sphinx-guides/source/api/getting-started.rst
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,20 @@ If you ever want to check an environment variable, you can "echo" it like this:
echo $SERVER_URL
With curl version 7.56.0 and higher, it is recommended to use --form-string with outer quote rather than -F flag without outer quote.

For example, curl command parameter below might cause error such as ``warning: garbage at end of field specification: ,"categories":["Data"]}``.

.. code-block:: bash
-F jsonData={\"description\":\"My description.\",\"categories\":[\"Data\"]}
Instead, use --from-string with outer quote. See https://github.com/curl/curl/issues/2022

.. code-block:: bash
--from-string 'jsonData={"description":"My description.","categories":["Data"]}'
If you don't like curl, don't have curl, or want to use a different programming language, you are encouraged to check out the Python, Javascript, R, and Java options in the :doc:`client-libraries` section.

.. _curl: https://curl.haxx.se
Expand Down

0 comments on commit 501ad42

Please sign in to comment.