* implement the :erase message from the backend to properly clean up the

header buffer

  When we're doing a search while the results of a previous search are still
  coming in from the backend, this way we can tell the frontend that this is
  the right time to clear the buffer (previously, sometimes the results would
  be mixed).

man/mu-server.1

@@ -51,6 +51,12 @@ Using the \fBfind\fR command we can search for messages.
 .nf
 -> find "<query>" <maxnum>
 .fi
+First, this will return an 'erase'-sexp, to clear the buffer from possible
+results from a previous query.
+.nf
+<- (:erase t)
+.fi
+
 This will return a series of 0 up to <maxnum> s-expression corresponding to each
 message found (with a negative number for <maxnum> meaning 'unlimited'). The
 information for each message does not contain the message body; the \fBview\fR