From owner-freebsd-arch@freebsd.org Fri Mar 11 17:37:41 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 CE246ACBDD7 for ; Fri, 11 Mar 2016 17:37:41 +0000 (UTC) (envelope-from bdrewery@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id B242BFDA for ; Fri, 11 Mar 2016 17:37:41 +0000 (UTC) (envelope-from bdrewery@FreeBSD.org) Received: from mail.xzibition.com (localhost [IPv6:::1]) by freefall.freebsd.org (Postfix) with ESMTP id ABE7C14DF for ; Fri, 11 Mar 2016 17:37:41 +0000 (UTC) (envelope-from bdrewery@FreeBSD.org) Received: from mail.xzibition.com (localhost [172.31.3.2]) by mail.xzibition.com (Postfix) with ESMTP id 5FF3E1E0B4 for ; Fri, 11 Mar 2016 17:37:41 +0000 (UTC) X-Virus-Scanned: amavisd-new at mail.xzibition.com Received: from mail.xzibition.com ([172.31.3.2]) by mail.xzibition.com (mail.xzibition.com [172.31.3.2]) (amavisd-new, port 10026) with LMTP id CEh9Sw_9bk9a for ; Fri, 11 Mar 2016 17:37:38 +0000 (UTC) To: "freebsd-arch@freebsd.org" DKIM-Filter: OpenDKIM Filter v2.9.2 mail.xzibition.com D958B1E0AF From: Bryan Drewery Subject: CHANGES file Openpgp: id=F9173CB2C3AAEA7A5C8A1F0935D771BB6E4697CF; url=http://www.shatow.net/bryan/bryan2.asc Organization: FreeBSD Message-ID: <56E30267.30009@FreeBSD.org> Date: Fri, 11 Mar 2016 09:37:43 -0800 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:38.0) Gecko/20100101 Thunderbird/38.6.0 MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="rXVFvjo6HgSg9DOVkM1MP1MqtB5k9CxgG" 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 17:37:42 -0000 This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --rXVFvjo6HgSg9DOVkM1MP1MqtB5k9CxgG Content-Type: multipart/mixed; boundary="4U3FcvogfHn0bAHcWffITFjqEvCBflLBq" From: Bryan Drewery To: "freebsd-arch@freebsd.org" Message-ID: <56E30267.30009@FreeBSD.org> Subject: CHANGES file --4U3FcvogfHn0bAHcWffITFjqEvCBflLBq Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable 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. 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. Note I am not requesting every little KPI change be documented in here. I am only wanting to document ones where a change will break something for someone and no warning or error is given if they do nothing. Many API changes will cause a build error or warning while many do not as they are not expressible in C or not utilized by our style or captured by all compilers (like which return values are possible via enum). Unless someone objects for good reason I will create this file and encourage others to document their subtle changes in it. Of course it will not be 100% but it should be helpful nonetheless. --=20 Regards, Bryan Drewery --4U3FcvogfHn0bAHcWffITFjqEvCBflLBq-- --rXVFvjo6HgSg9DOVkM1MP1MqtB5k9CxgG Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQEcBAEBAgAGBQJW4wJnAAoJEDXXcbtuRpfPfFsIALKdigY9d2dR40a8beXCXOAn G3EBZLjzzYY6QiZUQRwLI+jQEspmQwAAVTWXtCyrIdKj2UyjCVBNkaElDQ+Y6sXn htUsRNJhW+FbcS9zqwmBn6w4Gb3AUYZw+AijeK+dBJdbA08y0YX4LL3kipNyfNlE ijA8Gb810pbU9KW/OyOV1c4QMXHBhLE7M8jCBrxH6p5qLUPy4s+VNvKSBdXlHLQz rstlqs/iZPRWmNmpERdy1wvfuoyG0XwVgakuZZHSo7gsyJk/YOhZHwgKEvjsBYNY MHLHyESXCXfT1TFry4XUP6pm0kYG966taTQsSLE8EwMFbij9Z0lK84HtpBboRUE= =BhfZ -----END PGP SIGNATURE----- --rXVFvjo6HgSg9DOVkM1MP1MqtB5k9CxgG--