Mercurial > hg > xemacs-beta
annotate etc/bundled-packages/README @ 5160:ab9ee10a53e4
fix various problems with allocation statistics, track overhead properly
-------------------- ChangeLog entries follow: --------------------
lisp/ChangeLog addition:
2010-03-20 Ben Wing <ben@xemacs.org>
* diagnose.el (show-memory-usage):
* diagnose.el (show-object-memory-usage-stats):
Further changes to correspond with changes in the C code;
add an additional column showing the overhead used with each type,
and add it into the grand total memory usage.
src/ChangeLog addition:
2010-03-20 Ben Wing <ben@xemacs.org>
* alloc.c:
* alloc.c (init_lrecord_stats):
* alloc.c (free_normal_lisp_object):
* alloc.c (struct):
* alloc.c (clear_lrecord_stats):
* alloc.c (tick_lrecord_stats):
* alloc.c (COUNT_FROB_BLOCK_USAGE):
* alloc.c (COPY_INTO_LRECORD_STATS):
* alloc.c (sweep_strings):
* alloc.c (UNMARK_string):
* alloc.c (gc_sweep_1):
* alloc.c (finish_object_memory_usage_stats):
* alloc.c (object_memory_usage_stats):
* alloc.c (object_dead_p):
* alloc.c (fixed_type_block_overhead):
* alloc.c (lisp_object_storage_size):
* emacs.c (main_1):
* lisp.h:
* lrecord.h:
Export lisp_object_storage_size() and malloced_storage_size() even
when not MEMORY_USAGE_STATS, to get the non-MEMORY_USAGE_STATS
build to compile.
Don't export fixed_type_block_overhead() any more.
Some code cleanup, rearrangement, add some section headers.
Clean up various bugs especially involving computation of overhead
and double-counting certain usage in total_gc_usage. Add
statistics computing the overhead used by all types. Don't add a
special entry for string headers in the object-memory-usage-stats
because it's already present as just "string". But do count the
overhead used by long strings. Don't try to call the
memory_usage() methods when NEW_GC because there's nowhere obvious
in the sweep stage to make the calls.
* marker.c (compute_buffer_marker_usage):
Just use lisp_object_storage_size() rather than trying to
reimplement it.
author | Ben Wing <ben@xemacs.org> |
---|---|
date | Sat, 20 Mar 2010 20:20:30 -0500 |
parents | 146742e30f05 |
children | fd714e8ba81e |
rev | line source |
---|---|
4354
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
1 Package distributions may be placed in this directory. |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
2 If present and a package-path is configured, packages can be installed |
4361
146742e30f05
Ensure LATE_PACKAGES_DIRECTORIES is a trivial search path.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
4354
diff
changeset
|
3 using the top-level Makefile. |
4354
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
4 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
5 To configure the package path, use the --with-late-packages option to |
4361
146742e30f05
Ensure LATE_PACKAGES_DIRECTORIES is a trivial search path.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
4354
diff
changeset
|
6 configure, which specifies a single directory in which to install the |
146742e30f05
Ensure LATE_PACKAGES_DIRECTORIES is a trivial search path.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
4354
diff
changeset
|
7 xemacs-packages and mule-packages hierarchies provided. If this is null, |
146742e30f05
Ensure LATE_PACKAGES_DIRECTORIES is a trivial search path.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
4354
diff
changeset
|
8 or contains a Unix-style search path (i.e., a colon is present in the |
146742e30f05
Ensure LATE_PACKAGES_DIRECTORIES is a trivial search path.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
4354
diff
changeset
|
9 argument of the --with-late-packages option), you will have to install |
146742e30f05
Ensure LATE_PACKAGES_DIRECTORIES is a trivial search path.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
4354
diff
changeset
|
10 the packages by hand. |
4354
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
11 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
12 To find out if a distribution includes bundled packages, type |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
13 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
14 make check-available-packages |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
15 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
16 There are three Make targets that may be available depending on the package |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
17 sets supplied. |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
18 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
19 make install-bootstrap-packages |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
20 Install a selected set of packages sufficient to support |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
21 downloading and installing packages via the M-x list-packages |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
22 interface. Chose this if you want to be able to install the |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
23 latest version of each package immediately. |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
24 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
25 make install-nomule-packages |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
26 Install the full distribution of packages that do not require a |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
27 Mule-enabled XEmacs. Choose this package if you don't have a |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
28 Mule-enabled XEmacs and want the convenience of a single-command |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
29 installation. You can add or update packages via M-x list-packages |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
30 at any time. |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
31 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
32 make install-all-packages |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
33 Install the full distribution of packages, including those requiring |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
34 a Mule-enabled XEmacs. Choose this package if you have a Mule- |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
35 enabled XEmacs and want the convenience of a single-command |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
36 installation. You can add or update packages via M-x list-packages |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
37 at any time. |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
38 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
39 DISTRIBUTOR'S NOTE: you may choose what packages you wish to include in |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
40 bootstrap.tar.gz, but to make list-packages work you need to include at |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
41 least xemacs-base, dired, and efs. The tarball should unpack directly as |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
42 an xemacs-packages tree (and optionaly, a mule-packages tree. Also, if |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
43 either of xemacs-sumo.tar.gz or xemacs-mule-sumo.tar.gz is provided, the |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
44 other should be as well. |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
45 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
46 If packages are not available with the distribution, you can get them at |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
47 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
48 ftp://ftp.xemacs.org/pub/xemacs/packages/xemacs-sumo.tar.gz |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
49 ftp://ftp.xemacs.org/pub/xemacs/packages/xemacs-mule-sumo.tar.gz |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
50 http://turnbull.sk.tsukuba.ac.jp/Tools/XEmacs/bootstrap.tar.gz |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
51 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
52 and place them in the same directory as this file. You can also make your |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
53 own bootstrap.tar.gz by creating a directory xemacs-packages, then |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
54 untarring the packages of your choice into that directory, and tarring the |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
55 whole thing up with "tar czf bootstrap.tar.gz xemacs-packages". (If you |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
56 wish to include mule-packages, you should place them in mule-packages as |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
57 a sibling of xemacs-packages.) |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
58 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
59 This facility currently does not support installations which configure |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
60 the --with-early-packages, --with-late-packages, or --with-last-packages |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
61 options. |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
62 |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
63 This facility currently will not overwrite an existing package |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
64 installation, not even if a whole hierarchy (usually the mule-packages) |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
65 is missing. In particular, you cannot use this feature to add the |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
66 mule-packages to a package installation which lacks them, even if the |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
67 hierarchy is missing, or the xemacs-packages hierarchy was installed |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
68 this way. Nor can you "upgrade" a bootstrap installation to a full |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
69 installation. If you wish to do any of these things you will need to |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
70 remove the existing hierarchies. |
232d873b9705
Add support for installing bundled patches.
Stephen J. Turnbull <stephen@xemacs.org>
parents:
diff
changeset
|
71 |