diff options
| author | Joakim Verona | 2011-02-05 11:23:09 +0100 |
|---|---|---|
| committer | Joakim Verona | 2011-02-05 11:23:09 +0100 |
| commit | 4bd51ad5c3445b644dfb017d5b57b10a90aa325f (patch) | |
| tree | 894801e7308ce4ecc34933f959e28f4b9cff9533 /admin/notes | |
| parent | 13cfe8df462ab8da9f0028e16cc84dcaceaca3d1 (diff) | |
| parent | 9bcaafce5351d270ac514e23cb69ff1a5fd35229 (diff) | |
| download | emacs-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/bugtracker | 47 | ||||
| -rw-r--r-- | admin/notes/bzr | 81 | ||||
| -rw-r--r-- | admin/notes/copyright | 39 | ||||
| -rw-r--r-- | admin/notes/elpa | 42 | ||||
| -rw-r--r-- | admin/notes/font-backend | 3 | ||||
| -rw-r--r-- | admin/notes/iftc | 1 | ||||
| -rw-r--r-- | admin/notes/lel-TODO | 2 | ||||
| -rw-r--r-- | admin/notes/multi-tty | 3 | ||||
| -rw-r--r-- | admin/notes/trailing-whitespace | 1 | ||||
| -rw-r--r-- | admin/notes/unicode | 3 |
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: |
| 385 | notfixed 123 23.0.60 | 385 | notfixed 123 23.0.60 |
| 386 | 386 | ||
| 387 | *** To make a bug as present in a particular version: | ||
| 388 | found 123 23.2 | ||
| 389 | NB if there is no specified "fixed" version, or if there is one and it | ||
| 390 | is earlier than the found version, this reopens a closed bug. | ||
| 391 | |||
| 392 | The leading "23.1;" that M-x report-emacs-bug adds to bug subjects | ||
| 393 | automatically 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: |
| 388 | reassign 1234 emacs | 396 | reassign 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 |
| 470 | Emacs bug 123. You will first need to add a line to your bazaar.conf: | 478 | Emacs bug 123. You will first need to add a line to one of your |
| 479 | configuration files, ~/.bazaar/bazaar.conf or ~/.bazaar/locations.conf: | ||
| 480 | |||
| 481 | bugtracker_debbugs_url = http://debbugs.gnu.org/{id} | ||
| 482 | |||
| 483 | Here "{id}" is a literal string, a placeholder that will be replaced | ||
| 484 | by the bug number you specify after `--fixes debbugs:' in the bzr | ||
| 485 | command line (123 in the example above). | ||
| 486 | |||
| 487 | In the bazaar.conf file, this setting should go into the [DEFAULTS] | ||
| 488 | section. | ||
| 489 | |||
| 490 | In the locations.conf file, it should go into the branch-specific | ||
| 491 | configuration section for the branch where you want this to be in | ||
| 492 | effect. For example, if you want this to be in effect for the branch | ||
| 493 | located at `/home/projects/emacs/trunk', you need to have this in your | ||
| 494 | ~/.bazaar/locations.conf file: | ||
| 495 | |||
| 496 | [/home/projects/emacs/trunk] | ||
| 497 | bugtracker_debbugs_url = http://debbugs.gnu.org/{id} | ||
| 498 | |||
| 499 | If 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] | ||
| 501 | section. See "bzr help configuration" for more information about | ||
| 502 | the *.conf files, their location and formats. See "bzr help bugs" for | ||
| 503 | more information about the bugtracker_debbugs_url setting. | ||
| 471 | 504 | ||
| 472 | bugtracker_emacs_url = http://debbugs.gnu.org/{id} | 505 | See also log-edit-rewrite-fixes in .dir-locals.el. |
| 473 | 506 | ||
| 474 | Note that all this does is add some metadata to the commit, it doesn't | 507 | Note that all this does is add some metadata to the commit, it doesn't |
| 475 | actually mark the bug as closed in the tracker. There seems to be no | 508 | actually mark the bug as closed in the tracker. You can see this |
| 476 | way to see this "metadata" with `bzr log', which is rather poor, but | 509 | information with `bzr log', and it will show up as a link in a recent |
| 477 | it will show up as a link in a recent loggerhead installation, or with | 510 | loggerhead installation, or with some of the graphical frontends to |
| 478 | some 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 | |||
| 38 | yet another fun excursion into the exciting world of version control. | 38 | yet another fun excursion into the exciting world of version control. |
| 39 | 39 | ||
| 40 | http://lists.gnu.org/archive/html/emacs-devel/2010-04/msg00086.html | 40 | http://lists.gnu.org/archive/html/emacs-devel/2010-04/msg00086.html |
| 41 | |||
| 42 | * Installing changes from gnulib | ||
| 43 | Some of the files in Emacs are copied from gnulib. To synchronize | ||
| 44 | these files from the version of gnulib that you have checked out into | ||
| 45 | a sibling directory of your branch, type "make sync-from-gnulib"; this | ||
| 46 | will check out the latest version of gnulib if there is no sibling | ||
| 47 | directory already. It is a good idea to run "bzr status" afterwards, | ||
| 48 | so that if a gnulib module added a file, you can record the new file | ||
| 49 | using "bzr add". After synchronizing from gnulib, do a "make" in the | ||
| 50 | usual way. | ||
| 51 | |||
| 52 | To change the set of gnulib modules, change the GNULIB_MODULES | ||
| 53 | variable in the top-level Makefile.in, and then run: | ||
| 54 | |||
| 55 | ./config.status | ||
| 56 | make sync-from-gnulib | ||
| 57 | bzr status | ||
| 58 | |||
| 59 | The 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 | ||
| 61 | removes a file, then remove the corresponding files by hand. | ||
| 62 | |||
| 63 | * How to merge changes from emacs-23 to trunk | ||
| 64 | |||
| 65 | The following description uses bound branches, presumably it works in | ||
| 66 | a similar way with unbound ones. | ||
| 67 | |||
| 68 | 1) Get clean, up-to-date copies of the emacs-23 and trunk branches. | ||
| 69 | Check for any uncommitted changes with bzr status. | ||
| 70 | |||
| 71 | 2) M-x cd /path/to/trunk | ||
| 72 | |||
| 73 | 3) load admin/bzrmerge.el | ||
| 74 | |||
| 75 | 4) M-x bzrmerge RET /path/to/emacs-23 RET | ||
| 76 | |||
| 77 | It will prompt about revisions that should be skipped, based on the | ||
| 78 | regexp in bzrmerge-missing. If there are more revisions that you know | ||
| 79 | need skipping, you'll have to do that by hand. | ||
| 80 | |||
| 81 | 5) It will stop if there are any conflicts. Resolve them. | ||
| 82 | Using smerge-mode, there are menu items to skip to the next conflict, | ||
| 83 | and to take either the trunk, branch, or both copies. | ||
| 84 | |||
| 85 | 6) After resolving all conflicts, you might need to run the bzmerge | ||
| 86 | command again if there are more revisions still to merge. | ||
| 87 | |||
| 88 | Do not commit (or exit Emacs) until you have run bzrmerge to completion. | ||
| 89 | |||
| 90 | Before committing, check bzr status and bzr diff output. | ||
| 91 | If you have run bzrmerge enough times, the "pending merge tip" in bzr | ||
| 92 | status should be the last revision from the emacs-23 branch, and | ||
| 93 | bzr status -v should show all the revisions you expect to merge. | ||
| 94 | |||
| 95 | (Note that it will also show "skipped" revisions. This is expected, | ||
| 96 | and is due to a technical limitation of bzr. The log data for those | ||
| 97 | revisions gets merged, the actual changes themselves do not. | ||
| 98 | http://lists.gnu.org/archive/html/emacs-devel/2011-01/msg00609.html ) | ||
| 99 | |||
| 100 | Note that ChangeLog entries are automatically merged to the top with | ||
| 101 | today's date, but you still might want to check them to see that too | ||
| 102 | much is not being included, or whitespace between entries is not missing. | ||
| 103 | |||
| 104 | Notes: | ||
| 105 | |||
| 106 | 1) A lot that was in tramp.el in emacs-23 has moved to tramp-sh.el in | ||
| 107 | the trunk. If you end up with a conflict in tramp.el, the changes may | ||
| 108 | need to go to tramp-sh.el instead. Remember to update the file name in | ||
| 109 | the ChangeLog. | ||
| 110 | |||
| 111 | 2) If a file is modified in emacs-23, and deleted in the trunk, you | ||
| 112 | get a "contents conflict". Assuming the changes don't need to be in | ||
| 113 | the trunk at all, use `bzr resolve path/to/file --take-this' to keep the | ||
| 114 | trunk version. Prior to bzr 2.2.3, this may fail. You can just | ||
| 115 | delete the .OTHER etc files by hand and use bzr resolve path/to/file. | ||
| 116 | |||
| 117 | 3) Conflicts in autoload md5sums in comments. Strictly speaking, the | ||
| 118 | right thing to do is merge everything else, resolve the conflict by | ||
| 119 | choosing either the trunk or branch version, then run `make -C lisp | ||
| 120 | autoloads' to update the md5sums to the correct trunk value before | ||
| 121 | committing. | ||
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 @@ | |||
| 1 | Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. | 1 | Copyright (C) 2007-2011 Free Software Foundation, Inc. |
| 2 | See the end of the file for license conditions. | 2 | See 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 | |||
| 132 | GNUstep/Emacs.base/Resources/Info-gnustep.plist | 132 | GNUstep/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 | 135 | aclocal.m4 |
| 136 | lispintro/install-sh | 136 | configure |
| 137 | m4/*.m4 | ||
| 138 | - copyright FSF, with unlimited permission to copy, distribute and modify | ||
| 139 | |||
| 140 | lib/Makefile.in | ||
| 141 | - copyright FSF, with MIT-like license | ||
| 142 | |||
| 143 | install-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 | ||
| 146 | mkinstalldirs | ||
| 139 | src/m/news-r6.h | 147 | src/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 | ||
| 221 | lib-src/getopt1.c, getopt_int.h | ||
| 222 | - these are from the GNU C library. Leave the copyrights alone. | ||
| 223 | |||
| 224 | lisp/cedet/semantic/imenu.el | 229 | lisp/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 | |||
| 329 | is_exec.c alone. See the msdos/README file for the legal history of | 334 | is_exec.c alone. See the msdos/README file for the legal history of |
| 330 | these files. | 335 | these files. |
| 331 | 336 | ||
| 337 | msdos/sed*.inp - These files are copyright FSF and distributed under | ||
| 338 | an MIT-like license. | ||
| 339 | |||
| 332 | 340 | ||
| 333 | oldXMenu/ | 341 | oldXMenu/ |
| 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 | |||
| 611 | alone (may import them from Gnulib again). These are: | 619 | alone (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 | |||
| 628 | Note _not_ included in the above are src/regex.{c,h} (rms: "That | 641 | Note _not_ included in the above are src/regex.{c,h} (rms: "That |
| 629 | forked version is only in Emacs, so definitely relicense that."), and | 642 | forked version is only in Emacs, so definitely relicense that."), and |
| 630 | oldXMenu/insque.c (rms: "We wrote that specifically for Emacs, so | 643 | oldXMenu/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 @@ | |||
| 1 | NOTES ON THE EMACS PACKAGE ARCHIVE | ||
| 2 | |||
| 3 | Here are instructions on uploading files to the package archive at | ||
| 4 | elpa.gnu.org, for Emacs maintainers. (If you are not a maintainer, | ||
| 5 | contact us if you want to submit a package.) | ||
| 6 | |||
| 7 | 1. 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 | |||
| 13 | 2. 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 | |||
| 32 | 3. 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 | |||
| 42 | 4. 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 @@ | |||
| 1 | Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 | 1 | Copyright (C) 2002-2011 Free Software Foundation, Inc. |
| 2 | Free Software Foundation, Inc. | ||
| 3 | See the end of the file for license conditions. | 2 | See 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 | |||
| 24 | LOW and HIGH separately. When HIGH is ready to handle the type change, the | 24 | LOW and HIGH separately. When HIGH is ready to handle the type change, the |
| 25 | cast can be removed. | 25 | cast 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 @@ | |||
| 1 | Some lisp/emacs-lisp/ Features and Where They Are Documented | 1 | Some lisp/emacs-lisp/ Features and Where They Are Documented |
| 2 | 2 | ||
| 3 | Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. | 3 | Copyright (C) 2007-2011 Free Software Foundation, Inc. |
| 4 | See the end of the file for license conditions. | 4 | See 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 | ||
| 3 | Copyright (C) 2007, 2008, 2009, 2010 Free Software Foundation, Inc. | 3 | Copyright (C) 2007-2011 Free Software Foundation, Inc. |
| 4 | See the end of the file for license conditions. | 4 | See the end of the file for license conditions. |
| 5 | 5 | ||
| 6 | From README.multi-tty in the multi-tty branch. | 6 | From README.multi-tty in the multi-tty branch. |
| @@ -1360,4 +1360,3 @@ GNU General Public License for more details. | |||
| 1360 | You should have received a copy of the GNU General Public License | 1360 | You should have received a copy of the GNU General Public License |
| 1361 | along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. | 1361 | along 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 | |||
| 5 | it's a good idea to avoid adding trailing whitespace in new code/docs and in | 5 | it's a good idea to avoid adding trailing whitespace in new code/docs and in |
| 6 | changes. | 6 | changes. |
| 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 | ||
| 3 | Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 | 3 | Copyright (C) 2002-2011 Free Software Foundation, Inc. |
| 4 | Free Software Foundation, Inc. | ||
| 5 | See the end of the file for license conditions. | 4 | See the end of the file for license conditions. |
| 6 | 5 | ||
| 7 | Problems, fixmes and other unicode-related issues | 6 | Problems, fixmes and other unicode-related issues |