1 /* Record indices of function doc strings stored in a file.
3 Copyright (C) 1985-1986, 1993-1995, 1997-2012 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. */
31 #include "character.h"
37 Lisp_Object Qfunction_documentation
;
39 /* Buffer used for reading from documentation file. */
40 static char *get_doc_string_buffer
;
41 static ptrdiff_t get_doc_string_buffer_size
;
43 static unsigned char *read_bytecode_pointer
;
45 /* `readchar' in lread.c calls back here to fetch the next byte.
46 If UNREADFLAG is 1, we unread a byte. */
49 read_bytecode_char (bool unreadflag
)
53 read_bytecode_pointer
--;
56 return *read_bytecode_pointer
++;
59 /* Extract a doc string from a file. FILEPOS says where to get it.
60 If it is an integer, use that position in the standard DOC-... file.
61 If it is (FILE . INTEGER), use FILE as the file name
62 and INTEGER as the position in that file.
63 But if INTEGER is negative, make it positive.
64 (A negative integer is used for user variables, so we can distinguish
65 them without actually fetching the doc string.)
67 If the location does not point to the beginning of a docstring
68 (e.g. because the file has been modified and the location is stale),
71 If UNIBYTE, always make a unibyte string.
73 If DEFINITION, assume this is for reading
74 a dynamic function definition; convert the bytestring
75 and the constants vector with appropriate byte handling,
76 and return a cons cell. */
79 get_doc_string (Lisp_Object filepos
, bool unibyte
, bool definition
)
81 char *from
, *to
, *name
, *p
, *p1
;
86 Lisp_Object file
, tem
, pos
;
89 if (INTEGERP (filepos
))
91 file
= Vdoc_file_name
;
94 else if (CONSP (filepos
))
96 file
= XCAR (filepos
);
102 position
= eabs (XINT (pos
));
104 if (!STRINGP (Vdoc_directory
))
110 /* Put the file name in NAME as a C string.
111 If it is relative, combine it with Vdoc_directory. */
113 tem
= Ffile_name_absolute_p (file
);
114 file
= ENCODE_FILE (file
);
117 Lisp_Object docdir
= ENCODE_FILE (Vdoc_directory
);
118 minsize
= SCHARS (docdir
);
119 /* sizeof ("../etc/") == 8 */
122 name
= SAFE_ALLOCA (minsize
+ SCHARS (file
) + 8);
123 strcpy (name
, SSDATA (docdir
));
124 strcat (name
, SSDATA (file
));
128 name
= SSDATA (file
);
131 fd
= emacs_open (name
, O_RDONLY
, 0);
135 if (!NILP (Vpurify_flag
))
137 /* Preparing to dump; DOC file is probably not installed.
138 So check in ../etc. */
139 strcpy (name
, "../etc/");
140 strcat (name
, SSDATA (file
));
142 fd
= emacs_open (name
, O_RDONLY
, 0);
146 return concat3 (build_string ("Cannot open doc string file \""),
147 file
, build_string ("\"\n"));
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 (TYPE_MAXIMUM (off_t
) < position
155 || lseek (fd
, position
- offset
, 0) < 0)
158 error ("Position %"pI
"d out of range in doc string file \"%s\"",
164 /* Read the doc string into get_doc_string_buffer.
165 P points beyond the data just read. */
167 p
= get_doc_string_buffer
;
170 ptrdiff_t space_left
= (get_doc_string_buffer_size
- 1
171 - (p
- get_doc_string_buffer
));
174 /* Allocate or grow the buffer if we need to. */
177 ptrdiff_t in_buffer
= p
- get_doc_string_buffer
;
178 get_doc_string_buffer
=
179 xpalloc (get_doc_string_buffer
, &get_doc_string_buffer_size
,
181 p
= get_doc_string_buffer
+ in_buffer
;
182 space_left
= (get_doc_string_buffer_size
- 1
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 unsigned char uc
= c
;
259 Invalid data in documentation file -- %c followed by code %03o",
267 /* If DEFINITION, read from this buffer
268 the same way we would read bytes from a file. */
271 read_bytecode_pointer
= (unsigned char *) get_doc_string_buffer
+ offset
;
272 return Fread (Qlambda
);
276 return make_unibyte_string (get_doc_string_buffer
+ offset
,
277 to
- (get_doc_string_buffer
+ offset
));
280 /* The data determines whether the string is multibyte. */
282 multibyte_chars_in_text (((unsigned char *) get_doc_string_buffer
284 to
- (get_doc_string_buffer
+ offset
));
285 return make_string_from_bytes (get_doc_string_buffer
+ offset
,
287 to
- (get_doc_string_buffer
+ offset
));
291 /* Get a string from position FILEPOS and pass it through the Lisp reader.
292 We use this for fetching the bytecode string and constants vector
293 of a compiled function from the .elc file. */
296 read_doc_string (Lisp_Object filepos
)
298 return get_doc_string (filepos
, 0, 1);
302 reread_doc_file (Lisp_Object file
)
305 Lisp_Object reply
, prompt
[3];
308 prompt
[0] = build_string ("File ");
309 prompt
[1] = NILP (file
) ? Vdoc_file_name
: file
;
310 prompt
[2] = build_string (" is out of sync. Reload? ");
311 reply
= Fy_or_n_p (Fconcat (3, prompt
));
318 Fsnarf_documentation (Vdoc_file_name
);
320 Fload (file
, Qt
, Qt
, Qt
, Qnil
);
325 DEFUN ("documentation", Fdocumentation
, Sdocumentation
, 1, 2, 0,
326 doc
: /* Return the documentation string of FUNCTION.
327 Unless a non-nil second argument RAW is given, the
328 string is passed through `substitute-command-keys'. */)
329 (Lisp_Object function
, Lisp_Object raw
)
340 if (SYMBOLP (function
))
342 Lisp_Object tem
= Fget (function
, Qfunction_documentation
);
344 return Fdocumentation_property (function
, Qfunction_documentation
,
348 fun
= Findirect_function (function
, Qnil
);
349 if (CONSP (fun
) && EQ (XCAR (fun
), Qmacro
))
353 if (XSUBR (fun
)->doc
== 0)
355 /* FIXME: This is not portable, as it assumes that string
356 pointers have the top bit clear. */
357 else if ((intptr_t) XSUBR (fun
)->doc
>= 0)
358 doc
= build_string (XSUBR (fun
)->doc
);
360 doc
= make_number ((intptr_t) XSUBR (fun
)->doc
);
362 else if (COMPILEDP (fun
))
364 if ((ASIZE (fun
) & PSEUDOVECTOR_SIZE_MASK
) <= COMPILED_DOC_STRING
)
368 Lisp_Object tem
= AREF (fun
, COMPILED_DOC_STRING
);
371 else if (NATNUMP (tem
) || CONSP (tem
))
377 else if (STRINGP (fun
) || VECTORP (fun
))
379 return build_string ("Keyboard macro.");
381 else if (CONSP (fun
))
384 if (!SYMBOLP (funcar
))
385 xsignal1 (Qinvalid_function
, fun
);
386 else if (EQ (funcar
, Qkeymap
))
387 return build_string ("Prefix command (definition is a keymap associating keystrokes with commands).");
388 else if (EQ (funcar
, Qlambda
)
389 || (EQ (funcar
, Qclosure
) && (fun
= XCDR (fun
), 1))
390 || EQ (funcar
, Qautoload
))
392 Lisp_Object tem1
= Fcdr (Fcdr (fun
));
393 Lisp_Object tem
= Fcar (tem1
);
396 /* Handle a doc reference--but these never come last
397 in the function body, so reject them if they are last. */
398 else if ((NATNUMP (tem
) || (CONSP (tem
) && INTEGERP (XCDR (tem
))))
399 && !NILP (XCDR (tem1
)))
410 xsignal1 (Qinvalid_function
, fun
);
413 /* Check for a dynamic docstring. These come with
414 a dynamic-docstring-function text property. */
418 = Fget_text_property (make_number (0),
419 intern ("dynamic-docstring-function"),
422 /* Pass both `doc' and `function' since `function' can be needed, and
423 finding `doc' can be annoying: calling `documentation' is not an
424 option because it would infloop. */
425 doc
= call2 (func
, doc
, function
);
428 /* If DOC is 0, it's typically because of a dumped file missing
429 from the DOC file (bug in src/Makefile.in). */
430 if (EQ (doc
, make_number (0)))
432 if (INTEGERP (doc
) || CONSP (doc
))
435 tem
= get_doc_string (doc
, 0, 0);
436 if (NILP (tem
) && try_reload
)
438 /* The file is newer, we need to reset the pointers. */
439 struct gcpro gcpro1
, gcpro2
;
440 GCPRO2 (function
, raw
);
441 try_reload
= reread_doc_file (Fcar_safe (doc
));
454 doc
= Fsubstitute_command_keys (doc
);
458 DEFUN ("documentation-property", Fdocumentation_property
,
459 Sdocumentation_property
, 2, 3, 0,
460 doc
: /* Return the documentation string that is SYMBOL's PROP property.
461 Third argument RAW omitted or nil means pass the result through
462 `substitute-command-keys' if it is a string.
464 This differs from `get' in that it can refer to strings stored in the
465 `etc/DOC' file; and that it evaluates documentation properties that
467 (Lisp_Object symbol
, Lisp_Object prop
, Lisp_Object raw
)
472 documentation_property
:
474 tem
= Fget (symbol
, prop
);
475 if (EQ (tem
, make_number (0)))
477 if (INTEGERP (tem
) || (CONSP (tem
) && INTEGERP (XCDR (tem
))))
479 Lisp_Object doc
= tem
;
480 tem
= get_doc_string (tem
, 0, 0);
481 if (NILP (tem
) && try_reload
)
483 /* The file is newer, we need to reset the pointers. */
484 struct gcpro gcpro1
, gcpro2
, gcpro3
;
485 GCPRO3 (symbol
, prop
, raw
);
486 try_reload
= reread_doc_file (Fcar_safe (doc
));
491 goto documentation_property
;
495 else if (!STRINGP (tem
))
496 /* Feval protects its argument. */
497 tem
= Feval (tem
, Qnil
);
499 if (NILP (raw
) && STRINGP (tem
))
500 tem
= Fsubstitute_command_keys (tem
);
504 /* Scanning the DOC files and placing docstring offsets into functions. */
507 store_function_docstring (Lisp_Object obj
, ptrdiff_t offset
)
509 /* Don't use indirect_function here, or defaliases will apply their
510 docstrings to the base functions (Bug#2603). */
511 Lisp_Object fun
= SYMBOLP (obj
) ? XSYMBOL (obj
)->function
: obj
;
513 /* The type determines where the docstring is stored. */
515 /* Lisp_Subrs have a slot for it. */
518 intptr_t negative_offset
= - offset
;
519 XSUBR (fun
)->doc
= (char *) negative_offset
;
522 /* If it's a lisp form, stick it in the form. */
523 else if (CONSP (fun
))
528 if (EQ (tem
, Qlambda
) || EQ (tem
, Qautoload
)
529 || (EQ (tem
, Qclosure
) && (fun
= XCDR (fun
), 1)))
531 tem
= Fcdr (Fcdr (fun
));
532 if (CONSP (tem
) && INTEGERP (XCAR (tem
)))
533 /* FIXME: This modifies typically pure hash-cons'd data, so its
534 correctness is quite delicate. */
535 XSETCAR (tem
, make_number (offset
));
537 else if (EQ (tem
, Qmacro
))
538 store_function_docstring (XCDR (fun
), offset
);
541 /* Bytecode objects sometimes have slots for it. */
542 else if (COMPILEDP (fun
))
544 /* This bytecode object must have a slot for the
545 docstring, since we've found a docstring for it. */
546 if ((ASIZE (fun
) & PSEUDOVECTOR_SIZE_MASK
) > COMPILED_DOC_STRING
)
547 ASET (fun
, COMPILED_DOC_STRING
, make_number (offset
));
551 static const char buildobj
[] = BUILDOBJ
;
553 DEFUN ("Snarf-documentation", Fsnarf_documentation
, Ssnarf_documentation
,
555 doc
: /* Used during Emacs initialization to scan the `etc/DOC...' file.
556 This searches the `etc/DOC...' file for doc strings and
557 records them in function and variable definitions.
558 The function takes one argument, FILENAME, a string;
559 it specifies the file name (without a directory) of the DOC file.
560 That file is found in `../etc' now; later, when the dumped Emacs is run,
561 the same file name is found in the `doc-directory'. */)
562 (Lisp_Object filename
)
572 CHECK_STRING (filename
);
576 (!NILP (Vpurify_flag
))
577 #else /* CANNOT_DUMP */
579 #endif /* CANNOT_DUMP */
581 name
= alloca (SCHARS (filename
) + 14);
582 strcpy (name
, "../etc/");
586 CHECK_STRING (Vdoc_directory
);
587 name
= alloca (SCHARS (filename
) + SCHARS (Vdoc_directory
) + 1);
588 strcpy (name
, SSDATA (Vdoc_directory
));
590 strcat (name
, SSDATA (filename
)); /*** Add this line ***/
592 /* Vbuild_files is nil when temacs is run, and non-nil after that. */
593 if (NILP (Vbuild_files
))
595 const char *beg
, *end
;
597 for (beg
= buildobj
; *beg
; beg
= end
)
601 while (*beg
&& c_isspace (*beg
)) ++beg
;
603 for (end
= beg
; *end
&& ! c_isspace (*end
); ++end
)
604 if (*end
== '/') beg
= end
+1; /* skip directory part */
607 if (len
> 4 && end
[-4] == '.' && end
[-3] == 'o')
608 len
-= 2; /* Just take .o if it ends in .obj */
611 Vbuild_files
= Fcons (make_string (beg
, len
), Vbuild_files
);
613 Vbuild_files
= Fpurecopy (Vbuild_files
);
616 fd
= emacs_open (name
, O_RDONLY
, 0);
618 report_file_error ("Opening doc string file",
619 Fcons (build_string (name
), Qnil
));
620 Vdoc_file_name
= filename
;
627 filled
+= emacs_read (fd
, &buf
[filled
], sizeof buf
- 1 - filled
);
633 end
= buf
+ (filled
< 512 ? filled
: filled
- 128);
634 while (p
!= end
&& *p
!= '\037') p
++;
635 /* p points to ^_Ffunctionname\n or ^_Vvarname\n or ^_Sfilename\n. */
638 end
= strchr (p
, '\n');
640 /* See if this is a file name, and if it is a file in build-files. */
644 if (end
- p
> 4 && end
[-2] == '.'
645 && (end
[-1] == 'o' || end
[-1] == 'c'))
647 ptrdiff_t len
= end
- p
- 2;
648 char *fromfile
= alloca (len
+ 1);
649 memcpy (fromfile
, &p
[2], len
);
651 if (fromfile
[len
-1] == 'c')
652 fromfile
[len
-1] = 'o';
654 skip_file
= NILP (Fmember (build_string (fromfile
),
659 sym
= oblookup (Vobarray
, p
+ 2,
660 multibyte_chars_in_text ((unsigned char *) p
+ 2,
663 /* Check skip_file so that when a function is defined several
664 times in different files (typically, once in xterm, once in
665 w32term, ...), we only pay attention to the one that
667 if (! skip_file
&& SYMBOLP (sym
))
669 /* Attach a docstring to a variable? */
672 /* Install file-position as variable-documentation property
673 and make it negative for a user-variable
674 (doc starts with a `*'). */
675 if (!NILP (Fboundp (sym
)))
676 Fput (sym
, Qvariable_documentation
,
677 make_number ((pos
+ end
+ 1 - buf
)
678 * (end
[1] == '*' ? -1 : 1)));
681 /* Attach a docstring to a function? */
682 else if (p
[1] == 'F')
684 if (!NILP (Ffboundp (sym
)))
685 store_function_docstring (sym
, pos
+ end
+ 1 - buf
);
687 else if (p
[1] == 'S')
688 ; /* Just a source file name boundary marker. Ignore it. */
691 error ("DOC file invalid at position %"pI
"d", pos
);
696 memmove (buf
, end
, filled
);
702 DEFUN ("substitute-command-keys", Fsubstitute_command_keys
,
703 Ssubstitute_command_keys
, 1, 1, 0,
704 doc
: /* Substitute key descriptions for command names in STRING.
705 Each substring of the form \\=\\[COMMAND] is replaced by either a
706 keystroke sequence that invokes COMMAND, or "M-x COMMAND" if COMMAND
709 Each substring of the form \\=\\{MAPVAR} is replaced by a summary of
710 the value of MAPVAR as a keymap. This summary is similar to the one
711 produced by `describe-bindings'. The summary ends in two newlines
712 \(used by the helper function `help-make-xrefs' to find the end of the
715 Each substring of the form \\=\\<MAPVAR> specifies the use of MAPVAR
716 as the keymap for future \\=\\[COMMAND] substrings.
717 \\=\\= quotes the following character and is discarded;
718 thus, \\=\\=\\=\\= puts \\=\\= into the output, and \\=\\=\\=\\[ puts \\=\\[ into the output.
720 Return the original STRING if no substitutions are made.
721 Otherwise, return a new string, without any text properties. */)
732 unsigned char *start
;
733 ptrdiff_t length
, length_byte
;
735 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
742 CHECK_STRING (string
);
746 GCPRO4 (string
, tem
, keymap
, name
);
748 multibyte
= STRING_MULTIBYTE (string
);
751 /* KEYMAP is either nil (which means search all the active keymaps)
752 or a specified local map (which means search just that and the
753 global map). If non-nil, it might come from Voverriding_local_map,
754 or from a \\<mapname> construct in STRING itself.. */
755 keymap
= KVAR (current_kboard
, Voverriding_terminal_local_map
);
757 keymap
= Voverriding_local_map
;
759 bsize
= SBYTES (string
);
760 bufp
= buf
= xmalloc (bsize
);
762 strp
= SDATA (string
);
763 while (strp
< SDATA (string
) + SBYTES (string
))
765 if (strp
[0] == '\\' && strp
[1] == '=')
767 /* \= quotes the next character;
768 thus, to put in \[ without its special meaning, use \=\[. */
775 STRING_CHAR_AND_LENGTH (strp
, len
);
779 memcpy (bufp
, strp
, len
);
785 *bufp
++ = *strp
++, nchars
++;
787 else if (strp
[0] == '\\' && strp
[1] == '[')
790 bool follow_remap
= 1;
793 strp
+= 2; /* skip \[ */
795 start_idx
= start
- SDATA (string
);
797 while ((strp
- SDATA (string
)
801 length_byte
= strp
- start
;
805 /* Save STRP in IDX. */
806 idx
= strp
- SDATA (string
);
807 name
= Fintern (make_string ((char *) start
, length_byte
), Qnil
);
810 tem
= Fwhere_is_internal (name
, keymap
, Qt
, Qnil
, Qnil
);
812 if (VECTORP (tem
) && ASIZE (tem
) > 1
813 && EQ (AREF (tem
, 0), Qremap
) && SYMBOLP (AREF (tem
, 1))
816 name
= AREF (tem
, 1);
821 /* Note the Fwhere_is_internal can GC, so we have to take
822 relocation of string contents into account. */
823 strp
= SDATA (string
) + idx
;
824 start
= SDATA (string
) + start_idx
;
826 if (NILP (tem
)) /* but not on any keys */
828 ptrdiff_t offset
= bufp
- buf
;
829 if (STRING_BYTES_BOUND
- 4 < bsize
)
831 buf
= xrealloc (buf
, bsize
+= 4);
833 memcpy (bufp
, "M-x ", 4);
837 length
= multibyte_chars_in_text (start
, length_byte
);
839 length
= length_byte
;
843 { /* function is on a key */
844 tem
= Fkey_description (tem
, Qnil
);
848 /* \{foo} is replaced with a summary of the keymap (symbol-value foo).
849 \<foo> just sets the keymap used for \[cmd]. */
850 else if (strp
[0] == '\\' && (strp
[1] == '{' || strp
[1] == '<'))
852 struct buffer
*oldbuf
;
854 /* This is for computing the SHADOWS arg for describe_map_tree. */
855 Lisp_Object active_maps
= Fcurrent_active_maps (Qnil
, Qnil
);
856 Lisp_Object earlier_maps
;
859 strp
+= 2; /* skip \{ or \< */
861 start_idx
= start
- SDATA (string
);
863 while ((strp
- SDATA (string
) < SBYTES (string
))
864 && *strp
!= '}' && *strp
!= '>')
867 length_byte
= strp
- start
;
868 strp
++; /* skip } or > */
870 /* Save STRP in IDX. */
871 idx
= strp
- SDATA (string
);
873 /* Get the value of the keymap in TEM, or nil if undefined.
874 Do this while still in the user's current buffer
875 in case it is a local variable. */
876 name
= Fintern (make_string ((char *) start
, length_byte
), Qnil
);
877 tem
= Fboundp (name
);
880 tem
= Fsymbol_value (name
);
883 tem
= get_keymap (tem
, 0, 1);
884 /* Note that get_keymap can GC. */
885 strp
= SDATA (string
) + idx
;
886 start
= SDATA (string
) + start_idx
;
890 /* Now switch to a temp buffer. */
891 oldbuf
= current_buffer
;
892 set_buffer_internal (XBUFFER (Vprin1_to_string_buffer
));
896 name
= Fsymbol_name (name
);
897 insert_string ("\nUses keymap `");
898 insert_from_string (name
, 0, 0,
901 insert_string ("', which is not currently defined.\n");
902 if (start
[-1] == '<') keymap
= Qnil
;
904 else if (start
[-1] == '<')
908 /* Get the list of active keymaps that precede this one.
909 If this one's not active, get nil. */
910 earlier_maps
= Fcdr (Fmemq (tem
, Freverse (active_maps
)));
911 describe_map_tree (tem
, 1, Fnreverse (earlier_maps
),
912 Qnil
, (char *)0, 1, 0, 0, 1);
914 tem
= Fbuffer_string ();
916 set_buffer_internal (oldbuf
);
920 length
= SCHARS (tem
);
921 length_byte
= SBYTES (tem
);
924 ptrdiff_t offset
= bufp
- buf
;
925 if (STRING_BYTES_BOUND
- length_byte
< bsize
)
927 buf
= xrealloc (buf
, bsize
+= length_byte
);
929 memcpy (bufp
, start
, length_byte
);
932 /* Check STRING again in case gc relocated it. */
933 strp
= SDATA (string
) + idx
;
936 else if (! multibyte
) /* just copy other chars */
937 *bufp
++ = *strp
++, nchars
++;
942 STRING_CHAR_AND_LENGTH (strp
, len
);
946 memcpy (bufp
, strp
, len
);
953 if (changed
) /* don't bother if nothing substituted */
954 tem
= make_string_from_bytes (buf
, nchars
, bufp
- buf
);
958 RETURN_UNGCPRO (tem
);
964 DEFSYM (Qfunction_documentation
, "function-documentation");
966 DEFVAR_LISP ("internal-doc-file-name", Vdoc_file_name
,
967 doc
: /* Name of file containing documentation strings of built-in symbols. */);
968 Vdoc_file_name
= Qnil
;
970 DEFVAR_LISP ("build-files", Vbuild_files
,
971 doc
: /* A list of files used to build this Emacs binary. */);
974 defsubr (&Sdocumentation
);
975 defsubr (&Sdocumentation_property
);
976 defsubr (&Ssnarf_documentation
);
977 defsubr (&Ssubstitute_command_keys
);