sync SUMMARY and chapter titles

SUMMARY.md

@@ -1,6 +1,6 @@
 # Table of contents
 
-* [README](README.md)
+* [Introduction](README.md)
 * [How to read this book](how-to-read.md)
 * [The cURL project](project.md)
   * [How it started](project/started.md)
@@ -33,7 +33,7 @@
 * [Source code](source.md)
   * [Open Source](source/opensource.md)
     * [License](source/opensource/license.md)
-    * [Copyright and Legal](source/opensource/copyright.md)
+    * [Copyright](source/opensource/copyright.md)
   * [Code layout](source/layout.md)
   * [Handling build options](source/options.md)
   * [Code style](source/style.md)
@@ -87,7 +87,7 @@
     * [Shell redirects](usingcurl/downloads/redirects.md)
     * [Multiple downloads](usingcurl/downloads/multiple.md)
     * [My browser shows something else](usingcurl/downloads/browsers.md)
-    * [Maximum file size](usingcurl/downloads/max-filesize.md)
+    * [Maximum filesize](usingcurl/downloads/max-filesize.md)
     * [Storing metadata in file system](usingcurl/downloads/metadata-fs.md)
     * [Raw](usingcurl/downloads/raw.md)
     * [Retry](usingcurl/downloads/retry.md)
@@ -113,7 +113,7 @@
     * [HTTP proxy](usingcurl/proxies/http.md)
     * [SOCKS proxy](usingcurl/proxies/socks.md)
     * [MITM proxy](usingcurl/proxies/mitm.md)
-    * [Authentication](usingcurl/proxies/auth.md)
+    * [Proxy authentication](usingcurl/proxies/auth.md)
     * [HTTPS proxy](usingcurl/proxies/https.md)
     * [Proxy environment variables](usingcurl/proxies/env.md)
     * [Proxy headers](usingcurl/proxies/headers.md)

bindings.md

@@ -1,4 +1,4 @@
-# Bindings for libcurl
+# Bindings
 
 Creative people have written bindings or interfaces for various environments
 and programming languages. Using one of these allows you to take advantage of

build.md

@@ -1,4 +1,4 @@
-# Build
+# Build curl
 
 The source code for this project is written in a way that allows it to get
 compiled and built on just about any operating system and platform, with as

build/boringssl.md

@@ -1,4 +1,4 @@
-# Build curl with boringssl
+# BoringSSL
 
 ## build boringssl
 

build/tls.md

@@ -1,4 +1,4 @@
-# Build to use a TLS library
+# TLS libraries
 
 To make curl support TLS based protocols, such as HTTPS, FTPS, SMTPS, POP3S,
 IMAPS and more, you need to build with a third-party TLS library since curl

build/windows.md

@@ -1,4 +1,4 @@
-# On Windows
+# Windows
 
 You can build curl on Windows in several different ways. We recommend using
 the MSVC compiler from Microsoft or the free and open source mingw

cmdline/listopts.md

@@ -1,4 +1,4 @@
-# List all command-line options
+# List options
 
 curl has more than two hundred command-line options and the number of options
 keep increasing over time. Chances are the number of options will reach 250

cmdline/passwords.md

@@ -1,4 +1,4 @@
-# Passwords and snooping
+# Passwords
 
 Passwords are tricky and sensitive. Leaking a password can make someone other
 than you access the resources and the data otherwise protected.

cmdline/progressmeter.md

@@ -1,4 +1,4 @@
-# The progress meter
+# Progress meter
 
 curl has a built-in progress meter. When curl is invoked to transfer data
 (either uploading or downloading) it can show that meter in the terminal

ftp/traversedir.md

@@ -1,4 +1,4 @@
-# How to traverse directories
+# Directory traversing
 
 When doing FTP commands to traverse the remote file system, there are a few
 different ways curl can proceed to reach the target file, the file the user

ftp/twoconnections.md

@@ -1,4 +1,4 @@
-# FTP uses two connections
+# Two connections
 
 FTP uses two TCP connections! The first connection is setup by the client when
 it connects to an FTP server, and is called the *control connection*. As the

get.md

@@ -1,4 +1,4 @@
-# Get curl
+# Install curl
 
 curl is totally free, open and available. There are numerous ways to get it
 and install it for most operating systems and architecture. This section will

get/linux.md

@@ -1,4 +1,4 @@
-# Get curl for Linux
+# Linux
 
 Linux distributions come with "packager managers" that let you install
 software that they offer. Most Linux distributions offer curl and libcurl to

get/macos.md

@@ -1,4 +1,4 @@
-# Get curl for macOS
+# macOS
 
 macOS comes with the curl tool bundled with the operating system since many
 years. If you want to upgrade to the latest version shipped by the curl

get/windows.md

@@ -1,4 +1,4 @@
-# Get curl for Windows
+# Windows
 
 Windows 10 comes with the curl tool bundled with the operating system since
 version 1804. If you have an older Windows version or just want to upgrade to

http/auth.md

@@ -1,4 +1,4 @@
-# HTTP authentication
+# Authentication
 
 Each HTTP request can be made authenticated. If a server or a proxy want the
 user to provide proof that they have the correct credentials to access a URL

http/basics.md

@@ -1,4 +1,4 @@
-# HTTP protocol basics
+# Protocol basics
 
 (This assumes you have read the [Network and protocols](../protocols.md)
 section or are otherwise already familiar with protocols.)

http/hsts.md

@@ -1,4 +1,4 @@
-# HTTP Strict Transport Security
+# HSTS
 
 HTTP Strict Transport Security, HSTS, is a protocol mechanism that helps to
 protect HTTPS servers against man-in-the-middle attacks such as protocol

http/method.md

@@ -1,4 +1,4 @@
-# HTTP method
+# Method
 
 In every HTTP request, there is a method. Sometimes called a verb. The most
 commonly used ones are `GET`, `POST`, `HEAD` and `PUT`.

http/modify/fragment.md

@@ -1,4 +1,4 @@
-# Anchors or fragments
+# Fragment
 
 A URL may contain an "anchor", also known as a fragment, which is written with
 a pound sign and string at the end of the URL. Like for example

http/modify/method.md

@@ -1,4 +1,4 @@
-# Modify the request method
+# Request method
 
 The first line of an HTTP request includes the *method* - sometimes also
 referred to as the verb. When doing a simple GET request as this command line

http/modify/target.md

@@ -1,4 +1,4 @@
-# Modify request target
+# Request target
 
 When given an input URL such as `http://example.com/file`, the path section of
 the URL gets extracted and is turned into `/file` in the HTTP request line.

http/multipart.md

@@ -1,4 +1,4 @@
-# HTTP multipart formposts
+# Multipart formposts
 
 A multipart formpost is what an HTTP client sends when an HTML form is
 submitted with *enctype* set to "multipart/form-data". It is an HTTP POST

http/ranges.md

@@ -1,4 +1,4 @@
-# HTTP ranges
+# Ranges
 
 What if the client only wants the first 200 bytes out of a remote resource or
 perhaps 300 bytes somewhere in the middle? The HTTP protocol allows a client

http/redirects.md

@@ -1,4 +1,4 @@
-# HTTP redirects
+# Redirects
 
 The “redirect” is a fundamental part of the HTTP protocol. The concept was
 present and is documented already in the first spec (RFC 1945), published in

http/response.md

@@ -1,4 +1,4 @@
-# HTTP responses
+# Responses
 
 When an HTTP client talks HTTP to a server, the server *will* respond with an
 HTTP response message or curl will consider it an error and returns 52 with

internals/caches.md

@@ -1,4 +1,4 @@
-# Caches and state in libcurl
+# Caches and state
 
 When libcurl is used for Internet transfers, it stores data in caches and
 state storage in order to do subsequent transfers faster and better.

internals/memory-debugging.md

@@ -1,4 +1,4 @@
-# Memory Debugging
+# Memory debugging
 
 The file `lib/memdebug.c` contains debug-versions of a few functions.
 Functions such as `malloc()`, `free()`, `fopen()`, `fclose()`, etc that

internals/tests/ci.md

@@ -1,4 +1,4 @@
-# Continuous Integration (CI)
+# Continuous Integration
 
 For every pull request submitted to the curl project on GitHub and for every
 commit pushed to the master branch in the git repository, a vast amount of

internals/tests/torture.md

@@ -1,4 +1,4 @@
-# Torture tests
+# Torture
 
 When curl is built [debug enabled](debug.md), it offers a special kind of
 testing. The tests we call **torture** tests. Do not worry, it is not quite as

libcurl-http/auth.md

@@ -1,4 +1,4 @@
-# HTTP authentication
+# Authentication
 
 libcurl supports a wide variety of HTTP authentication schemes.
 

libcurl-http/cookies.md

@@ -1,4 +1,4 @@
-# Cookies with libcurl
+# Cookies
 
 By default and by design, libcurl makes transfers as basic as possible and
 features need to be enabled to get used. One such feature is HTTP cookies,

libcurl-http/download.md

@@ -1,4 +1,4 @@
-# libcurl HTTP download
+# Download
 
 The GET method is the default method libcurl uses when an HTTP URL is requested
 and no particular other method is asked for. It asks the server for a

libcurl-http/headerapi.md

@@ -1,4 +1,4 @@
-# Header API
+# Headers API
 
 libcurl offers an API for iterating over all received HTTP headers and for
 extracting the contents from specific ones.

libcurl-http/ranges.md

@@ -1,4 +1,4 @@
-# HTTP ranges
+# Ranges
 
 What if the client only wants the first 200 bytes out of a remote
 resource or perhaps 300 bytes somewhere in the middle? The HTTP protocol

libcurl-http/requests.md

@@ -1,4 +1,4 @@
-# HTTP Requests
+# Requests
 
 An HTTP request is what curl sends to the server when it tells the server what
 to do. When it wants to get data or send data. All transfers involving HTTP

libcurl-http/responses.md

@@ -1,4 +1,4 @@
-# HTTP responses
+# Responses
 
 Every HTTP request includes an HTTP response. An HTTP response is a set of
 metadata and a response body, where the body can occasionally be zero bytes

libcurl-http/upload.md

@@ -1,4 +1,4 @@
-# HTTP upload
+# Upload
 
 Uploads over HTTP can be done in many different ways and it is important to
 notice the differences. They can use different methods, like POST or PUT, and

libcurl-http/versions.md

@@ -1,4 +1,4 @@
-# HTTP versions
+# Versions
 
 Like all Internet protocols, the HTTP protocol has kept evolving over the
 years and now there are clients and servers distributed over the world and

libcurl/--libcurl.md

@@ -1,4 +1,4 @@
-# curl --libcurl
+# --libcurl
 
 We actively encourage users to first try out the transfer they want to do with
 the curl command-line tool, and once it works roughly the way you want it to,

libcurl/callbacks/debug.md

@@ -1,4 +1,4 @@
-# Debug callback
+# Debug
 
 The debug callback is set with `CURLOPT_DEBUGFUNCTION`:
 

libcurl/callbacks/header.md

@@ -1,4 +1,4 @@
-# Header callback
+# Header data
 
 The header callback is set with `CURLOPT_HEADERFUNCTION`:
 

libcurl/callbacks/openclosesocket.md

@@ -1,4 +1,4 @@
-# Opensocket and closesocket callbacks
+# Opensocket and closesocket
 
 Occasionally you end up in a situation where you want your application to
 control with more precision exactly what socket libcurl will use for its

libcurl/callbacks/progress.md

@@ -1,4 +1,4 @@
-# Progress callback
+# Progress information
 
 The progress callback is what gets called regularly and repeatedly for each
 transfer during the entire lifetime of the transfer. The old callback was set

libcurl/callbacks/read.md

@@ -1,4 +1,4 @@
-# Read callback
+# Read data
 
 The read callback is set with `CURLOPT_READFUNCTION`:
 

libcurl/callbacks/rtsp.md

@@ -1,4 +1,4 @@
-# RTSP interleave callback
+# RTSP interleaved data
 
 The callback with the `CURLOPT_INTERLEAVEFUNCTION` option.
 

libcurl/callbacks/seek.md

@@ -1,4 +1,4 @@
-# seek callback
+# Seek and ioctl
 
 This callback is set with `CURLOPT_SEEKFUNCTION`.
 

libcurl/callbacks/sockopt.md

@@ -1,4 +1,4 @@
-# sockopt callback
+# sockopt
 
 The sockopt callback is set with `CURLOPT_SOCKOPTFUNCTION`:
 

libcurl/callbacks/sshkey.md

@@ -1,4 +1,4 @@
-# SSH key callback
+# SSH key
 
 This callback is set with `CURLOPT_SSH_KEYFUNCTION`.
 

libcurl/callbacks/sslcontext.md

@@ -1,4 +1,4 @@
-# SSL context callback
+# SSL context
 
 libcurl offers a special TLS related callback called
 `CURLOPT_SSL_CTX_FUNCTION`. This option only works for libcurl powered by

libcurl/callbacks/write.md

@@ -1,4 +1,4 @@
-# Write callback
+# Write data
 
 The write callback is set with `CURLOPT_WRITEFUNCTION`:
 

libcurl/cplusplus.md

@@ -1,4 +1,4 @@
-# libcurl for C++ programmers
+# for C++ programmers
 
 libcurl provides a C API. C and C++ are similar but not the same. There are a
 few things to keep in mind when using libcurl in C++.

libcurl/curlcode.md

@@ -1,4 +1,4 @@
-# CURLcode return code
+# CURLcode return codes
 
 Many libcurl functions return a CURLcode. That is a special libcurl typedefed
 variable for error codes. It returns `CURLE_OK` (which has the value zero) if

libcurl/drive.md

@@ -1,4 +1,4 @@
-# "Drive" transfers
+# Drive transfers
 
 libcurl provides three different ways to perform the transfer. Which way to
 use in your case is entirely up to you and what you need.

libcurl/drive/easy.md

@@ -1,4 +1,4 @@
-# Driving with the easy interface
+# Drive with easy
 
 The name 'easy' was picked simply because this is really the easy way to use
 libcurl, and with easy, of course, comes a few limitations. Like, for example,

libcurl/drive/multi-socket.md

@@ -1,4 +1,4 @@
-# Driving with the "multi_socket" interface
+# Drive with multi\_socket
 
 multi_socket is the extra spicy version of the regular multi interface and is
 designed for event-driven applications. Make sure you read the

libcurl/drive/multi.md

@@ -1,4 +1,4 @@
-# Driving with the multi interface
+# Drive with multi
 
 The name 'multi' is for multiple, as in multiple parallel transfers, all done
 in the same single thread. The multi API is non-blocking so it can also make

libcurl/examples/get.md

@@ -1,4 +1,4 @@
-# Get a simple HTML page
+# Get a simple HTTP page
 
 This example just fetches the HTML from a given URL and sends it to
 stdout. Possibly the simplest libcurl program you can write.

libcurl/options.md

@@ -1,4 +1,4 @@
-# Set handle options
+# curl easy options
 
 You set options in the easy handle to control how that transfer is going to be
 done, or in some cases you can actually set options and modify the transfer's

libcurl/options/all.md

@@ -1,4 +1,4 @@
-# All easy options
+# All options
 
 This is a table of a complete list of all available options for
 `curl_easy_setopt()` as of what will be present in the 7.83.0 release, April

libcurl/options/tls.md

@@ -1,4 +1,4 @@
-# libcurl TLS options
+# TLS options
 
 At the time of writing this, there are no less than **forty** different
 options for curl_easy_setopt that are dedicated for controlling how libcurl