From owner-svn-src-head@freebsd.org Wed Dec 5 16:23:08 2018 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 556C1131A5D0; Wed, 5 Dec 2018 16:23:08 +0000 (UTC) (envelope-from freebsd@pdx.rh.CN85.dnsmgr.net) Received: from pdx.rh.CN85.dnsmgr.net (br1.CN84in.dnsmgr.net [69.59.192.140]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 8D11C7BA80; Wed, 5 Dec 2018 16:23:07 +0000 (UTC) (envelope-from freebsd@pdx.rh.CN85.dnsmgr.net) Received: from pdx.rh.CN85.dnsmgr.net (localhost [127.0.0.1]) by pdx.rh.CN85.dnsmgr.net (8.13.3/8.13.3) with ESMTP id wB5GN5rp041646; Wed, 5 Dec 2018 08:23:05 -0800 (PST) (envelope-from freebsd@pdx.rh.CN85.dnsmgr.net) Received: (from freebsd@localhost) by pdx.rh.CN85.dnsmgr.net (8.13.3/8.13.3/Submit) id wB5GN3HK041645; Wed, 5 Dec 2018 08:23:03 -0800 (PST) (envelope-from freebsd) From: "Rodney W. Grimes" Message-Id: <201812051623.wB5GN3HK041645@pdx.rh.CN85.dnsmgr.net> Subject: Re: svn commit: r341505 - head/share/man/man5 In-Reply-To: <44199325-5b07-5195-1157-63c197eb5f07@FreeBSD.org> To: Pedro Giffuni Date: Wed, 5 Dec 2018 08:23:03 -0800 (PST) CC: koobs@freebsd.org, src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Reply-To: rgrimes@freebsd.org X-Mailer: ELM [version 2.4ME+ PL121h (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII X-Rspamd-Queue-Id: 8D11C7BA80 X-Spamd-Result: default: False [-0.73 / 15.00]; ARC_NA(0.00)[]; HAS_REPLYTO(0.00)[rgrimes@freebsd.org]; NEURAL_HAM_MEDIUM(-0.61)[-0.613,0]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; NEURAL_HAM_LONG(-0.57)[-0.571,0]; MIME_GOOD(-0.10)[text/plain]; DMARC_NA(0.00)[dnsmgr.net]; REPLYTO_DOM_NEQ_FROM_DOM(0.00)[]; AUTH_NA(1.00)[]; RCPT_COUNT_FIVE(0.00)[5]; RCVD_COUNT_THREE(0.00)[3]; IP_SCORE(-0.02)[country: US(-0.09)]; MX_GOOD(-0.01)[cached: pdx.rh.CN85.dnsmgr.net]; NEURAL_HAM_SHORT(-0.42)[-0.416,0]; R_SPF_NA(0.00)[]; FROM_EQ_ENVFROM(0.00)[]; R_DKIM_NA(0.00)[]; RCVD_TLS_LAST(0.00)[]; ASN(0.00)[asn:13868, ipnet:69.59.192.0/19, country:US]; MID_RHS_MATCH_FROM(0.00)[] X-Rspamd-Server: mx1.freebsd.org X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 05 Dec 2018 16:23:08 -0000 > On 12/5/18 12:06 AM, Kubilay Kocak wrote: > > On 5/12/2018 9:51 am, Pedro F. Giffuni wrote: > >> Starting with FreeBSD 12 we fully support writing ext4 filesystems > > > > Can we remove '2' from the module/man/etc name if (since) it supports > > multiple extXfs versions? Is there anything serious preventing it? > > > Bad idea: neither us or linux support the old extfs format. It is a > common misconception that ext3 or ext4 are different filesystems: they > are both extensions over the ext2 format and they were always intended > to work like that. > > You can currently create plain ext2 filesystems on FreeBSD and add > ext3/4 features on top and it will work just fine. The distinction on > linux about ext2/3/4 is rather accidental: they didn't master Version > Control in time to branch instead of forking the implementation a couple > of times. It also seems like ext3 disappeared. > > > > Seems minor but I think worth it for discovery/pola/obviousness, and a > > good time (early in the 13.0 cycle). > > > > We get a lot of user questions about ext*fs support on FreeBSD and > > pointing to an ext2fs man page also feels a bit weird. > > > This has to be "fixed" through documentation. I will admit that I > haven't been working properly on the documentation, other than trying to > remember some details in the Wiki page. One simple fix would be to add MLINKS for ext3fs and ext4fs so that you could refer a user to ext4fs. Then manual page itself already has a proper NAME entry, so infact hum, these links should already be in place, that appears to be an oversight. --- share/man/man5/Makefile.prior 2017-07-20 23:42:14.000000000 +0000 +++ share/man/man5/Makefile 2018-12-05 16:23:02.923541000 +0000 @@ -69,6 +69,8 @@ tmpfs.5 MLINKS= dir.5 dirent.5 +MLINKS+=ext2fs.5 ext3fs.5 +MLINKS+=ext2fs.5 ext4fs.5 MLINKS+=fs.5 inode.5 MLINKS+=hosts.equiv.5 rhosts.5 MLINKS+=msdosfs.5 msdos.5 > > Happy to get/organise a !committer contributor to take care of this if > > no-one wants to pick it up. > > > > I will be glad to review/commit manpage changes that make things > clearer. We should probably even try to document the format, as I recall > we do for FAT somewhere(?). > > Pedro. > > > > -- Rod Grimes rgrimes@freebsd.org