← Back to branch summary

~ubuntu-branches/ubuntu/hoary/binutils/hoary

« back to all changes in this revision

Viewing changes to binutils/doc/ranlib.1

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2005-03-18 13:07:52 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20050318130752-j4i37zgqclj53b94
Tags: 2.15-5ubuntu2
debian/rules: Call pkgstriptranslations if present (the package does not
use debhelper, thus it does not happen automatically).

Show diffs side-by-side

added added

removed removed

Lines of Context:
binutils/doc/ranlib.1
 
1
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
 
2
.\"
 
3
.\" Standard preamble:
 
4
.\" ========================================================================
 
5
.de Sh \" Subsection heading
 
6
.br
 
7
.if t .Sp
 
8
.ne 5
 
9
.PP
 
10
\fB\\$1\fR
 
11
.PP
 
12
..
 
13
.de Sp \" Vertical space (when we can't use .PP)
 
14
.if t .sp .5v
 
15
.if n .sp
 
16
..
 
17
.de Vb \" Begin verbatim text
 
18
.ft CW
 
19
.nf
 
20
.ne \\$1
 
21
..
 
22
.de Ve \" End verbatim text
 
23
.ft R
 
24
.fi
 
25
..
 
26
.\" Set up some character translations and predefined strings.  \*(-- will
 
27
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
 
28
.\" double quote, and \*(R" will give a right double quote.  | will give a
 
29
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
 
30
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
 
31
.\" expand to `' in nroff, nothing in troff, for use with C<>.
 
32
.tr \(*W-|\(bv\*(Tr
 
33
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 
34
.ie n \{\
 
35
.    ds -- \(*W-
 
36
.    ds PI pi
 
37
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
 
38
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
 
39
.    ds L" ""
 
40
.    ds R" ""
 
41
.    ds C` ""
 
42
.    ds C' ""
 
43
'br\}
 
44
.el\{\
 
45
.    ds -- \|\(em\|
 
46
.    ds PI \(*p
 
47
.    ds L" ``
 
48
.    ds R" ''
 
49
'br\}
 
50
.\"
 
51
.\" If the F register is turned on, we'll generate index entries on stderr for
 
52
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
 
53
.\" entries marked with X<> in POD.  Of course, you'll have to process the
 
54
.\" output yourself in some meaningful fashion.
 
55
.if \nF \{\
 
56
.    de IX
 
57
.    tm Index:\\$1\t\\n%\t"\\$2"
 
58
..
 
59
.    nr % 0
 
60
.    rr F
 
61
.\}
 
62
.\"
 
63
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 
64
.\" way too many mistakes in technical documents.
 
65
.hy 0
 
66
.\"
 
67
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
 
68
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
 
69
.    \" fudge factors for nroff and troff
 
70
.if n \{\
 
71
.    ds #H 0
 
72
.    ds #V .8m
 
73
.    ds #F .3m
 
74
.    ds #[ \f1
 
75
.    ds #] \fP
 
76
.\}
 
77
.if t \{\
 
78
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
 
79
.    ds #V .6m
 
80
.    ds #F 0
 
81
.    ds #[ \&
 
82
.    ds #] \&
 
83
.\}
 
84
.    \" simple accents for nroff and troff
 
85
.if n \{\
 
86
.    ds ' \&
 
87
.    ds ` \&
 
88
.    ds ^ \&
 
89
.    ds , \&
 
90
.    ds ~ ~
 
91
.    ds /
 
92
.\}
 
93
.if t \{\
 
94
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 
95
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 
96
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 
97
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 
98
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 
99
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 
100
.\}
 
101
.    \" troff and (daisy-wheel) nroff accents
 
102
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 
103
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 
104
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 
105
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 
106
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 
107
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 
108
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 
109
.ds ae a\h'-(\w'a'u*4/10)'e
 
110
.ds Ae A\h'-(\w'A'u*4/10)'E
 
111
.    \" corrections for vroff
 
112
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 
113
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 
114
.    \" for low resolution devices (crt and lpr)
 
115
.if \n(.H>23 .if \n(.V>19 \
 
116
\{\
 
117
.    ds : e
 
118
.    ds 8 ss
 
119
.    ds o a
 
120
.    ds d- d\h'-1'\(ga
 
121
.    ds D- D\h'-1'\(hy
 
122
.    ds th \o'bp'
 
123
.    ds Th \o'LP'
 
124
.    ds ae ae
 
125
.    ds Ae AE
 
126
.\}
 
127
.rm #[ #] #H #V #F C
 
128
.\" ========================================================================
 
129
.\"
 
130
.IX Title "RANLIB 1"
 
131
.TH RANLIB 1 "2004-04-09" "binutils-2.14.91" "GNU Development Tools"
 
132
.SH "NAME"
 
133
ranlib \- generate index to archive.
 
134
.SH "SYNOPSIS"
 
135
.IX Header "SYNOPSIS"
 
136
ranlib [\fB\-vV\fR] \fIarchive\fR
 
137
.SH "DESCRIPTION"
 
138
.IX Header "DESCRIPTION"
 
139
\&\fBranlib\fR generates an index to the contents of an archive and
 
140
stores it in the archive.  The index lists each symbol defined by a
 
141
member of an archive that is a relocatable object file.  
 
142
.PP
 
143
You may use \fBnm \-s\fR or \fBnm \-\-print\-armap\fR to list this index.
 
144
.PP
 
145
An archive with such an index speeds up linking to the library and
 
146
allows routines in the library to call each other without regard to
 
147
their placement in the archive.
 
148
.PP
 
149
The \s-1GNU\s0 \fBranlib\fR program is another form of \s-1GNU\s0 \fBar\fR; running
 
150
\&\fBranlib\fR is completely equivalent to executing \fBar \-s\fR.
 
151
.SH "OPTIONS"
 
152
.IX Header "OPTIONS"
 
153
.IP "\fB\-v\fR" 4
 
154
.IX Item "-v"
 
155
.PD 0
 
156
.IP "\fB\-V\fR" 4
 
157
.IX Item "-V"
 
158
.IP "\fB\-\-version\fR" 4
 
159
.IX Item "--version"
 
160
.PD
 
161
Show the version number of \fBranlib\fR.
 
162
.SH "SEE ALSO"
 
163
.IX Header "SEE ALSO"
 
164
\&\fIar\fR\|(1), \fInm\fR\|(1), and the Info entries for \fIbinutils\fR.
 
165
.SH "COPYRIGHT"
 
166
.IX Header "COPYRIGHT"
 
167
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000,
 
168
2001, 2002, 2003 Free Software Foundation, Inc.
 
169
.PP
 
170
Permission is granted to copy, distribute and/or modify this document
 
171
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
 
172
or any later version published by the Free Software Foundation;
 
173
with no Invariant Sections, with no Front-Cover Texts, and with no
 
174
Back-Cover Texts.  A copy of the license is included in the
 
175
section entitled ``\s-1GNU\s0 Free Documentation License''.