welcome: please sign in
location: Diff for "Downloads"
Differences between revisions 6 and 7
Revision 6 as of 2013-06-28 13:16:16
Size: 2668
Editor: RussellSim
Comment: added more details about opening buffers
Revision 7 as of 2013-06-28 13:24:02
Size: 2649
Editor: RussellSim
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
Download buffers are opened automatically whenever you start a download, and whenever you use the `download-show` command. Those buffers can be opened in a new window, or in a new buffer in the current window. The default for the former is to open them in a new window, and for the latter in a new buffer in the current window. The variable `download_buffer_automatic_open_target` controls the behavior of automatically opened downloads. Its default is `OPEN_NEW_WINDOW` but other possible values include `OPEN_NEW_BUFFER` and `OPEN_NEW_BUFFER_BACKGROUND`. Download buffers are opened automatically whenever you start a download, and whenever you use the `download-show` command. Those buffers can be opened in a new window, or in a new buffer in the current window. The default for the former is to open them in a new window, and for the latter in a new buffer in the current window. The variable `download_buffer_automatic_open_target` controls the behavior of automatically opened downloads. Its default is `OPEN_NEW_WINDOW` but there are [[Targets#Target_Constants|other possible targets]].

Download buffers are opened automatically whenever you start a download, and whenever you use the download-show command. Those buffers can be opened in a new window, or in a new buffer in the current window. The default for the former is to open them in a new window, and for the latter in a new buffer in the current window. The variable download_buffer_automatic_open_target controls the behavior of automatically opened downloads. Its default is OPEN_NEW_WINDOW but there are other possible targets.

If you don't want a download buffer to open automatically ever, put the following in your rc:

remove_hook("download_added_hook", open_download_buffer_automatically);

To open a download buffer manually, do M-x download-show. You will be prompted for a download from a list of your current downloads. By default, the download buffer will be opened as a new buffer in the current window. With universal-argument, it will be opened in a new window. This can be configured with the alternates system. For example:

set_handler("download-show",
            alternates(download_show_new_window,
                       download_show_new_buffer));

Within a download buffer, the following key bindings are in effect:

d

download-cancel

Cancel the download. File will be deleted.

p

download-pause-or-resume

Toggle the paused state of the download.

r

download-retry-or-resume

Resume or restart a paused or cancelled download.

delete

download-remove

Remove the current download from the download manager. This command can only be used on inactive (paused, canceled, completed, or failed) downloads.

C-d

download-remove

x

download-shell-command

Run a shell command on the downloaded file. If the download is not complete, the action will be queued.

o

download-shell-command

It comes as a surprise to many people that the g key, and other bindings found in content buffers are not available in download buffers. Much of this is due to the separation of buffer types for security: a special buffer cannot become a content buffer, and a content buffer cannot become a special buffer. It is also worth bearing in mind that single-key alphanumeric bindings are always considered context-based shortcuts in Conkeror. To browse to an url in a new content buffer, use C-x C-f.

If you would rather use the Xulrunner built-in Downloads window, like Firefox has, you can open it by M-x download-manager-show-builtin-ui.

Conkeror.org: Downloads (last edited 2013-06-28 13:24:02 by RussellSim)