From owner-svn-src-all@freebsd.org Mon Nov 18 20:57:59 2019 Return-Path: Delivered-To: svn-src-all@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 B7A5F1C99E5; Mon, 18 Nov 2019 20:57:59 +0000 (UTC) (envelope-from carpeddiem@gmail.com) Received: from mail-io1-f43.google.com (mail-io1-f43.google.com [209.85.166.43]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) server-signature RSA-PSS (4096 bits) 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 47H1WC3MPbz4XNK; Mon, 18 Nov 2019 20:57:59 +0000 (UTC) (envelope-from carpeddiem@gmail.com) Received: by mail-io1-f43.google.com with SMTP id r144so20402861iod.8; Mon, 18 Nov 2019 12:57:59 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=C59KyayCOmeEk250hAnHCENLY2icH3L1vcDQm2uqaNM=; b=YNAHGCJvHCKpVXLK9ie4/akmv2pzUn7wUXD4BVsLIIn9r2S2HdhupwqL9GxjiC7hih AoHxGmeFP45vLG4dXOcSbCl70hrDQyKG7O0Q39AosSQMNjoxkQLyQvnvdD3cUuFKj6Mi 867jMsFBTQFNzIntRSFEIrAzNRgHFAbEybKaXsy0BC4Itz7c1MYolXY2+A8mqlzW3QLb uSA/xpqkBszuw0DqL/WJpoEAZRdeB/BEhD08z89QpE3sxoYWciTDipTf8LPRguX3WXC4 c/e8SiMYFxVNuBdinZPwor7fkpuCrc7KCIQQ5IhlgjY6PxNsRilRV22C9FA3GaU0Pqc3 V6ZA== X-Gm-Message-State: APjAAAUEPx2iSQVI44LX0gu2I0HaL1bNNlbatE3B0rIWRvG7PqOKUAm9 iGsaJv02zfKBwM3GmBlXv2HUdNEDJBjrf+am84/MrRhu X-Google-Smtp-Source: APXvYqzphfdR9AcFPzuHzUZEY2hsH9ZiyCvEh01Y/0D915hPF6QdUit4EsHnLMnXpP0z2EwWmIKFSrOMEkj6dmRJT84= X-Received: by 2002:a6b:b511:: with SMTP id e17mr14460724iof.18.1574110677372; Mon, 18 Nov 2019 12:57:57 -0800 (PST) MIME-Version: 1.0 References: <201911181905.xAIJ5q6A068355@repo.freebsd.org> <20191118194501.GA43295@raichu> <20191118203529.GA64688@FreeBSD.org> <20191118204836.GB43295@raichu> In-Reply-To: <20191118204836.GB43295@raichu> From: Ed Maste Date: Mon, 18 Nov 2019 12:11:17 -0500 Message-ID: Subject: Re: svn commit: r354824 - head/lib/geom/part To: Mark Johnston Cc: Alexey Dokuchaev , Alan Somers , svn-src-head , svn-src-all , src-committers Content-Type: text/plain; charset="UTF-8" X-Rspamd-Queue-Id: 47H1WC3MPbz4XNK X-Spamd-Bar: ----- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-5.92 / 15.00]; NEURAL_HAM_MEDIUM(-0.93)[-0.927,0]; NEURAL_HAM_LONG(-1.00)[-0.996,0]; REPLY(-4.00)[] X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 18 Nov 2019 20:57:59 -0000 On Mon, 18 Nov 2019 at 15:48, Mark Johnston wrote: > > > I presume that "content" means more like semantic, functional changes > > that affect some particular meaning. Grammar fixes are just, well, > > grammar fixes and thus do not warrant .Dd bump. > > Indeed, this was always my understanding as well. I can't find a > concrete definition anywhere. I don't understand why it would be useful > as a user to see the date of the last "content change" if such changes > might consist only of a small formatting change or typo fix. My understanding as well. My thinking - if the user last read the man page prior to the .Dd date then they know they have a reason to read it again. On Mon, 18 Nov 2019 at 15:50, Cy Schubert wrote: > > Should this be documented in the committers guide? Yes, it probably should. We probably need to provide more guidance on documentation in the committer's guide, but there's already a small bit about man pages in "18.3. Other Suggestions" and we could add this there.