#1008283 Really confusing update-exim4.conf(8) man page

Package:
exim4-config
Source:
exim4
Submitter:
S E
Date:
2022-03-29 05:42:05 UTC
Severity:
normal
#1008283#5
Date:
2022-03-25 22:03:20 UTC
From:
To:
Package: exim-configVersion: 4.95-4
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: S Egbert <s.egbert@sbcglobal.net>
To: Debian Bug Tracking System <submit@bugs.debian.org>
Subject: exim4-config: Really confusing update-exim4.conf(8) man page Package: exim4-config
Message-ID: <164824462535.48205.15761425627014536345.reportbug@ns1.egbert.net>
X-Mailer: reportbug 7.10.3+deb11u1
Date: Fri, 25 Mar 2022 17:43:45 -0400

X-Debbugs-Cc: s.egbert@sbcglobal.net Version: 4.95-4 Severity: normal Tags: a11y

Dear Maintainer,

Pulling up the manpage for 'update-exim4.conf'...  read in the first FIVE paragraphs,
still unable to comprehend.  Had to write it down a flowchart.

Analyzed the bash script of 'update-exim4.conf', wrote the semantic logic
down in a separate bash script.


Just my two-cents worth.

Bash file script to make heads and tails on WHO is using WHICH config
file(s) and by WHAT Debian config file methods.

Reference:

https://github.com/egberts/exim4-config-check-which


*** Reporter, please consider answering these questions, where appropriate ***

   * What led up to the situation?
   * What exactly did you do (or not do) that was effective (or
     ineffective)?
   * What was the outcome of this action?
   * What outcome did you expect instead?

*** End of the template - remove these template lines ***
#1008283#20
Date:
2022-03-29 05:40:02 UTC
From:
To:
It's a complex package. Does reading
/usr/share/doc/exim4-base/README.Debian.gz help?

If you have understood how things work now, can you do a patch for the
docs, making them better? It is sometimes hard to write beginner-level
docs when you have been stuck in the details of the package for two
decades.

Greetings
Marc
#1008283#23
Date:
2022-03-29 05:40:02 UTC
From:
To:
It's a complex package. Does reading
/usr/share/doc/exim4-base/README.Debian.gz help?

If you have understood how things work now, can you do a patch for the
docs, making them better? It is sometimes hard to write beginner-level
docs when you have been stuck in the details of the package for two
decades.

Greetings
Marc