doc: various doc and linkification improvements

Correctly link to subsections within the same page, and include
a link to mailing list archives.

Also, use "ssl_ctx" consistently as a local variable as
we internally use "ctx" for other purposes.

1 files changed, 6 insertions, 1 deletions

diff --git a/examples/yahns_rack_basic.conf.rb b/examples/yahns_rack_basic.conf.rb
index 33ba619..f3f8e6a 100644
--- a/examples/yahns_rack_basic.conf.rb
+++ b/examples/yahns_rack_basic.conf.rb
@@ -31,7 +31,12 @@ queue do
 end
 
 app(:rack, "config.ru", preload: false) do
-  listen 8080
+  listen 80
+
+  # See yahns_config(5) and OpenSSL::SSL::SSLContext on configuring
+  # HTTPS support
+  # listen 443, ssl_ctx: ...
+
   client_max_body_size 1024 * 1024
   input_buffering true
   output_buffering true # this lazy by default