diff --git a/hledger-ui/doc/hledger-ui.1.m4.md b/hledger-ui/doc/hledger-ui.1.m4.md
index 235c89590..a6802bceb 100644
--- a/hledger-ui/doc/hledger-ui.1.m4.md
+++ b/hledger-ui/doc/hledger-ui.1.m4.md
@@ -90,7 +90,7 @@ On a mac, the Karabiner app is one way to do that.)
 
 On most screens,
 `/` lets you set or change the [filter query](/hledger.html#queries),
-which limits the data shown on most screens (in addition to the quick
+which limits the data shown (this filter is in addition to the quick
 filters described below). While editing the query you can use typical
 command-line edit keys 
 ([CTRL-a/e/d/k, cursor keys etc.](http://hackage.haskell.org/package/brick-0.7/docs/Brick-Widgets-Edit.html#t:Editor)), 
@@ -100,7 +100,7 @@ and `ENTER`to set the new filter or `ESCAPE`to cancel.
 day, week, month, quarter, year, and unlimited (the default).
 When the report duration is limited in this way, `n` and `p`
 step to the next or previous day/week/month/etc.
-(To set arbitrary start/end dates, you can use `/` and a `date:` query.)
+(To set arbitrary start/end dates, you can use `/` to set a [`date:` query](manual.html#queries).)
 
 `BACKSPACE` or `DELETE` clears any filters in effect.
 
diff --git a/hledger/doc/queries.m4.md b/hledger/doc/queries.m4.md
index 111bb85d2..2e4cb4880 100644
--- a/hledger/doc/queries.m4.md
+++ b/hledger/doc/queries.m4.md
@@ -57,12 +57,12 @@ or `hledger print cur:\\$`.
 
 **`date:PERIODEXPR`**
 : match dates within the specified period.
-PERIODEXPR should not include a reporting interval.
-The command-line `--date2` flag makes this match secondary dates instead (like the `-b`/`-e`/`-p` options).
+PERIODEXPR is a [period expression](#period-expressions) (with no report interval).
+Examples: `date:2016`, `date:thismonth`, `date:2000/2/1-2/15`, date:`lastweek-`.
+The command-line `--date2` flag makes `date:` match [secondary dates](manual.html#secondary-dates) instead.
 
 **`date2:PERIODEXPR`**
 : match secondary dates within the specified period.
-PERIODEXPR should not include a reporting interval.
 
 **`depth:N`**
 : match (or display, depending on command) accounts at or above this depth