Liking cljdoc? Tell your friends :D

vaelii.browser.removed

The sentexes the browser last removed from each KB, so a removal can be put back.

A retraction is the browser's one write that loses content: an assert can be retracted and an edit edited back, but a retracted sentence exists afterwards only in the reader's memory. So every removal the browser makes is noted here once its write returns — the sentence as the editor prints it, its context and its strength — and the newest max-kept per KB are kept. /removed lists them, and putting one back is an assert of what was noted.

Per KB, on disk. The list is about a KB rather than a session, it has to outlive the process that made the removal, and it must not be written into the KB it describes, so it is an EDN file per KB under ~/.vaelii/removed/ (the vaelii.removed.dir property moves it, and the test profile sets it). A file is replaced whole through a rename, so a reader never sees half of one. A KB the catalog never registered has no name that outlives the process, so its list is held in memory, one per KB.

Only the sentexes a removal took out are noted. A selected sentex that stays, being derived another way, was not lost, and the derived sentexes the sweep took with a removal come back with what they rest on.

The sentexes the browser last removed from each KB, so a removal can be put back.

A retraction is the browser's one write that loses content: an assert can be retracted
and an edit edited back, but a retracted sentence exists afterwards only in the reader's
memory.  So every removal the browser makes is noted here once its write returns — the
sentence as the editor prints it, its context and its strength — and the newest
`max-kept` per KB are kept.  `/removed` lists them, and putting one back is an assert of
what was noted.

**Per KB, on disk.**  The list is about a KB rather than a session, it has to outlive
the process that made the removal, and it must not be written into the KB it
describes, so it is an EDN file per KB under `~/.vaelii/removed/` (the `vaelii.removed.dir`
property moves it, and the test profile sets it).  A file is
replaced whole through a rename, so a reader never sees half of one.  A KB the catalog
never registered has no name that outlives the process, so its list is held in memory,
one per KB.

Only the sentexes a removal **took out** are noted.  A selected sentex that stays,
being derived another way, was not lost, and the derived sentexes the sweep took with a
removal come back with what they rest on.
raw docstring

entriesclj

(entries owner)

The removals noted for owner, newest first: {:id :at :sentence :context :strength :via}, where :sentence and :context are text as the editor prints them. A string owner names a list kept in a file; any other owner is a KB whose list is held in memory. A missing or unreadable file is an empty list.

The removals noted for `owner`, newest first: `{:id :at :sentence :context :strength
:via}`, where `:sentence` and `:context` are text as the editor prints them.  A string
`owner` names a list kept in a file; any other `owner` is a KB whose list is held in
memory.  A missing or unreadable file is an empty list.
sourceraw docstring

entryclj

(entry owner id)

The noted removal id in owner's list, or nil.

The noted removal `id` in `owner`'s list, or nil.
sourceraw docstring

forget!clj

(forget! owner id)

Drop the noted removal id from owner's list — once it has been put back.

Drop the noted removal `id` from `owner`'s list — once it has been put back.
sourceraw docstring

max-keptclj

How many removals each KB's list holds; a note past it drops the oldest.

How many removals each KB's list holds; a note past it drops the oldest.
sourceraw docstring

note!clj

(note! owner via rows)

Prepend rows ({:sentence :context :strength}, text) to owner's list (entries), each given an id, the time and via (what removed it: :retract, :edit, :term), and keep the newest max-kept. Answers the rows as noted.

Prepend `rows` (`{:sentence :context :strength}`, text) to `owner`'s list (`entries`),
each given an id, the time and `via` (what removed it: `:retract`, `:edit`, `:term`),
and keep the newest `max-kept`.  Answers the rows as noted.
sourceraw docstring

cljdoc builds & hosts documentation for Clojure/Script libraries

Keyboard shortcuts
Ctrl+kJump to recent docs
←Move to previous article
→Move to next article
Ctrl+/Jump to the search field
× close