beets/docs/reference
Dominik Schrempf e39dcfc002
clarify -a option for beet modify
See https://github.com/beetbox/beets/discussions/4172.

I think the confusion arises because the documentation refers to the
query. That is, when `-a` is given, albums are queried, not tracks. This
is especially clear when using `beet list`, because then it truly lists
"albums instead of items". However, for other commands, the distinction
between what is queried and what is acted on should be made more clear.

This PR fixes the section for `modify`, but there are more questions:

- `remove` command: The documentation states that it acts on albums
instead of individual tracks. I guess we should also amend that? I think
the complete album including the tracks is deleted, or is that not true?

- `move` command: I think the same is true for this command. If `-a` is
  given, the queried albums including all tracks are moved.

- `update` command: The `-a` flag is not explained here.
2021-12-03 22:36:48 +01:00
..
cli.rst clarify -a option for beet modify 2021-12-03 22:36:48 +01:00
config.rst Remove duplicated : 2021-10-26 08:17:00 -04:00
index.rst introductory paragraphs 2011-09-17 16:02:06 -07:00
pathformat.rst Update a lot of URLs to use HTTPS 2019-06-05 03:11:49 +02:00
query.rst Update a lot of URLs to use HTTPS 2019-06-05 03:11:49 +02:00