V10/630/man/src/u_man/man1/mc68lorder.1

Compare this file to the similar file:
Show the results in this format:
.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.