Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 6 additions & 3 deletions docs/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -131,9 +131,12 @@ than passed on a command line, so the password never shows in `ps`.
**`prefix`** is the prefix the project's tracker gives its beads, written as
`bd init --prefix` takes it: `prefix = "dun"` for beads named `dun-7`. `bdi`
learns a prefix from the beads a tracker answers with, so this only matters
for a project it has not read. With it, a blocker
carrying the prefix is drawn as this project's bead, which was not read, and a
blocker carrying another prefix is never put down to this project. A project
for a project it has not read. With it, a blocker carrying the prefix is known
to be this project's bead. Where the directory `bdi` was started in chose what
to read, `bdi` then reads this project, draws the blocker as the bead it is,
and goes on reading the project from then on. Under `--project` it says the
blocker is this project's bead, which was not read. A blocker carrying another
prefix is never put down to this project. A project
stating none may hold any blocker whose prefix no answer carries, so the line
lists it among the projects not read.

Expand Down
20 changes: 14 additions & 6 deletions docs/design.md
Original file line number Diff line number Diff line change
Expand Up @@ -451,10 +451,15 @@ that sits in an excluded project is still reported, as a pane in that
project. And reloading the config while running will have to re-derive the
read set from the new file, so it is kept a function of config, directory and
flags rather than a value computed once at start. A dependency on another
project's bead does not reach an excluded project: it is looked for among
the projects the run reads, and one only an excluded project holds stays
work the answer does not hold. Reading an excluded tracker to draw one bead
is the unseen widening rejected above.
project's bead is looked for among the projects the run reads. Where the
directory chose the scope and a project it left out states the blocker's
prefix, the run widens to read that project, as a root on the command line
widens it, and goes on reading it from then on: the reader typed nothing the
widening overrides, and the project's line on the screen shows it was added.
Nothing else is read to find a bead, so a project nothing drawn needs stays
unread. Against a scope the reader typed, a bead only an excluded project
holds stays work the answer does not hold, because reading that tracker is
the unseen widening rejected above.

## Conventions are configuration

Expand Down Expand Up @@ -954,8 +959,11 @@ answers carry the prefix and hold no bead by that id, or the projects that
each hold one. Where no answer carries the prefix, it falls to the configured
projects that gave no answer, whether refused, unreachable or left out of the
run, because nothing can learn the prefix of a tracker that did not answer.
Only a project's config can state it. Where one of them states the prefix,
the line says the bead is in that project, which was not read. Otherwise it
Only a project's config can state it. Where one of them states the prefix
and the directory chose the scope, that project is read and the bead drawn,
as *The excluded projects stay known to the run* says. Where the reader typed
the scope, the line says the bead is in that project, which was not read.
Otherwise it
names the ones that may hold it: those stating the prefix, or failing any,
those stating none. Where no configured project may hold it, the bead is in a
project `bdi` is not configured to read. A parent no answer holds gets no such
Expand Down
Loading
Loading