Re: Review of texts for miniupnpd^Wminissdp
Yangfl wrote:
> Template: minissdpd/why_I_am_here
> Type: note
Devref says (in 6.5,3.1.8., the section about "Type: error"):
It is recommended to use this type for any message that needs user
attention for a correction of any kind.
It seems to me a note is either too much (if, e.g., I've previously
had it set up but then did an unpurged remove) or too little (if I'm
directly installing minissdpd and expecting it to work); couldn't the
install process check whether there's already a config-file in place?
Also, is it possible to configure minissdpd to not run at all? If so,
wouldn't that make a tolerable initial default?
(But the attached patch leaves it a note and just fixes the English)
> _Description: MiniSSDP daemon configuration
> If you see this message but never manually install MiniSSDP, then most
> probably this package is automatically pulled as a recommendation for
> libminiupnpc, which is the UPnP support library for many applications.
This has a couple of grammar problems, but the following should work
as either a "Type: note" or "Type: error" message:
The MiniSSDP daemon is being installed (perhaps as a dependency for UPnP
support) but will not function correctly until it is configured.
> .
> MiniSSDP is a daemon used by MiniUPnPc to speed up device discoveries. Due to
> a potential security issue, an out-of-box default configuration can not be
> provided anymore, thus a explicit configuration is required.
.
MiniSSDP is a daemon used by MiniUPnPc to speed up device discovery. For
security reasons, no out-of-box default configuration can be provided, so it
requires manual configuration.
> .
> You can simply ignore this configuration / remove this package. MiniSSDP
> **won't work** with the old default configuration, but MiniUPnPc (and your
> UPnP applications) will still function properly (despite some performance
> loss).
.
Alternatively you can simply override the recommendation and remove MiniSSDP,
or leave it unconfigured - it won't work, but MiniUPnPc (and UPnP
applications) will still function properly despite some performance loss.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
--- minissdp.old 2019-01-27 12:27:43.304760463 +0000
+++ minissdp.new 2019-01-27 12:34:52.383458914 +0000
@@ -1,15 +1,13 @@
Template: minissdpd/why_I_am_here
Type: note
_Description: MiniSSDP daemon configuration
- If you see this message but never manually install MiniSSDP, then most
- probably this package is automatically pulled as a recommendation for
- libminiupnpc, which is the UPnP support library for many applications.
+ The MiniSSDP daemon is being installed (perhaps as a dependency for UPnP
+ support) but will not function correctly until it is configured.
.
- MiniSSDP is a daemon used by MiniUPnPc to speed up device discoveries. Due to
- a potential security issue, an out-of-box default configuration can not be
- provided anymore, thus a explicit configuration is required.
+ MiniSSDP is a daemon used by MiniUPnPc to speed up device discovery. For
+ security reasons, no out-of-box default configuration can be provided, so it
+ requires manual configuration.
.
- You can simply ignore this configuration / remove this package. MiniSSDP
- **won't work** with the old default configuration, but MiniUPnPc (and your
- UPnP applications) will still function properly (despite some performance
- loss).
+ Alternatively you can simply override the recommendation and remove MiniSSDd,
+ or leave it unconfigured - it won't work, but MiniUPnPc (and UPnP
+ applications) will still function properly despite some performance loss.
Reply to: