view admin/FOR-RELEASE @ 110523:a5ad4f188e19

Synch Semantic to CEDET 1.0. Move CEDET ChangeLog entries to new file lisp/cedet/ChangeLog. * semantic.el (semantic-version): Update to 2.0. (semantic-mode-map): Add "," and "m" bindings. (navigate-menu): Update. * semantic/symref.el (semantic-symref-calculate-rootdir): New function. (semantic-symref-detect-symref-tool): Use it. * semantic/symref/grep.el (semantic-symref-grep-shell): New var. (semantic-symref-perform-search): Use it. Calculate root dir with semantic-symref-calculate-rootdir. (semantic-symref-derive-find-filepatterns): Improve error message. * semantic/symref/list.el (semantic-symref-results-mode-map): New bindings. (semantic-symref-auto-expand-results): New option. (semantic-symref-results-dump): Obey auto-expand. (semantic-symref-list-expand-all, semantic-symref-regexp) (semantic-symref-list-contract-all) (semantic-symref-list-map-open-hits) (semantic-symref-list-update-open-hits) (semantic-symref-list-create-macro-on-open-hit) (semantic-symref-list-call-macro-on-open-hits): New functions. (semantic-symref-list-menu-entries) (semantic-symref-list-menu): New vars. (semantic-symref-list-map-open-hits): Move cursor to beginning of match before calling the mapped function. * semantic/doc.el (semantic-documentation-comment-preceeding-tag): Do nothing if the mode doesn't provide comment-start-skip. * semantic/scope.el (semantic-analyze-scope-nested-tags-default): Strip duplicates. (semantic-analyze-scoped-inherited-tag-map): Take the tag we are looking for as part of the scoped tags list. * semantic/html.el (semantic-default-html-setup): Add senator-step-at-tag-classes. * semantic/decorate/include.el (semantic-decoration-on-unknown-includes): Change light bgcolor. (semantic-decoration-on-includes-highlight-default): Check that the include tag has a postion. * semantic/complete.el (semantic-collector-local-members): (semantic-complete-read-tag-local-members) (semantic-complete-jump-local-members): New class and functions. (semantic-complete-self-insert): Save excursion before completing. * semantic/analyze/complete.el (semantic-analyze-possible-completions-default): If no completions are found, return the raw by-name-only completion list. Add FLAGS arguments. Add support for 'no-tc (type constraint) and 'no-unique, or no stripping duplicates. (semantic-analyze-possible-completions-default): Add FLAGS arg. * semantic/util-modes.el (semantic-stickyfunc-show-only-functions-p): New option. (semantic-stickyfunc-fetch-stickyline): Don't show stickytext for the very first line in a buffer. * semantic/util.el (semantic-hack-search) (semantic-recursive-find-nonterminal-by-name) (semantic-current-tag-interactive): Deleted. (semantic-describe-buffer): Fix expand-nonterminal. Add lex-syntax-mods, type relation separator char, and command separation char. (semantic-sanity-check): Only message if called interactively. * semantic/tag.el (semantic-tag-deep-copy-one-tag): Copy the :filename property and the tag position. * semantic/lex-spp.el (semantic-lex-spp-lex-text-string): Add recursion limit. * semantic/imenu.el (semantic-imenu-bucketize-type-members): Make this buffer local, not the obsoleted variable. * semantic/idle.el: Add breadcrumbs support. (semantic-idle-summary-current-symbol-info-default) (semantic-idle-tag-highlight) (semantic-idle-completion-list-default): Use semanticdb-without-unloaded-file-searches for speed, and to conform to the controls that specify if the idle timer is supposed to be parsing unparsed includes. (semantic-idle-symbol-highlight-face) (semantic-idle-symbol-maybe-highlight): Rename from *-summary-*. Callers changed. (semantic-idle-work-parse-neighboring-files-flag): Default to nil. (semantic-idle-work-update-headers-flag): New var. (semantic-idle-work-for-one-buffer): Use it. (semantic-idle-local-symbol-highlight): Rename from semantic-idle-tag-highlight. (semantic-idle-truncate-long-summaries): New option. * semantic/ia.el (semantic-ia-cache) (semantic-ia-get-completions): Deleted. Callers changed. (semantic-ia-show-variants): New command. (semantic-ia-show-doc): If doc is empty, don't make a temp buffer. (semantic-ia-show-summary): If there isn't anything to show, say so. * semantic/grammar.el (semantic-grammar-create-package): Save the buffer even in batch mode. * semantic/fw.el (semanticdb-without-unloaded-file-searches): New macro. * semantic/dep.el (semantic-dependency-find-file-on-path): Fix case dereferencing ede-object when it is a list. * semantic/db-typecache.el (semanticdb-expand-nested-tag) (semanticdb-typecache-faux-namespace): New functions. (semanticdb-typecache-file-tags) (semanticdb-typecache-merge-streams): Use them. (semanticdb-typecache-file-tags): When deriving tags from a file, give the mode a chance to monkey with the tag copy. (semanticdb-typecache-find-default): Wrap find in save-excursion. (semanticdb-typecache-find-by-name-helper): Merge found names down. * semantic/db-global.el (semanticdb-enable-gnu-global-in-buffer): Don't show messages if GNU Global is not available and we don't want to throw an error. * semantic/db-find.el (semanticdb-find-result-nth-in-buffer): When trying to normalize the tag to a buffer, don't error if set-buffer method doesn't exist. * semantic/db-file.el (semanticdb-save-db): Simplify msg. * semantic/db.el (semanticdb-refresh-table): If forcing a refresh on a file not in a buffer, use semantic-find-file-noselect and delete the buffer after use. (semanticdb-current-database-list): When calculating root via hooks, force it through true-filename and skip the list of possible roots. * semantic/ctxt.el (semantic-ctxt-imported-packages): New. * semantic/analyze/debug.el (semantic-analyzer-debug-insert-tag): Reset standard output to current buffer. (semantic-analyzer-debug-global-symbol) (semantic-analyzer-debug-missing-innertype): Change "prefix" to "symbol" in messages. * semantic/analyze/refs.el: (semantic-analyze-refs-impl) (semantic-analyze-refs-proto): When calculating value, make sure the found tag is 'similar' to the originating tag. (semantic--analyze-refs-find-tags-with-parent): Attempt to identify matches via imported symbols of parents. (semantic--analyze-refs-full-lookup-with-parents): Do a deep search during the brute search. * semantic/analyze.el (semantic-analyze-find-tag-sequence-default): Be robust to calculated scopes being nil. * semantic/bovine/c.el (semantic-c-describe-environment): Add project macro symbol array. (semantic-c-parse-lexical-token): Add recursion limit. (semantic-ctxt-imported-packages, semanticdb-expand-nested-tag): New overrides. (semantic-expand-c-tag-namelist): Split a full type from a typedef out to its own tag. (semantic-expand-c-tag-namelist): Do not split out a typedef'd inline type if it is an anonymous type. (semantic-c-reconstitute-token): Use the optional initializers as a clue that some function is probably a constructor. When defining the type of these constructors, split the parent name, and use only the class part, if applicable. * semantic/bovine/c-by.el: * semantic/wisent/python-wy.el: Regenerate.

Tasks needed before the next release.

* TO BE DONE SHORTLY BEFORE RELEASE

** Manuals
Check cross-references between the manuals (eg from emacs to elisp)
are correct.  You can use something like the following in the info
directory in the Emacs build tree:

emacs -Q --eval "(setq Info-default-directory-list '(\".\"))" \
  -f info-xref-check-all

make emacs.dvi, elisp.dvi, and deal with any errors (undefined
references etc) in the output.  Break any overfull lines.
Underfull hboxes are not serious, but it can be nice to get rid of
them if a simple rephrasing or rearrangement will work.

Update the master menu and detailed menu (eg the antinews version).
The command texinfo-multiple-files-update can do this, but you
probably want to apply the results selectively (eg the current master
menu has better line-breaks than the automatic version).  It includes
the menu-entry name (if there is one) as well as the node name - using
only the latter looks better.  Also, it doesn't seem to handle nested
includes, so will miss edebug.texi etc.

Check for widow and orphan lines in the printed manual; make sure all
the pages really look ok in the manual as formatted.  Orphans/widows
are cases where the first/last line of a paragraph is on its own at
the end/start of a page, or where the last word in a paragraph is on
its own at the start of a line.  It looks better if you reword/respace
things to avoid these.  (AFAIK, there is no way to find these except
paging through the whole manual.)  This should be the very last thing
you do, since any change can alter the layout.

** Check the keybindings in the refcards are correct, and add any new ones.
Regenerate the pdf versions in etc/refcards/.
What paper size are the English versions supposed to be on?
On Debian testing, the packages texlive-lang-czechslovak and
texlive-lang-polish will let you generate the cs-* and sk-* pdfs.
The Makefile rules did not work for me, I had to use something like:
csplain -output-format=pdf cs-refcard

** Ask maintainers of refcard translations to update them.

Emacs 22 translators:

LANG	Translator            Status
cs	Pavel Janík           
de	Sven Joachim          
fr	Eric Jacoboni         
pl	Włodek Bzyl           
pt-br	Rodrigo Real          
ru	Alex Ott              
sk	Miroslav Vaško        

** Remove temporary +++/--- lines in NEWS.

** Try to reorder NEWS: most important things first, related items together.

** Consider bumping customize-changed-options-previous-release.

* BUGS

** Does deleting frames run Lisp code?  If so, can we get rid of that?
It is a dangerous design.
http://lists.gnu.org/archive/html/emacs-devel/2007-09/msg01330.html

** Why were the calls to x_fully_uncatch_errors commented out in eval.c?
http://lists.gnu.org/archive/html/emacs-devel/2007-09/msg01987.html

** rms: gnus-dired.el is a mistake.  Those features should not
be part of Gnus.  They should be moved to some other part of Emacs.
rsteib: Gnus dependencies in `gnus-dired.el' (and `mailcap.el') have been
minimized.  I don't know what is left to do here.

** Check for modes which bind M-s that conflicts with a new global binding M-s
and change key bindings where necessary.  The current list of modes:

1. Gnus binds `M-s' to `gnus-summary-search-article-forward'.

2. Minibuffer binds `M-s' to `next-matching-history-element'
   (not useful any more since C-s can now search in the history).

3. `center-line' in Text mode was already moved to the text formatting
   keymap as `M-o M-s' (thus this binding is not necessary any more
   in `nroff-mode-map' too and can be removed now from the nroff mode
   because it can now use the global key binding `M-o M-s' `center-line').

4. PCL-CVS binds `M-s' to `cvs-status', and log-edit-mode binds it to
   `log-edit-comment-search-forward'.  Perhaps search commands
   on the global key binding `M-s' are useless in these modes.

** [e-mail], 30 Oct: ps-lpr-switches has no effect
http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg02091.html

Fixed by this change?

2007-11-09  Vinicius Jose Latorre  <[e-mail]>

	* ps-print.el: [...]
	(ps-do-despool): If ps-lpr-switches is not a list, force it to be one.

** In C, use EMACS_INT for variables and structure members
for buffer/string positions.  E.g. struct it, struct text_pos.

* DOCUMENTATION

** Clean up Emacs.app references in code and documentation.

** Document new font backend

** Document XEmbed support

** Check the Emacs Tutorial.

The first line of every tutorial must begin with text ending in a
period (".", ASCII 0x2E) saying "Emacs Tutorial" in the respective
language. This should be followed by "See end for copying conditions",
likewise in the respective language.

After each file name, on the same line or the following line, come the
names of the people who have checked it.

SECTION                  READERS
----------------------------------
etc/TUTORIAL             rgm (but see Bug#3783)
etc/TUTORIAL.bg          
etc/TUTORIAL.cn
etc/TUTORIAL.cs          
etc/TUTORIAL.de          Werner Lemberg
etc/TUTORIAL.eo
etc/TUTORIAL.es          
etc/TUTORIAL.fr          
etc/TUTORIAL.it          
etc/TUTORIAL.ja		 
etc/TUTORIAL.ko
etc/TUTORIAL.nl		 
etc/TUTORIAL.pl          
etc/TUTORIAL.pt_BR       
etc/TUTORIAL.ro
etc/TUTORIAL.ru          
etc/TUTORIAL.sk          
etc/TUTORIAL.sl          
etc/TUTORIAL.sv          
etc/TUTORIAL.th          
etc/TUTORIAL.zh

** Check the manual.

abbrevs.texi      -- cyd
ack.texi          -- rgm
anti.texi
arevert-xtra.texi
basic.texi        -- cyd
buffers.texi      -- cyd
building.texi     -- cyd
calendar.texi     -- rgm
cal-xtra.texi     -- rgm
cmdargs.texi      -- cyd
commands.texi     -- cyd
custom.texi       -- cyd
dired.texi        -- cyd
dired-xtra.texi
display.texi      -- cyd
emacs.texi        -- cyd
emacs-xtra.texi
emerge-xtra.texi
entering.texi     -- cyd
files.texi        -- cyd
fixit.texi        -- cyd
fortran-xtra.texi -- rgm
frames.texi       -- cyd
glossary.texi
help.texi         -- cyd
indent.texi       -- cyd
killing.texi      -- cyd
kmacro.texi       -- cyd
macos.texi     -- davidswelt
maintaining.texi  -- cyd
major.texi        -- cyd
mark.texi         -- cyd
mini.texi         -- cyd
misc.texi         -- cyd
msdog.texi        -- eliz
msdog-xtra.texi   -- eliz
mule.texi         -- cyd
m-x.texi          -- cyd
programs.texi     -- cyd
regs.texi         -- cyd
rmail.texi        -- rgm
screen.texi       -- cyd
search.texi       -- cyd
sending.texi      -- rgm (maybe needs some brief mailclient.el details in
                          "Mail Sending" section?)
text.texi         -- cyd
trouble.texi      -- cyd
windows.texi      -- rudalics
xresources.texi   -- cyd

** Check the Lisp manual.

abbrevs.texi      -- cyd
advice.texi       -- cyd
anti.texi         -- cyd
back.texi
backups.texi      -- cyd
buffers.texi      -- cyd
commands.texi     -- cyd
compile.texi      -- cyd
control.texi      -- cyd
customize.texi    -- cyd
debugging.texi    -- cyd
display.texi      -- cyd
edebug.texi
elisp.texi
errors.texi       -- cyd
eval.texi         -- cyd
files.texi        -- cyd
frames.texi       -- cyd
functions.texi    -- cyd
hash.texi         -- cyd
help.texi         -- cyd
hooks.texi        -- cyd
index.texi
internals.texi    -- cyd
intro.texi        -- cyd
keymaps.texi      -- cyd
lists.texi        -- cyd
loading.texi      -- cyd
locals.texi       -- cyd
macros.texi       -- cyd
maps.texi         -- cyd
markers.texi      -- cyd
minibuf.texi      -- cyd
modes.texi        -- cyd
nonascii.texi     -- cyd
numbers.texi      -- cyd
objects.texi      -- cyd
os.texi           -- cyd
positions.texi    -- cyd
processes.texi
searching.texi    -- cyd
sequences.texi    -- cyd
streams.texi      -- cyd
strings.texi      -- cyd
symbols.texi      -- cyd
syntax.texi       -- cyd
text.texi         -- cyd
tips.texi         -- cyd
variables.texi    -- cyd
windows.texi      -- rudalics

* PLANNED ADDITIONS

** pov-mode (probably not for Emacs-23: waiting for a Free POV-Ray).
** gas-mode ?


Local variables:
mode: outline
coding: utf-8
end: