1 /* Record indices of function doc strings stored in a file.
2 Copyright (C) 1985-1986, 1993-1995, 1997-2011
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
23 #include <sys/types.h>
24 #include <sys/file.h> /* Must be after sys/types.h for USG*/
33 #include "character.h"
37 Lisp_Object Qfunction_documentation
;
39 extern Lisp_Object Qclosure
;
40 /* Buffer used for reading from documentation file. */
41 static char *get_doc_string_buffer
;
42 static int get_doc_string_buffer_size
;
44 static unsigned char *read_bytecode_pointer
;
45 static Lisp_Object
Fdocumentation_property (Lisp_Object
, Lisp_Object
,
47 static Lisp_Object
Fsnarf_documentation (Lisp_Object
);
49 /* readchar in lread.c calls back here to fetch the next byte.
50 If UNREADFLAG is 1, we unread a byte. */
53 read_bytecode_char (int unreadflag
)
57 read_bytecode_pointer
--;
60 return *read_bytecode_pointer
++;
63 /* Extract a doc string from a file. FILEPOS says where to get it.
64 If it is an integer, use that position in the standard DOC-... file.
65 If it is (FILE . INTEGER), use FILE as the file name
66 and INTEGER as the position in that file.
67 But if INTEGER is negative, make it positive.
68 (A negative integer is used for user variables, so we can distinguish
69 them without actually fetching the doc string.)
71 If the location does not point to the beginning of a docstring
72 (e.g. because the file has been modified and the location is stale),
75 If UNIBYTE is nonzero, always make a unibyte string.
77 If DEFINITION is nonzero, assume this is for reading
78 a dynamic function definition; convert the bytestring
79 and the constants vector with appropriate byte handling,
80 and return a cons cell. */
83 get_doc_string (Lisp_Object filepos
, int unibyte
, int definition
)
88 register char *p
, *p1
;
90 EMACS_INT offset
, position
;
91 Lisp_Object file
, tem
;
93 if (INTEGERP (filepos
))
95 file
= Vdoc_file_name
;
96 position
= XINT (filepos
);
98 else if (CONSP (filepos
))
100 file
= XCAR (filepos
);
101 position
= XINT (XCDR (filepos
));
107 position
= - position
;
109 if (!STRINGP (Vdoc_directory
))
115 /* Put the file name in NAME as a C string.
116 If it is relative, combine it with Vdoc_directory. */
118 tem
= Ffile_name_absolute_p (file
);
121 minsize
= SCHARS (Vdoc_directory
);
122 /* sizeof ("../etc/") == 8 */
125 name
= (char *) alloca (minsize
+ SCHARS (file
) + 8);
126 strcpy (name
, SSDATA (Vdoc_directory
));
127 strcat (name
, SSDATA (file
));
131 name
= SSDATA (file
);
134 fd
= emacs_open (name
, O_RDONLY
, 0);
138 if (!NILP (Vpurify_flag
))
140 /* Preparing to dump; DOC file is probably not installed.
141 So check in ../etc. */
142 strcpy (name
, "../etc/");
143 strcat (name
, SSDATA (file
));
145 fd
= emacs_open (name
, O_RDONLY
, 0);
149 error ("Cannot open doc string file \"%s\"", name
);
152 /* Seek only to beginning of disk block. */
153 /* Make sure we read at least 1024 bytes before `position'
154 so we can check the leading text for consistency. */
155 offset
= min (position
, max (1024, position
% (8 * 1024)));
156 if (0 > lseek (fd
, position
- offset
, 0))
159 error ("Position %"pEd
" out of range in doc string file \"%s\"",
163 /* Read the doc string into get_doc_string_buffer.
164 P points beyond the data just read. */
166 p
= get_doc_string_buffer
;
169 EMACS_INT space_left
= (get_doc_string_buffer_size
170 - (p
- get_doc_string_buffer
));
173 /* Allocate or grow the buffer if we need to. */
176 EMACS_INT in_buffer
= p
- get_doc_string_buffer
;
177 get_doc_string_buffer_size
+= 16 * 1024;
178 get_doc_string_buffer
179 = (char *) xrealloc (get_doc_string_buffer
,
180 get_doc_string_buffer_size
+ 1);
181 p
= get_doc_string_buffer
+ in_buffer
;
182 space_left
= (get_doc_string_buffer_size
183 - (p
- get_doc_string_buffer
));
186 /* Read a disk block at a time.
187 If we read the same block last time, maybe skip this? */
188 if (space_left
> 1024 * 8)
189 space_left
= 1024 * 8;
190 nread
= emacs_read (fd
, p
, space_left
);
194 error ("Read error on documentation file");
199 if (p
== get_doc_string_buffer
)
200 p1
= strchr (p
+ offset
, '\037');
202 p1
= strchr (p
, '\037');
213 /* Sanity checking. */
217 if (get_doc_string_buffer
[offset
- test
++] != ' ')
219 while (get_doc_string_buffer
[offset
- test
] >= '0'
220 && get_doc_string_buffer
[offset
- test
] <= '9')
222 if (get_doc_string_buffer
[offset
- test
++] != '@'
223 || get_doc_string_buffer
[offset
- test
] != '#')
229 if (get_doc_string_buffer
[offset
- test
++] != '\n')
231 while (get_doc_string_buffer
[offset
- test
] > ' ')
233 if (get_doc_string_buffer
[offset
- test
] != '\037')
237 /* Scan the text and perform quoting with ^A (char code 1).
238 ^A^A becomes ^A, ^A0 becomes a null char, and ^A_ becomes a ^_. */
239 from
= get_doc_string_buffer
+ offset
;
240 to
= get_doc_string_buffer
+ offset
;
257 Invalid data in documentation file -- %c followed by code %03o",
264 /* If DEFINITION, read from this buffer
265 the same way we would read bytes from a file. */
268 read_bytecode_pointer
= (unsigned char *) get_doc_string_buffer
+ offset
;
269 return Fread (Qlambda
);
273 return make_unibyte_string (get_doc_string_buffer
+ offset
,
274 to
- (get_doc_string_buffer
+ offset
));
277 /* The data determines whether the string is multibyte. */
279 multibyte_chars_in_text (((unsigned char *) get_doc_string_buffer
281 to
- (get_doc_string_buffer
+ offset
));
282 return make_string_from_bytes (get_doc_string_buffer
+ offset
,
284 to
- (get_doc_string_buffer
+ offset
));
288 /* Get a string from position FILEPOS and pass it through the Lisp reader.
289 We use this for fetching the bytecode string and constants vector
290 of a compiled function from the .elc file. */
293 read_doc_string (Lisp_Object filepos
)
295 return get_doc_string (filepos
, 0, 1);
299 reread_doc_file (Lisp_Object file
)
302 Lisp_Object reply
, prompt
[3];
305 prompt
[0] = build_string ("File ");
306 prompt
[1] = NILP (file
) ? Vdoc_file_name
: file
;
307 prompt
[2] = build_string (" is out of sync. Reload? ");
308 reply
= Fy_or_n_p (Fconcat (3, prompt
));
315 Fsnarf_documentation (Vdoc_file_name
);
317 Fload (file
, Qt
, Qt
, Qt
, Qnil
);
322 DEFUN ("documentation", Fdocumentation
, Sdocumentation
, 1, 2, 0,
323 doc
: /* Return the documentation string of FUNCTION.
324 Unless a non-nil second argument RAW is given, the
325 string is passed through `substitute-command-keys'. */)
326 (Lisp_Object function
, Lisp_Object raw
)
337 if (SYMBOLP (function
))
339 Lisp_Object tem
= Fget (function
, Qfunction_documentation
);
341 return Fdocumentation_property (function
, Qfunction_documentation
,
345 fun
= Findirect_function (function
, Qnil
);
348 if (XSUBR (fun
)->doc
== 0)
350 else if ((EMACS_INT
) XSUBR (fun
)->doc
>= 0)
351 doc
= build_string (XSUBR (fun
)->doc
);
353 doc
= make_number ((EMACS_INT
) XSUBR (fun
)->doc
);
355 else if (COMPILEDP (fun
))
357 if ((ASIZE (fun
) & PSEUDOVECTOR_SIZE_MASK
) <= COMPILED_DOC_STRING
)
361 Lisp_Object tem
= AREF (fun
, COMPILED_DOC_STRING
);
364 else if (NATNUMP (tem
) || CONSP (tem
))
370 else if (STRINGP (fun
) || VECTORP (fun
))
372 return build_string ("Keyboard macro.");
374 else if (CONSP (fun
))
377 if (!SYMBOLP (funcar
))
378 xsignal1 (Qinvalid_function
, fun
);
379 else if (EQ (funcar
, Qkeymap
))
380 return build_string ("Prefix command (definition is a keymap associating keystrokes with commands).");
381 else if (EQ (funcar
, Qlambda
)
382 || (EQ (funcar
, Qclosure
) && (fun
= XCDR (fun
), 1))
383 || EQ (funcar
, Qautoload
))
385 Lisp_Object tem1
= Fcdr (Fcdr (fun
));
386 Lisp_Object tem
= Fcar (tem1
);
389 /* Handle a doc reference--but these never come last
390 in the function body, so reject them if they are last. */
391 else if ((NATNUMP (tem
) || (CONSP (tem
) && INTEGERP (XCDR (tem
))))
392 && !NILP (XCDR (tem1
)))
397 else if (EQ (funcar
, Qmacro
))
398 return Fdocumentation (Fcdr (fun
), raw
);
405 xsignal1 (Qinvalid_function
, fun
);
408 /* Check for an advised function. Its doc string
409 has an `ad-advice-info' text property. */
412 Lisp_Object innerfunc
;
413 innerfunc
= Fget_text_property (make_number (0),
414 intern ("ad-advice-info"),
416 if (! NILP (innerfunc
))
417 doc
= call1 (intern ("ad-make-advised-docstring"), innerfunc
);
420 /* If DOC is 0, it's typically because of a dumped file missing
421 from the DOC file (bug in src/Makefile.in). */
422 if (EQ (doc
, make_number (0)))
424 if (INTEGERP (doc
) || CONSP (doc
))
427 tem
= get_doc_string (doc
, 0, 0);
428 if (NILP (tem
) && try_reload
)
430 /* The file is newer, we need to reset the pointers. */
431 struct gcpro gcpro1
, gcpro2
;
432 GCPRO2 (function
, raw
);
433 try_reload
= reread_doc_file (Fcar_safe (doc
));
446 doc
= Fsubstitute_command_keys (doc
);
450 DEFUN ("documentation-property", Fdocumentation_property
,
451 Sdocumentation_property
, 2, 3, 0,
452 doc
: /* Return the documentation string that is SYMBOL's PROP property.
453 Third argument RAW omitted or nil means pass the result through
454 `substitute-command-keys' if it is a string.
456 This differs from `get' in that it can refer to strings stored in the
457 `etc/DOC' file; and that it evaluates documentation properties that
459 (Lisp_Object symbol
, Lisp_Object prop
, Lisp_Object raw
)
464 documentation_property
:
466 tem
= Fget (symbol
, prop
);
467 if (EQ (tem
, make_number (0)))
469 if (INTEGERP (tem
) || (CONSP (tem
) && INTEGERP (XCDR (tem
))))
471 Lisp_Object doc
= tem
;
472 tem
= get_doc_string (tem
, 0, 0);
473 if (NILP (tem
) && try_reload
)
475 /* The file is newer, we need to reset the pointers. */
476 struct gcpro gcpro1
, gcpro2
, gcpro3
;
477 GCPRO3 (symbol
, prop
, raw
);
478 try_reload
= reread_doc_file (Fcar_safe (doc
));
483 goto documentation_property
;
487 else if (!STRINGP (tem
))
488 /* Feval protects its argument. */
489 tem
= Feval (tem
, Qnil
);
491 if (NILP (raw
) && STRINGP (tem
))
492 tem
= Fsubstitute_command_keys (tem
);
496 /* Scanning the DOC files and placing docstring offsets into functions. */
499 store_function_docstring (Lisp_Object fun
, EMACS_INT offset
)
500 /* Use EMACS_INT because we get offset from pointer subtraction. */
502 fun
= indirect_function (fun
);
504 /* The type determines where the docstring is stored. */
506 /* Lisp_Subrs have a slot for it. */
508 XSUBR (fun
)->doc
= (char *) - offset
;
510 /* If it's a lisp form, stick it in the form. */
511 else if (CONSP (fun
))
516 if (EQ (tem
, Qlambda
) || EQ (tem
, Qautoload
)
517 || (EQ (tem
, Qclosure
) && (fun
= XCDR (fun
), 1)))
519 tem
= Fcdr (Fcdr (fun
));
520 if (CONSP (tem
) && INTEGERP (XCAR (tem
)))
521 XSETCAR (tem
, make_number (offset
));
523 else if (EQ (tem
, Qmacro
))
524 store_function_docstring (XCDR (fun
), offset
);
527 /* Bytecode objects sometimes have slots for it. */
528 else if (COMPILEDP (fun
))
530 /* This bytecode object must have a slot for the
531 docstring, since we've found a docstring for it. */
532 if ((ASIZE (fun
) & PSEUDOVECTOR_SIZE_MASK
) > COMPILED_DOC_STRING
)
533 ASET (fun
, COMPILED_DOC_STRING
, make_number (offset
));
537 static const char buildobj
[] = BUILDOBJ
;
539 DEFUN ("Snarf-documentation", Fsnarf_documentation
, Ssnarf_documentation
,
541 doc
: /* Used during Emacs initialization to scan the `etc/DOC...' file.
542 This searches the `etc/DOC...' file for doc strings and
543 records them in function and variable definitions.
544 The function takes one argument, FILENAME, a string;
545 it specifies the file name (without a directory) of the DOC file.
546 That file is found in `../etc' now; later, when the dumped Emacs is run,
547 the same file name is found in the `doc-directory'. */)
548 (Lisp_Object filename
)
552 register EMACS_INT filled
;
553 register EMACS_INT pos
;
559 CHECK_STRING (filename
);
563 (!NILP (Vpurify_flag
))
564 #else /* CANNOT_DUMP */
566 #endif /* CANNOT_DUMP */
568 name
= (char *) alloca (SCHARS (filename
) + 14);
569 strcpy (name
, "../etc/");
573 CHECK_STRING (Vdoc_directory
);
574 name
= (char *) alloca (SCHARS (filename
)
575 + SCHARS (Vdoc_directory
) + 1);
576 strcpy (name
, SSDATA (Vdoc_directory
));
578 strcat (name
, SSDATA (filename
)); /*** Add this line ***/
580 /* Vbuild_files is nil when temacs is run, and non-nil after that. */
581 if (NILP (Vbuild_files
))
583 const char *beg
, *end
;
585 for (beg
= buildobj
; *beg
; beg
= end
)
589 while (*beg
&& isspace (*beg
)) ++beg
;
591 for (end
= beg
; *end
&& ! isspace (*end
); ++end
)
592 if (*end
== '/') beg
= end
+1; /* skip directory part */
595 if (len
> 4 && end
[-4] == '.' && end
[-3] == 'o')
596 len
-= 2; /* Just take .o if it ends in .obj */
599 Vbuild_files
= Fcons (make_string (beg
, len
), Vbuild_files
);
601 Vbuild_files
= Fpurecopy (Vbuild_files
);
604 fd
= emacs_open (name
, O_RDONLY
, 0);
606 report_file_error ("Opening doc string file",
607 Fcons (build_string (name
), Qnil
));
608 Vdoc_file_name
= filename
;
615 filled
+= emacs_read (fd
, &buf
[filled
], sizeof buf
- 1 - filled
);
621 end
= buf
+ (filled
< 512 ? filled
: filled
- 128);
622 while (p
!= end
&& *p
!= '\037') p
++;
623 /* p points to ^_Ffunctionname\n or ^_Vvarname\n or ^_Sfilename\n. */
626 end
= strchr (p
, '\n');
628 /* See if this is a file name, and if it is a file in build-files. */
632 if (end
- p
> 4 && end
[-2] == '.'
633 && (end
[-1] == 'o' || end
[-1] == 'c'))
635 EMACS_INT len
= end
- p
- 2;
636 char *fromfile
= alloca (len
+ 1);
637 strncpy (fromfile
, &p
[2], len
);
639 if (fromfile
[len
-1] == 'c')
640 fromfile
[len
-1] = 'o';
642 skip_file
= NILP (Fmember (build_string (fromfile
),
647 sym
= oblookup (Vobarray
, p
+ 2,
648 multibyte_chars_in_text ((unsigned char *) p
+ 2,
651 /* Check skip_file so that when a function is defined several
652 times in different files (typically, once in xterm, once in
653 w32term, ...), we only pay attention to the one that
655 if (! skip_file
&& SYMBOLP (sym
))
657 /* Attach a docstring to a variable? */
660 /* Install file-position as variable-documentation property
661 and make it negative for a user-variable
662 (doc starts with a `*'). */
663 Fput (sym
, Qvariable_documentation
,
664 make_number ((pos
+ end
+ 1 - buf
)
665 * (end
[1] == '*' ? -1 : 1)));
668 /* Attach a docstring to a function? */
669 else if (p
[1] == 'F')
670 store_function_docstring (sym
, pos
+ end
+ 1 - buf
);
672 else if (p
[1] == 'S')
673 ; /* Just a source file name boundary marker. Ignore it. */
676 error ("DOC file invalid at position %"pEd
, pos
);
681 memmove (buf
, end
, filled
);
687 DEFUN ("substitute-command-keys", Fsubstitute_command_keys
,
688 Ssubstitute_command_keys
, 1, 1, 0,
689 doc
: /* Substitute key descriptions for command names in STRING.
690 Substrings of the form \\=\\[COMMAND] replaced by either: a keystroke
691 sequence that will invoke COMMAND, or "M-x COMMAND" if COMMAND is not
693 Substrings of the form \\=\\{MAPVAR} are replaced by summaries
694 \(made by `describe-bindings') of the value of MAPVAR, taken as a keymap.
695 Substrings of the form \\=\\<MAPVAR> specify to use the value of MAPVAR
696 as the keymap for future \\=\\[COMMAND] substrings.
697 \\=\\= quotes the following character and is discarded;
698 thus, \\=\\=\\=\\= puts \\=\\= into the output, and \\=\\=\\=\\[ puts \\=\\[ into the output.
700 Returns original STRING if no substitutions were made. Otherwise,
701 a new string, without any text properties, is returned. */)
706 register unsigned char *strp
;
712 unsigned char *start
;
713 EMACS_INT length
, length_byte
;
715 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
722 CHECK_STRING (string
);
726 GCPRO4 (string
, tem
, keymap
, name
);
728 multibyte
= STRING_MULTIBYTE (string
);
731 /* KEYMAP is either nil (which means search all the active keymaps)
732 or a specified local map (which means search just that and the
733 global map). If non-nil, it might come from Voverriding_local_map,
734 or from a \\<mapname> construct in STRING itself.. */
735 keymap
= KVAR (current_kboard
, Voverriding_terminal_local_map
);
737 keymap
= Voverriding_local_map
;
739 bsize
= SBYTES (string
);
740 bufp
= buf
= (char *) xmalloc (bsize
);
742 strp
= SDATA (string
);
743 while (strp
< SDATA (string
) + SBYTES (string
))
745 if (strp
[0] == '\\' && strp
[1] == '=')
747 /* \= quotes the next character;
748 thus, to put in \[ without its special meaning, use \=\[. */
755 STRING_CHAR_AND_LENGTH (strp
, len
);
759 memcpy (bufp
, strp
, len
);
765 *bufp
++ = *strp
++, nchars
++;
767 else if (strp
[0] == '\\' && strp
[1] == '[')
770 int follow_remap
= 1;
773 strp
+= 2; /* skip \[ */
775 start_idx
= start
- SDATA (string
);
777 while ((strp
- SDATA (string
)
781 length_byte
= strp
- start
;
785 /* Save STRP in IDX. */
786 idx
= strp
- SDATA (string
);
787 name
= Fintern (make_string ((char *) start
, length_byte
), Qnil
);
790 tem
= Fwhere_is_internal (name
, keymap
, Qt
, Qnil
, Qnil
);
792 if (VECTORP (tem
) && XVECTOR (tem
)->size
> 1
793 && EQ (AREF (tem
, 0), Qremap
) && SYMBOLP (AREF (tem
, 1))
796 name
= AREF (tem
, 1);
801 /* Note the Fwhere_is_internal can GC, so we have to take
802 relocation of string contents into account. */
803 strp
= SDATA (string
) + idx
;
804 start
= SDATA (string
) + start_idx
;
806 if (NILP (tem
)) /* but not on any keys */
808 EMACS_INT offset
= bufp
- buf
;
809 buf
= (char *) xrealloc (buf
, bsize
+= 4);
811 memcpy (bufp
, "M-x ", 4);
815 length
= multibyte_chars_in_text (start
, length_byte
);
817 length
= length_byte
;
821 { /* function is on a key */
822 tem
= Fkey_description (tem
, Qnil
);
826 /* \{foo} is replaced with a summary of the keymap (symbol-value foo).
827 \<foo> just sets the keymap used for \[cmd]. */
828 else if (strp
[0] == '\\' && (strp
[1] == '{' || strp
[1] == '<'))
830 struct buffer
*oldbuf
;
832 /* This is for computing the SHADOWS arg for describe_map_tree. */
833 Lisp_Object active_maps
= Fcurrent_active_maps (Qnil
, Qnil
);
834 Lisp_Object earlier_maps
;
837 strp
+= 2; /* skip \{ or \< */
839 start_idx
= start
- SDATA (string
);
841 while ((strp
- SDATA (string
) < SBYTES (string
))
842 && *strp
!= '}' && *strp
!= '>')
845 length_byte
= strp
- start
;
846 strp
++; /* skip } or > */
848 /* Save STRP in IDX. */
849 idx
= strp
- SDATA (string
);
851 /* Get the value of the keymap in TEM, or nil if undefined.
852 Do this while still in the user's current buffer
853 in case it is a local variable. */
854 name
= Fintern (make_string ((char *) start
, length_byte
), Qnil
);
855 tem
= Fboundp (name
);
858 tem
= Fsymbol_value (name
);
861 tem
= get_keymap (tem
, 0, 1);
862 /* Note that get_keymap can GC. */
863 strp
= SDATA (string
) + idx
;
864 start
= SDATA (string
) + start_idx
;
868 /* Now switch to a temp buffer. */
869 oldbuf
= current_buffer
;
870 set_buffer_internal (XBUFFER (Vprin1_to_string_buffer
));
874 name
= Fsymbol_name (name
);
875 insert_string ("\nUses keymap \"");
876 insert_from_string (name
, 0, 0,
879 insert_string ("\", which is not currently defined.\n");
880 if (start
[-1] == '<') keymap
= Qnil
;
882 else if (start
[-1] == '<')
886 /* Get the list of active keymaps that precede this one.
887 If this one's not active, get nil. */
888 earlier_maps
= Fcdr (Fmemq (tem
, Freverse (active_maps
)));
889 describe_map_tree (tem
, 1, Fnreverse (earlier_maps
),
890 Qnil
, (char *)0, 1, 0, 0, 1);
892 tem
= Fbuffer_string ();
894 set_buffer_internal (oldbuf
);
898 length
= SCHARS (tem
);
899 length_byte
= SBYTES (tem
);
902 EMACS_INT offset
= bufp
- buf
;
903 buf
= (char *) xrealloc (buf
, bsize
+= length_byte
);
905 memcpy (bufp
, start
, length_byte
);
908 /* Check STRING again in case gc relocated it. */
909 strp
= SDATA (string
) + idx
;
912 else if (! multibyte
) /* just copy other chars */
913 *bufp
++ = *strp
++, nchars
++;
918 STRING_CHAR_AND_LENGTH (strp
, len
);
922 memcpy (bufp
, strp
, len
);
929 if (changed
) /* don't bother if nothing substituted */
930 tem
= make_string_from_bytes (buf
, nchars
, bufp
- buf
);
934 RETURN_UNGCPRO (tem
);
940 Qfunction_documentation
= intern_c_string ("function-documentation");
941 staticpro (&Qfunction_documentation
);
943 DEFVAR_LISP ("internal-doc-file-name", Vdoc_file_name
,
944 doc
: /* Name of file containing documentation strings of built-in symbols. */);
945 Vdoc_file_name
= Qnil
;
947 DEFVAR_LISP ("build-files", Vbuild_files
,
948 doc
: /* A list of files used to build this Emacs binary. */);
951 defsubr (&Sdocumentation
);
952 defsubr (&Sdocumentation_property
);
953 defsubr (&Ssnarf_documentation
);
954 defsubr (&Ssubstitute_command_keys
);