[openssl/openssl] a5a0c6: Add a very simple blocking TLS client demo

[Matt Caswell]

  Branch: refs/heads/master
  Home:   https://github.com/openssl/openssl
  Commit: a5a0c6a372d2cb9fbcec627e5a338c6f79aa0b16
      https://github.com/openssl/openssl/commit/a5a0c6a372d2cb9fbcec627e5a338c6f79aa0b16
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-06-14 (Wed, 14 Jun 2023)

  Changed paths:
    A demos/guide/Makefile
    A demos/guide/tls-client-block.c

  Log Message:
  -----------
  Add a very simple blocking TLS client demo

This blocking client is intended to be used to explain how to implement
a simple client in the documentation.

Reviewed-by: Viktor Dukhovni <viktor at openssl.org>
Reviewed-by: Paul Dale <pauli at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21133)


  Commit: f7b04ae8b4f58b3ce9b0562565f5fffa7a1c87e7
      https://github.com/openssl/openssl/commit/f7b04ae8b4f58b3ce9b0562565f5fffa7a1c87e7
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-06-14 (Wed, 14 Jun 2023)

  Changed paths:
    M doc/build.info
    A doc/man7/ossl-guide-tls-client-block.pod

  Log Message:
  -----------
  Add a tutorial on writing a simple blocking TLS client

Provide guidance on the steps needed to write a very simple blocking TLS
client.

Reviewed-by: Viktor Dukhovni <viktor at openssl.org>
Reviewed-by: Paul Dale <pauli at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21133)


  Commit: a2b6865be563810fad17e2d925304fde8d7eaf30
      https://github.com/openssl/openssl/commit/a2b6865be563810fad17e2d925304fde8d7eaf30
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-06-14 (Wed, 14 Jun 2023)

  Changed paths:
    M util/find-doc-nits

  Log Message:
  -----------
  Allow man7 pages to not have a DESCRIPTION section

For tutorial type pages it doesn't make any sense to have a DESCRIPTION
section.

Reviewed-by: Viktor Dukhovni <viktor at openssl.org>
Reviewed-by: Paul Dale <pauli at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21133)


  Commit: 2df71d618505056f86cf4e033d9fdfcde0e6574a
      https://github.com/openssl/openssl/commit/2df71d618505056f86cf4e033d9fdfcde0e6574a
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-06-14 (Wed, 14 Jun 2023)

  Changed paths:
    M doc/build.info
    M doc/man7/ossl-guide-tls-client-block.pod
    A doc/man7/ossl-guide-tls-introduction.pod

  Log Message:
  -----------
  Split the blocking TLS client guide page into two

We split the page into two: one covering basic TLS introductory material
that applies to both clients and servers, and one with the specific
material on writing a blocking TLS client.

Reviewed-by: Viktor Dukhovni <viktor at openssl.org>
Reviewed-by: Paul Dale <pauli at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21133)


  Commit: edd5b9d708d03ce1bdc1cbfc026ccc9183d586ad
      https://github.com/openssl/openssl/commit/edd5b9d708d03ce1bdc1cbfc026ccc9183d586ad
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-06-14 (Wed, 14 Jun 2023)

  Changed paths:
    M demos/guide/tls-client-block.c
    M doc/man7/ossl-guide-tls-client-block.pod

  Log Message:
  -----------
  Fix minor issues in the demo/man pages for TLS client/blocking

Reviewed-by: Viktor Dukhovni <viktor at openssl.org>
Reviewed-by: Paul Dale <pauli at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21133)


Compare: https://github.com/openssl/openssl/compare/4032cd9a1434...edd5b9d708d0