From owner-freebsd-arch@freebsd.org Fri Mar 11 18:31:44 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 41F46ACC345 for ; Fri, 11 Mar 2016 18:31:44 +0000 (UTC) (envelope-from markjdb@gmail.com) Received: from mail-pa0-x234.google.com (mail-pa0-x234.google.com [IPv6:2607:f8b0:400e:c03::234]) (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 1DDE2B2F; Fri, 11 Mar 2016 18:31:44 +0000 (UTC) (envelope-from markjdb@gmail.com) Received: by mail-pa0-x234.google.com with SMTP id fe3so89447864pab.1; Fri, 11 Mar 2016 10:31:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=sugPkfb8fA8MBL6tDkl5VOTCKndGvxe+GUtRkYorgag=; b=JzFNftNN7A7leOi1EnhYz3LmSeH+vTSlZ7UhVa5PCaEea4CBxxf5MWyN6vl9s24o4R P6VXNFEFLQgxgpzvX67urCSP0QloMQkQQnuNQPeSRQuXOLUVP8mJLuXx/mzEpUgDQHaY nGM4WoqXzYjScOmxviSpJrtmXTxjiFin3JnOarEqiwsPlpBjzsjv0kGaOX+1K4MiJH5V EBbi0+Q3kSv/c0kq7BfHkbg129GxEvnzU7v1HQFkGbD94v7oo0tNmMUR6Bxt8at90u+2 HdCYj19BSHSFhKgBA+If+xyByjQgyFKkWUipnWFkpLfZuuSngdNEYOZ38t10gsaT7fM/ XGOA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:date:from:to:cc:subject:message-id :references:mime-version:content-disposition:in-reply-to:user-agent; bh=sugPkfb8fA8MBL6tDkl5VOTCKndGvxe+GUtRkYorgag=; b=L7gx0LNanLpuTEQUu3N/8EBSSIe4oUkHy87N+rXtD0hlPSmwMeh9vMvSCLvYhkm/bk +uQ/x5qQS7M0FbckBYU7ilNTU4avLh1LTh4LpE4SbVlWmINO/aYHSmyRG0P+pepEGeVd w7sqsVEeWkwtRtskt2qYYYeB+IHcRApvTyT6ZXfl9K89znV2MNt5yLW5qI6Vx6Szx1r3 Za5reGEQ+GZAkmgNXiVmoihnZX2kXvMY7cuu8/3GJDIqE3mhrlFl+wW8u/2MskY9XIrD kakKgS9+/Rs1mly/tG9mP0wxGnFxE3JkOGfon/Ywj3Cka4xR2dlKKpBMTR5IBciBXndW iTWg== X-Gm-Message-State: AD7BkJI3nDkYvQ5EFobD1N4k6uQVdqBxF61g179iiTpOQY84SW4tAWmC/B40IRxgoAUPvw== X-Received: by 10.66.164.39 with SMTP id yn7mr17884925pab.107.1457721103535; Fri, 11 Mar 2016 10:31:43 -0800 (PST) Received: from wkstn-mjohnston.west.isilon.com (c-67-182-131-225.hsd1.wa.comcast.net. [67.182.131.225]) by smtp.gmail.com with ESMTPSA id sj4sm14525576pab.43.2016.03.11.10.31.41 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 11 Mar 2016 10:31:42 -0800 (PST) Sender: Mark Johnston Date: Fri, 11 Mar 2016 10:34:44 -0800 From: Mark Johnston To: Bryan Drewery Cc: "freebsd-arch@freebsd.org" Subject: Re: CHANGES file Message-ID: <20160311183444.GA53265@wkstn-mjohnston.west.isilon.com> References: <56E30267.30009@FreeBSD.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <56E30267.30009@FreeBSD.org> User-Agent: Mutt/1.5.24 (2015-08-30) 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 18:31:44 -0000 On Fri, Mar 11, 2016 at 09:37:43AM -0800, 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. +1 > > Some examples of recent changes that are otherwise undocumented: > > 1. r295707 which introduced g_reset_bio() which *currently* is a wrapper > around bzero, but may change. At Isilon we had >1 lines of our own code > affected by this change and I feel lucky I noticed it rather than > leaving it to someone to discover years from now when it matters. > 2. A lot of my recent share/mk changes may cause grief for vendors (but > not likely out-of-tree builds). > 3. callout_stop(9) return value. Some other recent examples: - DIOGDINFO removal - a proc_set_cred() call is now needed to set the p_ucred field of a process - callout_drain() return value - with INVARIANTS, default use of the "trash" destructor in UMA zones