Mercurial > emacs
annotate admin/make-tarball.txt @ 94926:70a8f8c84456
Include <strings.h>.
(enable_font_backend): Delete it.
(Qfont_spec, Qfont_entity, Qfont_object): New variables.
(CHECK_VALIDATE_FONT_SPEC): Delete it.
(PT_PER_INCH, POINT_TO_PIXEL, PIXEL_TO_POINT): Moved to font.h.
(null_string): Delete it.
(null_vector): Make it static.
(font_family_alist): Delete it.
(Qnormal): Extern it.
(QCextra, QClanguage): Delete it.
(QClang, QCavgwidth, QCfont_entity, QCfc_unknown_spec): New
variables.
(font_make_spec, font_make_entity, font_make_object)
(font_intern_prop): Renamed from intern_downcase. Don't downcase
the string. Callers changed.
(font_pixel_size): Adjusted for the format change of font-related
objects.
(prop_name_to_numeric, prop_numeric_to_name): Delete them.
(font_style_to_value, font_style_symbolic): New function.
(build_font_family_alist): Delete it.
(font_registry_charsets): Use Fassoc_string instead of
assq_no_quit.
(font_prop_validate_symbol): Don't return null_string.
(font_prop_validate_style): Adjusted for the change of
style-related values in a font vector.
(font_property_table): Delete entries for QClangauge and
QCantialias, add entries for QCavgwidth.
(get_font_prop_index): Delete the 2nd argument FROM.
(font_prop_validate): Arguments changed.
(font_put_extra): Adjusted for the change of font-related objects.
(font_expand_wildcards, font_parse_xlfd, font_unparse_xlfd)
(font_parse_fcname, font_unparse_fcname)
(font_prepare_composition): Likewise.
(font_parse_family_registry): Renamed from font_merge_old_spec.
(otf_open): Delete the 1st arg entity.
(font_otf_capability): Adjusted for the above change.
(font_score): New arg alternate_families. Adjusted for the change
of font-related objects.
(font_sort_entites): New arg best_only.
(font_symbolic_weight, font_symbolic_slant, font_symbolic_width):
Delete them.
(font_match_p): Check alternate families.
(font_find_object): Delete it.
(font_check_object): New function.
(font_clear_cache): Adjusted for the change of font-related
objects.
(font_delete_unmatched): New arg.
(font_list_entities): Call font_driver->list with a spec that
doesn't specify style-related properties.
(font_matching_entity): Arguments changed. Caller changed.
(font_open_entity): Adjusted for the change of font-related
objects.
(font_close_object, font_has_char, font_encode_char)
(font_get_name, font_get_spec): Likewise.
(font_spec_from_name, font_clear_prop, font_update_lface): New
functions.
(font_find_for_lface, font_open_for_lface, font_load_for_lface):
(font_prepare_for_face, font_done_for_face, font_open_by_name)
(font_at): Adjusted for the change of font-related objects.
(font_range): New function.
(Ffontp, Ffont_spec, Ffont_get, Ffont_put, Flist_fonts)
(Ffont_xlfd_name): Adjusted for the change of font-related
objects.
(Fcopy_font_spec, Fmerge_font_spec): New function.
(Ffont_family_list): Renamed from list-families.
(Finternal_set_font_style_table): Arguments changed.
(Ffont_fill_gstring, Ffont_shape_text, Fopen_font)
(Ffont_drive_otf, Fquery_font, Ffont_match_p): Adjusted for the
change of font-related objects.
(syms_of_font): Delete "ifdef USE_FONT_BACKEND". DEFSYM new
symboles.
author | Kenichi Handa <handa@m17n.org> |
---|---|
date | Wed, 14 May 2008 01:25:55 +0000 |
parents | 5d58981e6690 |
children | c70e45a7acfd 9592c50233ab |
rev | line source |
---|---|
48667
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
1 Instructions to create pretest or release tarballs. |
54148
229b09cd4c04
Correct original attribution
Francesco Potortì <pot@gnu.org>
parents:
52929
diff
changeset
|
2 -- originally written by Gerd Moellmann, amended by Francesco Potort́ |
229b09cd4c04
Correct original attribution
Francesco Potortì <pot@gnu.org>
parents:
52929
diff
changeset
|
3 with the initial help of Eli Zaretskii |
48667
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
4 |
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
5 For each step, check for possible errors. |
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
6 |
59969
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
7 1. cvs -q update -Pd |
48667
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
8 |
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
9 2. Bootstrap to make 100% sure all elc files are up-to-date, and to |
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
10 make sure that the later tagged version will bootstrap, should it be |
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
11 necessary to check it out. |
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
12 |
84414 | 13 3. Regenerate Emacs' etc/AUTHORS file (M-x load-file RET |
52662
d46a70300b43
Mention regenerating Emacs' AUTHORS file.
Lute Kamstra <lute@gnu.org>
parents:
52401
diff
changeset
|
14 lisp/emacs-lisp/authors.el RET, then M-x authors RET, then save |
d46a70300b43
Mention regenerating Emacs' AUTHORS file.
Lute Kamstra <lute@gnu.org>
parents:
52401
diff
changeset
|
15 the *Authors* buffer). This may require fixing syntactically |
d46a70300b43
Mention regenerating Emacs' AUTHORS file.
Lute Kamstra <lute@gnu.org>
parents:
52401
diff
changeset
|
16 incorrect ChangeLog entries beforehand. |
d46a70300b43
Mention regenerating Emacs' AUTHORS file.
Lute Kamstra <lute@gnu.org>
parents:
52401
diff
changeset
|
17 |
d46a70300b43
Mention regenerating Emacs' AUTHORS file.
Lute Kamstra <lute@gnu.org>
parents:
52401
diff
changeset
|
18 4. Set the version number (M-x load-file RET admin/admin.el RET, then |
48667
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
19 M-x set-version RET). For a release, add released change log |
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
20 entries (M-x add-release-logs RET). |
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
21 |
59969
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
22 5. rm configure; make bootstrap |
48667
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
23 |
87777 | 24 6. Commit configure, README, doc/emacs/emacs.texi, |
25 doc/lispref/elisp.texi, etc/AUTHORS, lisp/version.el, | |
74069
63bb14878bb5
Add three additional files to commit.
Chong Yidong <cyd@stupidchicken.com>
parents:
74066
diff
changeset
|
26 mac/Emacs.app/Contents/Resources/English.lproj/InfoPlist.strings, |
63bb14878bb5
Add three additional files to commit.
Chong Yidong <cyd@stupidchicken.com>
parents:
74066
diff
changeset
|
27 mac/src/Emacs.r, nt/emacs.rc. Copy lisp/loaddefs.el to |
63bb14878bb5
Add three additional files to commit.
Chong Yidong <cyd@stupidchicken.com>
parents:
74066
diff
changeset
|
28 lisp/ldefs-boot.el and commit lisp/ldefs-boot.el. For a release, |
63bb14878bb5
Add three additional files to commit.
Chong Yidong <cyd@stupidchicken.com>
parents:
74066
diff
changeset
|
29 also commit the ChangeLog files in all directories. |
48667
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
30 |
59969
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
31 7. make-dist --snapshot. Check the contents of the new tar with |
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
32 admin/diff-tar-files against an older tar file. Some old pretest |
49345 | 33 tarballs are kept under fencepost.gnu.org:~pot/emacs-pretest/, while |
34 old emacs tarballs are at <ftp://ftp.gnu.org/pub/gnu/emacs/>. | |
48667
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
35 |
59969
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
36 8. xdelta delta emacs-OLD.tar.gz emacs-NEW.tar.gz emacs-OLD-NEW.xdelta |
48667
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
37 |
59969
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
38 9. tar -zxf emacs-NEW.tar.gz; cd emacs-NEW |
61653
4fedc3d06aec
Don't commit lisp/loaddefs.el.
Lute Kamstra <lute@gnu.org>
parents:
59969
diff
changeset
|
39 ./configure && make && make -n install |
48805
bd5cc892ddde
Cleaned up, added reference to make-announce and to emacs-pretest-bug.
Francesco Potortì <pot@gnu.org>
parents:
48670
diff
changeset
|
40 Use `script' or M-x compile to save the compilation log in |
bd5cc892ddde
Cleaned up, added reference to make-announce and to emacs-pretest-bug.
Francesco Potortì <pot@gnu.org>
parents:
48670
diff
changeset
|
41 compile-NEW.log and compare it against an old one. The easiest way |
bd5cc892ddde
Cleaned up, added reference to make-announce and to emacs-pretest-bug.
Francesco Potortì <pot@gnu.org>
parents:
48670
diff
changeset
|
42 to do that is to visit the old log in Emacs, change the version |
bd5cc892ddde
Cleaned up, added reference to make-announce and to emacs-pretest-bug.
Francesco Potortì <pot@gnu.org>
parents:
48670
diff
changeset
|
43 number of the old Emacs to __, do the same with the new log and do |
61653
4fedc3d06aec
Don't commit lisp/loaddefs.el.
Lute Kamstra <lute@gnu.org>
parents:
59969
diff
changeset
|
44 M-x ediff. Especially check that Info files aren't built. |
48667
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
45 |
59969
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
46 10. cd EMACS_ROOT_DIR; cvs tag TAG |
49345 | 47 TAG is EMACS_PRETEST_XX_YY_ZZZ for a pretest, EMACS_XX_YY for a |
48 release. | |
48667
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
49 |
59969
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
50 11. admin/make-announcement OLD NEW |
49345 | 51 This creates an announcement for pretests. OLD is the version used |
59969
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
52 to make deltas with respect to NEW. Announcements for releases need |
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
53 to be crafted by hand. Use an older announcement to start with: |
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
54 look in ssh://fencepost.gnu.org/~pot/emacs-tarballs/. |
48667
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
55 |
59969
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
56 12. Now you should upload the files to the GNU ftp server. In order to |
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
57 do that, you must be registered as an Emacs maintainer and have your |
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
58 GPG key acknowledged by the ftp people. Mail <ftp-upload@gnu.org> |
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
59 for instructions. Once you are there, for each file FILE to be |
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
60 released, create a detached GPG binary signature and a clearsigned |
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
61 directive file like this: |
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
62 gpg -b FILE |
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
63 echo directory: emacs/pretest > FILE.directive (for a pretest) |
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
64 echo directory: emacs > FILE.directive (for a release) |
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
65 gpg --clearsign FILE.directive |
73361
52051ccbb0d0
Fix upload instructions: pretest files should not be uploaded in
Romain Francoise <romain@orebokech.com>
parents:
69702
diff
changeset
|
66 Upload by anonymous ftp to ftp://ftp-upload.gnu.org/ the files FILE, |
52051ccbb0d0
Fix upload instructions: pretest files should not be uploaded in
Romain Francoise <romain@orebokech.com>
parents:
69702
diff
changeset
|
67 FILE.sig, FILE.directive.asc. |
52051ccbb0d0
Fix upload instructions: pretest files should not be uploaded in
Romain Francoise <romain@orebokech.com>
parents:
69702
diff
changeset
|
68 For a release, place the files in the /incoming/ftp directory. |
52051ccbb0d0
Fix upload instructions: pretest files should not be uploaded in
Romain Francoise <romain@orebokech.com>
parents:
69702
diff
changeset
|
69 For a pretest, place the files in /incoming/alpha instead, so that |
52051ccbb0d0
Fix upload instructions: pretest files should not be uploaded in
Romain Francoise <romain@orebokech.com>
parents:
69702
diff
changeset
|
70 they appear on ftp://alpha.gnu.org/. |
48667
7ce5464da6b5
Instructions to create pretest or release tarballs.
Francesco Potortì <pot@gnu.org>
parents:
diff
changeset
|
71 |
59969
6af50633a8f1
ftp upload procedure finally described
Francesco Potortì <pot@gnu.org>
parents:
54148
diff
changeset
|
72 13. After five minutes, verify that the files are visible at |
50201
d0449a23c8d9
Release instructions added.
Francesco Potortì <pot@gnu.org>
parents:
49634
diff
changeset
|
73 ftp://alpha.gnu.org/gnu/emacs/pretest/ for a pretest, at |
d0449a23c8d9
Release instructions added.
Francesco Potortì <pot@gnu.org>
parents:
49634
diff
changeset
|
74 ftp://ftp.gnu.org/gnu/emacs/ for a release. |
48669 | 75 |
87903 | 76 14. For a pretest, let Richard Stallman <rms@gnu.org> know about the new |
77 pretest and tell him to announce it using the announcement you prepared. | |
78 Remind him to set a Reply-to header to <emacs-pretest-bug@gnu.org>. | |
77484
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
79 |
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
80 15. Shortly before the release, cut the branch with the following commands: |
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
81 |
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
82 cvs rtag EMACS_`NUMBER'_BASE |
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
83 cvs rtag -b EMACS_`NUMBER'_RC -r EMACS_`NUMBER'_BASE |
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
84 |
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
85 where `NUMBER' is the major version number of the release. This makes it |
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
86 easier to see what changes have been applied to the branch with: |
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
87 |
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
88 cvs diff -r EMACS_`NUMBER'_BASE -r EMACS_`NUMBER'_RC |
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
89 |
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
90 or merge changes back to the trunk with "cvs update -j", if necessary. |
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
91 |
77502
9a42a4441db4
Mention increasing trunk version number after branching.
Glenn Morris <rgm@gnu.org>
parents:
77485
diff
changeset
|
92 After doing this, increase the version number on the trunk as per step 4. |
9a42a4441db4
Mention increasing trunk version number after branching.
Glenn Morris <rgm@gnu.org>
parents:
77485
diff
changeset
|
93 |
77484
d7dd3448e6d3
Add note about cutting the branch.
Nick Roberts <nickrob@snap.net.nz>
parents:
74069
diff
changeset
|
94 16. For a release, Richard should prepare the announcement himself, |
50201
d0449a23c8d9
Release instructions added.
Francesco Potortì <pot@gnu.org>
parents:
49634
diff
changeset
|
95 possibly starting from a previous announcment. |
52401 | 96 |
97 # arch-tag: c23c771f-ca26-4584-8a04-50ecf0989390 |