tree cdbec44618aada6529116f8e1b6f563b7f88683c
parent baa7b38160246c52ae4dc6ba5dcab4a24a4d59f8
author Dmitri Shuralyov <dmitshur@golang.org> 1615325219 -0500
committer Dmitri Shuralyov <dmitshur@golang.org> 1615403263 +0000

all: improve update-readmes.go and regenerate package READMEs

Some of README.md files were initially generated by update-readmes.go,
but later had some additional information appended. Re-running update-
readmes.go blasts away those changes, and requires manually reverting
the deletions. This makes it expensive to re-run update-readmes.go to
add new READMEs or update existing ones.

Solve this problem by adding support for a special "<!-- End of auto-
generated section -->" comment and making update-readmes.go preserve
any content after it.

After this change, re-running update-readmes.go produces a zero diff.

Also set the working directory when using build.Import so that packages
inside nested modules work okay.

Add the missing first word 'Package' to ./internal/datastore/fake doc.

Change-Id: If7ba92a297eebeec8029d48d760acb1daa7f263e
Reviewed-on: https://go-review.googlesource.com/c/build/+/300229
Trust: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Alexander Rakoczy <alex@golang.org>
Reviewed-by: Carlos Amedee <carlos@golang.org>