summaryrefslogtreecommitdiffstats
path: root/usr.bin/ar
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2000-11-20 19:21:22 +0000
committerru <ru@FreeBSD.org>2000-11-20 19:21:22 +0000
commit0d1334ca0c7f5a53195b38b126d726747949ce5d (patch)
tree399269f867eeb084bb6edf479f12b35526a9edb4 /usr.bin/ar
parent0100fd6e93e8e0203ec077685f3e68afea54de52 (diff)
downloadFreeBSD-src-0d1334ca0c7f5a53195b38b126d726747949ce5d.zip
FreeBSD-src-0d1334ca0c7f5a53195b38b126d726747949ce5d.tar.gz
mdoc(7) police: use the new features of the Nm macro.
Diffstat (limited to 'usr.bin/ar')
-rw-r--r--usr.bin/ar/ar.140
-rw-r--r--usr.bin/ar/ar.56
2 files changed, 23 insertions, 23 deletions
diff --git a/usr.bin/ar/ar.1 b/usr.bin/ar/ar.1
index 3741299..d452f92 100644
--- a/usr.bin/ar/ar.1
+++ b/usr.bin/ar/ar.1
@@ -41,45 +41,45 @@
.Nm ar
.Nd create and maintain library archives
.Sh SYNOPSIS
-.Nm ar
+.Nm
.Fl d
.Op Fl \Tv
.Ar archive file ...
-.Nm ar
+.Nm
.Fl m
.Op Fl \Tv
.Ar archive file ...
-.Nm ar
+.Nm
.Fl m
.Op Fl abiTv
.Ar position archive file ...
-.Nm ar
+.Nm
.Fl p
.Op Fl \Tv
.Ar archive [file ...]
-.Nm ar
+.Nm
.Fl q
.Op Fl cTv
.Ar archive file ...
-.Nm ar
+.Nm
.Fl r
.Op Fl cuTv
.Ar archive file ...
-.Nm ar
+.Nm
.Fl r
.Op Fl abciuTv
.Ar position archive file ...
-.Nm ar
+.Nm
.Fl t
.Op Fl \Tv
.Ar archive [file ...]
-.Nm ar
+.Nm
.Fl x
.Op Fl ouTv
.Ar archive [file ...]
.Sh DESCRIPTION
The
-.Nm ar
+.Nm
utility creates and maintains groups of files combined into an archive.
Once an archive has been created, new files can be added and existing
files can be extracted, deleted, or replaced.
@@ -98,7 +98,7 @@ on the command line to ``select'' archive files for an operation, only the
file with a matching name will be selected.
.Pp
The normal use of
-.Nm ar
+.Nm
is for the creation and maintenance of libraries suitable for use with
the loader (see
.Xr ld 1 )
@@ -131,7 +131,7 @@ is written to standard error.
If the
.Fl c
option is specified,
-.Nm ar
+.Nm
creates the archive silently.
.It Fl d
Delete the specified archive files.
@@ -218,14 +218,14 @@ When used with the
or
.Fl x
options,
-.Nm ar
+.Nm
gives a file-by-file description of the archive modification.
This description consists of three, white-space separated fields: the
option letter, a dash (``-'') and the file name.
When used with the
.Fl r
option,
-.Nm ar
+.Nm
displays the description as above, but the initial letter is an ``a'' if
the file is added to the archive and an ``r'' if the file replaces a file
already in the archive.
@@ -243,7 +243,7 @@ followed by two newline characters.
When used with the
.Fl t
option,
-.Nm ar
+.Nm
displays an ``ls -l'' style listing of information about the members of
the archive.
This listing consists of eight, white-space separated fields:
@@ -271,7 +271,7 @@ extracted file or the super-user.
.El
.Pp
The
-.Nm ar
+.Nm
utility exits 0 on success, and >0 if an error occurs.
.Sh ENVIRONMENT
.Bl -tag -width indent -compact
@@ -287,14 +287,14 @@ temporary file names
.El
.Sh COMPATIBILITY
By default,
-.Nm ar
+.Nm
writes archives that may be incompatible with historic archives, as
the format used for storing archive members with names longer than
fifteen characters has changed.
This implementation of
-.Nm ar
+.Nm
is backward compatible with previous versions of
-.Nm ar
+.Nm
in that it can read and write (using the
.Fl T
option) historic archives.
@@ -307,7 +307,7 @@ See
for more information.
.Sh STANDARDS
The
-.Nm ar
+.Nm
utility is expected to offer a superset of the
.St -p1003.2
functionality.
diff --git a/usr.bin/ar/ar.5 b/usr.bin/ar/ar.5
index e163cf6..e04e353 100644
--- a/usr.bin/ar/ar.5
+++ b/usr.bin/ar/ar.5
@@ -42,14 +42,14 @@
.Fd #include <ar.h>
.Sh DESCRIPTION
The archive command
-.Nm ar
+.Nm
combines several files into one.
Archives are mainly used as libraries of object files intended to be
loaded using the link-editor
.Xr ld 1 .
.Pp
A file created with
-.Nm ar
+.Nm
begins with the ``magic'' string "!<arch>\en".
The rest of the archive is made up of objects, each of which is composed
of a header for a file, a possible file name, and the file contents.
@@ -108,7 +108,7 @@ character, although the size in the header does not reflect this.
.Xr stat 2
.Sh HISTORY
There have been at least four
-.Nm ar
+.Nm
formats.
The first was denoted by the leading ``magic'' number 0177555 (stored as
type int).
OpenPOWER on IntegriCloud