From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: David Kastrup Newsgroups: gmane.lisp.guile.devel Subject: And another deprecation joke Date: Wed, 07 Dec 2011 13:58:21 +0100 Organization: Organization?!? Message-ID: <877h28iln6.fsf@fencepost.gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: dough.gmane.org 1323262736 18060 80.91.229.12 (7 Dec 2011 12:58:56 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 7 Dec 2011 12:58:56 +0000 (UTC) To: guile-devel@gnu.org Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Wed Dec 07 13:58:52 2011 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1RYH5G-0004ky-Qm for guile-devel@m.gmane.org; Wed, 07 Dec 2011 13:58:50 +0100 Original-Received: from localhost ([::1]:60501 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RYH5G-00071v-H0 for guile-devel@m.gmane.org; Wed, 07 Dec 2011 07:58:50 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:55618) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RYH59-00071j-TD for guile-devel@gnu.org; Wed, 07 Dec 2011 07:58:49 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RYH58-00075I-Kb for guile-devel@gnu.org; Wed, 07 Dec 2011 07:58:43 -0500 Original-Received: from lo.gmane.org ([80.91.229.12]:37818) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RYH58-00074e-FZ for guile-devel@gnu.org; Wed, 07 Dec 2011 07:58:42 -0500 Original-Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1RYH53-0004gg-4v for guile-devel@gnu.org; Wed, 07 Dec 2011 13:58:37 +0100 Original-Received: from p508eaf98.dip.t-dialin.net ([80.142.175.152]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 07 Dec 2011 13:58:37 +0100 Original-Received: from dak by p508eaf98.dip.t-dialin.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 07 Dec 2011 13:58:37 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 37 Original-X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: p508eaf98.dip.t-dialin.net X-Face: 2FEFf>]>q>2iw=B6, xrUubRI>pR&Ml9=ao@P@i)L:\urd*t9M~y1^:+Y]'C0~{mAl`oQuAl \!3KEIp?*w`|bL5qr,H)LFO6Q=qx~iH4DN; i"; /yuIsqbLLCh/!U#X[S~(5eZ41to5f%E@'ELIi$t^ Vc\LWP@J5p^rst0+('>Er0=^1{]M9!p?&:\z]|;&=NP3AhB!B_bi^]Pfkw User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.90 (gnu/linux) Cancel-Lock: sha1:5fjDUCUgYshZHeL80M/rPZFUW4g= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 80.91.229.12 X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:13001 Archived-At: `dimensions->uniform-array' is deprecated. Use `make-typed-array' instead. Unfortunately, this was not even called in the application. The actual function called was make-uniform-vector. If we look at the documentation of make-typed-array, we find — Scheme Procedure: make-typed-array type fill bound ... — C Function: scm_make_typed_array (type, fill, bounds) Create and return an array that has as many dimensions as there are bounds and (maybe) fill it with fill. The underlying storage vector is created according to type, which must be a symbol whose name is the `vectag' of the array as explained above, or #t for ordinary, non-specialized arrays. This, however, is a lie, since there is no place above where "vectag" would be explained. There is an explanation about how it will be printed as part of an array, but not how it is specified. Would it please be possible a) to not just deprecate some function when there are _callers_ in the guile code base that are _not_ explicitly deprecated b) make sure that the recommended replacements are actually _documented_? This is not the first such "deprecation" I have encountered, and it shows a blatant disrespect of the user base. -- David Kastrup