5 commits

Author	SHA1	Message	Date
John Ericson	0746951be1	Finish converting existing comments for internal API docs (#8146) ... * Finish converting existing comments for internal API docs 99% of this was just reformatting existing comments. Only two exceptions: - Expanded upon `BuildResult::status` compat note - Split up file-level `symbol-table.hh` doc comments to get per-definition docs Also fixed a few whitespace goofs, turning leading tabs to spaces and removing trailing spaces. Picking up from #8133 * Fix two things from comments * Use triple-backtick not indent for `dumpPath` * Convert GNU-style `\`..'` quotes to markdown style in API docs This will render correctly.	2023-04-07 13:55:28 +00:00
John Ericson	f4ab297b31	Ensure all headers have #pragma once and are in API docs ... `///@file` makes them show up in the internal API dos. A tiny few were missing `#pragma once`.	2023-03-31 23:19:44 -04:00
John Ericson	a03b1fd7f6	Deduplicate the Store downcasting with a template	2022-03-11 13:32:33 +00:00
John Ericson	073e134de6	Rename requireGcStore to GcStore::require ... I should have done this to begin with. This will be nicer once more Store sub-interfaces exist too, to illustrate the pattern.	2022-03-11 13:27:38 +00:00
John Ericson	6636202356	Factor out a GcStore interface ... Starts progress on #5729. The idea is that we should not have these default methods throwing "unimplemented". This is a small step in that direction. I kept `addTempRoot` because it is a no-op, rather than failure. Also, as a practical matter, it is called all over the place, while doing other tasks, so the downcasting would be annoying. Maybe in the future I could move the "real" `addTempRoot` to `GcStore`, and the existing usecases use a `tryAddTempRoot` wrapper to downcast or do nothing, but I wasn't sure whether that was a good idea so with a bias to less churn I didn't do it yet.	2022-03-03 19:01:25 +00:00