annotate etc/ETAGS.README @ 5070:b0f4adffca7d

fix so that CL docstrings (with &key, etc.) handled properly -------------------- ChangeLog entries follow: -------------------- lisp/ChangeLog addition: 2010-02-23 Ben Wing <ben@xemacs.org> * autoload.el: * autoload.el (make-autoload): * cl-macs.el (cl-function-arglist): * cl-macs.el (cl-transform-lambda): Don't add argument list with the tag "Common Lisp lambda list:"; instead add in "standard" form using "arguments:" and omitting the function name. Add an arg to `cl-function-arglist' to omit the name and use it in autoload.el instead of just hacking it off. * help.el: * help.el (function-arglist): * help.el (function-documentation-1): New. Extract out common code to recognize and/or strip the arglist from documentation into `function-documentation-1'. Use in `function-arglist' and `function-documentation'. Modify `function-arglist' so it looks for the `arguments: ' stuff in all doc strings, not just subrs/autoloads, so that CL functions get recognized properly. Change the regexp used to match "arguments: " specs to allow nested parens inside the arg list (happens when you have a default value specified in a CL arglist).
author Ben Wing <ben@xemacs.org>
date Tue, 23 Feb 2010 01:12:13 -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.