aboutsummaryrefslogtreecommitdiffstats
path: root/admin/notes
diff options
context:
space:
mode:
authorJoakim Verona2011-02-05 11:23:09 +0100
committerJoakim Verona2011-02-05 11:23:09 +0100
commit4bd51ad5c3445b644dfb017d5b57b10a90aa325f (patch)
tree894801e7308ce4ecc34933f959e28f4b9cff9533 /admin/notes
parent13cfe8df462ab8da9f0028e16cc84dcaceaca3d1 (diff)
parent9bcaafce5351d270ac514e23cb69ff1a5fd35229 (diff)
downloademacs-4bd51ad5c3445b644dfb017d5b57b10a90aa325f.tar.gz
emacs-4bd51ad5c3445b644dfb017d5b57b10a90aa325f.zip
merge from upstream. currently seems to have bitroted and i get segfaults
Diffstat (limited to 'admin/notes')
-rw-r--r--admin/notes/bugtracker47
-rw-r--r--admin/notes/bzr81
-rw-r--r--admin/notes/copyright39
-rw-r--r--admin/notes/elpa42
-rw-r--r--admin/notes/font-backend3
-rw-r--r--admin/notes/iftc1
-rw-r--r--admin/notes/lel-TODO2
-rw-r--r--admin/notes/multi-tty3
-rw-r--r--admin/notes/trailing-whitespace1
-rw-r--r--admin/notes/unicode3
10 files changed, 193 insertions, 29 deletions
diff --git a/admin/notes/bugtracker b/admin/notes/bugtracker
index 5b3af5e242c..7c6c0ff4272 100644
--- a/admin/notes/bugtracker
+++ b/admin/notes/bugtracker
@@ -384,6 +384,14 @@ fixed 123 23.0.60
384*** To remove a "fixed" mark: 384*** To remove a "fixed" mark:
385notfixed 123 23.0.60 385notfixed 123 23.0.60
386 386
387*** To make a bug as present in a particular version:
388found 123 23.2
389NB if there is no specified "fixed" version, or if there is one and it
390is earlier than the found version, this reopens a closed bug.
391
392The leading "23.1;" that M-x report-emacs-bug adds to bug subjects
393automatically sets a found version (if none is explicitly specified).
394
387*** To assign or reassign a bug to a package or list of packages: 395*** To assign or reassign a bug to a package or list of packages:
388reassign 1234 emacs 396reassign 1234 emacs
389 397
@@ -466,16 +474,41 @@ http://lists.gnu.org/archive/html/emacs-devel/2009-11/msg00440.html
466 474
467** Bazaar stuff 475** Bazaar stuff
468 476
469*** You can use `bzr commit --fixes emacs:123' to mark that a commit fixes 477*** You can use `bzr commit --fixes debbugs:123' to mark that a commit fixes
470Emacs bug 123. You will first need to add a line to your bazaar.conf: 478Emacs bug 123. You will first need to add a line to one of your
479configuration files, ~/.bazaar/bazaar.conf or ~/.bazaar/locations.conf:
480
481bugtracker_debbugs_url = http://debbugs.gnu.org/{id}
482
483Here "{id}" is a literal string, a placeholder that will be replaced
484by the bug number you specify after `--fixes debbugs:' in the bzr
485command line (123 in the example above).
486
487In the bazaar.conf file, this setting should go into the [DEFAULTS]
488section.
489
490In the locations.conf file, it should go into the branch-specific
491configuration section for the branch where you want this to be in
492effect. For example, if you want this to be in effect for the branch
493located at `/home/projects/emacs/trunk', you need to have this in your
494~/.bazaar/locations.conf file:
495
496[/home/projects/emacs/trunk]
497bugtracker_debbugs_url = http://debbugs.gnu.org/{id}
498
499If you want to use this in all Emacs branches whose common parent is
500`/home/projects/emacs', put the setting in the [/home/projects/emacs]
501section. See "bzr help configuration" for more information about
502the *.conf files, their location and formats. See "bzr help bugs" for
503more information about the bugtracker_debbugs_url setting.
471 504
472bugtracker_emacs_url = http://debbugs.gnu.org/{id} 505See also log-edit-rewrite-fixes in .dir-locals.el.
473 506
474Note that all this does is add some metadata to the commit, it doesn't 507Note that all this does is add some metadata to the commit, it doesn't
475actually mark the bug as closed in the tracker. There seems to be no 508actually mark the bug as closed in the tracker. You can see this
476way to see this "metadata" with `bzr log', which is rather poor, but 509information with `bzr log', and it will show up as a link in a recent
477it will show up as a link in a recent loggerhead installation, or with 510loggerhead installation, or with some of the graphical frontends to
478some of the graphical frontends to bzr log. 511`bzr log'.
479 512
480** Gnus-specific voodoo 513** Gnus-specific voodoo
481 514
diff --git a/admin/notes/bzr b/admin/notes/bzr
index c66cdd98a3c..cb2a1bd4e4f 100644
--- a/admin/notes/bzr
+++ b/admin/notes/bzr
@@ -38,3 +38,84 @@ Or use shelves; or rebase; or do something else. See the thread for
38yet another fun excursion into the exciting world of version control. 38yet another fun excursion into the exciting world of version control.
39 39
40http://lists.gnu.org/archive/html/emacs-devel/2010-04/msg00086.html 40http://lists.gnu.org/archive/html/emacs-devel/2010-04/msg00086.html
41
42* Installing changes from gnulib
43Some of the files in Emacs are copied from gnulib. To synchronize
44these files from the version of gnulib that you have checked out into
45a sibling directory of your branch, type "make sync-from-gnulib"; this
46will check out the latest version of gnulib if there is no sibling
47directory already. It is a good idea to run "bzr status" afterwards,
48so that if a gnulib module added a file, you can record the new file
49using "bzr add". After synchronizing from gnulib, do a "make" in the
50usual way.
51
52To change the set of gnulib modules, change the GNULIB_MODULES
53variable in the top-level Makefile.in, and then run:
54
55 ./config.status
56 make sync-from-gnulib
57 bzr status
58
59The last command will mention files that may need to be added using
60"bzr add". If you remove a gnulib module, or if a gnulib module
61removes a file, then remove the corresponding files by hand.
62
63* How to merge changes from emacs-23 to trunk
64
65The following description uses bound branches, presumably it works in
66a similar way with unbound ones.
67
681) Get clean, up-to-date copies of the emacs-23 and trunk branches.
69Check for any uncommitted changes with bzr status.
70
712) M-x cd /path/to/trunk
72
733) load admin/bzrmerge.el
74
754) M-x bzrmerge RET /path/to/emacs-23 RET
76
77It will prompt about revisions that should be skipped, based on the
78regexp in bzrmerge-missing. If there are more revisions that you know
79need skipping, you'll have to do that by hand.
80
815) It will stop if there are any conflicts. Resolve them.
82Using smerge-mode, there are menu items to skip to the next conflict,
83and to take either the trunk, branch, or both copies.
84
856) After resolving all conflicts, you might need to run the bzmerge
86command again if there are more revisions still to merge.
87
88Do not commit (or exit Emacs) until you have run bzrmerge to completion.
89
90Before committing, check bzr status and bzr diff output.
91If you have run bzrmerge enough times, the "pending merge tip" in bzr
92status should be the last revision from the emacs-23 branch, and
93bzr status -v should show all the revisions you expect to merge.
94
95(Note that it will also show "skipped" revisions. This is expected,
96and is due to a technical limitation of bzr. The log data for those
97revisions gets merged, the actual changes themselves do not.
98http://lists.gnu.org/archive/html/emacs-devel/2011-01/msg00609.html )
99
100Note that ChangeLog entries are automatically merged to the top with
101today's date, but you still might want to check them to see that too
102much is not being included, or whitespace between entries is not missing.
103
104Notes:
105
1061) A lot that was in tramp.el in emacs-23 has moved to tramp-sh.el in
107the trunk. If you end up with a conflict in tramp.el, the changes may
108need to go to tramp-sh.el instead. Remember to update the file name in
109the ChangeLog.
110
1112) If a file is modified in emacs-23, and deleted in the trunk, you
112get a "contents conflict". Assuming the changes don't need to be in
113the trunk at all, use `bzr resolve path/to/file --take-this' to keep the
114trunk version. Prior to bzr 2.2.3, this may fail. You can just
115delete the .OTHER etc files by hand and use bzr resolve path/to/file.
116
1173) Conflicts in autoload md5sums in comments. Strictly speaking, the
118right thing to do is merge everything else, resolve the conflict by
119choosing either the trunk or branch version, then run `make -C lisp
120autoloads' to update the md5sums to the correct trunk value before
121committing.
diff --git a/admin/notes/copyright b/admin/notes/copyright
index e0389212304..e4077caf77b 100644
--- a/admin/notes/copyright
+++ b/admin/notes/copyright
@@ -1,4 +1,4 @@
1Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. 1Copyright (C) 2007-2011 Free Software Foundation, Inc.
2See the end of the file for license conditions. 2See the end of the file for license conditions.
3 3
4 4
@@ -132,10 +132,18 @@ Cocoa/Emacs.base/Contents/Resources/English.lproj/InfoPlist.strings
132GNUstep/Emacs.base/Resources/Info-gnustep.plist 132GNUstep/Emacs.base/Resources/Info-gnustep.plist
133 `set-copyright' in admin.el will do all the above. 133 `set-copyright' in admin.el will do all the above.
134 134
135<top-level>/install-sh 135aclocal.m4
136lispintro/install-sh 136configure
137m4/*.m4
138 - copyright FSF, with unlimited permission to copy, distribute and modify
139
140lib/Makefile.in
141 - copyright FSF, with MIT-like license
142
143install-sh
137 - this file is copyright MIT, which is OK. Leave the copyright alone. 144 - this file is copyright MIT, which is OK. Leave the copyright alone.
138 145
146mkinstalldirs
139src/m/news-r6.h 147src/m/news-r6.h
140 public domain, leave alone. 148 public domain, leave alone.
141 149
@@ -218,9 +226,6 @@ lib-src/etags.c
218 --version output just says "Copyright <year> FSF" is apparently OK 226 --version output just says "Copyright <year> FSF" is apparently OK
219 from a legal point of view. 227 from a legal point of view.
220 228
221lib-src/getopt1.c, getopt_int.h
222 - these are from the GNU C library. Leave the copyrights alone.
223
224lisp/cedet/semantic/imenu.el 229lisp/cedet/semantic/imenu.el
225 - See http://lists.gnu.org/archive/html/emacs-devel/2010-03/msg00410.html 230 - See http://lists.gnu.org/archive/html/emacs-devel/2010-03/msg00410.html
226 in which Eric Ludlam established that the remaining contributions 231 in which Eric Ludlam established that the remaining contributions
@@ -329,6 +334,9 @@ Leave the copyrights alone. Leave the Eli Zaretskii copyright in
329is_exec.c alone. See the msdos/README file for the legal history of 334is_exec.c alone. See the msdos/README file for the legal history of
330these files. 335these files.
331 336
337msdos/sed*.inp - These files are copyright FSF and distributed under
338an MIT-like license.
339
332 340
333oldXMenu/ 341oldXMenu/
334 Keep the "copyright.h" method used by X11, rather than moving the 342 Keep the "copyright.h" method used by X11, rather than moving the
@@ -611,20 +619,25 @@ of writing) GPL >= 2. rms says may as well leave the licenses of these
611alone (may import them from Gnulib again). These are: 619alone (may import them from Gnulib again). These are:
612 620
613 Gnulib: 621 Gnulib:
622 arg-nonnull.h
623 c++defs.h
624 compile
625 config.guess
626 config.sub
627 depcomp
628 doc/man/texinfo.tex
629 missing
630 move-if-change
631 warn-on-use.h
632 lib/*.[ch]
633 lib/gnulib.mk
614 src/getloadavg.c 634 src/getloadavg.c
615 src/gmalloc.c 635 src/gmalloc.c
616 src/md5.c 636 src/md5.c
617 src/md5.h 637 src/md5.h
618 src/mktime.c
619 src/strftime.c
620 src/termcap.c 638 src/termcap.c
621 src/tparam.c 639 src/tparam.c
622 640
623 Others:
624 config.guess
625 config.sub
626 doc/man/texinfo.tex
627
628Note _not_ included in the above are src/regex.{c,h} (rms: "That 641Note _not_ included in the above are src/regex.{c,h} (rms: "That
629forked version is only in Emacs, so definitely relicense that."), and 642forked version is only in Emacs, so definitely relicense that."), and
630oldXMenu/insque.c (rms: "We wrote that specifically for Emacs, so 643oldXMenu/insque.c (rms: "We wrote that specifically for Emacs, so
diff --git a/admin/notes/elpa b/admin/notes/elpa
new file mode 100644
index 00000000000..e28d81e6d6e
--- /dev/null
+++ b/admin/notes/elpa
@@ -0,0 +1,42 @@
1NOTES ON THE EMACS PACKAGE ARCHIVE
2
3Here are instructions on uploading files to the package archive at
4elpa.gnu.org, for Emacs maintainers. (If you are not a maintainer,
5contact us if you want to submit a package.)
6
71. You will need login access to elpa.gnu.org. You will also need to
8 get the FSF sysadmins to allow ssh access through the FSF firewall
9 for your local machine. Ensure that your uid, USER, is in the
10 `elpa' group on elpa.gnu.org; this gives you write access to the
11 bzr repository from which the packages are managed.
12
132. Go to your bzr repository on your local machine. Of, if you don't
14 have one (you should, if you're tracking Emacs bzr), make one:
15
16 cd $DEVHOME
17 bzr init-repo elpa/
18 cd elpa
19
20 Create a branch for elpa:
21
22 bzr branch bzr+ssh://USER@elpa.gnu.org/home/elpa/package-repo package-repo
23
24 Bind the branch:
25
26 cd package-repo/
27 echo "public_branch = bzr+ssh://USER@elpa.gnu.org/home/elpa/package-repo" >> .bzr/branch/branch.conf
28 bzr bind bzr+ssh://USER@elpa.gnu.org/home/elpa/package-repo
29
30 Now you should be able to do `bzr up' and `bzr commit'.
31
323. Changes in bzr do not immediately propagate to the user-facing tree
33 (i.e., what users see when they do `M-x list-packages'). That tree
34 is created by a (daily) cron job that does "bzr export". If for
35 some reason you need to refresh the user-facing tree immediately,
36 run /home/elpa/bin/package-update.sh as the "elpa" user.
37
38 The Org mode dailies are not part of the repository. After the
39 package-update.sh script creates the user-facing tree, it copies
40 the daily tarfile hosted on orgmode.org directly into that tree.
41
424. FIXME: How to actually upload a package file.
diff --git a/admin/notes/font-backend b/admin/notes/font-backend
index d3fb56a2ba4..d51d3ec1c3b 100644
--- a/admin/notes/font-backend
+++ b/admin/notes/font-backend
@@ -1,5 +1,4 @@
1Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 1Copyright (C) 2002-2011 Free Software Foundation, Inc.
2 Free Software Foundation, Inc.
3See the end of the file for license conditions. 2See the end of the file for license conditions.
4 3
5 4
diff --git a/admin/notes/iftc b/admin/notes/iftc
index e8dcdd3a6d6..983b1486685 100644
--- a/admin/notes/iftc
+++ b/admin/notes/iftc
@@ -24,4 +24,3 @@ it from other casting. We commit the changes and can now go about modifying
24LOW and HIGH separately. When HIGH is ready to handle the type change, the 24LOW and HIGH separately. When HIGH is ready to handle the type change, the
25cast can be removed. 25cast can be removed.
26 26
27;;; arch-tag: 3309cc41-5d59-421b-b7be-c94b04083bb5
diff --git a/admin/notes/lel-TODO b/admin/notes/lel-TODO
index 2e453444275..c03d0f6fdfb 100644
--- a/admin/notes/lel-TODO
+++ b/admin/notes/lel-TODO
@@ -1,6 +1,6 @@
1Some lisp/emacs-lisp/ Features and Where They Are Documented 1Some lisp/emacs-lisp/ Features and Where They Are Documented
2 2
3Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. 3Copyright (C) 2007-2011 Free Software Foundation, Inc.
4See the end of the file for license conditions. 4See the end of the file for license conditions.
5 5
6 6
diff --git a/admin/notes/multi-tty b/admin/notes/multi-tty
index d7f68930204..85babb903b9 100644
--- a/admin/notes/multi-tty
+++ b/admin/notes/multi-tty
@@ -1,6 +1,6 @@
1-*- coding: utf-8; mode: text; -*- 1-*- coding: utf-8; mode: text; -*-
2 2
3Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. 3Copyright (C) 2007-2011 Free Software Foundation, Inc.
4See the end of the file for license conditions. 4See the end of the file for license conditions.
5 5
6From README.multi-tty in the multi-tty branch. 6From README.multi-tty in the multi-tty branch.
@@ -1360,4 +1360,3 @@ GNU General Public License for more details.
1360You should have received a copy of the GNU General Public License 1360You should have received a copy of the GNU General Public License
1361along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. 1361along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
1362 1362
1363;;; arch-tag: 8da1619e-2e79-41a8-9ac9-a0485daad17d
diff --git a/admin/notes/trailing-whitespace b/admin/notes/trailing-whitespace
index e29456b3a2f..8c85b8984d5 100644
--- a/admin/notes/trailing-whitespace
+++ b/admin/notes/trailing-whitespace
@@ -5,4 +5,3 @@ there was a mass-change to remove such from various branches in cvs. probably
5it's a good idea to avoid adding trailing whitespace in new code/docs and in 5it's a good idea to avoid adding trailing whitespace in new code/docs and in
6changes. 6changes.
7 7
8;;; arch-tag: de441379-c345-4826-a784-352b5413a698
diff --git a/admin/notes/unicode b/admin/notes/unicode
index a9176377dad..ce7d3732f03 100644
--- a/admin/notes/unicode
+++ b/admin/notes/unicode
@@ -1,7 +1,6 @@
1 -*-mode: text; coding: latin-1;-*- 1 -*-mode: text; coding: latin-1;-*-
2 2
3Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 3Copyright (C) 2002-2011 Free Software Foundation, Inc.
4 Free Software Foundation, Inc.
5See the end of the file for license conditions. 4See the end of the file for license conditions.
6 5
7Problems, fixmes and other unicode-related issues 6Problems, fixmes and other unicode-related issues