aboutsummaryrefslogtreecommitdiffstats
path: root/src/pdumper.c
diff options
context:
space:
mode:
authorPaul Eggert2019-07-23 09:19:09 -0700
committerPaul Eggert2019-07-23 09:23:20 -0700
commit8dd5b6ea56c38669bc98104ee2d6b31496624d28 (patch)
tree3c0f5d0259478f97052fd21585cb24d5d105437c /src/pdumper.c
parent29a7d73d195761e8309a4fe23872888758436d1e (diff)
downloademacs-8dd5b6ea56c38669bc98104ee2d6b31496624d28.tar.gz
emacs-8dd5b6ea56c38669bc98104ee2d6b31496624d28.zip
Improve pdumper doc; say unexec is deprecated
Say that pdumping cannot redump unless -batch is used. Say that the traditional unexec dumping method is by default not available, and is deprecated. Don't call dump files "portable", as dump files are not any more portable than the Emacs executables themselves. Just call them "dump files". Similar, prefer "portable dumper" (since the dumper code is portable) to "portable dumping" (since the dump file is not). Be more systematic about calling them "dump files" instead of "dumped images" or whatnot.
Diffstat (limited to 'src/pdumper.c')
-rw-r--r--src/pdumper.c10
1 files changed, 5 insertions, 5 deletions
diff --git a/src/pdumper.c b/src/pdumper.c
index cda8b40be4c..84147353e85 100644
--- a/src/pdumper.c
+++ b/src/pdumper.c
@@ -333,8 +333,8 @@ dump_fingerprint (char const *label,
333 fprintf (stderr, "%s: %.*s\n", label, hexbuf_size, hexbuf); 333 fprintf (stderr, "%s: %.*s\n", label, hexbuf_size, hexbuf);
334} 334}
335 335
336/* Format of an Emacs portable dump file. All offsets are relative to 336/* Format of an Emacs dump file. All offsets are relative to
337 the beginning of the file. An Emacs portable dump file is coupled 337 the beginning of the file. An Emacs dump file is coupled
338 to exactly the Emacs binary that produced it, so details of 338 to exactly the Emacs binary that produced it, so details of
339 alignment and endianness are unimportant. 339 alignment and endianness are unimportant.
340 340
@@ -3990,7 +3990,7 @@ dump_drain_deferred_symbols (struct dump_context *ctx)
3990DEFUN ("dump-emacs-portable", 3990DEFUN ("dump-emacs-portable",
3991 Fdump_emacs_portable, Sdump_emacs_portable, 3991 Fdump_emacs_portable, Sdump_emacs_portable,
3992 1, 2, 0, 3992 1, 2, 0,
3993 doc: /* Dump current state of Emacs into portable dump file FILENAME. 3993 doc: /* Dump current state of Emacs into dump file FILENAME.
3994If TRACK-REFERRERS is non-nil, keep additional debugging information 3994If TRACK-REFERRERS is non-nil, keep additional debugging information
3995that can help track down the provenance of unsupported object 3995that can help track down the provenance of unsupported object
3996types. */) 3996types. */)
@@ -5470,14 +5470,14 @@ pdumper_record_wd (const char *wd)
5470 5470
5471DEFUN ("pdumper-stats", Fpdumper_stats, Spdumper_stats, 0, 0, 0, 5471DEFUN ("pdumper-stats", Fpdumper_stats, Spdumper_stats, 0, 0, 0,
5472 doc: /* Return statistics about portable dumping used by this session. 5472 doc: /* Return statistics about portable dumping used by this session.
5473If this Emacs sesion was started from a portable dump file, 5473If this Emacs session was started from a dump file,
5474the return value is an alist of the form: 5474the return value is an alist of the form:
5475 5475
5476 ((dumped-with-pdumper . t) (load-time . TIME) (dump-file-name . FILE)) 5476 ((dumped-with-pdumper . t) (load-time . TIME) (dump-file-name . FILE))
5477 5477
5478where TIME is the time in seconds it took to restore Emacs state 5478where TIME is the time in seconds it took to restore Emacs state
5479from the dump file, and FILE is the name of the dump file. 5479from the dump file, and FILE is the name of the dump file.
5480Value is nil if this session was not started using a portable dump file.*/) 5480Value is nil if this session was not started using a dump file.*/)
5481 (void) 5481 (void)
5482{ 5482{
5483 if (!dumped_with_pdumper_p ()) 5483 if (!dumped_with_pdumper_p ())