Send inn-workers mailing list submissions to
[email protected]
To subscribe or unsubscribe via the World Wide Web, visit
https://lists.isc.org/mailman/listinfo/inn-workers
or, via email, send a message with subject or body 'help' to
[email protected]
You can reach the person managing the list at
[email protected]
When replying, please edit your Subject line so it is more specific
than "Re: Contents of inn-workers digest..."
Today's Topics:
1. storage.conf(5) manpage name too generic?
(Dominik 'Rathann' Mierzejewski)
2. Re: storage.conf(5) manpage name too generic? (Russ Allbery)
----------------------------------------------------------------------
Message: 1
Date: Fri, 8 Sep 2017 17:52:04 +0200
From: Dominik 'Rathann' Mierzejewski <[email protected]>
To: [email protected]
Subject: storage.conf(5) manpage name too generic?
Message-ID: <[email protected]>
Content-Type: text/plain; charset=us-ascii
Hello,
I'm one of the maintainers of inn package in Fedora. Recently,
I received a report that inn's storage.conf(5) manpage has a name
that's too generic and likely to conflict with other software:
https://bugzilla.redhat.com/show_bug.cgi?id=1482048
One example is skopeo, which also has a "storage.conf" file and
an associated manpage, at least in Fedora:
https://src.fedoraproject.org/cgit/rpms/skopeo.git/tree/
The report is asking if I'm ok with renaming the manpage to
inn-storage.conf(5), so I'm asking the same question here.
Any comments?
Regards,
Dominik
--
Fedora https://getfedora.org | RPMFusion http://rpmfusion.org
There should be a science of discontent. People need hard times and
oppression to develop psychic muscles.
-- from "Collected Sayings of Muad'Dib" by the Princess Irulan
------------------------------
Message: 2
Date: Fri, 08 Sep 2017 20:30:14 -0700
From: Russ Allbery <[email protected]>
To: [email protected]
Subject: Re: storage.conf(5) manpage name too generic?
Message-ID: <[email protected]>
Content-Type: text/plain
Dominik 'Rathann' Mierzejewski <[email protected]> writes:
> I'm one of the maintainers of inn package in Fedora. Recently, I
> received a report that inn's storage.conf(5) manpage has a name that's
> too generic and likely to conflict with other software:
> https://bugzilla.redhat.com/show_bug.cgi?id=1482048
> One example is skopeo, which also has a "storage.conf" file and an
> associated manpage, at least in Fedora:
> https://src.fedoraproject.org/cgit/rpms/skopeo.git/tree/
> The report is asking if I'm ok with renaming the manpage to
> inn-storage.conf(5), so I'm asking the same question here. Any
> comments?
Well, I don't think anyone here is going to object, and the name is pretty
generic. It's kind of sad to lose the property that the man page has the
same name as the file, though. It definitely makes it harder to find the
documentation.
While this isn't really a great excuse for using a very generic name, it's
worth noting that INN has installed that config file and man page for 19
years, or about six times longer than skopeo has existed. So maybe they
shouldn't have used a name that was already in use.... :)
If we had it to do over again, we'd pick a name that was better
namespaced, but it feels a bit late to rename it now. We *could*, I
suppose, but it's kind of a hassle, and I'm not sure it's worth the pain.
--
Russ Allbery ([email protected]) <http://www.eyrie.org/~eagle/>
Please send questions to the list rather than mailing me directly.
<http://www.eyrie.org/~eagle/faqs/questions.html> explains why.
------------------------------
Subject: Digest Footer
_______________________________________________
inn-workers mailing list
[email protected]
https://lists.isc.org/mailman/listinfo/inn-workers
------------------------------
End of inn-workers Digest, Vol 98, Issue 3
******************************************
