Remove more, update docs

Author: Lars T Hansen

doc/CHANGELOG.md

@@ -5,23 +5,19 @@ general, all relevant fixes are uplifted from release branches to main, so a cha
 will always be on main and in all later releases.
 
 Since v0.13.0, the output format is documented mainly by the file
-[util/formats/newfmt/types.go](../util/formats/newfmt/types.go), which specifies the new JSON output
+[util/formats/newfmt/types.go](../util/formats/newfmt/types.go), which specifies the JSON output
 format in terms of a Go data structure with JSON annotations.  Changes to the output format can most
 easily be be seen by diffing this file against a desired tag, starting with "v0.13.0".  Such changes
-are therefore no longer mentioned specially below.  Recall that to get the new format, Sonar must be
-run in daemon mode or with the --json switch (which also requires the --cluster).
+are therefore no longer mentioned specially below.
 
-The "old" output formats are for the most part not being extended with new fields and should not be
-relied upon.  Consumers should expect to see the "new" JSON format for new data, and all producers
-should ask for that format.
 
 ## Changes in v0.17.0 (on `main`)
 
-* Bug 244 - **REMOVED FUNCTIONALITY.** Remove all code related to producing CSV and the "old"
-  JSON format, asking for those formats will now cause errors.  The --json switch is still
-  accepted but has no effect.
-* Bug 434 - **IMPORTANT FUNCTIONALITY.** Introduce the batch-size setting to allow very large
-  slurm job lists to be split into multiple messages.
+* Bug 244 - **REMOVED FUNCTIONALITY.** Remove all code related to producing CSV and the "old" JSON
+  format, asking for those formats will now cause errors.  The --json switch is still accepted but
+  has no effect.
+* Bug 434 - **IMPORTANT FUNCTIONALITY.** Introduce the batch-size setting to allow very large slurm
+  job lists to be split into multiple messages.
 
 
 ## Changes in v0.16.0 (on `release_0_16`)
@@ -32,8 +28,8 @@ should ask for that format.
 * Bug 352 - **MAJOR FUNCTIONALITY.**  Populate the `topo_svg` field, introduce a `topo_text` field,
   and expand the config file so as to be able to specify how to generate those data
 * Bug 353 - Remove the `software` field.
-* Bug 387 - **IMPORTANT FIX.** Parse some slurm data, notably ReqMem, correctly.  Previously the parser
-  would always return 0 for this field
+* Bug 387 - **IMPORTANT FIX.** Parse some slurm data, notably ReqMem, correctly.  Previously the
+  parser would always return 0 for this field
 * Bug 401 - better error messages for Kafka
 * Bug 402 - synthesize a UUID on AMD cards when needed
 * Bug 402 - change the syntax of synthesized UUIDs on XPU (now joint with AMD)
@@ -43,10 +39,10 @@ should ask for that format.
   is no longer a required argument for that (defaulting to the empty string).
 * Bug 410 - output on stderr does not by itself cause a subcommand to fail, so long as the
   exit code is 0
-* Bug 409 / 437 - **MAJOR FUNCTIONALITY.** Run scontrol in addition to sacct in order to extract resource
-  request for pending jobs.  Remove the unused `gres_detail` field of slurm job data and introduce
-  two fields `allocated_resources` and `requested_resources` and fill them with unparsed resouce data from
-  sacct and scontrol.
+* Bug 409 / 437 - **MAJOR FUNCTIONALITY.** Run scontrol in addition to sacct in order to extract
+  resource request for pending jobs.  Remove the unused `gres_detail` field of slurm job data and
+  introduce two fields `allocated_resources` and `requested_resources` and fill them with unparsed
+  resouce data from sacct and scontrol.
 * Testing (sundry): Many testing improvements
 * Doc (sundry): Various improvements
 

util/Makefile

@@ -5,9 +5,7 @@ all:
 
 test:
 	( cd formats ; $(MAKE) test )
-	( cd ingest-files ; $(MAKE) test )
 
 format:
 	( cd formats ; $(MAKE) format )
-	( cd ingest-files ; $(MAKE) format )
 

util/README.md

@@ -1,10 +1,3 @@
 In `formats/` are definitions of the Sonar data formats, as high-level Go code, and simple parsers
-for the most important of the formats.  Currently there are definitions for the initial v0.13 and
-older format, known here as "old" because there's a "new" format coming.
-
-There is a sample client of the format definition:
-
-* In `ingest-files/` is a program that will attempt to read old-format data from a directory tree.
-
-The ingestor program is a sensible basis for a program that obtains data and stores them in a
-database, for example.
+for the most important of the formats.  Currently there is a definition for only a JSON format
+(previously known as the "new" format since there were older formats than that).

util/formats/README.md

@@ -1 +1 @@
-Defines the old and new Sonar data formats in a reusable module, and parsers for the old data.
+Defines the Sonar data format in a reusable, machine-processable module.