From d22a2570081d5cbee9daccb3060b93e5b83d1390 Mon Sep 17 00:00:00 2001 From: Adrian Sampson Date: Wed, 1 Mar 2017 20:22:30 -0500 Subject: [PATCH] Main guide: clarify meaning of plain keyword query Fixes #2463. --- docs/guides/main.rst | 4 +++- docs/reference/query.rst | 2 ++ 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/guides/main.rst b/docs/guides/main.rst index ec23e8a8f..4b5381a3a 100644 --- a/docs/guides/main.rst +++ b/docs/guides/main.rst @@ -238,7 +238,9 @@ songs. Thus:: $ beet ls album:bird The Mae Shi - Terrorbird - Revelation Six -As you can see, search terms by default search all attributes of songs. (They're +By default, a search term will match any of a handful of :ref:`common +attributes ` of songs. +(They're also implicitly joined by ANDs: a track must match *all* criteria in order to match the query.) To narrow a search term to a particular metadata field, just put the field before the term, separated by a : character. So ``album:bird`` diff --git a/docs/reference/query.rst b/docs/reference/query.rst index 2f3366d4c..b4789aa10 100644 --- a/docs/reference/query.rst +++ b/docs/reference/query.rst @@ -6,6 +6,8 @@ searches that select tracks and albums from your library. This page explains the query string syntax, which is meant to vaguely resemble the syntax used by Web search engines. +.. _keywordquery: + Keyword -------