Christoph, "jail" is a FreeBSD feature (I believe, even OpenBSD stopped using jail (it was sysjail there) some 10 years ago), and most other systems contain/call it just "chroot", without "jail"; so, this name collision is probably only present on FreeBSD.
However, I still think it is a good idea for the manpages for a package to reflect the package's name, rather than being so generic as jail.conf (cf. mail.conf ). This is important for identification of the manpages and also for the convenience of multisystem admins who manage the package (fail2ban) on different OSes at the same time. On another hand, it is helpful when a man page coinsides with the filename. In that regard, there are two options: 1. renaming also the file to fail2ban-jail.conf or, since jail.conf(5) covers several config files, 2. renaming jail.conf(5) to fail2ban.conf(5) I prefer this, latter version (for simplicity). tl;dr: I support Christoph's suggestion for renaming the man page for all systems. My preferred way is to rename it to fail2ban.conf(5). An alternative would beto rename it to fail2ban-jail.conf(5) and further suggest to rename the config file the same way as well. Best, Igor On Tue, 28 Feb 2017, Christoph Theis wrote: > Under FreeBSD there is a name clash between FreeBSD's jails man page > jail.conf(5) and fail2ban's man page jail.conf(5). To solve this I had > to rename fail2ban's man page to fail2ban-jail.conf(5). > I was notified that I forgot to update the content of the man pages. > It would be easy to do that, but before I'd like to ask if jail.conf(5) > shouldn't be renamed to fail2ban-jail.conf(5) for all systems to be more > consistent with the other man page names? What do you think? > > > Christoph > > ------------------------------------------------------------------------------ > Check out the vibrant tech community on one of the world's most > engaging tech sites, SlashDot.org! http://sdm.link/slashdot > _______________________________________________ > Fail2ban-users mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/fail2ban-users > ------------------------------------------------------------------------------ Check out the vibrant tech community on one of the world's most engaging tech sites, SlashDot.org! http://sdm.link/slashdot _______________________________________________ Fail2ban-users mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/fail2ban-users
