chiark / gitweb /
nailing-cargo.git
3 years agoProvide --clean-linkfarm and --keep-linkfarm, and document oot.clean
Ian Jackson [Sat, 25 Jul 2020 18:18:57 +0000 (19:18 +0100)]
Provide --clean-linkfarm and --keep-linkfarm, and document oot.clean

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: [oot] clean, facility to clean up linkfarm
Ian Jackson [Sat, 25 Jul 2020 18:11:35 +0000 (19:11 +0100)]
nailing-cargo: [oot] clean, facility to clean up linkfarm

Not documented yet, pending command line.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoProvide --leave-nailed option
Ian Jackson [Sat, 25 Jul 2020 18:07:52 +0000 (19:07 +0100)]
Provide --leave-nailed option

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoProvide --just-linkfarm option
Ian Jackson [Sat, 25 Jul 2020 18:00:24 +0000 (19:00 +0100)]
Provide --just-linkfarm option

Closes #10

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Tolerate lack of build commands with -n
Ian Jackson [Sat, 25 Jul 2020 17:49:57 +0000 (18:49 +0100)]
nailing-cargo: Tolerate lack of build commands with -n

We just use dummy values instead.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoOption --man[ual] to show the manual
Ian Jackson [Sat, 25 Jul 2020 17:43:34 +0000 (18:43 +0100)]
Option --man[ual] to show the manual

Closes #8

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Record $base_path from linking goose-hunting
Ian Jackson [Sat, 25 Jul 2020 17:41:01 +0000 (18:41 +0100)]
nailing-cargo: Record $base_path from linking goose-hunting

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoProvide usage summary, invoked with -h --help
Ian Jackson [Sat, 25 Jul 2020 17:22:56 +0000 (18:22 +0100)]
Provide usage summary, invoked with -h --help

Closes #7

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Chase path dependencies
Ian Jackson [Sat, 25 Jul 2020 17:09:29 +0000 (18:09 +0100)]
nailing-cargo: Chase path dependencies

Closes #9

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Do not adjust paths in the same subdir
Ian Jackson [Sat, 25 Jul 2020 17:04:25 +0000 (18:04 +0100)]
nailing-cargo: Do not adjust paths in the same subdir

This usually means paths in the same workspace.

This does away with the need for
  8dbd084a86a3dff840a215211cf8304ee61a927a
  nailing-cargo: Work around cargo annoyance with workspaces

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: When we set path, delete git and branch
Ian Jackson [Sat, 25 Jul 2020 16:57:09 +0000 (17:57 +0100)]
nailing-cargo: When we set path, delete git and branch

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Print every path change, with many -v
Ian Jackson [Sat, 25 Jul 2020 16:56:51 +0000 (17:56 +0100)]
nailing-cargo: Print every path change, with many -v

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Record $org_subdir in %packagemap and %manifests
Ian Jackson [Sat, 25 Jul 2020 16:56:26 +0000 (17:56 +0100)]
nailing-cargo: Record $org_subdir in %packagemap and %manifests

No functional change yet.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Process target-specific dependencies too
Ian Jackson [Sat, 25 Jul 2020 16:33:12 +0000 (17:33 +0100)]
nailing-cargo: Process target-specific dependencies too

We don't know which cfg() etc. apply, but that's OK.  We hope.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Refactor target_dependency_tables
Ian Jackson [Sat, 25 Jul 2020 16:26:58 +0000 (17:26 +0100)]
nailing-cargo:  Refactor target_dependency_tables

NFC.  This function needs enhancing.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Break out get_dependency_tables
Ian Jackson [Sat, 25 Jul 2020 16:25:47 +0000 (17:25 +0100)]
nailing-cargo: Break out get_dependency_tables

NFC.  This function needs enhancing.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Work around cargo annoyance with workspaces
Ian Jackson [Sat, 25 Jul 2020 15:53:46 +0000 (16:53 +0100)]
nailing-cargo: Work around cargo annoyance with workspaces

When the invocation $subdir is a workspace, with -u, cargo complains
that the packages in the linkfarm are different to the ones in the
source area.

Fix this by, in this case, adjusting those path references to point
into the linkfarm.

cargo seems to use realpath on one of these paths, so we must do so
too, or cargo complains that two things are different which are
literally two different paths to the very same symlink.

With this change I am able to build lexpr-rs, both in its own right,
and as a dependency.  Closes #1.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoMake a shallow symlink farm
Ian Jackson [Sat, 25 Jul 2020 15:49:36 +0000 (16:49 +0100)]
Make a shallow symlink farm

Fighting Cargo to avoid this has become too much hard work.

In particular, otherwise with workspaces we would have to edit all of
the member paths.  And having done that the sources themselves claim
to be part of a different workspace, so it's all awful.

I have also seen some weird behaviours where cargo didn't work quite
right because the package wasn't convincing enough.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: oot_massage_cmdline: Initialise $pre and $post
Ian Jackson [Sat, 25 Jul 2020 16:15:55 +0000 (17:15 +0100)]
nailing-cargo: oot_massage_cmdline: Initialise $pre and $post

Otherwise if we don't write anything to them, we produce an undef
warning.

No functional change with current code.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Make oot_absdir available earlier
Ian Jackson [Sat, 25 Jul 2020 15:48:46 +0000 (16:48 +0100)]
nailing-cargo: Make oot_absdir available earlier

No functional change.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Chase down workspace members
Ian Jackson [Sat, 25 Jul 2020 16:04:31 +0000 (17:04 +0100)]
nailing-cargo: Chase down workspace members

When workspaces are in use, we need to look at their members.
This is quite a palaver.

We want to process them after all the stuff in the config, so we must
queue them up when we see them.  And we want to chase recursively,
perhaps.  (We certainly will do when we extend this to path
dependencies.)  So rather than an actual recursive function, we have a
queue.

We use realpath(1) to check that the paths we find don't
escape.  (Strictly, this code might [l]stat or readdir various
pathnames controlled by hostile cargo metadata, but that's all.
Basically, I'm assuming it's OK to pass a hostile path to realpath(1)
and then check what realpath(1) said.)

Now we record a manifest as relevant if it has a [workspace], even if
it didn't have a package.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Change read_manifest return convention
Ian Jackson [Sat, 25 Jul 2020 16:06:23 +0000 (17:06 +0100)]
nailing-cargo: Change read_manifest return convention

Now it returns $ws too, which is going to be workspace information.

Right now it's just undef, so no functional change.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Pass $org_subdir to read_manifest
Ian Jackson [Sat, 25 Jul 2020 15:57:52 +0000 (16:57 +0100)]
nailing-cargo: Pass $org_subdir to read_manifest

Currently this is just $subdir.  But we are going to recursively chase
down workspaces and path dependencies, and we want to know where they
came from so we can check the paths for sanity.

No functional change yet

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
.

3 years agonailing-cargo: Print $why in error messages
Ian Jackson [Sat, 25 Jul 2020 10:42:54 +0000 (11:42 +0100)]
nailing-cargo: Print $why in error messages

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Pass $why to read_manifest
Ian Jackson [Sat, 25 Jul 2020 10:36:53 +0000 (11:36 +0100)]
nailing-cargo: Pass $why to read_manifest

This will help with error messages.

Not used yet.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Make ignored-subdir message more accurate
Ian Jackson [Sat, 25 Jul 2020 00:25:36 +0000 (01:25 +0100)]
nailing-cargo: Make ignored-subdir message more accurate

Maybe there was a Cargo.toml but we didn't like it.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Print a better error about missing update mode
Ian Jackson [Sat, 25 Jul 2020 00:12:07 +0000 (01:12 +0100)]
nailing-cargo: Print a better error about missing update mode

If the user forgot generate-lockfile, we would fail with a confusing
ENOENT error from the command script.  Instead, spot this situation.

This also gives us a place to do decide to mkdir -p or something.

Related to #5, but does not fix it completely.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Try to fix salsa formatting
Ian Jackson [Mon, 22 Jun 2020 18:31:18 +0000 (19:31 +0100)]
README.md: Try to fix salsa formatting

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Fix link (actually)
Ian Jackson [Mon, 22 Jun 2020 18:30:11 +0000 (19:30 +0100)]
README.md: Fix link (actually)

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Fix link
Ian Jackson [Mon, 22 Jun 2020 18:29:06 +0000 (19:29 +0100)]
README.md: Fix link

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Fix link
Ian Jackson [Mon, 22 Jun 2020 18:26:27 +0000 (19:26 +0100)]
README.md: Fix link

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Improve grammar
Ian Jackson [Mon, 22 Jun 2020 18:25:25 +0000 (19:25 +0100)]
README.md: Improve grammar

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Fix grammar
Ian Jackson [Mon, 22 Jun 2020 18:22:54 +0000 (19:22 +0100)]
README.md: Fix grammar

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Fix typo
Ian Jackson [Mon, 22 Jun 2020 18:22:24 +0000 (19:22 +0100)]
README.md: Fix typo

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Fix busted link
Ian Jackson [Mon, 22 Jun 2020 18:20:04 +0000 (19:20 +0100)]
README.md: Fix busted link

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Discussion of the scope of the local crate feature
Ian Jackson [Sun, 21 Jun 2020 19:46:38 +0000 (20:46 +0100)]
README.md: Discussion of the scope of the local crate feature

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agomisc.online: Fix
Ian Jackson [Sun, 21 Jun 2020 19:31:02 +0000 (20:31 +0100)]
misc.online: Fix

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agomisc.online: Support for `auto`
Ian Jackson [Sun, 21 Jun 2020 19:28:04 +0000 (20:28 +0100)]
misc.online: Support for `auto`

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Update for actual -u functionality
Ian Jackson [Sun, 21 Jun 2020 18:43:16 +0000 (19:43 +0100)]
README.md: Update for actual -u functionality

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoAllow --cargo-lock-update in in-tree builds
Ian Jackson [Sun, 21 Jun 2020 18:42:54 +0000 (19:42 +0100)]
Allow --cargo-lock-update in in-tree builds

We pass --locked otherwise!

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Restore -u and -U options
Ian Jackson [Sun, 21 Jun 2020 18:37:53 +0000 (19:37 +0100)]
nailing-cargo: Restore -u and -U options

People will need these occasionally - even in the basic runes.

They were still in README.md.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Mention generate-lockfile
Ian Jackson [Sun, 21 Jun 2020 18:34:34 +0000 (19:34 +0100)]
README.md: Mention generate-lockfile

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Clarify `oot.command'
Ian Jackson [Sun, 21 Jun 2020 18:33:03 +0000 (19:33 +0100)]
README.md: Clarify `oot.command'

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Clarify `oot.user'
Ian Jackson [Sun, 21 Jun 2020 18:32:55 +0000 (19:32 +0100)]
README.md: Clarify `oot.user'

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Delete reference to `fetch' in `online' discusson
Ian Jackson [Sun, 21 Jun 2020 18:32:11 +0000 (19:32 +0100)]
README.md: Delete reference to `fetch' in `online' discusson

This is now mentioned elsewhere.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Minor pronoun clarification
Ian Jackson [Sun, 21 Jun 2020 18:31:31 +0000 (19:31 +0100)]
README.md: Minor pronoun clarification

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Fix leftover ref to -ARPI, should be -T
Ian Jackson [Sun, 21 Jun 2020 18:31:09 +0000 (19:31 +0100)]
README.md: Fix leftover ref to -ARPI, should be -T

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Add explicit invitation to submit oot sudo support
Ian Jackson [Sun, 21 Jun 2020 18:30:55 +0000 (19:30 +0100)]
README.md: Add explicit invitation to submit oot sudo support

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Add explicit invitation to submit bugs/fixes for props
Ian Jackson [Sun, 21 Jun 2020 18:30:38 +0000 (19:30 +0100)]
README.md: Add explicit invitation to submit bugs/fixes for props

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Change an `out of tree' to `out-of-tree'
Ian Jackson [Sun, 21 Jun 2020 18:30:15 +0000 (19:30 +0100)]
README.md: Change an `out of tree' to `out-of-tree'

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Fix handling of missing oot.use
Ian Jackson [Sun, 21 Jun 2020 18:29:52 +0000 (19:29 +0100)]
nailing-cargo: Fix handling of missing oot.use

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Fix handling of unrecogised (ie cargo) short options
Ian Jackson [Sun, 21 Jun 2020 18:29:19 +0000 (19:29 +0100)]
nailing-cargo: Fix handling of unrecogised (ie cargo) short options

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Trigger out of tree with oot.user too
Ian Jackson [Sun, 21 Jun 2020 18:28:46 +0000 (19:28 +0100)]
nailing-cargo: Trigger out of tree with oot.user too

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Punctation fix
Ian Jackson [Sun, 21 Jun 2020 16:24:49 +0000 (17:24 +0100)]
README.md: Punctation fix

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Minor fixes
Ian Jackson [Sun, 21 Jun 2020 13:36:40 +0000 (14:36 +0100)]
README.md: Minor fixes

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Reorder options to put most usual first
Ian Jackson [Sun, 21 Jun 2020 13:34:01 +0000 (14:34 +0100)]
README.md: Reorder options to put most usual first

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Collapse function list a bit
Ian Jackson [Sun, 21 Jun 2020 13:31:53 +0000 (14:31 +0100)]
README.md: Collapse function list a bit

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Cross-references, add missing </a>
Ian Jackson [Sun, 21 Jun 2020 13:27:38 +0000 (14:27 +0100)]
README.md: Cross-references, add missing </a>

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Cross-references
Ian Jackson [Sun, 21 Jun 2020 13:25:15 +0000 (14:25 +0100)]
README.md: Cross-references

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Paragraph indentation, etc.
Ian Jackson [Sun, 21 Jun 2020 13:16:03 +0000 (14:16 +0100)]
README.md: Paragraph indentation, etc.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoPass options right after the cargo subommand
Ian Jackson [Sun, 21 Jun 2020 13:08:33 +0000 (14:08 +0100)]
Pass options right after the cargo subommand

This means that the user can pass non-option arguments to cargo (eg
for cargo run).

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoNew scheme for subcommand handling - seems to work, ish
Ian Jackson [Sun, 21 Jun 2020 12:58:46 +0000 (13:58 +0100)]
New scheme for subcommand handling - seems to work, ish

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoNew scheme for subcommand handling - wip
Ian Jackson [Sun, 21 Jun 2020 12:43:14 +0000 (13:43 +0100)]
New scheme for subcommand handling - wip

Does not work yet.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoNew scheme for subcommand handling - wip
Ian Jackson [Sun, 21 Jun 2020 11:47:31 +0000 (12:47 +0100)]
New scheme for subcommand handling - wip

Does not work yet.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: wip new argument parsing control spec
Ian Jackson [Sat, 20 Jun 2020 22:02:56 +0000 (23:02 +0100)]
README.md: wip new argument parsing control spec

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Implement new arg parsing rules
Ian Jackson [Sat, 20 Jun 2020 21:30:00 +0000 (22:30 +0100)]
nailing-cargo: Implement new arg parsing rules

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agonailing-cargo: Move arg parsing into a subroutine
Ian Jackson [Sat, 20 Jun 2020 11:45:37 +0000 (12:45 +0100)]
nailing-cargo: Move arg parsing into a subroutine

No functional change.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agooot: provide `disable' mode
Ian Jackson [Sat, 20 Jun 2020 11:37:35 +0000 (12:37 +0100)]
oot: provide `disable' mode

This allows more-locally overriding a more-global oot setting.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: update-readme-toc: add autogeneration warning
Ian Jackson [Fri, 19 Jun 2020 17:23:55 +0000 (18:23 +0100)]
README.md: update-readme-toc: add autogeneration warning

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Provide and run update-readme-toc
Ian Jackson [Fri, 19 Jun 2020 17:21:28 +0000 (18:21 +0100)]
README.md: Provide and run update-readme-toc

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: wip TOC, seems to generate nice output
Ian Jackson [Fri, 19 Jun 2020 17:20:22 +0000 (18:20 +0100)]
README.md: wip TOC, seems to generate nice output

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: wip TOC
Ian Jackson [Fri, 19 Jun 2020 17:17:33 +0000 (18:17 +0100)]
README.md: wip TOC

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: wip TOC
Ian Jackson [Fri, 19 Jun 2020 17:07:49 +0000 (18:07 +0100)]
README.md: wip TOC

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: wip TOC
Ian Jackson [Fri, 19 Jun 2020 17:03:49 +0000 (18:03 +0100)]
README.md: wip TOC

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Minor fiddling
Ian Jackson [Fri, 19 Jun 2020 16:49:20 +0000 (17:49 +0100)]
README.md: Minor fiddling

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Proposed invocation rework
Ian Jackson [Fri, 19 Jun 2020 16:46:57 +0000 (17:46 +0100)]
README.md: Proposed invocation rework

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Config reference tidying
Ian Jackson [Fri, 19 Jun 2020 12:42:55 +0000 (13:42 +0100)]
README.md: Config reference tidying

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Config reference: misc.online
Ian Jackson [Fri, 19 Jun 2020 12:39:42 +0000 (13:39 +0100)]
README.md: Config reference: misc.online

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Config reference: arch
Ian Jackson [Fri, 19 Jun 2020 12:34:36 +0000 (13:34 +0100)]
README.md: Config reference: arch

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: oot config: discuss build dir contents
Ian Jackson [Fri, 19 Jun 2020 12:32:16 +0000 (13:32 +0100)]
README.md: oot config: discuss build dir contents

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Config reference: oot
Ian Jackson [Fri, 19 Jun 2020 12:32:10 +0000 (13:32 +0100)]
README.md: Config reference: oot

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Config reference: packages and subdirs
Ian Jackson [Fri, 19 Jun 2020 12:22:57 +0000 (13:22 +0100)]
README.md: Config reference: packages and subdirs

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Config, start having section names in headings
Ian Jackson [Fri, 19 Jun 2020 12:22:42 +0000 (13:22 +0100)]
README.md: Config, start having section names in headings

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Clarify the precise `unified filesystem' view needs
Ian Jackson [Fri, 19 Jun 2020 11:25:09 +0000 (12:25 +0100)]
README.md: Clarify the precise `unified filesystem' view needs

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Fix missing bullet point re alt lock leafname
Ian Jackson [Fri, 19 Jun 2020 11:24:35 +0000 (12:24 +0100)]
README.md: Fix missing bullet point re alt lock leafname

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: With oot.use=ssh, user may be just username
Ian Jackson [Fri, 19 Jun 2020 11:19:39 +0000 (12:19 +0100)]
README.md: With oot.use=ssh, user may be just username

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Fix discussion of Cargo.lock leafname filesystem
Ian Jackson [Fri, 19 Jun 2020 11:13:35 +0000 (12:13 +0100)]
README.md: Fix discussion of Cargo.lock leafname filesystem

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Improve Make Cargo.lock leafnamme options
Ian Jackson [Fri, 19 Jun 2020 11:09:53 +0000 (12:09 +0100)]
README.md: Improve Make Cargo.lock leafnamme options

Make the grammar and punctuation more consistent.  Reorganise the list
to make it easier to read.

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Make -O | --offline ordering consistent
Ian Jackson [Fri, 19 Jun 2020 11:06:34 +0000 (12:06 +0100)]
README.md: Make -O | --offline ordering consistent

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Fix bungled markup for `fetch`
Ian Jackson [Fri, 19 Jun 2020 11:06:01 +0000 (12:06 +0100)]
README.md: Fix bungled markup for `fetch`

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Add missing comma to -m description
Ian Jackson [Fri, 19 Jun 2020 11:04:48 +0000 (12:04 +0100)]
README.md: Add missing comma to -m description

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Reorganise -A description to clarify it
Ian Jackson [Fri, 19 Jun 2020 11:04:03 +0000 (12:04 +0100)]
README.md: Reorganise -A description to clarify it

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Add missing word in -A description
Ian Jackson [Fri, 19 Jun 2020 11:02:59 +0000 (12:02 +0100)]
README.md: Add missing word in -A description

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Clarify wording re `packages`
Ian Jackson [Fri, 19 Jun 2020 11:02:03 +0000 (12:02 +0100)]
README.md: Clarify wording re `packages`

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Remove a confusing comma
Ian Jackson [Fri, 19 Jun 2020 11:01:55 +0000 (12:01 +0100)]
README.md: Remove a confusing comma

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Write ` ` around Cargo.foo filenames
Ian Jackson [Fri, 19 Jun 2020 11:00:33 +0000 (12:00 +0100)]
README.md: Write ` ` around Cargo.foo filenames

This was previously not always done consistently.

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Make 4th function grammar consistent
Ian Jackson [Fri, 19 Jun 2020 10:55:50 +0000 (11:55 +0100)]
README.md: Make 4th function grammar consistent

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Remove ` ` around make
Ian Jackson [Fri, 19 Jun 2020 10:55:02 +0000 (11:55 +0100)]
README.md: Remove ` ` around make

I think now ` ` are not used around program names.

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Remove ` ` around nailing-cargo and cargo
Ian Jackson [Fri, 19 Jun 2020 10:54:32 +0000 (11:54 +0100)]
README.md: Remove ` ` around nailing-cargo and cargo

Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
3 years agoREADME.md: Clarify dirtying bug
Ian Jackson [Fri, 19 Jun 2020 10:51:44 +0000 (11:51 +0100)]
README.md: Clarify dirtying bug

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>