From owner-dev-commits-src-main@freebsd.org Fri Jan 8 12:50:54 2021 Return-Path: Delivered-To: dev-commits-src-main@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id AA35F4C9445; Fri, 8 Jan 2021 12:50:54 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: from mail-ed1-f52.google.com (mail-ed1-f52.google.com [209.85.208.52]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4DC2yk4K4Dz3rX2; Fri, 8 Jan 2021 12:50:54 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: by mail-ed1-f52.google.com with SMTP id u19so11129250edx.2; Fri, 08 Jan 2021 04:50:54 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:to:cc:references:from:subject:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding :content-language; bh=3ClQjwv3rGIvElMvVpEiyopbQBY9S2rDm0k1itTSOo8=; b=KPlBiOv7ALRd1yOl+yLnDCxWbU8pM7dFij5YEZaqsrzVB0yFkKY4w8Vz+D69cZk+Fx XORG2MJkSaBedww4rnf+8lqpJLMcS0TtsldRUuA6Rslw9B3kJ7wf/kAop0eYMijMli/h BdKdKRBWDvGUTaN71xdqB4VuK30R6vW0qyXQU0ujvDsvgdWuAzmpI39DezKTKI5zIusj zZvr2HWFFcI1Cm+55NFV4sNY8bGathg8d42swC+DHDqzUCaMAKmAjEjmuI+FwE+5bFzk i6brYvk6p3b47PJ2N3MPTNphiiUGKPYCzy3XDpiMPLwhoXWMmRPYtzZo2arA93vbaaFd ObYQ== X-Gm-Message-State: AOAM530zKXzE1PYpW8Yytpv/eX1nJeGtVnkQENmg+UkFJXMOKBX1ufZO TIpv14IyQAW0jU2nxXH3rmHmR1RI4BY= X-Google-Smtp-Source: ABdhPJwDmmydE3TTzRyYvEjsBCWhECjkZpcj8eg/37gndsWt4q7R+v4F+jvKG55Ge1jVT38teMqmlw== X-Received: by 2002:a50:c315:: with SMTP id a21mr5155454edb.50.1610110252099; Fri, 08 Jan 2021 04:50:52 -0800 (PST) Received: from ?IPv6:2a02:8109:98c0:4ad0:5e5f:67ff:fef4:ffd8? ([2a02:8109:98c0:4ad0:5e5f:67ff:fef4:ffd8]) by smtp.gmail.com with ESMTPSA id w13sm2463498edx.20.2021.01.08.04.50.50 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 08 Jan 2021 04:50:51 -0800 (PST) To: Konstantin Belousov Cc: src-committers@freebsd.org, dev-commits-src-all@freebsd.org, dev-commits-src-main@freebsd.org References: <202101070924.1079OE4g081849@gitrepo.freebsd.org> From: Mateusz Piotrowski <0mp@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> Date: Fri, 8 Jan 2021 13:51:16 +0100 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:78.0) Gecko/20100101 Thunderbird/78.5.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Content-Language: en-US X-Rspamd-Queue-Id: 4DC2yk4K4Dz3rX2 X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[] X-BeenThere: dev-commits-src-main@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for the main branch of the src repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 08 Jan 2021 12:50:54 -0000 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