Date: Fri, 8 Jan 2021 13:51:16 +0100 From: Mateusz Piotrowski <0mp@FreeBSD.org> To: Konstantin Belousov <kostikbel@gmail.com> Cc: src-committers@freebsd.org, dev-commits-src-all@freebsd.org, dev-commits-src-main@freebsd.org Subject: Re: git: 74bd20769706 - main - Reference newfs_msdos(8) from the newfs(8) manual Message-ID: <52e99dc8-cd75-a2ab-7670-b81d8aaa8134@FreeBSD.org> In-Reply-To: <X/dQAejFbWFxM8Uu@kib.kiev.ua> References: <202101070924.1079OE4g081849@gitrepo.freebsd.org> <X/dQAejFbWFxM8Uu@kib.kiev.ua>
next in thread | previous in thread | raw e-mail | index | archive | help
Hello Konstantin, On 1/7/21 7:16 PM, Konstantin Belousov wrote: > On Thu, Jan 07, 2021 at 09:24:14AM +0000, Mateusz Piotrowski wrote: >> The branch main has been updated by 0mp (doc, ports committer): >> >> URL: https://cgit.FreeBSD.org/src/commit/?id=3D74bd20769706041108a5736= 01cf0b61c755bdc56 >> >> commit 74bd20769706041108a573601cf0b61c755bdc56 >> Author: Mateusz Piotrowski <0mp@FreeBSD.org> >> AuthorDate: 2021-01-07 09:22:20 +0000 >> Commit: Mateusz Piotrowski <0mp@FreeBSD.org> >> CommitDate: 2021-01-07 09:24:07 +0000 >> >> Reference newfs_msdos(8) from the newfs(8) manual > Why ? newfs is not the interface to create arbitrary kind of filesyste= m, > it is just UFS writer. I think that it is beneficial nevertheless. Now users can discover other = newfs_* commands FreeBSD=20 offers. Also, newfs_msdos(8) already references newfs(8) (there are only = two items in the SEE ALSO=20 section there, the other one being gpart(8)). From my perspective it is not too bad to have this reference in the newf= s manual. It seems like=20 it's also something some FreeBSD users expect to see in the manual page a= s we received a bug report=20 for that. I can revert this patch and also remove newfs(8) from the newfs_msdos man= ual while at it if desired.=20 Perhaps newfs commands are easy enough to find so this patch only hurts t= he readability of the manual... Best, Mateusz
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?52e99dc8-cd75-a2ab-7670-b81d8aaa8134>