Hi Lennart, On Wed, Apr 23, 2014 at 7:15 PM, Lennart Poettering <lenn...@poettering.net> wrote: > On Wed, 23.04.14 07:42, Michael Kerrisk (man-pages) (mtk.manpa...@gmail.com) > wrote: > >> On 04/21/2014 05:01 PM, Roger Leigh wrote: >> > On Mon, Apr 21, 2014 at 03:39:20PM +0200, Michael Kerrisk (man-pages) >> > wrote: >> >> On 04/21/2014 10:04 AM, Petter Reinholdtsen wrote: >> >>> [Roger Leigh] >> >>>> Sorry, I've not done anything on this lately--I'm not too active in >> >>>> Debian at present due to RSI and other reasons. Petter, would you >> >>>> possibly be able to look into this on the sysvinit side? >> >>> >> >>> As far as I can see from <URL: https://bugs.debian.org/669866 >, the >> >>> upstream manpages maintainer is waiting for copyright information for >> >>> the hostname.5 file. This can only be provide by the authors, and >> >>> nothing I can do from the sysvinit side. >> >> >> >> >> >> Exactly. The page text says it was written by Lennart P and Roger. If >> >> they're both agreeable, and have a license, then I'd take the page. >> > >> > For my part, I'm happy for my contributions to this page to be licensed >> > under whatever DFSG-free licence you use for the manpages. >> >> Hi Lennart, >> >> See https://bugs.debian.org/669866. >> >> Roger Leigh has made a proposal that the hostname(5) page should be >> upstreamed into man-pages. This makes some sense to me, since >> /etc/hostname is a standard system file (like /etc/paasswwd, >> /etc/group, etc.), and most of those are documented by man-pages. >> >> It appears that the page is currently distributed by both Debian and >> as part of systemd, and the version referred top in the bug is noted >> as being written by you and Roger. What do you think of passing this >> page to man-pages? Does it make sense? > > I don't mind if the man page is added to the manpages package under any > license you like, but do note that /etc/hostname is a Debianism, which > we added to systemd and thus is now supported by the union of > Debian-derived distributions and those which adopted systemd. I am not > sure what the rules regarding what belongs in the manpages package is, > but I have the suspicion that at least Slackware and Gentoo don't have > this file. > > Also, in the systemd context the man page refers to "hostnamectl(1)" > which doesn't exist outside of systemd, and we make stricter > recommendations on the hostname to store in /etc/hostname than debian > probably traditionally made.
Thanks for the above details, which I was unaware of. Sounds to me like it would be best not to take this into man-pages. I'll leave Debian to work out what they want to do. > How does the Debian version of the man page look like? Is it available > online? How would the version you'd add to the manpages package look > like? See below. > The systemd version you find here: > > http://www.freedesktop.org/software/systemd/man/hostname.html Looks pretty similar. Cheers, Michael diff -urN manpages-3.35.original/man5/hostname.5 manpages-3.35/man5/hostname.5 --- manpages-3.35.original/man5/hostname.5 1970-01-01 01:00:00.000000000 +0100 +++ manpages-3.35/man5/hostname.5 2012-04-21 14:53:11.618069753 +0100 @@ -0,0 +1,33 @@ +.TH HOSTNAME 5 2012-04-09 "Linux" "Linux Programmer's Manual" +.SH NAME +/etc/hostname \- local host name configuration +.SH DESCRIPTION +The +.B /etc/hostname +file configures the name of the local system that is set during boot, +with the +.BR hostname (1) +command. It should contain a single newline-terminated host name +string. The host name may be a free-form string up to 64 characters in +length, however it is recommended that it consists only of 7bit ASCII +lower-case characters and no spaces or dots, and limits itself to the +format allowed for DNS domain name labels, even though this is not a +strict requirement. +.PP +Depending on the operating system other configuration files might be +checked for configuration of the host name as well, however only as a +fallback. +.SH FILES +.I /etc/hostname +.SH NOTES +The hostname file and format are supported by both the Debian System V +init system (initscripts) and systemd. +.SH SEE ALSO +.PP +.BR hostname (1), +.BR sethostname (2), +.BR hostname (7). +.SH AUTHORS +.PP +Lennart Poettering <lenn...@poettering.net> and Roger Leigh +<rle...@debian.org>. -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
