[PATCH v1 00/16] Create gh-pages for ktls-utils

[Chuck Lever <cel@kernel.org>]

From: Chuck Lever <chuck.lever@oracle.com>

Sorry for the size of this series.

The Doxygen comment style we started with was the kdoc style, which
isn't suitable for user space projects. So the first step is to
convert the comments to bog standard user-space Doxygen.

Patch 13/14 then adds the "create the Doxygen tree" build logic.

Patch 14/14 adds a GitHub action that can generate and deploy a
set of gh-pages for ktls-utils. It includes the man pages, an
example configuration file, and the generated Doxygen tree.

This isn't perfect, but it's something that can be built on over
time.

Chuck Lever (14):
  tlshd: Add kernel's quic.h
  tlshd: Translate kernel-style Doxygen comments in src/tlshd/client.c
  tlshd: Translate kernel-style Doxygen comments in src/tlshd/config.c
  tlshd: Translate kernel-style Doxygen comments in
    src/tlshd/handshake.c
  tlshd: Translate kernel-style Doxygen comments in src/tlshd/keyring.c
  tlshd: Translate kernel-style Doxygen comments in src/tlshd/ktls.c
  tlshd: Translate kernel-style Doxygen comments in src/tlshd/log.c
  tlshd: Translate kernel-style Doxygen comments in src/tlshd/main.c
  tlshd: Translate kernel-style Doxygen comments in src/tlshd/netlink.c
  tlshd: Translate kernel-style Doxygen comments in src/tlshd/quic.c
  tlshd: Translate kernel-style Doxygen comments in src/tlshd/server.c
  tlshd: Translate kernel-style Doxygen comments in src/tlshd/tlshd.h
  Build Doxygen web site
  workflows: Generate gh-pages automatically

Xin Long (2):
  tlshd: leave session_status as EIO on GnuTLS failure in QUIC session
    setup
  tlshd: set conn errcode to EACCES on GnuTLS failure in QUIC handshake

 .github/workflows/documentation.yml |  154 ++
 .gitignore                          |    1 +
 Makefile.am                         |    3 +-
 configure.ac                        |   13 +-
 docs/Doxyfile.in                    | 2836 +++++++++++++++++++++++++++
 {src => docs}/Makefile.am           |   13 +-
 src/Makefile.am                     |    2 +
 src/mainpage.c                      |   20 +
 src/tlshd/Makefile.am               |    3 +-
 src/tlshd/client.c                  |  200 +-
 src/tlshd/config.c                  |  164 +-
 src/tlshd/handshake.c               |   32 +-
 src/tlshd/keyring.c                 |   79 +-
 src/tlshd/ktls.c                    |  118 +-
 src/tlshd/log.c                     |  102 +-
 src/tlshd/main.c                    |   42 +-
 src/tlshd/netlink.c                 |  110 +-
 src/tlshd/quic.c                    |  246 ++-
 src/tlshd/quic.h                    |  236 +++
 src/tlshd/server.c                  |  232 ++-
 src/tlshd/tlshd.h                   |   87 +-
 21 files changed, 4343 insertions(+), 350 deletions(-)
 create mode 100644 .github/workflows/documentation.yml
 create mode 100644 docs/Doxyfile.in
 copy {src => docs}/Makefile.am (78%)
 create mode 100644 src/mainpage.c
 create mode 100644 src/tlshd/quic.h

-- 
2.51.0