config/doc/config.sub.1
John Ericson 39c49ea712 config.sub: Systematize parsing of machine code formats
Instead of treating them as OSes, we treat them as their own category.
This is modeled on what LLVM does with its `ObjectFormatType` enum [1],
advancing my long-running project of trying to nudge GNU config and LLVM
towards each other, taking the best ideas of both.

Currently, my emphasis is just on code cleanup. There are just a few
tests for newly supported changes that fall out of this. But down the
road, this also opens the door to parsing configs with more than 4
components, like [2].

[1]: https://llvm.org/doxygen/classllvm_1_1Triple.html#a83e907e55fa50e093caa96a0aff96201

[2]: a18266473b/llvm/unittests/TargetParser/TripleTest.cpp (L1873C50-L1873C77)
added in
28b82bc39e

* config.sub: Save machine code format name separately from the OS name.
* doc/config.sub.1: Regenerate.
* testsuite/config-sub.data (arm-unknown-none-aout,
arm-unknown-none-pe): New entries.

Signed-off-by: Dmitry V. Levin <ldv@altlinux.org>
2023-08-07 18:20:40 +00:00

28 lines
863 B
Groff

.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5.
.TH CONFIG.SUB "1" "August 2023" "GNU config.sub (2023-08-07)" "User Commands"
.SH NAME
config.sub \- validate and canonicalize a configuration triplet
.SH SYNOPSIS
.B config.sub
[\fI\,OPTION\/\fR] \fI\,CPU-MFR-OPSYS or ALIAS\/\fR
.SH DESCRIPTION
Canonicalize a configuration name.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
print this help, then exit
.TP
\fB\-t\fR, \fB\-\-time\-stamp\fR
print date of last modification, then exit
.TP
\fB\-v\fR, \fB\-\-version\fR
print version number, then exit
.SH "REPORTING BUGS"
Report bugs and patches to <config\-patches@gnu.org>.
.SH COPYRIGHT
Copyright 1992\-2023 Free Software Foundation, Inc.
.PP
.br
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.