v0.3.0

This release does two things. The lang: filter now works with semantic search, not only with word search. The Emacs package also does more for you: it keeps the index current when you save a note, and it asks what to do when a search fails.

This release needs binary version 0.3.0.

Rebuild the semantic index one time. Semantic search does not work until you do this. Run org-semantic index <vault> --full, or press C-u C-u M-x org-semantic-reindex. The index now records a language for each passage, so the package refuses an older index. The word index is not affected.

You must now declare your vault. Set org-semantic-vault-root to your notes directory. Before this release, the package found a vault by its .org-semantic directory. It no longer does this.

Added

• lang: and -lang: now narrow a search by meaning. Both indexes record the language of each passage.
• org-semantic-auto-reindex-mode reindexes a vault two seconds after you stop saving notes. It does not build an index that does not exist.
• org-semantic-auto-reindex-touch tells the package that notes changed. Use it from a file watcher, or from another package that indexes the same notes.
• org-semantic-vault-root accepts a function. Use a function when another package decides which vault is open.
• The index of a vault can be in a different directory from the notes. A vault.json file gives the location of the notes.
• Passages show the faces of org-mode: emphasis, verbatim, headings, block markers and links.
• New keys in the results buffer: f shows each passage in its note as you move, l joins the terms of a word query with and or or, k and K change how many notes appear, + and - change how many passages each note contributes.

Changed

• A failed search asks what to do in the minibuffer. Each answer is one key, and each answer tells you what it costs.
• The query prompt gives the name of the ranking: Semantic search for: or Lexical search for:. Press M-s for semantic or M-l for lexical. The two keys also work in the results buffer.
• org-semantic-canonical-vault is now public. Use it if your own code gives a vault name to the server.

Fixed

• A preview could replace the list of results.
• The offer to download a missing model downloaded nothing.
• A passage that started inside a block did not contain the first line of the block. A blank line in a block also divided the block into two passages. A passage now contains the full block.
• A first run could ignore the # ltex: language= line of a note.
• A search by word from a failure message changed the ranking of the buffer permanently.

Removed

• The "Try again" offer. It only ran the search again, which g also does.
• Four keys in the results buffer: =, P, a and M.

---

Full changelog
All commits in this release