Bug#1028535: certbot: Please include the certbot(7) man page in the certbot package

2023-01-14 Thread Harlan Lieberman-Berg 
tag 1028535 +pending
thanks

On Fri, Jan 13, 2023 at 12:28 PM Karl O. Pinc  wrote:
> What motivated me was interest in documenting this:
>
> ${webroot-path}/.well-known/acme-challenge
>
> I did just pester the certbot people into including that
> in certbot(1).  But it has been helpful in the past
> to know more about the protocol and details about choices,
> whether for validation or whatever.
> [snip]
> It can be helpful to have prose to look at and disk is
> cheap.

Fair point!  I committed the patch to my repo; it'll go out in the next upload.

Cheers!

Bug#1028535: certbot: Please include the certbot(7) man page in the certbot package

2023-01-13 Thread Karl O. Pinc 
Hi Harlan,

On Fri, 13 Jan 2023 00:00:19 +
Harlan Lieberman-Berg  wrote:

> On Thu, Jan 12, 2023 at 1:06 PM Karl O. Pinc  wrote:
> > The certbot upstream includes a certbot(7) man page.  At present
> > this is not included in the Debian package.  It would be helpful to
> > have it included.  

> I'm interested in what you're looking for that's in the certbot.7
> manpage.  Most of that information is either duplicated in the
> certbot.1 manpage, or is really for plugin developers rather than
> actual users.

What motivated me was interest in documenting this:

${webroot-path}/.well-known/acme-challenge

I did just pester the certbot people into including that
in certbot(1).  But it has been helpful in the past
to know more about the protocol and details about choices,
whether for validation or whatever.

I don't find the writing in certbot(1) to always be entirely
clear or comprehensive.
(Some recent critique of random bits regarding webroot at: 
https://community.letsencrypt.org/t/please-document-the-webroot-well-known-request-path/191024/9
)  It can be helpful to have prose to look at and disk is
cheap.

Thanks for the interest.

Regards,

Karl 
Free Software:  "You don't pay back, you pay forward."
 -- Robert A. Heinlein

Bug#1028535: certbot: Please include the certbot(7) man page in the certbot package

2023-01-12 Thread Harlan Lieberman-Berg 
On Thu, Jan 12, 2023 at 1:06 PM Karl O. Pinc  wrote:
> The certbot upstream includes a certbot(7) man page.  At present this
> is not included in the Debian package.  It would be helpful to have it
> included.

Hi Karl,

I'm interested in what you're looking for that's in the certbot.7
manpage.  Most of that information is either duplicated in the
certbot.1 manpage, or is really for plugin developers rather than
actual users.

Sincerely,

Bug#1028535: certbot: Please include the certbot(7) man page in the certbot package

2023-01-12 Thread Karl O. Pinc 
Package: certbot
Severity: minor

Hi,

The certbot upstream includes a certbot(7) man page.  At present this
is not included in the Debian package.  It would be helpful to have it
included.


-- System Information:
Debian Release: 11.6
  APT prefers stable-security
  APT policy: (500, 'stable-security'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.10.0-20-amd64 (SMP w/4 CPU threads)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages certbot depends on:
ii  debconf [debconf-2.0]  1.5.77
ii  python33.9.2-3
pn  python3-certbot

certbot recommends no packages.

Versions of packages certbot suggests:
ii  python-certbot-doc  1.12.0-2
pn  python3-certbot-apache  
pn  python3-certbot-nginx