Tcl Source Code

Good idea to document this. I approve! Review of the candidate manpage follows:

I'm wondering whether the SYNOPSIS is too busy.

Perhaps it would be better as just this:

\fB::tcl::build-info\fR ?\fIfield\fR?

That says you the command has one optional argument, field, and that's basically all that it needs to say.

I guess the DESCRIPTION should then be:

This command provides a way to retrieve information about how Tcl was built.
Without a \fIfield\fR, the command returns the Tcl patchlevel, followed
by the '\fB+\fR'-sign, followed by the fossil commit-id followed by a list of
dot-separated tags. If a \fIfield\fR is given, this command extracts that
field as described below. For official Tcl releases, the \fIfield\fRs are:

The remaining parts of the manual page look fine. Perhaps we ought to add more references into the SEE ALSO section? (platform(n) and tcl_platform(n)/tclvars(n) would be my candidates.)

If you don't change the SYNOPSIS as suggested, at least remove the ? from the first line of it; the subsequent lines make it unnecessary in that case and it's technically ambiguous according to our simple command syntax rules.

Do as you will with the review, but I hope it helps.