annotate etc/ETAGS.README @ 4844:91b3d00e717f

Various cleanups for Dynarr code, from Unicode-internal ws dynarr.c: Add comment explaining Dynarr_largest() use. dynarr.c: In Dynarr_insert_many(), don't call Dynarr_resize() unless we actually need to resize, and note that an assert() that we are inserting at or below the current end could be wrong if code wants to access stuff between `len' and `largest'. dynarr.c: Don't just Dynarr_resize() to the right size; instead use Dynarr_reset() then Dynarr_add_many(), so that the 'len' and 'largest' and such get set properly. dynarr.c, faces.c, gutter.c, lisp.h, lread.c, lrecord.h, redisplay-output.c, redisplay.c: Rename Dynarr member 'cur' to 'len' since it's the length of the dynarr, not really a pointer to a "current insertion point". Use type_checking_assert() instead of just assert() in some places. Add additional assertions (Dynarr_verify*()) to check that we're being given positions within range. Use them in Dynarr_at, Dynarr_atp, etc. New Dynarr_atp_allow_end() for retrieving a pointer to a position that might be the element past the last one. New Dynarr_past_lastp() to retrieve a pointer to the position past the last one, using Dynarr_atp_allow_end(). Change code appropriately to use it. Rename Dynarr_end() to Dynarr_lastp() (pointer to the last element) for clarity, and change code appropriately to use it. Change code appropriately to use Dynarr_begin(). Rewrite Dynarr_add_many(). New version can accept a NULL pointer to mean "reserve space but don't put anything in it". Used by stack_like_malloc().
author Ben Wing <ben@xemacs.org>
date Wed, 13 Jan 2010 04:07:42 -0600
parents 6cd3955b7e4d
children 308d34e9f07d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3972
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
1 etags is distributed under the following conditions:
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
2
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
3
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
4 Copyright (C) 1984 The Regents of the University of California
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
5
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
6 Redistribution and use in source and binary forms, with or without
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
7 modification, are permitted provided that the following conditions are
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
8 met:
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
9 1. Redistributions of source code must retain the above copyright
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
10 notice, this list of conditions and the following disclaimer.
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
11 2. Redistributions in binary form must reproduce the above copyright
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
12 notice, this list of conditions and the following disclaimer in the
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
13 documentation and/or other materials provided with the
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
14 distribution.
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
15 3. Neither the name of the University nor the names of its
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
16 contributors may be used to endorse or promote products derived
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
17 from this software without specific prior written permission.
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
18
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
19 THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
20 EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
21 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
22 DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
23 DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
24 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
25 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
26 ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
27 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
28 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
29
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
30
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
31 Copyright (C) 1984, 1987, 1988, 1989, 1993, 1994, 1995, 1998, 1999,
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
32 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
33 Free Software Foundation, Inc.
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
34
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
35 This file is not considered part of GNU Emacs.
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
36
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
37 This program is free software; you can redistribute it and/or modify
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
38 it under the terms of the GNU General Public License as published by
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
39 the Free Software Foundation; either version 2 of the License, or
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
40 (at your option) any later version.
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
41
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
42 This program is distributed in the hope that it will be useful,
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
43 but WITHOUT ANY WARRANTY; without even the implied warranty of
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
44 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
45 GNU General Public License for more details.
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
46
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
47 You should have received a copy of the GNU General Public License
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
48 along with this program; if not, write to the Free Software Foundation,
6cd3955b7e4d [xemacs-hg @ 2007-05-21 03:50:13 by stephent]
stephent
parents:
diff changeset
49 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.