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 INFUN (Fdocumentation_property
, 3);
46 INFUN (Fsnarf_documentation
, 1);
48 /* readchar in lread.c calls back here to fetch the next byte.
49 If UNREADFLAG is 1, we unread a byte. */
52 read_bytecode_char (int unreadflag
)
56 read_bytecode_pointer
--;
59 return *read_bytecode_pointer
++;
62 /* Extract a doc string from a file. FILEPOS says where to get it.
63 If it is an integer, use that position in the standard DOC-... file.
64 If it is (FILE . INTEGER), use FILE as the file name
65 and INTEGER as the position in that file.
66 But if INTEGER is negative, make it positive.
67 (A negative integer is used for user variables, so we can distinguish
68 them without actually fetching the doc string.)
70 If the location does not point to the beginning of a docstring
71 (e.g. because the file has been modified and the location is stale),
74 If UNIBYTE is nonzero, always make a unibyte string.
76 If DEFINITION is nonzero, assume this is for reading
77 a dynamic function definition; convert the bytestring
78 and the constants vector with appropriate byte handling,
79 and return a cons cell. */
82 get_doc_string (Lisp_Object filepos
, int unibyte
, int definition
)
87 register char *p
, *p1
;
89 EMACS_INT offset
, position
;
90 Lisp_Object file
, tem
;
92 if (INTEGERP (filepos
))
94 file
= Vdoc_file_name
;
95 position
= XINT (filepos
);
97 else if (CONSP (filepos
))
99 file
= XCAR (filepos
);
100 position
= XINT (XCDR (filepos
));
106 position
= - position
;
108 if (!STRINGP (Vdoc_directory
))
114 /* Put the file name in NAME as a C string.
115 If it is relative, combine it with Vdoc_directory. */
117 tem
= Ffile_name_absolute_p (file
);
120 minsize
= SCHARS (Vdoc_directory
);
121 /* sizeof ("../etc/") == 8 */
124 name
= (char *) alloca (minsize
+ SCHARS (file
) + 8);
125 strcpy (name
, SSDATA (Vdoc_directory
));
126 strcat (name
, SSDATA (file
));
130 name
= SSDATA (file
);
133 fd
= emacs_open (name
, O_RDONLY
, 0);
137 if (!NILP (Vpurify_flag
))
139 /* Preparing to dump; DOC file is probably not installed.
140 So check in ../etc. */
141 strcpy (name
, "../etc/");
142 strcat (name
, SSDATA (file
));
144 fd
= emacs_open (name
, O_RDONLY
, 0);
148 error ("Cannot open doc string file \"%s\"", name
);
151 /* Seek only to beginning of disk block. */
152 /* Make sure we read at least 1024 bytes before `position'
153 so we can check the leading text for consistency. */
154 offset
= min (position
, max (1024, position
% (8 * 1024)));
155 if (0 > lseek (fd
, position
- offset
, 0))
158 error ("Position %"pEd
" out of range in doc string file \"%s\"",
162 /* Read the doc string into get_doc_string_buffer.
163 P points beyond the data just read. */
165 p
= get_doc_string_buffer
;
168 EMACS_INT space_left
= (get_doc_string_buffer_size
169 - (p
- get_doc_string_buffer
));
172 /* Allocate or grow the buffer if we need to. */
175 EMACS_INT in_buffer
= p
- get_doc_string_buffer
;
176 get_doc_string_buffer_size
+= 16 * 1024;
177 get_doc_string_buffer
178 = (char *) xrealloc (get_doc_string_buffer
,
179 get_doc_string_buffer_size
+ 1);
180 p
= get_doc_string_buffer
+ in_buffer
;
181 space_left
= (get_doc_string_buffer_size
182 - (p
- get_doc_string_buffer
));
185 /* Read a disk block at a time.
186 If we read the same block last time, maybe skip this? */
187 if (space_left
> 1024 * 8)
188 space_left
= 1024 * 8;
189 nread
= emacs_read (fd
, p
, space_left
);
193 error ("Read error on documentation file");
198 if (p
== get_doc_string_buffer
)
199 p1
= strchr (p
+ offset
, '\037');
201 p1
= strchr (p
, '\037');
212 /* Sanity checking. */
216 if (get_doc_string_buffer
[offset
- test
++] != ' ')
218 while (get_doc_string_buffer
[offset
- test
] >= '0'
219 && get_doc_string_buffer
[offset
- test
] <= '9')
221 if (get_doc_string_buffer
[offset
- test
++] != '@'
222 || get_doc_string_buffer
[offset
- test
] != '#')
228 if (get_doc_string_buffer
[offset
- test
++] != '\n')
230 while (get_doc_string_buffer
[offset
- test
] > ' ')
232 if (get_doc_string_buffer
[offset
- test
] != '\037')
236 /* Scan the text and perform quoting with ^A (char code 1).
237 ^A^A becomes ^A, ^A0 becomes a null char, and ^A_ becomes a ^_. */
238 from
= get_doc_string_buffer
+ offset
;
239 to
= get_doc_string_buffer
+ offset
;
255 error ("Invalid data in documentation file -- ^A followed by code 0%o", c
);
261 /* If DEFINITION, read from this buffer
262 the same way we would read bytes from a file. */
265 read_bytecode_pointer
= (unsigned char *) get_doc_string_buffer
+ offset
;
266 return Fread (Qlambda
);
270 return make_unibyte_string (get_doc_string_buffer
+ offset
,
271 to
- (get_doc_string_buffer
+ offset
));
274 /* The data determines whether the string is multibyte. */
276 multibyte_chars_in_text (((unsigned char *) get_doc_string_buffer
278 to
- (get_doc_string_buffer
+ offset
));
279 return make_string_from_bytes (get_doc_string_buffer
+ offset
,
281 to
- (get_doc_string_buffer
+ offset
));
285 /* Get a string from position FILEPOS and pass it through the Lisp reader.
286 We use this for fetching the bytecode string and constants vector
287 of a compiled function from the .elc file. */
290 read_doc_string (Lisp_Object filepos
)
292 return get_doc_string (filepos
, 0, 1);
296 reread_doc_file (Lisp_Object file
)
299 Lisp_Object reply
, prompt
[3];
302 prompt
[0] = build_string ("File ");
303 prompt
[1] = NILP (file
) ? Vdoc_file_name
: file
;
304 prompt
[2] = build_string (" is out of sync. Reload? ");
305 reply
= Fy_or_n_p (Fconcat (3, prompt
));
312 Fsnarf_documentation (Vdoc_file_name
);
314 Fload (file
, Qt
, Qt
, Qt
, Qnil
);
319 DEFUN ("documentation", Fdocumentation
, Sdocumentation
, 1, 2, 0,
320 doc
: /* Return the documentation string of FUNCTION.
321 Unless a non-nil second argument RAW is given, the
322 string is passed through `substitute-command-keys'. */)
323 (Lisp_Object function
, Lisp_Object raw
)
334 if (SYMBOLP (function
))
336 Lisp_Object tem
= Fget (function
, Qfunction_documentation
);
338 return Fdocumentation_property (function
, Qfunction_documentation
,
342 fun
= Findirect_function (function
, Qnil
);
345 if (XSUBR (fun
)->doc
== 0)
347 else if ((EMACS_INT
) XSUBR (fun
)->doc
>= 0)
348 doc
= build_string (XSUBR (fun
)->doc
);
350 doc
= make_number ((EMACS_INT
) XSUBR (fun
)->doc
);
352 else if (COMPILEDP (fun
))
354 if ((ASIZE (fun
) & PSEUDOVECTOR_SIZE_MASK
) <= COMPILED_DOC_STRING
)
358 Lisp_Object tem
= AREF (fun
, COMPILED_DOC_STRING
);
361 else if (NATNUMP (tem
) || CONSP (tem
))
367 else if (STRINGP (fun
) || VECTORP (fun
))
369 return build_string ("Keyboard macro.");
371 else if (CONSP (fun
))
374 if (!SYMBOLP (funcar
))
375 xsignal1 (Qinvalid_function
, fun
);
376 else if (EQ (funcar
, Qkeymap
))
377 return build_string ("Prefix command (definition is a keymap associating keystrokes with commands).");
378 else if (EQ (funcar
, Qlambda
)
379 || (EQ (funcar
, Qclosure
) && (fun
= XCDR (fun
), 1))
380 || EQ (funcar
, Qautoload
))
382 Lisp_Object tem1
= Fcdr (Fcdr (fun
));
383 Lisp_Object tem
= Fcar (tem1
);
386 /* Handle a doc reference--but these never come last
387 in the function body, so reject them if they are last. */
388 else if ((NATNUMP (tem
) || (CONSP (tem
) && INTEGERP (XCDR (tem
))))
389 && !NILP (XCDR (tem1
)))
394 else if (EQ (funcar
, Qmacro
))
395 return Fdocumentation (Fcdr (fun
), raw
);
402 xsignal1 (Qinvalid_function
, fun
);
405 /* Check for an advised function. Its doc string
406 has an `ad-advice-info' text property. */
409 Lisp_Object innerfunc
;
410 innerfunc
= Fget_text_property (make_number (0),
411 intern ("ad-advice-info"),
413 if (! NILP (innerfunc
))
414 doc
= call1 (intern ("ad-make-advised-docstring"), innerfunc
);
417 /* If DOC is 0, it's typically because of a dumped file missing
418 from the DOC file (bug in src/Makefile.in). */
419 if (EQ (doc
, make_number (0)))
421 if (INTEGERP (doc
) || CONSP (doc
))
424 tem
= get_doc_string (doc
, 0, 0);
425 if (NILP (tem
) && try_reload
)
427 /* The file is newer, we need to reset the pointers. */
428 struct gcpro gcpro1
, gcpro2
;
429 GCPRO2 (function
, raw
);
430 try_reload
= reread_doc_file (Fcar_safe (doc
));
443 doc
= Fsubstitute_command_keys (doc
);
447 DEFUN ("documentation-property", Fdocumentation_property
,
448 Sdocumentation_property
, 2, 3, 0,
449 doc
: /* Return the documentation string that is SYMBOL's PROP property.
450 Third argument RAW omitted or nil means pass the result through
451 `substitute-command-keys' if it is a string.
453 This differs from `get' in that it can refer to strings stored in the
454 `etc/DOC' file; and that it evaluates documentation properties that
456 (Lisp_Object symbol
, Lisp_Object prop
, Lisp_Object raw
)
461 documentation_property
:
463 tem
= Fget (symbol
, prop
);
464 if (EQ (tem
, make_number (0)))
466 if (INTEGERP (tem
) || (CONSP (tem
) && INTEGERP (XCDR (tem
))))
468 Lisp_Object doc
= tem
;
469 tem
= get_doc_string (tem
, 0, 0);
470 if (NILP (tem
) && try_reload
)
472 /* The file is newer, we need to reset the pointers. */
473 struct gcpro gcpro1
, gcpro2
, gcpro3
;
474 GCPRO3 (symbol
, prop
, raw
);
475 try_reload
= reread_doc_file (Fcar_safe (doc
));
480 goto documentation_property
;
484 else if (!STRINGP (tem
))
485 /* Feval protects its argument. */
486 tem
= Feval (tem
, Qnil
);
488 if (NILP (raw
) && STRINGP (tem
))
489 tem
= Fsubstitute_command_keys (tem
);
493 /* Scanning the DOC files and placing docstring offsets into functions. */
496 store_function_docstring (Lisp_Object fun
, EMACS_INT offset
)
497 /* Use EMACS_INT because we get offset from pointer subtraction. */
499 fun
= indirect_function (fun
);
501 /* The type determines where the docstring is stored. */
503 /* Lisp_Subrs have a slot for it. */
505 XSUBR (fun
)->doc
= (char *) - offset
;
507 /* If it's a lisp form, stick it in the form. */
508 else if (CONSP (fun
))
513 if (EQ (tem
, Qlambda
) || EQ (tem
, Qautoload
)
514 || (EQ (tem
, Qclosure
) && (fun
= XCDR (fun
), 1)))
516 tem
= Fcdr (Fcdr (fun
));
517 if (CONSP (tem
) && INTEGERP (XCAR (tem
)))
518 XSETCAR (tem
, make_number (offset
));
520 else if (EQ (tem
, Qmacro
))
521 store_function_docstring (XCDR (fun
), offset
);
524 /* Bytecode objects sometimes have slots for it. */
525 else if (COMPILEDP (fun
))
527 /* This bytecode object must have a slot for the
528 docstring, since we've found a docstring for it. */
529 if ((ASIZE (fun
) & PSEUDOVECTOR_SIZE_MASK
) > COMPILED_DOC_STRING
)
530 ASET (fun
, COMPILED_DOC_STRING
, make_number (offset
));
534 static const char buildobj
[] = BUILDOBJ
;
536 DEFUN ("Snarf-documentation", Fsnarf_documentation
, Ssnarf_documentation
,
538 doc
: /* Used during Emacs initialization to scan the `etc/DOC...' file.
539 This searches the `etc/DOC...' file for doc strings and
540 records them in function and variable definitions.
541 The function takes one argument, FILENAME, a string;
542 it specifies the file name (without a directory) of the DOC file.
543 That file is found in `../etc' now; later, when the dumped Emacs is run,
544 the same file name is found in the `doc-directory'. */)
545 (Lisp_Object filename
)
549 register EMACS_INT filled
;
550 register EMACS_INT pos
;
556 CHECK_STRING (filename
);
560 (!NILP (Vpurify_flag
))
561 #else /* CANNOT_DUMP */
563 #endif /* CANNOT_DUMP */
565 name
= (char *) alloca (SCHARS (filename
) + 14);
566 strcpy (name
, "../etc/");
570 CHECK_STRING (Vdoc_directory
);
571 name
= (char *) alloca (SCHARS (filename
)
572 + SCHARS (Vdoc_directory
) + 1);
573 strcpy (name
, SSDATA (Vdoc_directory
));
575 strcat (name
, SSDATA (filename
)); /*** Add this line ***/
577 /* Vbuild_files is nil when temacs is run, and non-nil after that. */
578 if (NILP (Vbuild_files
))
580 const char *beg
, *end
;
582 for (beg
= buildobj
; *beg
; beg
= end
)
586 while (*beg
&& isspace (*beg
)) ++beg
;
588 for (end
= beg
; *end
&& ! isspace (*end
); ++end
)
589 if (*end
== '/') beg
= end
+1; /* skip directory part */
592 if (len
> 4 && end
[-4] == '.' && end
[-3] == 'o')
593 len
-= 2; /* Just take .o if it ends in .obj */
596 Vbuild_files
= Fcons (make_string (beg
, len
), Vbuild_files
);
598 Vbuild_files
= Fpurecopy (Vbuild_files
);
601 fd
= emacs_open (name
, O_RDONLY
, 0);
603 report_file_error ("Opening doc string file",
604 Fcons (build_string (name
), Qnil
));
605 Vdoc_file_name
= filename
;
612 filled
+= emacs_read (fd
, &buf
[filled
], sizeof buf
- 1 - filled
);
618 end
= buf
+ (filled
< 512 ? filled
: filled
- 128);
619 while (p
!= end
&& *p
!= '\037') p
++;
620 /* p points to ^_Ffunctionname\n or ^_Vvarname\n or ^_Sfilename\n. */
623 end
= strchr (p
, '\n');
625 /* See if this is a file name, and if it is a file in build-files. */
629 if (end
- p
> 4 && end
[-2] == '.'
630 && (end
[-1] == 'o' || end
[-1] == 'c'))
632 EMACS_INT len
= end
- p
- 2;
633 char *fromfile
= alloca (len
+ 1);
634 strncpy (fromfile
, &p
[2], len
);
636 if (fromfile
[len
-1] == 'c')
637 fromfile
[len
-1] = 'o';
639 skip_file
= NILP (Fmember (build_string (fromfile
),
644 sym
= oblookup (Vobarray
, p
+ 2,
645 multibyte_chars_in_text ((unsigned char *) p
+ 2,
648 /* Check skip_file so that when a function is defined several
649 times in different files (typically, once in xterm, once in
650 w32term, ...), we only pay attention to the one that
652 if (! skip_file
&& SYMBOLP (sym
))
654 /* Attach a docstring to a variable? */
657 /* Install file-position as variable-documentation property
658 and make it negative for a user-variable
659 (doc starts with a `*'). */
660 Fput (sym
, Qvariable_documentation
,
661 make_number ((pos
+ end
+ 1 - buf
)
662 * (end
[1] == '*' ? -1 : 1)));
665 /* Attach a docstring to a function? */
666 else if (p
[1] == 'F')
667 store_function_docstring (sym
, pos
+ end
+ 1 - buf
);
669 else if (p
[1] == 'S')
670 ; /* Just a source file name boundary marker. Ignore it. */
673 error ("DOC file invalid at position %"pEd
, pos
);
678 memmove (buf
, end
, filled
);
684 DEFUE ("substitute-command-keys", Fsubstitute_command_keys
,
685 Ssubstitute_command_keys
, 1, 1, 0,
686 doc
: /* Substitute key descriptions for command names in STRING.
687 Substrings of the form \\=\\[COMMAND] replaced by either: a keystroke
688 sequence that will invoke COMMAND, or "M-x COMMAND" if COMMAND is not
690 Substrings of the form \\=\\{MAPVAR} are replaced by summaries
691 \(made by `describe-bindings') of the value of MAPVAR, taken as a keymap.
692 Substrings of the form \\=\\<MAPVAR> specify to use the value of MAPVAR
693 as the keymap for future \\=\\[COMMAND] substrings.
694 \\=\\= quotes the following character and is discarded;
695 thus, \\=\\=\\=\\= puts \\=\\= into the output, and \\=\\=\\=\\[ puts \\=\\[ into the output.
697 Returns original STRING if no substitutions were made. Otherwise,
698 a new string, without any text properties, is returned. */)
703 register unsigned char *strp
;
709 unsigned char *start
;
710 EMACS_INT length
, length_byte
;
712 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
719 CHECK_STRING (string
);
723 GCPRO4 (string
, tem
, keymap
, name
);
725 multibyte
= STRING_MULTIBYTE (string
);
728 /* KEYMAP is either nil (which means search all the active keymaps)
729 or a specified local map (which means search just that and the
730 global map). If non-nil, it might come from Voverriding_local_map,
731 or from a \\<mapname> construct in STRING itself.. */
732 keymap
= KVAR (current_kboard
, Voverriding_terminal_local_map
);
734 keymap
= Voverriding_local_map
;
736 bsize
= SBYTES (string
);
737 bufp
= buf
= (char *) xmalloc (bsize
);
739 strp
= SDATA (string
);
740 while (strp
< SDATA (string
) + SBYTES (string
))
742 if (strp
[0] == '\\' && strp
[1] == '=')
744 /* \= quotes the next character;
745 thus, to put in \[ without its special meaning, use \=\[. */
752 STRING_CHAR_AND_LENGTH (strp
, len
);
756 memcpy (bufp
, strp
, len
);
762 *bufp
++ = *strp
++, nchars
++;
764 else if (strp
[0] == '\\' && strp
[1] == '[')
767 int follow_remap
= 1;
770 strp
+= 2; /* skip \[ */
772 start_idx
= start
- SDATA (string
);
774 while ((strp
- SDATA (string
)
778 length_byte
= strp
- start
;
782 /* Save STRP in IDX. */
783 idx
= strp
- SDATA (string
);
784 name
= Fintern (make_string ((char *) start
, length_byte
), Qnil
);
787 tem
= Fwhere_is_internal (name
, keymap
, Qt
, Qnil
, Qnil
);
789 if (VECTORP (tem
) && XVECTOR (tem
)->size
> 1
790 && EQ (AREF (tem
, 0), Qremap
) && SYMBOLP (AREF (tem
, 1))
793 name
= AREF (tem
, 1);
798 /* Note the Fwhere_is_internal can GC, so we have to take
799 relocation of string contents into account. */
800 strp
= SDATA (string
) + idx
;
801 start
= SDATA (string
) + start_idx
;
803 if (NILP (tem
)) /* but not on any keys */
805 EMACS_INT offset
= bufp
- buf
;
806 buf
= (char *) xrealloc (buf
, bsize
+= 4);
808 memcpy (bufp
, "M-x ", 4);
812 length
= multibyte_chars_in_text (start
, length_byte
);
814 length
= length_byte
;
818 { /* function is on a key */
819 tem
= Fkey_description (tem
, Qnil
);
823 /* \{foo} is replaced with a summary of the keymap (symbol-value foo).
824 \<foo> just sets the keymap used for \[cmd]. */
825 else if (strp
[0] == '\\' && (strp
[1] == '{' || strp
[1] == '<'))
827 struct buffer
*oldbuf
;
829 /* This is for computing the SHADOWS arg for describe_map_tree. */
830 Lisp_Object active_maps
= Fcurrent_active_maps (Qnil
, Qnil
);
831 Lisp_Object earlier_maps
;
834 strp
+= 2; /* skip \{ or \< */
836 start_idx
= start
- SDATA (string
);
838 while ((strp
- SDATA (string
) < SBYTES (string
))
839 && *strp
!= '}' && *strp
!= '>')
842 length_byte
= strp
- start
;
843 strp
++; /* skip } or > */
845 /* Save STRP in IDX. */
846 idx
= strp
- SDATA (string
);
848 /* Get the value of the keymap in TEM, or nil if undefined.
849 Do this while still in the user's current buffer
850 in case it is a local variable. */
851 name
= Fintern (make_string ((char *) start
, length_byte
), Qnil
);
852 tem
= Fboundp (name
);
855 tem
= Fsymbol_value (name
);
858 tem
= get_keymap (tem
, 0, 1);
859 /* Note that get_keymap can GC. */
860 strp
= SDATA (string
) + idx
;
861 start
= SDATA (string
) + start_idx
;
865 /* Now switch to a temp buffer. */
866 oldbuf
= current_buffer
;
867 set_buffer_internal (XBUFFER (Vprin1_to_string_buffer
));
871 name
= Fsymbol_name (name
);
872 insert_string ("\nUses keymap \"");
873 insert_from_string (name
, 0, 0,
876 insert_string ("\", which is not currently defined.\n");
877 if (start
[-1] == '<') keymap
= Qnil
;
879 else if (start
[-1] == '<')
883 /* Get the list of active keymaps that precede this one.
884 If this one's not active, get nil. */
885 earlier_maps
= Fcdr (Fmemq (tem
, Freverse (active_maps
)));
886 describe_map_tree (tem
, 1, Fnreverse (earlier_maps
),
887 Qnil
, (char *)0, 1, 0, 0, 1);
889 tem
= Fbuffer_string ();
891 set_buffer_internal (oldbuf
);
895 length
= SCHARS (tem
);
896 length_byte
= SBYTES (tem
);
899 EMACS_INT offset
= bufp
- buf
;
900 buf
= (char *) xrealloc (buf
, bsize
+= length_byte
);
902 memcpy (bufp
, start
, length_byte
);
905 /* Check STRING again in case gc relocated it. */
906 strp
= SDATA (string
) + idx
;
909 else if (! multibyte
) /* just copy other chars */
910 *bufp
++ = *strp
++, nchars
++;
915 STRING_CHAR_AND_LENGTH (strp
, len
);
919 memcpy (bufp
, strp
, len
);
926 if (changed
) /* don't bother if nothing substituted */
927 tem
= make_string_from_bytes (buf
, nchars
, bufp
- buf
);
931 RETURN_UNGCPRO (tem
);
937 Qfunction_documentation
= intern_c_string ("function-documentation");
938 staticpro (&Qfunction_documentation
);
940 DEFVAR_LISP ("internal-doc-file-name", Vdoc_file_name
,
941 doc
: /* Name of file containing documentation strings of built-in symbols. */);
942 Vdoc_file_name
= Qnil
;
944 DEFVAR_LISP ("build-files", Vbuild_files
,
945 doc
: /* A list of files used to build this Emacs binary. */);
948 defsubr (&Sdocumentation
);
949 defsubr (&Sdocumentation_property
);
950 defsubr (&Ssnarf_documentation
);
951 defsubr (&Ssubstitute_command_keys
);