261119.1 d1753f14c7293dd5f2cdb3b5b4488e94ab87a52a The project is dirview and its command drvu
commit time warp
The name is final. NAME, back from WORKING_NAME, holds drvu, and everything the tool names follows: the binaries drvu, drvu-public and drvu-syntax, DRVU_ADDR and the other variables, ~/.local/state/drvu, the journal tag, .drvu-follow, /_drvu/ and the systemd units.
The project, its Go module and its Debian packages are dirview and dirview-syntax. The Makefile takes that name from the module path as PACKAGE, so the name test now guards both names.
Old names stop working: WWW_ADDR, ~/.local/state/www, the www package and running www servers stay until removed.
Changes to doc/development.md. All files
doc/development.md
@@ -1,20 +1,20 @@ # Development -To try a change without installing it, run `make run`. It builds `build/www` and the syntax tree helper and serves this directory on port 8080 with `--debug`, beside an installed server on port 80.+To try a change without installing it, run `make run`. It builds `build/drvu` and the syntax tree helper and serves this directory on port 8080 with `--debug`, beside an installed server on port 80. A later run replaces the server on 8080 with the new build, serving the same trees, and open pages go on under it. So edit and `make run` again. -It opens the browser only when no page of this directory was open on the old server, and says which happened. A hidden tab holds no connection, so it does not count and gets a second tab. `www --kill -a 127.31.N.1:8080` stops it.+It opens the browser only when no page of this directory was open on the old server, and says which happened. A hidden tab holds no connection, so it does not count and gets a second tab. `drvu --kill -a 127.31.N.1:8080` stops it. ## Two executables -The root directory is a library package. Each executable has only its main under `cmd/`: `cmd/local` builds `www`, the reader, and `cmd/public` builds `www-public`, for the open web. `make build` builds both into `build/`.+The root directory is a library package. Each executable has only its main under `cmd/`: `cmd/local` builds `drvu`, the reader, and `cmd/public` builds `drvu-public`, for the open web. `make build` builds both into `build/`. The public executable leaves a feature out by never calling it, and the linker drops code that no call leads to. A server gets the stop form, the bug form and the index only through `local()`, which the public start never calls. `TestPublicLeavesOutTheReadersFeatures` builds both and reads their symbols: the public one must hold none of the listed names and the reader every one. -## The working name+## The names -The program's name lives in the file `WORKING_NAME`, since www is a working name until a final one is chosen. The binary, its paths, environment variables, journal tag and URLs, the Makefile and the Debian package all take it from there. A test fails on any other copy outside prose and `go.mod`.+The project is dirview and its command is drvu. The command's name lives in the file `NAME`: the binaries, their paths, environment variables, journal tag, units and URLs take it from there. The project's name lives in `go.mod`, as the module's, and the Debian packages take it from there. A test fails on any other copy of either outside prose, `go.mod` and the Go package and import lines. ## Usage check