Version 0.4.00.4.0

1 files changed, 75 insertions, 0 deletions

diff --git a/man/mcpu-ar.1 b/man/mcpu-ar.1
new file mode 100644
index 0000000..3de29f8
--- /dev/null
+++ b/man/mcpu-ar.1
@@ -0,0 +1,75 @@
+.TH MCPU-AR 1 "October 2026" "LibMCPU" "User Commands"
+
+.SH NAME
+mcpu-ar \- create and maintain deterministic MCPU static archives
+.SH SYNOPSIS
+.B mcpu-ar
+.RI [ options ] " operation archive " [ member ...]
+.SH DESCRIPTION
+.B mcpu-ar
+creates and maintains deterministic UNIX ar archives whose ordinary members
+are MCPU MELF ET_REL objects.  Member order is preserved.  A standard
+System-V/GNU-style archive symbol index can be built with the s operation or
+modifier and is used by
+.BR mcpu-ld (1)
+for selective extraction.
+.SH OPERATIONS
+.TP
+.B r
+Replace matching members in place or append members not already present.
+.TP
+.B q
+Append members without replacement.
+.TP
+.B d
+Delete named members.
+.TP
+.B t
+List members.
+.TP
+.B p
+Write selected member contents to standard output.
+.TP
+.B x
+Extract selected members into the current directory.
+.TP
+.B s
+Rebuild the archive symbol index.
+.SH MODIFIERS
+.TP
+.B c
+Accepted for ar compatibility; archive creation is quiet.
+.TP
+.B s
+Write or rebuild the standard archive symbol index.
+.TP
+.B v
+Verbose operation.
+.PP
+Operation and modifiers may be combined, for example rcs, tv or xv.
+.SH OPTIONS
+.TP
+.B --help
+Display help and exit.
+.TP
+.B --version
+Display the program name, MCPU toolchain identity and version, then exit.
+.TP
+.B --dump-version
+Display only the MCPU package version number and exit.
+.SH EXIT STATUS
+Zero on success; nonzero on malformed archives, invalid members, I/O or command
+errors.
+.SH EXAMPLES
+.nf
+mcpu-ar rcs libsimple.a add-one.o add-two.o value.o
+mcpu-ar t libsimple.a
+mcpu-ar tv libsimple.a
+mcpu-ar x libsimple.a add-one.o
+mcpu-ar s libsimple.a
+.fi
+.SH SEE ALSO
+.BR mcpu-ld (1),
+.BR mcpu-nm (1),
+.BR mcpu-objdump (1),
+.BR libmcpu (7)