cc_apt_pipelining:
  description: |
    This module configures APT's ``Acquire::http::Pipeline-Depth`` option,
    which controls how APT handles HTTP pipelining. It may be useful for
    pipelining to be disabled, because some web servers (such as S3) do not
    pipeline properly (LP: #948461).

    Value configuration options for this module are:
    
    - ``os``: (Default) use distro default
    - ``false``: Disable pipelining altogether
    - ``<number>``: Manually specify pipeline depth. This is not recommended.
  examples:
  - comment: |
      Example 1:
    file: cc_apt_pipelining/example1.yaml
  - comment: |
      Example 2:
    file: cc_apt_pipelining/example2.yaml
  - comment: |
      Example 3:
    file: cc_apt_pipelining/example3.yaml
  name: Apt Pipelining
  title: Configure APT pipelining
