Check all A* components for extras, changes, ..

Purpose

a-check checks all the A* components as specified in environment variable ASTAR for:

Extra files that are not under A* version control.
Changes to files that are pending.
New files that have been added.

Usage

Run a-check and assuming that environment variable ASTAR is the A* components and that your path includes $ASTAR/bin you will get list of components, number of extra files or changed files followed by the name of the files.

% a-check
a-check              6   extra      KEYWORDS Makefile README.md a-check main.md talk.md
a-event              5   extra      KEYWORDS Makefile README.md a-event main.md
a-fui                1   extra      a-fui
a-make               1   extra      a-make
a-make               1   changed    Makefile
a-merge              9   extra      COPYRIGHT KEYWORDS LICENSE Makefile README README.md a-merge main.md talk.md
a-new                4   extra      KEYWORDS Makefile README talk.md
a-new                1   changed    a-new
a-notes-to-npv       10  extra      COPYRIGHT KEYWORDS LICENSE Makefile README.md a-notes-to-npv main.md talk.md tests/test.md tests/word-example-md.docx
a-npv-to-csv         1   extra      a-npv-to-csv
a-pdf-notes-to-npv   1   extra      a-pdf-notes-to-npv
a-star-microgrid-pub 55  extra      COPYRIGHT LICENSE README.md photos/102k/Digital-Intelligence.jpg photos/102k/MawsonWtg.jpg photos/102k/Ross-Island-Team.jpg photos/102k/Wtg.jpg photos/102k/WtgTower.jpg photos/102k/e40-bremerbay.jpg photos/102k/flores-hydro.jpg photos/102k/lld-bremerbay.jpg photos/102k/phil-face.jpg photos/102k/phil-furthest-south.jpg photos/102k/pstore.jpg photos/102k/vergnet-wtg.jpg photos/ACEPlogo.jpg photos/BSA.png photos/DalyRiver.jpeg photos/Digital-Intelligence.jpg photos/EPG_Solutions_Logo_White.svg photos/M-Troop.png photos/MawsonWtg.jpg photos/PC-map.png photos/Ross-Island-Team.jpg photos/SETuP-map.png photos/Wtg.jpg photos/WtgTower.jpg photos/denamics-logo.png photos/dilbert-logo.png photos/e40-bremerbay.jpg photos/energynautics-logo.svg photos/flores-hydro.jpg photos/fossil3.gif photos/kukri.jpg photos/lld-bremerbay.jpg photos/openbsd.png photos/phil-face.jpg photos/phil-furthest-south.jpg photos/pikchr-url.png photos/proconx_logo-website.v3.svg photos/proofcraft-future.svg photos/pstore.jpg photos/raspberrypi.png photos/sel4-logo-white.svg photos/solar-bad-days.jpg photos/valid-html401.png photos/vergnet-wtg.jpg processes/Makefile processes/README processes/info-flow.png processes/info-flow.puml processes/initial-investigation.png processes/initial-investigation.puml processes/skin.puml talks/trend-training.avi
a-star-microgrid-pub 1   changed    a-star-home.md
a-sysgen             1   extra      a-sysgen
a-weave-doc          5   extra      KEYWORDS Makefile README main.md talk.md
license-a-star       3   extra      COPYRIGHT LICENSE README.md
md-annotated-to-npv  10  extra      COPYRIGHT KEYWORDS LICENSE Makefile README README.md main.md md-annotated-to-npv talk.md x.md
www-pub-a-star       2   extra      photos/mariko-unifi-video.png talk.md

The command takes an optional argument which limits the search to components match a glob pattern, e.g.

% a-check "a-*"

Exit Status

a-check exits with status 0 if there are no changes/message. Otherwise it returns 1.

This intended for use in Makefile where a release target might need to check if there are any pending changes, e.g.

release:
  a-check
  actual work