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 Lisp_Object
Fsnarf_documentation (Lisp_Object
);
47 /* readchar in lread.c calls back here to fetch the next byte.
48 If UNREADFLAG is 1, we unread a byte. */
51 read_bytecode_char (int unreadflag
)
55 read_bytecode_pointer
--;
58 return *read_bytecode_pointer
++;
61 /* Extract a doc string from a file. FILEPOS says where to get it.
62 If it is an integer, use that position in the standard DOC-... file.
63 If it is (FILE . INTEGER), use FILE as the file name
64 and INTEGER as the position in that file.
65 But if INTEGER is negative, make it positive.
66 (A negative integer is used for user variables, so we can distinguish
67 them without actually fetching the doc string.)
69 If the location does not point to the beginning of a docstring
70 (e.g. because the file has been modified and the location is stale),
73 If UNIBYTE is nonzero, always make a unibyte string.
75 If DEFINITION is nonzero, assume this is for reading
76 a dynamic function definition; convert the bytestring
77 and the constants vector with appropriate byte handling,
78 and return a cons cell. */
81 get_doc_string (Lisp_Object filepos
, int unibyte
, int definition
)
86 register char *p
, *p1
;
88 EMACS_INT offset
, position
;
89 Lisp_Object file
, tem
;
91 if (INTEGERP (filepos
))
93 file
= Vdoc_file_name
;
94 position
= XINT (filepos
);
96 else if (CONSP (filepos
))
98 file
= XCAR (filepos
);
99 position
= XINT (XCDR (filepos
));
105 position
= - position
;
107 if (!STRINGP (Vdoc_directory
))
113 /* Put the file name in NAME as a C string.
114 If it is relative, combine it with Vdoc_directory. */
116 tem
= Ffile_name_absolute_p (file
);
119 minsize
= SCHARS (Vdoc_directory
);
120 /* sizeof ("../etc/") == 8 */
123 name
= (char *) alloca (minsize
+ SCHARS (file
) + 8);
124 strcpy (name
, SSDATA (Vdoc_directory
));
125 strcat (name
, SSDATA (file
));
129 name
= SSDATA (file
);
132 fd
= emacs_open (name
, O_RDONLY
, 0);
136 if (!NILP (Vpurify_flag
))
138 /* Preparing to dump; DOC file is probably not installed.
139 So check in ../etc. */
140 strcpy (name
, "../etc/");
141 strcat (name
, SSDATA (file
));
143 fd
= emacs_open (name
, O_RDONLY
, 0);
147 error ("Cannot open doc string file \"%s\"", name
);
150 /* Seek only to beginning of disk block. */
151 /* Make sure we read at least 1024 bytes before `position'
152 so we can check the leading text for consistency. */
153 offset
= min (position
, max (1024, position
% (8 * 1024)));
154 if (0 > lseek (fd
, position
- offset
, 0))
157 error ("Position %ld out of range in doc string file \"%s\"",
161 /* Read the doc string into get_doc_string_buffer.
162 P points beyond the data just read. */
164 p
= get_doc_string_buffer
;
167 EMACS_INT space_left
= (get_doc_string_buffer_size
168 - (p
- get_doc_string_buffer
));
171 /* Allocate or grow the buffer if we need to. */
174 EMACS_INT in_buffer
= p
- get_doc_string_buffer
;
175 get_doc_string_buffer_size
+= 16 * 1024;
176 get_doc_string_buffer
177 = (char *) xrealloc (get_doc_string_buffer
,
178 get_doc_string_buffer_size
+ 1);
179 p
= get_doc_string_buffer
+ in_buffer
;
180 space_left
= (get_doc_string_buffer_size
181 - (p
- get_doc_string_buffer
));
184 /* Read a disk block at a time.
185 If we read the same block last time, maybe skip this? */
186 if (space_left
> 1024 * 8)
187 space_left
= 1024 * 8;
188 nread
= emacs_read (fd
, p
, space_left
);
192 error ("Read error on documentation file");
197 if (p
== get_doc_string_buffer
)
198 p1
= strchr (p
+ offset
, '\037');
200 p1
= strchr (p
, '\037');
211 /* Sanity checking. */
215 if (get_doc_string_buffer
[offset
- test
++] != ' ')
217 while (get_doc_string_buffer
[offset
- test
] >= '0'
218 && get_doc_string_buffer
[offset
- test
] <= '9')
220 if (get_doc_string_buffer
[offset
- test
++] != '@'
221 || get_doc_string_buffer
[offset
- test
] != '#')
227 if (get_doc_string_buffer
[offset
- test
++] != '\n')
229 while (get_doc_string_buffer
[offset
- test
] > ' ')
231 if (get_doc_string_buffer
[offset
- test
] != '\037')
235 /* Scan the text and perform quoting with ^A (char code 1).
236 ^A^A becomes ^A, ^A0 becomes a null char, and ^A_ becomes a ^_. */
237 from
= get_doc_string_buffer
+ offset
;
238 to
= get_doc_string_buffer
+ offset
;
254 error ("Invalid data in documentation file -- ^A followed by code 0%o", c
);
260 /* If DEFINITION, read from this buffer
261 the same way we would read bytes from a file. */
264 read_bytecode_pointer
= (unsigned char *) get_doc_string_buffer
+ offset
;
265 return Fread (Qlambda
);
269 return make_unibyte_string (get_doc_string_buffer
+ offset
,
270 to
- (get_doc_string_buffer
+ offset
));
273 /* The data determines whether the string is multibyte. */
275 multibyte_chars_in_text (((unsigned char *) get_doc_string_buffer
277 to
- (get_doc_string_buffer
+ offset
));
278 return make_string_from_bytes (get_doc_string_buffer
+ offset
,
280 to
- (get_doc_string_buffer
+ offset
));
284 /* Get a string from position FILEPOS and pass it through the Lisp reader.
285 We use this for fetching the bytecode string and constants vector
286 of a compiled function from the .elc file. */
289 read_doc_string (Lisp_Object filepos
)
291 return get_doc_string (filepos
, 0, 1);
295 reread_doc_file (Lisp_Object file
)
298 Lisp_Object reply
, prompt
[3];
301 prompt
[0] = build_string ("File ");
302 prompt
[1] = NILP (file
) ? Vdoc_file_name
: file
;
303 prompt
[2] = build_string (" is out of sync. Reload? ");
304 reply
= Fy_or_n_p (Fconcat (3, prompt
));
311 Fsnarf_documentation (Vdoc_file_name
);
313 Fload (file
, Qt
, Qt
, Qt
, Qnil
);
318 DEFUN ("documentation", Fdocumentation
, Sdocumentation
, 1, 2, 0,
319 doc
: /* Return the documentation string of FUNCTION.
320 Unless a non-nil second argument RAW is given, the
321 string is passed through `substitute-command-keys'. */)
322 (Lisp_Object function
, Lisp_Object raw
)
326 Lisp_Object tem
, doc
;
333 if (SYMBOLP (function
)
334 && (tem
= Fget (function
, Qfunction_documentation
),
336 return Fdocumentation_property (function
, Qfunction_documentation
, raw
);
338 fun
= Findirect_function (function
, Qnil
);
341 if (XSUBR (fun
)->doc
== 0)
343 else if ((EMACS_INT
) XSUBR (fun
)->doc
>= 0)
344 doc
= build_string (XSUBR (fun
)->doc
);
346 doc
= make_number ((EMACS_INT
) XSUBR (fun
)->doc
);
348 else if (COMPILEDP (fun
))
350 if ((ASIZE (fun
) & PSEUDOVECTOR_SIZE_MASK
) <= COMPILED_DOC_STRING
)
352 tem
= AREF (fun
, COMPILED_DOC_STRING
);
355 else if (NATNUMP (tem
) || CONSP (tem
))
360 else if (FUNVECP (fun
))
362 /* Unless otherwise handled, funvecs have no documentation. */
365 else if (STRINGP (fun
) || VECTORP (fun
))
367 return build_string ("Keyboard macro.");
369 else if (CONSP (fun
))
372 if (!SYMBOLP (funcar
))
373 xsignal1 (Qinvalid_function
, fun
);
374 else if (EQ (funcar
, Qkeymap
))
375 return build_string ("Prefix command (definition is a keymap associating keystrokes with commands).");
376 else if (EQ (funcar
, Qlambda
)
377 || EQ (funcar
, Qautoload
))
380 tem1
= Fcdr (Fcdr (fun
));
384 /* Handle a doc reference--but these never come last
385 in the function body, so reject them if they are last. */
386 else if ((NATNUMP (tem
) || (CONSP (tem
) && INTEGERP (XCDR (tem
))))
387 && !NILP (XCDR (tem1
)))
392 else if (EQ (funcar
, Qclosure
))
393 return Fdocumentation (Fcdr (XCDR (fun
)), raw
);
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
))
515 tem
= Fcdr (Fcdr (fun
));
516 if (CONSP (tem
) && INTEGERP (XCAR (tem
)))
517 XSETCAR (tem
, make_number (offset
));
519 else if (EQ (tem
, Qmacro
))
520 store_function_docstring (XCDR (fun
), offset
);
521 else if (EQ (tem
, Qclosure
))
522 store_function_docstring (Fcdr (XCDR (fun
)), offset
);
525 /* Bytecode objects sometimes have slots for it. */
526 else if (COMPILEDP (fun
))
528 /* This bytecode object must have a slot for the
529 docstring, since we've found a docstring for it. */
530 if ((ASIZE (fun
) & PSEUDOVECTOR_SIZE_MASK
) > COMPILED_DOC_STRING
)
531 ASET (fun
, COMPILED_DOC_STRING
, make_number (offset
));
535 static const char buildobj
[] = BUILDOBJ
;
537 DEFUN ("Snarf-documentation", Fsnarf_documentation
, Ssnarf_documentation
,
539 doc
: /* Used during Emacs initialization to scan the `etc/DOC...' file.
540 This searches the `etc/DOC...' file for doc strings and
541 records them in function and variable definitions.
542 The function takes one argument, FILENAME, a string;
543 it specifies the file name (without a directory) of the DOC file.
544 That file is found in `../etc' now; later, when the dumped Emacs is run,
545 the same file name is found in the `doc-directory'. */)
546 (Lisp_Object filename
)
550 register EMACS_INT filled
;
551 register EMACS_INT pos
;
552 register char *p
, *end
;
557 CHECK_STRING (filename
);
561 (!NILP (Vpurify_flag
))
562 #else /* CANNOT_DUMP */
564 #endif /* CANNOT_DUMP */
566 name
= (char *) alloca (SCHARS (filename
) + 14);
567 strcpy (name
, "../etc/");
571 CHECK_STRING (Vdoc_directory
);
572 name
= (char *) alloca (SCHARS (filename
)
573 + SCHARS (Vdoc_directory
) + 1);
574 strcpy (name
, SSDATA (Vdoc_directory
));
576 strcat (name
, SSDATA (filename
)); /*** Add this line ***/
578 /* Vbuild_files is nil when temacs is run, and non-nil after that. */
579 if (NILP (Vbuild_files
))
581 const char *beg
, *end
;
583 for (beg
= buildobj
; *beg
; beg
= end
)
587 while (*beg
&& isspace (*beg
)) ++beg
;
589 for (end
= beg
; *end
&& ! isspace (*end
); ++end
)
590 if (*end
== '/') beg
= end
+1; /* skip directory part */
593 if (len
> 4 && end
[-4] == '.' && end
[-3] == 'o')
594 len
-= 2; /* Just take .o if it ends in .obj */
597 Vbuild_files
= Fcons (make_string (beg
, len
), Vbuild_files
);
599 Vbuild_files
= Fpurecopy (Vbuild_files
);
602 fd
= emacs_open (name
, O_RDONLY
, 0);
604 report_file_error ("Opening doc string file",
605 Fcons (build_string (name
), Qnil
));
606 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 %d", pos
);
678 memmove (buf
, end
, filled
);
684 DEFUN ("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
);