diff --git a/beets/util/__init__.py b/beets/util/__init__.py index f17571f0d..61a95baa2 100644 --- a/beets/util/__init__.py +++ b/beets/util/__init__.py @@ -736,11 +736,14 @@ def open_anything(): def interactive_open(target, command=None): - """Open `target` file with `command` or, in not available, ask the OS to - deal with it. + """Open the file `target` by `exec`ing a new command. (The new + program takes over, and Python execution ends: this does not fork a + subprocess.) - The executed program will have stdin, stdout and stderr. - OSError may be raised, it is left to the caller to catch them. + If `command` is provided, use it. Otherwise, use an OS-specific + command (from `open_anything`) to open the file. + + Can raise `OSError`. """ if command: command = command.encode('utf8') diff --git a/beetsplug/play.py b/beetsplug/play.py index 6404ab7cf..156bffba3 100644 --- a/beetsplug/play.py +++ b/beetsplug/play.py @@ -66,7 +66,7 @@ class PlayPlugin(BeetsPlugin): # Prepare command strings with optional args command_str = command_str.format(opts.args or '')\ .format(confargs or '') - + # Perform search by album and add folders rather than tracks to # playlist. if opts.album: diff --git a/docs/changelog.rst b/docs/changelog.rst index dd953713f..643904268 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -8,8 +8,8 @@ The new features: * Add new color aliases for standard terminal color names (e.g., cyan and magenta). Thanks to :user:`mathstuf`. :bug:`1548` -* :doc:`/plugins/play`: A new option `--args`/`-A` has been added, used to - hand over options to the player. +* :doc:`/plugins/play`: A new ``--args`` option lets you specify options for + the player command. :bug:`1532` Fixes: