From owner-freebsd-arch@freebsd.org Fri Mar 11 21:16:31 2016 Return-Path: Delivered-To: freebsd-arch@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id A38E4ACC007 for ; Fri, 11 Mar 2016 21:16:31 +0000 (UTC) (envelope-from carpeddiem@gmail.com) Received: from mail-io0-x236.google.com (mail-io0-x236.google.com [IPv6:2607:f8b0:4001:c06::236]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 71504800; Fri, 11 Mar 2016 21:16:31 +0000 (UTC) (envelope-from carpeddiem@gmail.com) Received: by mail-io0-x236.google.com with SMTP id m184so161263417iof.1; Fri, 11 Mar 2016 13:16:31 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:from:date:message-id :subject:to:cc; bh=F6/bnuT0HZ5Xg3yLSQiLupi7L1Oy0KoPXwRoRm455QM=; b=dYw8FkxZ6XFCa3z9QKXDzJ9CwmlZWIqhSnkHCNmlFa0cPlIe3yCDPpech6wfvX9zrk GVXXSBelIZjzatRPI5jYDHWI/WiQNrhKUp/bpcfv/OXTmuDM3/2tzEO3AAsbDt7IPixM hNybuIRfzUPJWAsnygA5EaGR7nBGEHRK/weJ+nK31ujBWI67VZi1Kk9E3ECWwHaLrfBx CcCFG2+pp05mphRT49uJoZ8bvgQNPEMnqvWS5fY+sTu44Q3oQInIt+5V1/OSlt4A2aQj 1OWfe0KIfNDlQQyxIe/lhe0YHiEQN7bLAVdQH29II30P3HYAi+QqC7vi7IpwkOPWsDdq FHgQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:sender:in-reply-to:references:from :date:message-id:subject:to:cc; bh=F6/bnuT0HZ5Xg3yLSQiLupi7L1Oy0KoPXwRoRm455QM=; b=AvDnSqbF3cEUu6q1DbL9dZyGVRCH9H7j0v27we8gMjFvKmHnlJ32HCsGbhVulh5vBM J3TSpVN68dKmYUb8tlOwQvsmrQIJRB3dYI1PjeKsPEVdwP4SoZZWYLJ5Rkx52dU2KVxD 9YY+D9Mpi1nuG8UADJJfkVjoyZZxf+nX6Bjwb1yE3lSkPwUYpPaejeZ6MZU/MyOaH+Ma XLuj4yvT64w1Ax1jreu7pp6RR29WZ3NIkj4JdiDIARlEgO3MdLLF6KVAJ8uwSOVGM4cH hYlRG2DA9aBz+Tp77dxxQHGKdmXDmWeqwa86TwsgdrDRgpo/keznHPo53dYtsIU0k3kL zIHg== X-Gm-Message-State: AD7BkJLKNFoultjgmJ1griAtY92dzG4VB0X5iZ69jdaUx69tho7K4OOy2kj8DE5RClX1alRqVRCSJ1lWqYRoBA== X-Received: by 10.107.157.70 with SMTP id g67mr12175932ioe.38.1457730990822; Fri, 11 Mar 2016 13:16:30 -0800 (PST) MIME-Version: 1.0 Sender: carpeddiem@gmail.com Received: by 10.107.39.66 with HTTP; Fri, 11 Mar 2016 13:16:11 -0800 (PST) In-Reply-To: <56E30267.30009@FreeBSD.org> References: <56E30267.30009@FreeBSD.org> From: Ed Maste Date: Fri, 11 Mar 2016 16:16:11 -0500 X-Google-Sender-Auth: -eZVLRbs7-6Wmc6qqoTn_5zPNPU Message-ID: Subject: Re: CHANGES file To: Bryan Drewery Cc: "freebsd-arch@freebsd.org" Content-Type: text/plain; charset=UTF-8 X-BeenThere: freebsd-arch@freebsd.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: Discussion related to FreeBSD architecture List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 11 Mar 2016 21:16:31 -0000 On 11 March 2016 at 12:37, Bryan Drewery wrote: > In ports we have an UPDATING file that is targeted at users and a > CHANGES file that is targeted at developers regarding API changes. > > I would like to introduce a CHANGES file as it makes it simpler for > developers to see what has changed without reading through all commit > logs. This is of great benefit for module writers and vendors who may > even have customized some of the code in the tree. Seems like a good idea to me. I worry that it will be forgotten on a number of changes, but that's no worse than today and can be remedied after the fact when a missing entry is noticed.