From 3c40840ca7726d28d98d1a9252b32f6b1ed1ad8f Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Mon, 6 Sep 2021 23:04:13 +0200 Subject: [PATCH] docs: remove experimental mentions from HSTS and MQTT Reported-by: Jonathan Cardoso Bug: https://github.com/curl/curl/pull/6700#issuecomment-913792863 Closes #7681 --- docs/cmdline-opts/page-header | 4 ++-- docs/libcurl/opts/CURLOPT_HSTS.3 | 7 +------ docs/libcurl/opts/CURLOPT_HSTSREADDATA.3 | 7 +------ docs/libcurl/opts/CURLOPT_HSTSREADFUNCTION.3 | 7 +------ docs/libcurl/opts/CURLOPT_HSTSWRITEDATA.3 | 7 +------ docs/libcurl/opts/CURLOPT_HSTSWRITEFUNCTION.3 | 7 +------ docs/libcurl/opts/CURLOPT_HSTS_CTRL.3 | 7 +------ 7 files changed, 8 insertions(+), 38 deletions(-) diff --git a/docs/cmdline-opts/page-header b/docs/cmdline-opts/page-header index 8974e433d0..65b503fbbe 100644 --- a/docs/cmdline-opts/page-header +++ b/docs/cmdline-opts/page-header @@ -132,8 +132,8 @@ without using TLS. curl can do directory lookups for you, with or without TLS. .IP MQTT curl supports MQTT version 3. Downloading over MQTT equals "subscribe" to a -topic while uploading/posting equals "publish" on a topic. MQTT support is -experimental and TLS based MQTT is not supported (yet). +topic while uploading/posting equals "publish" on a topic. MQTT over TLS is +not supported (yet). .IP POP3(S) Downloading from a pop3 server means getting a mail. With or without using TLS. diff --git a/docs/libcurl/opts/CURLOPT_HSTS.3 b/docs/libcurl/opts/CURLOPT_HSTS.3 index 2eb366878b..399828d7ee 100644 --- a/docs/libcurl/opts/CURLOPT_HSTS.3 +++ b/docs/libcurl/opts/CURLOPT_HSTS.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 2020, Daniel Stenberg, , et al. +.\" * Copyright (C) 2020 - 2021, Daniel Stenberg, , et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -29,11 +29,6 @@ CURLOPT_HSTS \- set HSTS cache file name CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTS, char *filename); .fi -.SH EXPERIMENTAL -Warning: this feature is early code and is marked as experimental. It can only -be enabled by explicitly telling configure with \fB--enable-hsts\fP. You are -advised to not ship this in production before the experimental label is -removed. .SH DESCRIPTION Make the \fIfilename\fP point to a file name to load an existing HSTS cache from, and to store the cache in when the easy handle is closed. Setting a file diff --git a/docs/libcurl/opts/CURLOPT_HSTSREADDATA.3 b/docs/libcurl/opts/CURLOPT_HSTSREADDATA.3 index 5ae72d8269..e2d20373c9 100644 --- a/docs/libcurl/opts/CURLOPT_HSTSREADDATA.3 +++ b/docs/libcurl/opts/CURLOPT_HSTSREADDATA.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2020, Daniel Stenberg, , et al. +.\" * Copyright (C) 1998 - 2021, Daniel Stenberg, , et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -27,11 +27,6 @@ CURLOPT_HSTSREADDATA \- pointer passed to the HSTS read callback #include CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTSREADDATA, void *pointer); -.SH EXPERIMENTAL -Warning: this feature is early code and is marked as experimental. It can only -be enabled by explicitly telling configure with \fB--enable-hsts\fP. You are -advised to not ship this in production before the experimental label is -removed. .SH DESCRIPTION Data \fIpointer\fP to pass to the HSTS read function. If you use the \fICURLOPT_HSTSREADFUNCTION(3)\fP option, this is the pointer you'll get as diff --git a/docs/libcurl/opts/CURLOPT_HSTSREADFUNCTION.3 b/docs/libcurl/opts/CURLOPT_HSTSREADFUNCTION.3 index c51df7983c..d5e6ea5429 100644 --- a/docs/libcurl/opts/CURLOPT_HSTSREADFUNCTION.3 +++ b/docs/libcurl/opts/CURLOPT_HSTSREADFUNCTION.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2020, Daniel Stenberg, , et al. +.\" * Copyright (C) 1998 - 2021, Daniel Stenberg, , et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -29,11 +29,6 @@ CURLOPT_HSTSREADFUNCTION \- read callback for HSTS hosts CURLSTScode hstsread(CURL *easy, struct curl_hstsentry *sts, void *userp); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTSREADFUNCTION, hstsread); -.SH EXPERIMENTAL -Warning: this feature is early code and is marked as experimental. It can only -be enabled by explicitly telling configure with \fB--enable-hsts\fP. You are -advised to not ship this in production before the experimental label is -removed. .SH DESCRIPTION Pass a pointer to your callback function, as the prototype shows above. diff --git a/docs/libcurl/opts/CURLOPT_HSTSWRITEDATA.3 b/docs/libcurl/opts/CURLOPT_HSTSWRITEDATA.3 index 68c50c24e8..ccfdccfab3 100644 --- a/docs/libcurl/opts/CURLOPT_HSTSWRITEDATA.3 +++ b/docs/libcurl/opts/CURLOPT_HSTSWRITEDATA.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2020, Daniel Stenberg, , et al. +.\" * Copyright (C) 1998 - 2021, Daniel Stenberg, , et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -27,11 +27,6 @@ CURLOPT_HSTSWRITEDATA \- pointer passed to the HSTS write callback #include CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTSWRITEDATA, void *pointer); -.SH EXPERIMENTAL -Warning: this feature is early code and is marked as experimental. It can only -be enabled by explicitly telling configure with \fB--enable-hsts\fP. You are -advised to not ship this in production before the experimental label is -removed. .SH DESCRIPTION Data \fIpointer\fP to pass to the HSTS write function. If you use the \fICURLOPT_HSTSWRITEFUNCTION(3)\fP option, this is the pointer you'll get as diff --git a/docs/libcurl/opts/CURLOPT_HSTSWRITEFUNCTION.3 b/docs/libcurl/opts/CURLOPT_HSTSWRITEFUNCTION.3 index 55b271c0b0..beaa095a56 100644 --- a/docs/libcurl/opts/CURLOPT_HSTSWRITEFUNCTION.3 +++ b/docs/libcurl/opts/CURLOPT_HSTSWRITEFUNCTION.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2020, Daniel Stenberg, , et al. +.\" * Copyright (C) 1998 - 2021, Daniel Stenberg, , et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -30,11 +30,6 @@ CURLSTScode hstswrite(CURL *easy, struct curl_hstsentry *sts, struct curl_index *count, void *userp); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTSWRITEFUNCTION, hstswrite); -.SH EXPERIMENTAL -Warning: this feature is early code and is marked as experimental. It can only -be enabled by explicitly telling configure with \fB--enable-hsts\fP. You are -advised to not ship this in production before the experimental label is -removed. .SH DESCRIPTION Pass a pointer to your callback function, as the prototype shows above. diff --git a/docs/libcurl/opts/CURLOPT_HSTS_CTRL.3 b/docs/libcurl/opts/CURLOPT_HSTS_CTRL.3 index ecb7129f98..bfd473c5fa 100644 --- a/docs/libcurl/opts/CURLOPT_HSTS_CTRL.3 +++ b/docs/libcurl/opts/CURLOPT_HSTS_CTRL.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 2020, Daniel Stenberg, , et al. +.\" * Copyright (C) 2020, 2021, Daniel Stenberg, , et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -32,11 +32,6 @@ CURLOPT_HSTS_CTRL \- control HSTS behavior CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTS_CTRL, long bitmask); .fi -.SH EXPERIMENTAL -Warning: this feature is early code and is marked as experimental. It can only -be enabled by explicitly telling configure with \fB--enable-hsts\fP. You are -advised to not ship this in production before the experimental label is -removed. .SH DESCRIPTION HSTS (HTTP Strict Transport Security) means that an HTTPS server can instruct the client to not contact it again over clear-text HTTP for a certain period -- 2.47.3