annotate lib-src/make-docfile.c @ 50860:4fd35ed09e9b

(c-lineup-argcont, c-lineup-gcc-asm-reg): Don't quote nil and t in docstrings.
author Juanma Barranquero <lekktu@gmail.com>
date Tue, 06 May 2003 17:44:11 +0000
parents 23a1cea22d13
children 695cf19ef79e d7ddb3e565de
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1 /* Generate doc-string file for GNU Emacs from source files.
35293
39b2af5f7ee2 (write_c_args): Print newlines as spaces.
Gerd Moellmann <gerd@gnu.org>
parents: 28401
diff changeset
2 Copyright (C) 1985, 86, 92, 93, 94, 97, 1999, 2000, 2001
39b2af5f7ee2 (write_c_args): Print newlines as spaces.
Gerd Moellmann <gerd@gnu.org>
parents: 28401
diff changeset
3 Free Software Foundation, Inc.
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
4
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
5 This file is part of GNU Emacs.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
6
38
056b931d312b *** empty log message ***
Joseph Arceneaux <jla@gnu.org>
parents: 24
diff changeset
7 GNU Emacs is free software; you can redistribute it and/or modify
056b931d312b *** empty log message ***
Joseph Arceneaux <jla@gnu.org>
parents: 24
diff changeset
8 it under the terms of the GNU General Public License as published by
638
40b255f55df3 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 168
diff changeset
9 the Free Software Foundation; either version 2, or (at your option)
38
056b931d312b *** empty log message ***
Joseph Arceneaux <jla@gnu.org>
parents: 24
diff changeset
10 any later version.
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
11
38
056b931d312b *** empty log message ***
Joseph Arceneaux <jla@gnu.org>
parents: 24
diff changeset
12 GNU Emacs is distributed in the hope that it will be useful,
056b931d312b *** empty log message ***
Joseph Arceneaux <jla@gnu.org>
parents: 24
diff changeset
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
056b931d312b *** empty log message ***
Joseph Arceneaux <jla@gnu.org>
parents: 24
diff changeset
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
056b931d312b *** empty log message ***
Joseph Arceneaux <jla@gnu.org>
parents: 24
diff changeset
15 GNU General Public License for more details.
056b931d312b *** empty log message ***
Joseph Arceneaux <jla@gnu.org>
parents: 24
diff changeset
16
056b931d312b *** empty log message ***
Joseph Arceneaux <jla@gnu.org>
parents: 24
diff changeset
17 You should have received a copy of the GNU General Public License
056b931d312b *** empty log message ***
Joseph Arceneaux <jla@gnu.org>
parents: 24
diff changeset
18 along with GNU Emacs; see the file COPYING. If not, write to
14186
ee40177f6c68 Update FSF's address in the preamble.
Erik Naggum <erik@naggum.no>
parents: 12351
diff changeset
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
ee40177f6c68 Update FSF's address in the preamble.
Erik Naggum <erik@naggum.no>
parents: 12351
diff changeset
20 Boston, MA 02111-1307, USA. */
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
21
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
22 /* The arguments given to this program are all the C and Lisp source files
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
23 of GNU Emacs. .elc and .el and .c files are allowed.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
24 A .o file can also be specified; the .c file it was made from is used.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
25 This helps the makefile pass the correct list of files.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
26
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
27 The results, which go to standard output or to a file
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
28 specified with -a or -o (-a to append, -o to start from nothing),
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
29 are entries containing function or variable names and their documentation.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
30 Each entry starts with a ^_ character.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
31 Then comes F for a function or V for a variable.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
32 Then comes the function or variable name, terminated with a newline.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
33 Then comes the documentation for that function or variable.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
34 */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
35
11690
450b9598aca5 Include config.h.
Richard M. Stallman <rms@gnu.org>
parents: 11413
diff changeset
36 #define NO_SHORTNAMES /* Tell config not to load remap.h */
25532
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
37 #include <config.h>
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
38
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
39 /* defined to be emacs_main, sys_fopen, etc. in config.h */
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
40 #undef main
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
41 #undef fopen
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
42 #undef chdir
11690
450b9598aca5 Include config.h.
Richard M. Stallman <rms@gnu.org>
parents: 11413
diff changeset
43
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
44 #include <stdio.h>
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
45 #ifdef MSDOS
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
46 #include <fcntl.h>
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
47 #endif /* MSDOS */
9772
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
48 #ifdef WINDOWSNT
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
49 #include <stdlib.h>
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
50 #include <fcntl.h>
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
51 #include <direct.h>
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
52 #endif /* WINDOWSNT */
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
53
9772
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
54 #ifdef DOS_NT
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
55 #define READ_TEXT "rt"
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
56 #define READ_BINARY "rb"
9772
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
57 #else /* not DOS_NT */
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
58 #define READ_TEXT "r"
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
59 #define READ_BINARY "r"
9772
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
60 #endif /* not DOS_NT */
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
61
9491
dd3b83e4ceb0 Eliminate some -Wall warnings.
David J. MacKenzie <djm@gnu.org>
parents: 7564
diff changeset
62 int scan_file ();
dd3b83e4ceb0 Eliminate some -Wall warnings.
David J. MacKenzie <djm@gnu.org>
parents: 7564
diff changeset
63 int scan_lisp_file ();
dd3b83e4ceb0 Eliminate some -Wall warnings.
David J. MacKenzie <djm@gnu.org>
parents: 7564
diff changeset
64 int scan_c_file ();
dd3b83e4ceb0 Eliminate some -Wall warnings.
David J. MacKenzie <djm@gnu.org>
parents: 7564
diff changeset
65
12134
cf65209088d6 [MSDOS]: #undef chdir.
Karl Heuer <kwzh@gnu.org>
parents: 11690
diff changeset
66 #ifdef MSDOS
cf65209088d6 [MSDOS]: #undef chdir.
Karl Heuer <kwzh@gnu.org>
parents: 11690
diff changeset
67 /* s/msdos.h defines this as sys_chdir, but we're not linking with the
cf65209088d6 [MSDOS]: #undef chdir.
Karl Heuer <kwzh@gnu.org>
parents: 11690
diff changeset
68 file where that function is defined. */
cf65209088d6 [MSDOS]: #undef chdir.
Karl Heuer <kwzh@gnu.org>
parents: 11690
diff changeset
69 #undef chdir
cf65209088d6 [MSDOS]: #undef chdir.
Karl Heuer <kwzh@gnu.org>
parents: 11690
diff changeset
70 #endif
cf65209088d6 [MSDOS]: #undef chdir.
Karl Heuer <kwzh@gnu.org>
parents: 11690
diff changeset
71
21783
798a28989dde Include <unistd.h> for chdir.
Andreas Schwab <schwab@suse.de>
parents: 19636
diff changeset
72 #ifdef HAVE_UNISTD_H
798a28989dde Include <unistd.h> for chdir.
Andreas Schwab <schwab@suse.de>
parents: 19636
diff changeset
73 #include <unistd.h>
798a28989dde Include <unistd.h> for chdir.
Andreas Schwab <schwab@suse.de>
parents: 19636
diff changeset
74 #endif
798a28989dde Include <unistd.h> for chdir.
Andreas Schwab <schwab@suse.de>
parents: 19636
diff changeset
75
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
76 /* Stdio stream for output to the DOC file. */
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
77 FILE *outfile;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
78
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
79 /* Name this program was invoked with. */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
80 char *progname;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
81
41084
052c2896e6ca Comment fixes.
Pavel Janík <Pavel@Janik.cz>
parents: 40130
diff changeset
82 /* Print error message. `s1' is printf control string, `s2' is arg for it. */
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
83
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
84 /* VARARGS1 */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
85 void
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
86 error (s1, s2)
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
87 char *s1, *s2;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
88 {
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
89 fprintf (stderr, "%s: ", progname);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
90 fprintf (stderr, s1, s2);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
91 fprintf (stderr, "\n");
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
92 }
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
93
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
94 /* Print error message and exit. */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
95
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
96 /* VARARGS1 */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
97 void
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
98 fatal (s1, s2)
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
99 char *s1, *s2;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
100 {
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
101 error (s1, s2);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
102 exit (1);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
103 }
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
104
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
105 /* Like malloc but get fatal error if memory is exhausted. */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
106
11690
450b9598aca5 Include config.h.
Richard M. Stallman <rms@gnu.org>
parents: 11413
diff changeset
107 long *
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
108 xmalloc (size)
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
109 unsigned int size;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
110 {
11690
450b9598aca5 Include config.h.
Richard M. Stallman <rms@gnu.org>
parents: 11413
diff changeset
111 long *result = (long *) malloc (size);
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
112 if (result == NULL)
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
113 fatal ("virtual memory exhausted", 0);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
114 return result;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
115 }
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
116
9491
dd3b83e4ceb0 Eliminate some -Wall warnings.
David J. MacKenzie <djm@gnu.org>
parents: 7564
diff changeset
117 int
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
118 main (argc, argv)
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
119 int argc;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
120 char **argv;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
121 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
122 int i;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
123 int err_count = 0;
9643
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
124 int first_infile;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
125
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
126 progname = argv[0];
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
127
12328
dbc55496f684 (main): On MSDOS, don't change stdout to binary, and insist on an -o option.
Richard M. Stallman <rms@gnu.org>
parents: 12134
diff changeset
128 outfile = stdout;
dbc55496f684 (main): On MSDOS, don't change stdout to binary, and insist on an -o option.
Richard M. Stallman <rms@gnu.org>
parents: 12134
diff changeset
129
9772
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
130 /* Don't put CRs in the DOC file. */
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
131 #ifdef MSDOS
12350
68508136431f (main) [MSDOS]: Do set _fmode.
Richard M. Stallman <rms@gnu.org>
parents: 12328
diff changeset
132 _fmode = O_BINARY;
12328
dbc55496f684 (main): On MSDOS, don't change stdout to binary, and insist on an -o option.
Richard M. Stallman <rms@gnu.org>
parents: 12134
diff changeset
133 #if 0 /* Suspicion is that this causes hanging.
dbc55496f684 (main): On MSDOS, don't change stdout to binary, and insist on an -o option.
Richard M. Stallman <rms@gnu.org>
parents: 12134
diff changeset
134 So instead we require people to use -o on MSDOS. */
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
135 (stdout)->_flag &= ~_IOTEXT;
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
136 _setmode (fileno (stdout), O_BINARY);
12328
dbc55496f684 (main): On MSDOS, don't change stdout to binary, and insist on an -o option.
Richard M. Stallman <rms@gnu.org>
parents: 12134
diff changeset
137 #endif
dbc55496f684 (main): On MSDOS, don't change stdout to binary, and insist on an -o option.
Richard M. Stallman <rms@gnu.org>
parents: 12134
diff changeset
138 outfile = 0;
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
139 #endif /* MSDOS */
9772
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
140 #ifdef WINDOWSNT
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
141 _fmode = O_BINARY;
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
142 _setmode (fileno (stdout), O_BINARY);
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
143 #endif /* WINDOWSNT */
20652342eb9a (main) [WINDOWSNT]: Now sets _fmode and stdout to O_BINARY.
Richard M. Stallman <rms@gnu.org>
parents: 9643
diff changeset
144
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
145 /* If first two args are -o FILE, output to FILE. */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
146 i = 1;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
147 if (argc > i + 1 && !strcmp (argv[i], "-o"))
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
148 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
149 outfile = fopen (argv[i + 1], "w");
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
150 i += 2;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
151 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
152 if (argc > i + 1 && !strcmp (argv[i], "-a"))
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
153 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
154 outfile = fopen (argv[i + 1], "a");
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
155 i += 2;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
156 }
2814
0da5b58e98ed Install patches from David J. Mackenzie to make the srcdir option
Jim Blandy <jimb@redhat.com>
parents: 2483
diff changeset
157 if (argc > i + 1 && !strcmp (argv[i], "-d"))
0da5b58e98ed Install patches from David J. Mackenzie to make the srcdir option
Jim Blandy <jimb@redhat.com>
parents: 2483
diff changeset
158 {
0da5b58e98ed Install patches from David J. Mackenzie to make the srcdir option
Jim Blandy <jimb@redhat.com>
parents: 2483
diff changeset
159 chdir (argv[i + 1]);
0da5b58e98ed Install patches from David J. Mackenzie to make the srcdir option
Jim Blandy <jimb@redhat.com>
parents: 2483
diff changeset
160 i += 2;
0da5b58e98ed Install patches from David J. Mackenzie to make the srcdir option
Jim Blandy <jimb@redhat.com>
parents: 2483
diff changeset
161 }
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
162
12328
dbc55496f684 (main): On MSDOS, don't change stdout to binary, and insist on an -o option.
Richard M. Stallman <rms@gnu.org>
parents: 12134
diff changeset
163 if (outfile == 0)
dbc55496f684 (main): On MSDOS, don't change stdout to binary, and insist on an -o option.
Richard M. Stallman <rms@gnu.org>
parents: 12134
diff changeset
164 fatal ("No output file specified", "");
dbc55496f684 (main): On MSDOS, don't change stdout to binary, and insist on an -o option.
Richard M. Stallman <rms@gnu.org>
parents: 12134
diff changeset
165
9643
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
166 first_infile = i;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
167 for (; i < argc; i++)
9643
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
168 {
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
169 int j;
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
170 /* Don't process one file twice. */
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
171 for (j = first_infile; j < i; j++)
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
172 if (! strcmp (argv[i], argv[j]))
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
173 break;
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
174 if (j == i)
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
175 err_count += scan_file (argv[i]);
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
176 }
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
177 #ifndef VMS
9643
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
178 exit (err_count > 0);
3028
cf9379f91ea1 * make-docfile.c: Doc fix.
Jim Blandy <jimb@redhat.com>
parents: 2966
diff changeset
179 #endif /* VMS */
9643
5d1e70b22a93 (main): Don't process one input file twice.
Richard M. Stallman <rms@gnu.org>
parents: 9491
diff changeset
180 return err_count > 0;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
181 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
182
164
aba3ff2b9eb4 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 162
diff changeset
183 /* Read file FILENAME and output its doc strings to outfile. */
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
184 /* Return 1 if file is not found, 0 if it is found. */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
185
9491
dd3b83e4ceb0 Eliminate some -Wall warnings.
David J. MacKenzie <djm@gnu.org>
parents: 7564
diff changeset
186 int
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
187 scan_file (filename)
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
188 char *filename;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
189 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
190 int len = strlen (filename);
12351
f2e9eb6a8939 (scan_file): Make sure it never looks at filename[-1].
Richard M. Stallman <rms@gnu.org>
parents: 12350
diff changeset
191 if (len > 4 && !strcmp (filename + len - 4, ".elc"))
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
192 return scan_lisp_file (filename, READ_BINARY);
12351
f2e9eb6a8939 (scan_file): Make sure it never looks at filename[-1].
Richard M. Stallman <rms@gnu.org>
parents: 12350
diff changeset
193 else if (len > 3 && !strcmp (filename + len - 3, ".el"))
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
194 return scan_lisp_file (filename, READ_TEXT);
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
195 else
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
196 return scan_c_file (filename, READ_TEXT);
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
197 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
198
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
199 char buf[128];
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
200
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
201 /* Some state during the execution of `read_c_string_or_comment'. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
202 struct rcsoc_state
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
203 {
41084
052c2896e6ca Comment fixes.
Pavel Janík <Pavel@Janik.cz>
parents: 40130
diff changeset
204 /* A count of spaces and newlines that have been read, but not output. */
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
205 unsigned pending_spaces, pending_newlines;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
206
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
207 /* Where we're reading from. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
208 FILE *in_file;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
209
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
210 /* If non-zero, a buffer into which to copy characters. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
211 char *buf_ptr;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
212 /* If non-zero, a file into which to copy characters. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
213 FILE *out_file;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
214
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
215 /* A keyword we look for at the beginning of lines. If found, it is
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
216 not copied, and SAW_KEYWORD is set to true. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
217 char *keyword;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
218 /* The current point we've reached in an occurance of KEYWORD in
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
219 the input stream. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
220 char *cur_keyword_ptr;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
221 /* Set to true if we saw an occurance of KEYWORD. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
222 int saw_keyword;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
223 };
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
224
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
225 /* Output CH to the file or buffer in STATE. Any pending newlines or
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
226 spaces are output first. */
39986
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
227
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
228 static INLINE void
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
229 put_char (ch, state)
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
230 int ch;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
231 struct rcsoc_state *state;
39986
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
232 {
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
233 int out_ch;
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
234 do
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
235 {
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
236 if (state->pending_newlines > 0)
39986
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
237 {
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
238 state->pending_newlines--;
39986
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
239 out_ch = '\n';
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
240 }
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
241 else if (state->pending_spaces > 0)
39986
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
242 {
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
243 state->pending_spaces--;
39986
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
244 out_ch = ' ';
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
245 }
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
246 else
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
247 out_ch = ch;
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
248
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
249 if (state->out_file)
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
250 putc (out_ch, state->out_file);
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
251 if (state->buf_ptr)
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
252 *state->buf_ptr++ = out_ch;
39986
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
253 }
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
254 while (out_ch != ch);
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
255 }
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
256
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
257 /* If in the middle of scanning a keyword, continue scanning with
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
258 character CH, otherwise output CH to the file or buffer in STATE.
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
259 Any pending newlines or spaces are output first, as well as any
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
260 previously scanned characters that were thought to be part of a
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
261 keyword, but were in fact not. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
262
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
263 static void
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
264 scan_keyword_or_put_char (ch, state)
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
265 int ch;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
266 struct rcsoc_state *state;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
267 {
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
268 if (state->keyword
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
269 && *state->cur_keyword_ptr == ch
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
270 && (state->cur_keyword_ptr > state->keyword
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
271 || state->pending_newlines > 0))
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
272 /* We might be looking at STATE->keyword at some point.
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
273 Keep looking until we know for sure. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
274 {
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
275 if (*++state->cur_keyword_ptr == '\0')
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
276 /* Saw the whole keyword. Set SAW_KEYWORD flag to true. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
277 {
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
278 state->saw_keyword = 1;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
279
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
280 /* Reset the scanning pointer. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
281 state->cur_keyword_ptr = state->keyword;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
282
41084
052c2896e6ca Comment fixes.
Pavel Janík <Pavel@Janik.cz>
parents: 40130
diff changeset
283 /* Canonicalize whitespace preceding a usage string. */
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
284 state->pending_newlines = 2;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
285 state->pending_spaces = 0;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
286
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
287 /* Skip any whitespace between the keyword and the
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
288 usage string. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
289 do
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
290 ch = getc (state->in_file);
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
291 while (ch == ' ' || ch == '\n');
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
292
46958
d7669c85c9cb (scan_keyword_or_put_char, write_c_args): Use `fn'
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46394
diff changeset
293 /* Output the open-paren we just read. */
d7669c85c9cb (scan_keyword_or_put_char, write_c_args): Use `fn'
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46394
diff changeset
294 put_char (ch, state);
d7669c85c9cb (scan_keyword_or_put_char, write_c_args): Use `fn'
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46394
diff changeset
295
d7669c85c9cb (scan_keyword_or_put_char, write_c_args): Use `fn'
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46394
diff changeset
296 /* Skip the function name and replace it with `fn'. */
d7669c85c9cb (scan_keyword_or_put_char, write_c_args): Use `fn'
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46394
diff changeset
297 do
d7669c85c9cb (scan_keyword_or_put_char, write_c_args): Use `fn'
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46394
diff changeset
298 ch = getc (state->in_file);
d7669c85c9cb (scan_keyword_or_put_char, write_c_args): Use `fn'
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46394
diff changeset
299 while (ch != ' ' && ch != ')');
d7669c85c9cb (scan_keyword_or_put_char, write_c_args): Use `fn'
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46394
diff changeset
300 put_char ('f', state);
d7669c85c9cb (scan_keyword_or_put_char, write_c_args): Use `fn'
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46394
diff changeset
301 put_char ('n', state);
49600
23a1cea22d13 Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 48313
diff changeset
302
46958
d7669c85c9cb (scan_keyword_or_put_char, write_c_args): Use `fn'
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46394
diff changeset
303 /* Put back the last character. */
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
304 ungetc (ch, state->in_file);
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
305 }
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
306 }
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
307 else
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
308 {
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
309 if (state->keyword && state->cur_keyword_ptr > state->keyword)
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
310 /* We scanned the beginning of a potential usage
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
311 keyword, but it was a false alarm. Output the
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
312 part we scanned. */
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
313 {
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
314 char *p;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
315
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
316 for (p = state->keyword; p < state->cur_keyword_ptr; p++)
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
317 put_char (*p, state);
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
318
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
319 state->cur_keyword_ptr = state->keyword;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
320 }
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
321
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
322 put_char (ch, state);
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
323 }
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
324 }
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
325
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
326
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
327 /* Skip a C string or C-style comment from INFILE, and return the
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
328 character that follows. COMMENT non-zero means skip a comment. If
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
329 PRINTFLAG is positive, output string contents to outfile. If it is
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
330 negative, store contents in buf. Convert escape sequences \n and
40112
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
331 \t to newline and tab; discard \ followed by newline.
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
332 If SAW_USAGE is non-zero, then any occurances of the string `usage:'
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
333 at the beginning of a line will be removed, and *SAW_USAGE set to
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
334 true if any were encountered. */
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
335
9491
dd3b83e4ceb0 Eliminate some -Wall warnings.
David J. MacKenzie <djm@gnu.org>
parents: 7564
diff changeset
336 int
40112
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
337 read_c_string_or_comment (infile, printflag, comment, saw_usage)
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
338 FILE *infile;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
339 int printflag;
40112
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
340 int *saw_usage;
48313
85a91bbe8e45 (read_c_string_or_comment): Declare msgno.
Dave Love <fx@gnu.org>
parents: 46958
diff changeset
341 int comment;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
342 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
343 register int c;
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
344 struct rcsoc_state state;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
345
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
346 state.in_file = infile;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
347 state.buf_ptr = (printflag < 0 ? buf : 0);
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
348 state.out_file = (printflag > 0 ? outfile : 0);
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
349 state.pending_spaces = 0;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
350 state.pending_newlines = 0;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
351 state.keyword = (saw_usage ? "usage:" : 0);
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
352 state.cur_keyword_ptr = state.keyword;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
353 state.saw_keyword = 0;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
354
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
355 c = getc (infile);
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
356 if (comment)
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
357 while (c == '\n' || c == '\r' || c == '\t' || c == ' ')
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
358 c = getc (infile);
40112
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
359
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
360 while (c != EOF)
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
361 {
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
362 while (c != EOF && (comment ? c != '*' : c != '"'))
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
363 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
364 if (c == '\\')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
365 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
366 c = getc (infile);
25532
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
367 if (c == '\n' || c == '\r')
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
368 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
369 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
370 continue;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
371 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
372 if (c == 'n')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
373 c = '\n';
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
374 if (c == 't')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
375 c = '\t';
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
376 }
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
377
39986
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
378 if (c == ' ')
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
379 state.pending_spaces++;
39986
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
380 else if (c == '\n')
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
381 {
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
382 state.pending_newlines++;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
383 state.pending_spaces = 0;
39986
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
384 }
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
385 else
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
386 scan_keyword_or_put_char (c, &state);
39986
c9411c9fab91 (put_char): New function.
Miles Bader <miles@gnu.org>
parents: 39976
diff changeset
387
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
388 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
389 }
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
390
39949
f169b10c8e00 (read_c_string_or_comment): Don't drop a '*'
Gerd Moellmann <gerd@gnu.org>
parents: 39897
diff changeset
391 if (c != EOF)
f169b10c8e00 (read_c_string_or_comment): Don't drop a '*'
Gerd Moellmann <gerd@gnu.org>
parents: 39897
diff changeset
392 c = getc (infile);
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
393
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
394 if (comment)
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
395 {
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
396 if (c == '/')
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
397 {
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
398 c = getc (infile);
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
399 break;
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
400 }
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
401
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
402 scan_keyword_or_put_char ('*', &state);
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
403 }
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
404 else
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
405 {
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
406 if (c != '"')
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
407 break;
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
408
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
409 /* If we had a "", concatenate the two strings. */
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
410 c = getc (infile);
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
411 }
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
412 }
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
413
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
414 if (printflag < 0)
40130
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
415 *state.buf_ptr = 0;
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
416
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
417 if (saw_usage)
89269b100451 (struct rcsoc_state): New type.
Miles Bader <miles@gnu.org>
parents: 40112
diff changeset
418 *saw_usage = state.saw_keyword;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
419
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
420 return c;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
421 }
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
422
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
423
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
424
5604
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
425 /* Write to file OUT the argument names of function FUNC, whose text is in BUF.
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
426 MINARGS and MAXARGS are the minimum and maximum number of arguments. */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
427
9491
dd3b83e4ceb0 Eliminate some -Wall warnings.
David J. MacKenzie <djm@gnu.org>
parents: 7564
diff changeset
428 void
5604
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
429 write_c_args (out, func, buf, minargs, maxargs)
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
430 FILE *out;
5604
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
431 char *func, *buf;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
432 int minargs, maxargs;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
433 {
1206
de54d705652f *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 753
diff changeset
434 register char *p;
1250
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
435 int in_ident = 0;
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
436 int just_spaced = 0;
5604
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
437 int need_space = 1;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
438
46958
d7669c85c9cb (scan_keyword_or_put_char, write_c_args): Use `fn'
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 46394
diff changeset
439 fprintf (out, "(fn");
5604
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
440
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
441 if (*buf == '(')
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
442 ++buf;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
443
1206
de54d705652f *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 753
diff changeset
444 for (p = buf; *p; p++)
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
445 {
1250
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
446 char c = *p;
2483
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
447 int ident_start = 0;
1250
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
448
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
449 /* Notice when we start printing a new identifier. */
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
450 if ((('A' <= c && c <= 'Z')
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
451 || ('a' <= c && c <= 'z')
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
452 || ('0' <= c && c <= '9')
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
453 || c == '_')
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
454 != in_ident)
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
455 {
1250
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
456 if (!in_ident)
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
457 {
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
458 in_ident = 1;
2483
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
459 ident_start = 1;
1206
de54d705652f *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 753
diff changeset
460
5604
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
461 if (need_space)
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
462 putc (' ', out);
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
463
1250
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
464 if (minargs == 0 && maxargs > 0)
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
465 fprintf (out, "&optional ");
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
466 just_spaced = 1;
1206
de54d705652f *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 753
diff changeset
467
1250
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
468 minargs--;
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
469 maxargs--;
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
470 }
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
471 else
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
472 in_ident = 0;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
473 }
638
40b255f55df3 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 168
diff changeset
474
1250
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
475 /* Print the C argument list as it would appear in lisp:
35293
39b2af5f7ee2 (write_c_args): Print newlines as spaces.
Gerd Moellmann <gerd@gnu.org>
parents: 28401
diff changeset
476 print underscores as hyphens, and print commas and newlines
39b2af5f7ee2 (write_c_args): Print newlines as spaces.
Gerd Moellmann <gerd@gnu.org>
parents: 28401
diff changeset
477 as spaces. Collapse adjacent spaces into one. */
39b2af5f7ee2 (write_c_args): Print newlines as spaces.
Gerd Moellmann <gerd@gnu.org>
parents: 28401
diff changeset
478 if (c == '_')
39b2af5f7ee2 (write_c_args): Print newlines as spaces.
Gerd Moellmann <gerd@gnu.org>
parents: 28401
diff changeset
479 c = '-';
39b2af5f7ee2 (write_c_args): Print newlines as spaces.
Gerd Moellmann <gerd@gnu.org>
parents: 28401
diff changeset
480 else if (c == ',' || c == '\n')
39b2af5f7ee2 (write_c_args): Print newlines as spaces.
Gerd Moellmann <gerd@gnu.org>
parents: 28401
diff changeset
481 c = ' ';
1250
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
482
2483
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
483 /* In C code, `default' is a reserved word, so we spell it
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
484 `defalt'; unmangle that here. */
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
485 if (ident_start
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
486 && strncmp (p, "defalt", 6) == 0
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
487 && ! (('A' <= p[6] && p[6] <= 'Z')
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
488 || ('a' <= p[6] && p[6] <= 'z')
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
489 || ('0' <= p[6] && p[6] <= '9')
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
490 || p[6] == '_'))
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
491 {
7564
d5d803ffff27 (write_c_args): Put `default' in upper case.
Richard M. Stallman <rms@gnu.org>
parents: 5604
diff changeset
492 fprintf (out, "DEFAULT");
2483
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
493 p += 5;
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
494 in_ident = 0;
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
495 just_spaced = 0;
b4145a12422d * make-docfile.c (write_c_args): Print an argument named "defalt"
Jim Blandy <jimb@redhat.com>
parents: 1676
diff changeset
496 }
35293
39b2af5f7ee2 (write_c_args): Print newlines as spaces.
Gerd Moellmann <gerd@gnu.org>
parents: 28401
diff changeset
497 else if (c != ' ' || !just_spaced)
5604
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
498 {
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
499 if (c >= 'a' && c <= 'z')
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
500 /* Upcase the letter. */
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
501 c += 'A' - 'a';
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
502 putc (c, out);
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
503 }
1250
5788741d1eaa entered into RCS
Jim Blandy <jimb@redhat.com>
parents: 1206
diff changeset
504
35293
39b2af5f7ee2 (write_c_args): Print newlines as spaces.
Gerd Moellmann <gerd@gnu.org>
parents: 28401
diff changeset
505 just_spaced = c == ' ';
5604
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
506 need_space = 0;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
507 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
508 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
509
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
510 /* Read through a c file. If a .o file is named,
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
511 the corresponding .c file is read instead.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
512 Looks for DEFUN constructs such as are defined in ../src/lisp.h.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
513 Accepts any word starting DEF... so it finds DEFSIMPLE and DEFPRED. */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
514
9491
dd3b83e4ceb0 Eliminate some -Wall warnings.
David J. MacKenzie <djm@gnu.org>
parents: 7564
diff changeset
515 int
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
516 scan_c_file (filename, mode)
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
517 char *filename, *mode;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
518 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
519 FILE *infile;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
520 register int c;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
521 register int commas;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
522 register int defunflag;
1676
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
523 register int defvarperbufferflag;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
524 register int defvarflag;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
525 int minargs, maxargs;
11413
9cd115f44483 (scan_c_file): At end, restore file name last char to its original value.
Richard M. Stallman <rms@gnu.org>
parents: 10199
diff changeset
526 int extension = filename[strlen (filename) - 1];
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
527
11413
9cd115f44483 (scan_c_file): At end, restore file name last char to its original value.
Richard M. Stallman <rms@gnu.org>
parents: 10199
diff changeset
528 if (extension == 'o')
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
529 filename[strlen (filename) - 1] = 'c';
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
530
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
531 infile = fopen (filename, mode);
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
532
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
533 /* No error if non-ex input file */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
534 if (infile == NULL)
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
535 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
536 perror (filename);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
537 return 0;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
538 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
539
41084
052c2896e6ca Comment fixes.
Pavel Janík <Pavel@Janik.cz>
parents: 40130
diff changeset
540 /* Reset extension to be able to detect duplicate files. */
11413
9cd115f44483 (scan_c_file): At end, restore file name last char to its original value.
Richard M. Stallman <rms@gnu.org>
parents: 10199
diff changeset
541 filename[strlen (filename) - 1] = extension;
9cd115f44483 (scan_c_file): At end, restore file name last char to its original value.
Richard M. Stallman <rms@gnu.org>
parents: 10199
diff changeset
542
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
543 c = '\n';
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
544 while (!feof (infile))
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
545 {
39976
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
546 int doc_keyword = 0;
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
547
25532
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
548 if (c != '\n' && c != '\r')
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
549 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
550 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
551 continue;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
552 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
553 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
554 if (c == ' ')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
555 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
556 while (c == ' ')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
557 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
558 if (c != 'D')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
559 continue;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
560 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
561 if (c != 'E')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
562 continue;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
563 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
564 if (c != 'F')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
565 continue;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
566 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
567 if (c != 'V')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
568 continue;
1676
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
569 c = getc (infile);
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
570 if (c != 'A')
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
571 continue;
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
572 c = getc (infile);
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
573 if (c != 'R')
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
574 continue;
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
575 c = getc (infile);
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
576 if (c != '_')
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
577 continue;
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
578
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
579 defvarflag = 1;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
580 defunflag = 0;
1676
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
581
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
582 c = getc (infile);
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
583 defvarperbufferflag = (c == 'P');
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
584
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
585 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
586 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
587 else if (c == 'D')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
588 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
589 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
590 if (c != 'E')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
591 continue;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
592 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
593 if (c != 'F')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
594 continue;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
595 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
596 defunflag = c == 'U';
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
597 defvarflag = 0;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
598 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
599 else continue;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
600
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
601 while (c != '(')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
602 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
603 if (c < 0)
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
604 goto eof;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
605 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
606 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
607
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
608 /* Lisp variable or function name. */
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
609 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
610 if (c != '"')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
611 continue;
40112
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
612 c = read_c_string_or_comment (infile, -1, 0, 0);
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
613
39976
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
614 /* DEFVAR_LISP ("name", addr, "doc")
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
615 DEFVAR_LISP ("name", addr /\* doc *\/)
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
616 DEFVAR_LISP ("name", addr, doc: /\* doc *\/) */
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
617
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
618 if (defunflag)
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
619 commas = 5;
1676
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
620 else if (defvarperbufferflag)
e8b3c6b52c1e * make-docfile.c (scan_c_file): Since DEFVAR_PER_BUFFER now takes
Jim Blandy <jimb@redhat.com>
parents: 1250
diff changeset
621 commas = 2;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
622 else if (defvarflag)
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
623 commas = 1;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
624 else /* For DEFSIMPLE and DEFPRED */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
625 commas = 2;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
626
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
627 while (commas)
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
628 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
629 if (c == ',')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
630 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
631 commas--;
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
632
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
633 if (defunflag && (commas == 1 || commas == 2))
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
634 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
635 do
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
636 c = getc (infile);
25532
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
637 while (c == ' ' || c == '\n' || c == '\r' || c == '\t');
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
638 if (c < 0)
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
639 goto eof;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
640 ungetc (c, infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
641 if (commas == 2) /* pick up minargs */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
642 fscanf (infile, "%d", &minargs);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
643 else /* pick up maxargs */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
644 if (c == 'M' || c == 'U') /* MANY || UNEVALLED */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
645 maxargs = -1;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
646 else
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
647 fscanf (infile, "%d", &maxargs);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
648 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
649 }
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
650
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
651 if (c == EOF)
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
652 goto eof;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
653 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
654 }
39976
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
655
25532
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
656 while (c == ' ' || c == '\n' || c == '\r' || c == '\t')
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
657 c = getc (infile);
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
658
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
659 if (c == '"')
40112
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
660 c = read_c_string_or_comment (infile, 0, 0, 0);
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
661
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
662 while (c != EOF && c != ',' && c != '/')
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
663 c = getc (infile);
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
664 if (c == ',')
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
665 {
39976
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
666 c = getc (infile);
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
667 while (c == ' ' || c == '\n' || c == '\r' || c == '\t')
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
668 c = getc (infile);
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
669 while ((c >= 'a' && c <= 'z') || (c >= 'Z' && c <= 'Z'))
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
670 c = getc (infile);
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
671 if (c == ':')
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
672 {
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
673 doc_keyword = 1;
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
674 c = getc (infile);
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
675 while (c == ' ' || c == '\n' || c == '\r' || c == '\t')
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
676 c = getc (infile);
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
677 }
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
678 }
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
679
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
680 if (c == '"'
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
681 || (c == '/'
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
682 && (c = getc (infile),
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
683 ungetc (c, infile),
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
684 c == '*')))
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
685 {
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
686 int comment = c != '"';
40112
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
687 int saw_usage;
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
688
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
689 putc (037, outfile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
690 putc (defvarflag ? 'V' : 'F', outfile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
691 fprintf (outfile, "%s\n", buf);
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
692
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
693 if (comment)
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
694 getc (infile); /* Skip past `*' */
40112
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
695 c = read_c_string_or_comment (infile, 1, comment, &saw_usage);
168
e0ec73426aea *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 164
diff changeset
696
e0ec73426aea *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 164
diff changeset
697 /* If this is a defun, find the arguments and print them. If
e0ec73426aea *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 164
diff changeset
698 this function takes MANY or UNEVALLED args, then the C source
e0ec73426aea *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 164
diff changeset
699 won't give the names of the arguments, so we shouldn't bother
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
700 trying to find them.
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
701
39976
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
702 Various doc-string styles:
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
703 0: DEFUN (..., "DOC") (args) [!comment]
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
704 1: DEFUN (..., /\* DOC *\/ (args)) [comment && !doc_keyword]
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
705 2: DEFUN (..., doc: /\* DOC *\/) (args) [comment && doc_keyword]
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
706 */
40112
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
707 if (defunflag && maxargs != -1 && !saw_usage)
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
708 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
709 char argbuf[1024], *p = argbuf;
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
710
39976
fa2e20b1440c (scan_c_file): Handle `new style' doc strings in comments [with `doc:'
Miles Bader <miles@gnu.org>
parents: 39949
diff changeset
711 if (!comment || doc_keyword)
39897
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
712 while (c != ')')
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
713 {
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
714 if (c < 0)
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
715 goto eof;
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
716 c = getc (infile);
3e6f2f2a0a62 (read_c_string_or_comment): Renamed from
Gerd Moellmann <gerd@gnu.org>
parents: 35293
diff changeset
717 }
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
718
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
719 /* Skip into arguments. */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
720 while (c != '(')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
721 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
722 if (c < 0)
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
723 goto eof;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
724 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
725 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
726 /* Copy arguments into ARGBUF. */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
727 *p++ = c;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
728 do
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
729 *p++ = c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
730 while (c != ')');
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
731 *p = '\0';
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
732 /* Output them. */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
733 fprintf (outfile, "\n\n");
5604
32ac07bd58ef Make the argument list output look more like the Lisp docstrings do.
Roland McGrath <roland@gnu.org>
parents: 5449
diff changeset
734 write_c_args (outfile, buf, argbuf, minargs, maxargs);
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
735 }
46394
1dd68094031a (scan_c_file): Warn about missing `usage' info.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 42566
diff changeset
736 else if (defunflag && maxargs == -1 && !saw_usage)
1dd68094031a (scan_c_file): Warn about missing `usage' info.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 42566
diff changeset
737 /* The DOC should provide the usage form. */
1dd68094031a (scan_c_file): Warn about missing `usage' info.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 42566
diff changeset
738 fprintf (stderr, "Missing `usage' for function `%s'.\n", buf);
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
739 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
740 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
741 eof:
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
742 fclose (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
743 return 0;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
744 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
745
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
746 /* Read a file of Lisp code, compiled or interpreted.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
747 Looks for
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
748 (defun NAME ARGS DOCSTRING ...)
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
749 (defmacro NAME ARGS DOCSTRING ...)
28401
65f19ae2c578 (scan_lisp_file): Also look for `defsubst'.
Andreas Schwab <schwab@suse.de>
parents: 26083
diff changeset
750 (defsubst NAME ARGS DOCSTRING ...)
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
751 (autoload (quote NAME) FILE DOCSTRING ...)
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
752 (defvar NAME VALUE DOCSTRING)
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
753 (defconst NAME VALUE DOCSTRING)
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
754 (fset (quote NAME) (make-byte-code ... DOCSTRING ...))
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
755 (fset (quote NAME) #[... DOCSTRING ...])
2966
e936d56c2354 (scan_lisp_file): Recognize defalias like fset.
Richard M. Stallman <rms@gnu.org>
parents: 2814
diff changeset
756 (defalias (quote NAME) #[... DOCSTRING ...])
19636
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
757 (custom-declare-variable (quote NAME) VALUE DOCSTRING ...)
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
758 starting in column zero.
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
759 (quote NAME) may appear as 'NAME as well.
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
760
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
761 We also look for #@LENGTH CONTENTS^_ at the beginning of the line.
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
762 When we find that, we save it for the following defining-form,
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
763 and we use that instead of reading a doc string within that defining-form.
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
764
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
765 For defvar, defconst, and fset we skip to the docstring with a kludgy
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
766 formatting convention: all docstrings must appear on the same line as the
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
767 initial open-paren (the one in column zero) and must contain a backslash
25536
2cfdaebe325c Fix comment about conventions for Lisp files.
Dave Love <fx@gnu.org>
parents: 25532
diff changeset
768 and a newline immediately after the initial double-quote. No newlines
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
769 must appear between the beginning of the form and the first double-quote.
25536
2cfdaebe325c Fix comment about conventions for Lisp files.
Dave Love <fx@gnu.org>
parents: 25532
diff changeset
770 For defun, defmacro, and autoload, we know how to skip over the
2cfdaebe325c Fix comment about conventions for Lisp files.
Dave Love <fx@gnu.org>
parents: 25532
diff changeset
771 arglist, but the doc string must still have a backslash and newline
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
772 immediately after the double quote.
25536
2cfdaebe325c Fix comment about conventions for Lisp files.
Dave Love <fx@gnu.org>
parents: 25532
diff changeset
773 The only source files that must follow this convention are preloaded
2cfdaebe325c Fix comment about conventions for Lisp files.
Dave Love <fx@gnu.org>
parents: 25532
diff changeset
774 uncompiled ones like loaddefs.el and bindings.el; aside
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
775 from that, it is always the .elc file that we look at, and they are no
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
776 problem because byte-compiler output follows this convention.
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
777 The NAME and DOCSTRING are output.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
778 NAME is preceded by `F' for a function or `V' for a variable.
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
779 An entry is output only if DOCSTRING has \ newline just after the opening "
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
780 */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
781
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
782 void
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
783 skip_white (infile)
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
784 FILE *infile;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
785 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
786 char c = ' ';
25532
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
787 while (c == ' ' || c == '\t' || c == '\n' || c == '\r')
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
788 c = getc (infile);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
789 ungetc (c, infile);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
790 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
791
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
792 void
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
793 read_lisp_symbol (infile, buffer)
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
794 FILE *infile;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
795 char *buffer;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
796 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
797 char c;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
798 char *fillp = buffer;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
799
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
800 skip_white (infile);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
801 while (1)
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
802 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
803 c = getc (infile);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
804 if (c == '\\')
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
805 *(++fillp) = getc (infile);
25532
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
806 else if (c == ' ' || c == '\t' || c == '\n' || c == '\r' || c == '(' || c == ')')
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
807 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
808 ungetc (c, infile);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
809 *fillp = 0;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
810 break;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
811 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
812 else
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
813 *fillp++ = c;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
814 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
815
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
816 if (! buffer[0])
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
817 fprintf (stderr, "## expected a symbol, got '%c'\n", c);
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
818
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
819 skip_white (infile);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
820 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
821
9491
dd3b83e4ceb0 Eliminate some -Wall warnings.
David J. MacKenzie <djm@gnu.org>
parents: 7564
diff changeset
822 int
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
823 scan_lisp_file (filename, mode)
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
824 char *filename, *mode;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
825 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
826 FILE *infile;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
827 register int c;
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
828 char *saved_string = 0;
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
829
5449
296db649863d [MSDOS]: Use text/binary mode as appropriate.
Richard M. Stallman <rms@gnu.org>
parents: 5317
diff changeset
830 infile = fopen (filename, mode);
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
831 if (infile == NULL)
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
832 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
833 perror (filename);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
834 return 0; /* No error */
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
835 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
836
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
837 c = '\n';
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
838 while (!feof (infile))
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
839 {
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
840 char buffer[BUFSIZ];
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
841 char type;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
842
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
843 /* If not at end of line, skip till we get to one. */
25532
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
844 if (c != '\n' && c != '\r')
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
845 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
846 c = getc (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
847 continue;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
848 }
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
849 /* Skip the line break. */
25821
9a999c51f856 (scan_lisp_file): Fix typo causing infloop.
Dave Love <fx@gnu.org>
parents: 25809
diff changeset
850 while (c == '\n' || c == '\r')
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
851 c = getc (infile);
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
852 /* Detect a dynamic doc string and save it for the next expression. */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
853 if (c == '#')
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
854 {
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
855 c = getc (infile);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
856 if (c == '@')
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
857 {
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
858 int length = 0;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
859 int i;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
860
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
861 /* Read the length. */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
862 while ((c = getc (infile),
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
863 c >= '0' && c <= '9'))
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
864 {
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
865 length *= 10;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
866 length += c - '0';
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
867 }
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
868
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
869 /* The next character is a space that is counted in the length
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
870 but not part of the doc string.
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
871 We already read it, so just ignore it. */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
872 length--;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
873
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
874 /* Read in the contents. */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
875 if (saved_string != 0)
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
876 free (saved_string);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
877 saved_string = (char *) malloc (length);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
878 for (i = 0; i < length; i++)
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
879 saved_string[i] = getc (infile);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
880 /* The last character is a ^_.
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
881 That is needed in the .elc file
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
882 but it is redundant in DOC. So get rid of it here. */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
883 saved_string[length - 1] = 0;
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
884 /* Skip the line break. */
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
885 while (c == '\n' && c == '\r')
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
886 c = getc (infile);
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
887 /* Skip the following line. */
25532
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
888 while (c != '\n' && c != '\r')
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
889 c = getc (infile);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
890 }
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
891 continue;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
892 }
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
893
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
894 if (c != '(')
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
895 continue;
164
aba3ff2b9eb4 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 162
diff changeset
896
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
897 read_lisp_symbol (infile, buffer);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
898
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
899 if (! strcmp (buffer, "defun")
28401
65f19ae2c578 (scan_lisp_file): Also look for `defsubst'.
Andreas Schwab <schwab@suse.de>
parents: 26083
diff changeset
900 || ! strcmp (buffer, "defmacro")
65f19ae2c578 (scan_lisp_file): Also look for `defsubst'.
Andreas Schwab <schwab@suse.de>
parents: 26083
diff changeset
901 || ! strcmp (buffer, "defsubst"))
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
902 {
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
903 type = 'F';
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
904 read_lisp_symbol (infile, buffer);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
905
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
906 /* Skip the arguments: either "nil" or a list in parens */
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
907
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
908 c = getc (infile);
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
909 if (c == 'n') /* nil */
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
910 {
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
911 if ((c = getc (infile)) != 'i'
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
912 || (c = getc (infile)) != 'l')
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
913 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
914 fprintf (stderr, "## unparsable arglist in %s (%s)\n",
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
915 buffer, filename);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
916 continue;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
917 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
918 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
919 else if (c != '(')
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
920 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
921 fprintf (stderr, "## unparsable arglist in %s (%s)\n",
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
922 buffer, filename);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
923 continue;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
924 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
925 else
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
926 while (c != ')')
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
927 c = getc (infile);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
928 skip_white (infile);
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
929
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
930 /* If the next three characters aren't `dquote bslash newline'
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
931 then we're not reading a docstring.
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
932 */
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
933 if ((c = getc (infile)) != '"'
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
934 || (c = getc (infile)) != '\\'
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
935 || ((c = getc (infile)) != '\n' && c != '\r'))
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
936 {
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
937 #ifdef DEBUG
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
938 fprintf (stderr, "## non-docstring in %s (%s)\n",
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
939 buffer, filename);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
940 #endif
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
941 continue;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
942 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
943 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
944
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
945 else if (! strcmp (buffer, "defvar")
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
946 || ! strcmp (buffer, "defconst"))
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
947 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
948 char c1 = 0, c2 = 0;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
949 type = 'V';
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
950 read_lisp_symbol (infile, buffer);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
951
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
952 if (saved_string == 0)
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
953 {
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
954
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
955 /* Skip until the end of line; remember two previous chars. */
25532
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
956 while (c != '\n' && c != '\r' && c >= 0)
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
957 {
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
958 c2 = c1;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
959 c1 = c;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
960 c = getc (infile);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
961 }
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
962
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
963 /* If two previous characters were " and \,
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
964 this is a doc string. Otherwise, there is none. */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
965 if (c2 != '"' || c1 != '\\')
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
966 {
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
967 #ifdef DEBUG
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
968 fprintf (stderr, "## non-docstring in %s (%s)\n",
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
969 buffer, filename);
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
970 #endif
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
971 continue;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
972 }
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
973 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
974 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
975
19636
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
976 else if (! strcmp (buffer, "custom-declare-variable"))
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
977 {
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
978 char c1 = 0, c2 = 0;
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
979 type = 'V';
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
980
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
981 c = getc (infile);
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
982 if (c == '\'')
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
983 read_lisp_symbol (infile, buffer);
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
984 else
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
985 {
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
986 if (c != '(')
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
987 {
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
988 fprintf (stderr,
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
989 "## unparsable name in custom-declare-variable in %s\n",
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
990 filename);
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
991 continue;
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
992 }
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
993 read_lisp_symbol (infile, buffer);
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
994 if (strcmp (buffer, "quote"))
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
995 {
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
996 fprintf (stderr,
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
997 "## unparsable name in custom-declare-variable in %s\n",
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
998 filename);
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
999 continue;
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1000 }
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1001 read_lisp_symbol (infile, buffer);
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1002 c = getc (infile);
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1003 if (c != ')')
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1004 {
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1005 fprintf (stderr,
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1006 "## unparsable quoted name in custom-declare-variable in %s\n",
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1007 filename);
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1008 continue;
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1009 }
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1010 }
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1011
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1012 if (saved_string == 0)
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1013 {
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
1014 /* Skip to end of line; remember the two previous chars. */
25532
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
1015 while (c != '\n' && c != '\r' && c >= 0)
19636
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1016 {
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1017 c2 = c1;
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1018 c1 = c;
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1019 c = getc (infile);
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1020 }
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
1021
19636
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1022 /* If two previous characters were " and \,
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1023 this is a doc string. Otherwise, there is none. */
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1024 if (c2 != '"' || c1 != '\\')
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1025 {
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1026 #ifdef DEBUG
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1027 fprintf (stderr, "## non-docstring in %s (%s)\n",
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1028 buffer, filename);
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1029 #endif
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1030 continue;
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1031 }
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1032 }
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1033 }
77fa90ed939d (scan_lisp_file): Handle custom-declare-variable.
Richard M. Stallman <rms@gnu.org>
parents: 14186
diff changeset
1034
2966
e936d56c2354 (scan_lisp_file): Recognize defalias like fset.
Richard M. Stallman <rms@gnu.org>
parents: 2814
diff changeset
1035 else if (! strcmp (buffer, "fset") || ! strcmp (buffer, "defalias"))
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1036 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1037 char c1 = 0, c2 = 0;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1038 type = 'F';
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1039
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1040 c = getc (infile);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1041 if (c == '\'')
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1042 read_lisp_symbol (infile, buffer);
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1043 else
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1044 {
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1045 if (c != '(')
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1046 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1047 fprintf (stderr, "## unparsable name in fset in %s\n",
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1048 filename);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1049 continue;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1050 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1051 read_lisp_symbol (infile, buffer);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1052 if (strcmp (buffer, "quote"))
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1053 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1054 fprintf (stderr, "## unparsable name in fset in %s\n",
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1055 filename);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1056 continue;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1057 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1058 read_lisp_symbol (infile, buffer);
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1059 c = getc (infile);
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1060 if (c != ')')
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1061 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1062 fprintf (stderr,
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1063 "## unparsable quoted name in fset in %s\n",
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1064 filename);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1065 continue;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1066 }
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1067 }
164
aba3ff2b9eb4 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 162
diff changeset
1068
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1069 if (saved_string == 0)
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1070 {
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
1071 /* Skip to end of line; remember the two previous chars. */
25532
9ed9cbc425fe Include config.h not ../src/config.h.
Richard M. Stallman <rms@gnu.org>
parents: 25449
diff changeset
1072 while (c != '\n' && c != '\r' && c >= 0)
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1073 {
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1074 c2 = c1;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1075 c1 = c;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1076 c = getc (infile);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1077 }
42566
6c1d733d1794 Remove unnecessary whitespaces.
Pavel Janík <Pavel@Janik.cz>
parents: 41084
diff changeset
1078
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1079 /* If two previous characters were " and \,
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1080 this is a doc string. Otherwise, there is none. */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1081 if (c2 != '"' || c1 != '\\')
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1082 {
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1083 #ifdef DEBUG
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1084 fprintf (stderr, "## non-docstring in %s (%s)\n",
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1085 buffer, filename);
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1086 #endif
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1087 continue;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1088 }
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1089 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1090 }
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1091
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1092 else if (! strcmp (buffer, "autoload"))
164
aba3ff2b9eb4 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 162
diff changeset
1093 {
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1094 type = 'F';
164
aba3ff2b9eb4 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 162
diff changeset
1095 c = getc (infile);
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1096 if (c == '\'')
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1097 read_lisp_symbol (infile, buffer);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1098 else
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1099 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1100 if (c != '(')
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1101 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1102 fprintf (stderr, "## unparsable name in autoload in %s\n",
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1103 filename);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1104 continue;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1105 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1106 read_lisp_symbol (infile, buffer);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1107 if (strcmp (buffer, "quote"))
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1108 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1109 fprintf (stderr, "## unparsable name in autoload in %s\n",
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1110 filename);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1111 continue;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1112 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1113 read_lisp_symbol (infile, buffer);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1114 c = getc (infile);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1115 if (c != ')')
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1116 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1117 fprintf (stderr,
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1118 "## unparsable quoted name in autoload in %s\n",
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1119 filename);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1120 continue;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1121 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1122 }
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1123 skip_white (infile);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1124 if ((c = getc (infile)) != '\"')
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1125 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1126 fprintf (stderr, "## autoload of %s unparsable (%s)\n",
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1127 buffer, filename);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1128 continue;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1129 }
40112
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
1130 read_c_string_or_comment (infile, 0, 0, 0);
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1131 skip_white (infile);
164
aba3ff2b9eb4 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 162
diff changeset
1132
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1133 if (saved_string == 0)
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1134 {
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1135 /* If the next three characters aren't `dquote bslash newline'
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1136 then we're not reading a docstring. */
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
1137 if ((c = getc (infile)) != '"'
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
1138 || (c = getc (infile)) != '\\'
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
1139 || ((c = getc (infile)) != '\n' && c != '\r'))
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1140 {
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1141 #ifdef DEBUG
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1142 fprintf (stderr, "## non-docstring in %s (%s)\n",
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1143 buffer, filename);
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1144 #endif
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1145 continue;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1146 }
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1147 }
164
aba3ff2b9eb4 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 162
diff changeset
1148 }
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1149
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1150 #ifdef DEBUG
25809
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
1151 else if (! strcmp (buffer, "if")
89230444d638 patched by pjr from diff by rms
Phillip Rulon <pjr@gnu.org>
parents: 25536
diff changeset
1152 || ! strcmp (buffer, "byte-code"))
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1153 ;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1154 #endif
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1155
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1156 else
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1157 {
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1158 #ifdef DEBUG
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1159 fprintf (stderr, "## unrecognised top-level form, %s (%s)\n",
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1160 buffer, filename);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1161 #endif
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1162 continue;
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1163 }
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1164
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1165 /* At this point, we should either use the previous
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1166 dynamic doc string in saved_string
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1167 or gobble a doc string from the input file.
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1168
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1169 In the latter case, the opening quote (and leading
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1170 backslash-newline) have already been read. */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1171
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1172 putc (037, outfile);
753
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1173 putc (type, outfile);
8a4c2c149ec2 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 650
diff changeset
1174 fprintf (outfile, "%s\n", buffer);
10199
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1175 if (saved_string)
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1176 {
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1177 fputs (saved_string, outfile);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1178 /* Don't use one dynamic doc string twice. */
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1179 free (saved_string);
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1180 saved_string = 0;
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1181 }
3e2571e22b61 (scan_lisp_file): Handle dynamic doc strings.
Richard M. Stallman <rms@gnu.org>
parents: 9772
diff changeset
1182 else
40112
3a1cdf305658 (read_c_string_or_comment): Add SAW_USAGE parameter, and implement
Miles Bader <miles@gnu.org>
parents: 39986
diff changeset
1183 read_c_string_or_comment (infile, 1, 0, 0);
24
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1184 }
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1185 fclose (infile);
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1186 return 0;
2354a499c504 Initial revision
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1187 }