Import http://conkeror.org/BreakingChanges into debian/NEWS
[conkeror.git] / debian / NEWS
blob89838262b46ccda5fefe4d29c4f0b578f5658078
1 conkeror (0.9.3+git110213-1) unstable; urgency=low
3   * In the new-tabs module, the widgets that show the buffer index in each
4     tab now have the class "tab2-index" instead of "tab2-icon". This
5     change affects anybody who has written a theme which styles the
6     new-tabs tab bar.
8   * The variable edit_field_in_external_editor_extension has been removed,
9     and superseded by a mime-type table
10     external_editor_extension_overrides which maps mime types to
11     extensions. If you previously used this variable to set the temp file
12     extension to "foo", for example, you would update your rc to now do
13     the following:
15       external_editor_extension_overrides.set("text/plain", "foo");
17   * The function get_filename_for_current_textfield has been superseded by
18     external_editor_make_base_filename, which takes as its arguments the
19     root element being edited and the top document of the buffer
20     containing the element. The top document is more useful than the
21     element's own ownerDocument in some cases, such as when about:blank is
22     used for the document of an editable iframe. The new function returns
23     only the base filename, with no extension, as the extension is
24     generated by means described above.
26   * buffer_favicon_change_hook renamed to buffer_icon_change_hook
28   * current_buffer_favicon_change_hook renamed to
29     current_buffer_icon_change_hook
31   * reddit-mode is no longer loaded by default. Consensus was that it is a
32     confusing mode, mainly because of how it overrides several default
33     browser objects. If you use this mode, you will now need to load it by
34     putting the following in your rc:
36       require("reddit");
38   * Module search-engine.js replaced by opensearch.js. API for defining
39     opensearch webjumps has changed to be more conventional. Opensearch
40     webjumps can now be defined like either of the following:
42       define_opensearch_webjump("foo", make_file("/opensearch/files/foo.xml"));
44       opensearch_load_paths.unshift(make_file("/opensearch/files/"));
45       define_opensearch_webjump("foo", "foo.xml");
47   * The browser object browser-object-links, which is used by follow,
48     copy, etc, no longer matches anchors which do not have an href
49     attribute.
51  -- Axel Beckert <abe@debian.org>  Sun, 13 Feb 2011 18:47:03 +0100
53 conkeror (0.9.3+git101015-1) experimental; urgency=low
55   * The eval-expression command (M-:) now evaluates directly in
56     application scope. This lets you do things like set user variables and
57     define functions without fully qualifying names with "conkeror.".
59   * Page-modes no longer bind alternative keys for keys that they shadow
60     in the normal keymaps. These were bindings like 'C-c f' for follow,
61     etc. The key C-z can now be used as a prefix to access bindings that
62     are shadowed by a page-mode keymap.
64  -- Axel Beckert <abe@debian.org>  Fri, 15 Oct 2010 00:29:44 +0200
66 conkeror (0.9.3-1) experimental; urgency=low
68   * Input-modes removed. Instead of an input-mode display in the
69     minibuffer, there is now a keymaps-display.
71     - quote-next-input-mode renamed to quote-next-mode
72     - gmail_edit_keymap removed (no longer necessary)
73     - buffer-reset-input-mode command removed (no longer necessary)
75   * overlink_mode rewritten
77     - content_buffer_overlink_change_hook removed
78     - current_content_buffer_overlink_change_hook removed
80   * Hinting now performs a case-sensitive match if the user's text
81     includes upper-case letters.
83   * stackoverflow-mode has been renamed to stackexchange-mode.
85  -- Axel Beckert <abe@debian.org>  Wed, 06 Oct 2010 21:02:21 +0200
87 conkeror (0.9.2+git100804-1) unstable; urgency=low
89   * Editing in the minibuffer is now done with the normal editing commands
90     instead of a special set of editing commands. All of the editing
91     commands which begin with the prefix "minibuffer-" have been
92     removed. Also, editing commands are now bound in the keymap
93     text_keymap instead of content_buffer_text_keymap and
94     minibuffer_base_keymap. If you have written custom bindings for
95     editing in your rc, you will need to change [pairs of] bindings like
96     this:
98       define_key(minibuffer_base_keymap, "C-l", "minibuffer-forward-char");
99       define_key(content_buffer_text_keymap, "C-l", "forward-char");
101     to this:
103       define_key(text_keymap, "C-l", "forward-char");
105   * In hinting mode, right and left are no longer bound to
106     next/previous-hint. Hinting mode now supports editing in the
107     minibuffer, so right and left move the cursor. Down, up, C-n, C-p,
108     C-s, and C-r are all bound to next/previous-hint.
110   * Due to a change in Mozilla as of XULRunner 1.9.3a5pre, Conkeror's
111     feature of automatically loading glue code for extensions is no longer
112     possible. This means that when you have one of the previously
113     supported extensions installed, you will no longer automatically have
114     Conkeror commands for using the extension. The extensions that were
115     previously supported in this way were adblockplus, dom-inspector,
116     noscript, and venkman. If you have any of these extensions installed,
117     you will now have to load the glue module from your rc, with a line
118     like the following, substituting in the appropriate module name:
120       require("dom-inspector");
122     With some of these modules, loading the module when the extension is
123     not installed could result in an error, so to be safe, you could wrap
124     the call to 'require' in a try/catch block:
126       try { require("dom-inspector"); } catch (e) {}
128     Further information: http://bugs.conkeror.org/issue272
130   * The variable download_buffer_automatic_open_target can no longer be an
131     array of two targets. This is a reversion from 2009-06-07 back to how
132     it was before. The behavior of the download-show command is now
133     configured independently of this variable. To configure download-show,
134     use set_handler and alternates. The following handlers are provided:
135     download_show_new_window, download_show_new_buffer,
136     download_show_new_buffer_background. The default handler of
137     download_show is alternates(download_show_new_buffer,
138     download_show_new_window).
140  -- Axel Beckert <abe@debian.org>  Wed, 04 Aug 2010 23:04:22 +0200
142 conkeror (0.9.2+git100420-2) unstable; urgency=low
144   * Function load_rc no longer supports loading arbitrary js files. Use
145     load instead.
147   * Function load_rc_file removed. Use load instead.
149   * call_after_load now takes a feature name, not a filename. In general
150     this simply means trimming off any ".js" extension.
152   * Modules API overhaul (already included in 0.9.2-1 and caused the
153     uploads 0.9.2+git100324-1 and -2):
154     - Modules should have an in_module assertion as their first
155       expression. For modules to be loaded directly into application
156       scope, it should be in_module(null);
157     - Modules should have as their last expression a provide call, like
158       provide("feature"); where "feature" is the name of the feature
159       provided by the module.
161  -- Axel Beckert <abe@debian.org>  Tue, 20 Apr 2010 23:38:49 +0200
163 conkeror (0.9.1+git100317-1) unstable; urgency=low
165   * emacswiki webjump removed. better version posted on
166     http://conkeror.org/Webjumps
168   * M-< and home keys now scroll to the top left corner of the buffer.
170   * minibuffer.read_url now returns a load_spec instead of a simple
171     string.
173   * The command confirm-quit has been removed. To have a quit
174     confirmation, see the code example on
175     http://conkeror.org/BreakingChanges
177  -- Axel Beckert <abe@debian.org>  Wed, 17 Mar 2010 02:04:20 +0100
179 conkeror (0.9.1+git100131-1) unstable; urgency=low
181   Please see http://conkeror.org/BreakingChanges for the complete list of
182   breaking changes. Just the most important ones are listed here.
183   
184   * mime_type_external_handlers removed. Replaced by
185     external_content_handlers.
186   
187   * define_buffer_mode, define_input_mode, and define_page_mode no longer
188     take display_name or doc as positional arguments. They are now given
189     as keyword arguments: $display_name and $doc.
190   
191   * The variable browser_automatic_form_focus_window_duration was renamed
192     to block_content_focus_change_duration.
193   
194   * The commands follow-current, follow-current-new-buffer,
195     follow-current-new-buffer-background, and follow-current-new-window
196     have been removed.
197   
198   * browser_prevent_automatic_form_focus_mode has been renamed and put in
199     its own file. To use this mode, simply do this:
200     require("block-content-focus-change.js");
202   * The default of hints_auto_exit_delay has been changed to 0.
204     This change means that by default, the user has to hit return to exit
205     the hints interaction. This change makes Conkeror's UI more
206     predictable for new users, less prone to run unintended commands
207     because of extra keystrokes outside the timeout window, and removes
208     assumptions about people's typing speed, browsing style, and focus of
209     attention when using the hints system.
210   
211     To use the hints-auto-exit feature, put a line like the following in
212     your rc, adjusting the number to suit your preference. 500 was the old
213     default.
215       hints_auto_exit_delay = 500;
217  -- Axel Beckert <abe@debian.org>  Sun, 31 Jan 2010 17:55:04 +0100
219 conkeror (0.9~git090708-1) unstable; urgency=low
221   The conkeror Debian package now works with the upcoming experimental
222   xulrunner-1.9.1 packages (see http://glandium.org/blog/?p=370) in
223   Debian, too.
224   
225   Since conkeror still throws much more warnings with xulrunner 1.9.1 than
226   with 1.9.0.x, for now the package currently prefers 1.9.0.x over 1.9.1
227   if both are installed.
228   
229   Call "xulrunner-1.9.1 /usr/share/conkeror/application.ini" if you have
230   xulrunner-1.9 and xulrunner-1.9.1 installed and want to checkout
231   conkeror in combination with xulrunner 1.9.1.
233  -- Axel Beckert <abe@deuxchevaux.org>  Wed, 08 Jul 2009 20:48:36 +0200
235 conkeror (0.9~git090617-1) unstable; urgency=low
237   There were a few changes since the last conkeror version in Debian which
238   may cause troubles to users of the previous version.
239   
240   Short summary follows:
241   * The key bindings `<<` and `>>` are now simply `<` and `>`.
242   * page-mode keymaps are now declared in the `define_page_mode` form with
243     a new keyword argument, `$keymaps`.  See
244     http://conkeror.org/WritingPageModes for more information about the
245     new style.
246   * `default_directory` and `set_default_directory` have been removed and
247     replaced by the variable `cwd`.
248   * buffer-local variables are now indexed by `buffer.local.foo`.
249     page-local variables are indexed by `buffer.page.local.foo`.
250   * The command `send-ret` was removed since it is redundant of the
251     module `global-overlay-keymap`.
252   * Buffer-local cwd is no longer set or inherited automatically.
253   * `download-cancel` is now bound to `d` instead of `C-g`, and it asks
254     for confirmation.
255   * In order to make Conkeror compatible with native toolkit theming,
256     Conkeror's themes have undergone a big rewrite:
257     - Conkeror no longer specifies its own gui colors.
258     - The blackened theme no longer exists.
259     - It is no longer possible to theme scrollbars.
260     From now on, the right way to change Conkeror's gui colors is to do so
261     at the OS level, for example, with a GTK theme.
262   * Conkeror has now session saving support. See
263     http://conkeror.org/Sessions for details.
265   See http://article.gmane.org/gmane.comp.mozilla.conkeror/1547 and
266   http://thread.gmane.org/gmane.comp.mozilla.conkeror/1451 for the
267   details and what to change in case you run over some removed or renamed
268   functions or variables.
269   
270  -- Axel Beckert <abe@deuxchevaux.org>  Wed, 17 Jun 2009 00:04:58 +0200
272 conkeror (0.9~git090223-1) unstable; urgency=low
274   There were a few changes since the last conkeror version in Debian which
275   may cause troubles to users of the previous version:
276   * Changes to the behaviour of the universal argument C-u.
277   * Loads now ~/.conkerorrc as the default rc file
278   * Many simple webjumps previously enabled by default have been removed
279     from upstream. Non-default webjumps are now collected and shared at
280     http://conkeror.org/Webjumps
281   * Many additional keybindings, e.g.
282       - pasting current paste buffer content bound to `C-y'
283       - new command `submit-form' bound to `C-c C-c' in forms
284   * Incremental search for URLs in the mini-buffer can currently include
285     _either_ the history or the bookmarks, but not both at the same
286     time. See http://bugs.conkeror.org/issue10 for details on choosing
287     which one to use.
289  -- Axel Beckert <abe@deuxchevaux.org>  Mon, 23 Feb 2009 21:04:41 +0100