build: Better Build System

1 files changed, 63 insertions, 0 deletions

diff --git a/static/unix-v10/man1/mc68lorder.1 b/static/unix-v10/man1/mc68lorder.1
new file mode 100755
index 00000000..6eb484ff
--- /dev/null
+++ b/static/unix-v10/man1/mc68lorder.1
@@ -0,0 +1,63 @@
+.ds ZZ DEVELOPMENT PACKAGE
+.TH MC68LORDER 1 "630 MTG"
+.SH NAME
+mc68lorder \- find ordering relation for an object library
+.SH SYNOPSIS
+.B mc68lorder
+file ...
+.SH DESCRIPTION
+The input
+is one or more object or library archive
+.I files\^
+[see
+.IR mc68ar (1)].
+The standard output
+is a list of pairs of object file names,
+meaning that the first file of the pair refers to
+external identifiers defined in the second file.
+The output may be processed by
+.IR tsort (1)
+to find an ordering of
+a library suitable for one-pass access by
+.IR mc68ld (1).
+Note that the link editor
+.IR mc68ld (1)
+is capable of multiple passes over an archive in the portable archive format
+[see
+.IR ar (4)]
+and does not require that
+.IR mc68lorder (1)
+be used when building an archive.  The usage of 
+the
+.IR mc68lorder (1)
+command may, however, allow for a slightly more efficient access of
+the archive during the link edit process.
+.PP
+The following example builds a new library
+from existing
+.B \&.o
+files.
+.PP
+.RS
+.ft CM
+mc68ar cr library `mc68lorder \(**.o | tsort`
+.ft 1
+.RE
+.SH FILES
+\(**symref, \(**symdef	temporary files
+.SH "SEE ALSO"
+mc68ar(1),
+mc68ld(1).
+.br
+ar(4) in the \f2UNIX System V Programmer's Reference
+Manual\f1.
+.br
+tsort(1) in the
+\f2\s-1UNIX\s+1 System V User Reference Manual\f1.
+.SH BUGS
+Object files whose names do not end with
+.BR .o ,
+even when
+contained in library archives, are overlooked.
+The global symbols and references are attributed to
+some other file.