curl_easy_setopt.3: mention RTMP URL quirks
authorDaniel Stenberg <daniel@haxx.se>
Fri, 13 Sep 2013 12:06:00 +0000 (14:06 +0200)
committerDaniel Stenberg <daniel@haxx.se>
Fri, 13 Sep 2013 12:06:20 +0000 (14:06 +0200)
URL: http://curl.haxx.se/bug/view.cgi?id=1278
Reported-by: Gorilla Maguila
docs/libcurl/curl_easy_setopt.3

index b370855f94bd1dff78264660586d9a0fe3f75374..a2b40e0c3c7d56b05c47fe374567b92886195fda 100644 (file)
@@ -891,6 +891,19 @@ Active Directory server.
 For more information about the individual components of a LDAP URL please
 see RFC4516.
 
+.B RTMP
+
+There's no official URL spec for RTMP so libcurl uses the URL syntax supported
+by the underlying librtmp library. It has a syntax where it wants a
+traditional URL, followed by a space and a series of space-separated
+name=value pairs.
+
+While space is not typically a "legal" letter, libcurl accepts them. When a
+user wants to pass in a '#' (hash) character it will be treated as a fragment
+and get cut off by libcurl if provided literally. You will instead have to
+escape it by providing it as backslash and its ASCII value in hexadecimal:
+"\\23".
+
 .B NOTES
 
 Starting with version 7.20.0, the fragment part of the URI will not be sent as