tidy-up: git options, ECH, HTTP/3 documentation

- prefer `--branch` over `-b`, where missing.
- add `--depth 1` where missing.
- sync option order between docs and GHA.
- bump quiche and rustls-ffi versions in documentation.
- ECH.md: update for OpenSSL 4.

Closes #21447
This commit is contained in:
Viktor Szakats 2026-04-25 12:59:55 +02:00
parent c6b1c49be0
commit 701cd4cfc3
No known key found for this signature in database
6 changed files with 40 additions and 40 deletions

View file

@ -18,11 +18,11 @@ discussion about a good path forward for ECH support in curl.
## OpenSSL Build
To build the OpenSSL project's ECH feature branch:
To build OpenSSL 4.0.0+:
```sh
cd $HOME/code
git clone https://github.com/openssl/openssl --branch feature/ech
git clone --depth 1 --branch openssl-4.0.0 https://github.com/openssl/openssl
cd openssl
./config --libdir=lib --prefix=$HOME/code/openssl-local-inst
...stuff...
@ -36,12 +36,12 @@ To build curl ECH-enabled, making use of the above:
```sh
cd $HOME/code
git clone https://github.com/curl/curl
git clone --depth 1 https://github.com/curl/curl
cd curl
autoreconf -fi
LDFLAGS="-Wl,-rpath,$HOME/code/openssl-local-inst/lib/" ./configure --with-ssl=$HOME/code/openssl-local-inst --enable-ech
...lots of output...
WARNING: ECH HTTPSRR enabled but marked EXPERIMENTAL...
WARNING: ECH is enabled but marked EXPERIMENTAL...
make
...lots more output...
```
@ -296,7 +296,7 @@ To build with cmake, assuming our ECH-enabled OpenSSL is as before:
```sh
cd $HOME/code
git clone https://github.com/curl/curl
git clone --depth 1 https://github.com/curl/curl
cd curl
mkdir build
cd build
@ -317,7 +317,7 @@ with that, instead of our ECH-enabled OpenSSL:
```sh
cd $HOME/code
git clone https://boringssl.googlesource.com/boringssl
git clone --depth 1 https://boringssl.googlesource.com/boringssl
cd boringssl
cmake -DCMAKE_INSTALL_PREFIX:PATH=$HOME/code/boringssl/inst -DBUILD_SHARED_LIBS=1
make
@ -329,7 +329,7 @@ Then:
```sh
cd $HOME/code
git clone https://github.com/curl/curl
git clone --depth 1 https://github.com/curl/curl
cd curl
autoreconf -fi
LDFLAGS="-Wl,-rpath,$HOME/code/boringssl/inst/lib" ./configure --with-ssl=$HOME/code/boringssl/inst --enable-ech
@ -351,7 +351,7 @@ wolfSSL also supports ECH and can be used by curl, so here's how:
```sh
cd $HOME/code
git clone https://github.com/wolfSSL/wolfssl
git clone --depth 1 https://github.com/wolfSSL/wolfssl
cd wolfssl
./autogen.sh
./configure --prefix=$HOME/code/wolfssl/inst --enable-ech --enable-debug --enable-opensslextra
@ -366,7 +366,7 @@ important or else we get build problems with curl below.
```sh
cd $HOME/code
git clone https://github.com/curl/curl
git clone --depth 1 https://github.com/curl/curl
cd curl
autoreconf -fi
./configure --with-wolfssl=$HOME/code/wolfssl/inst --enable-ech