]> git.donarmstrong.com Git - debhelper.git/blob - dh_makeshlibs.1
r273: * dh_installdocs.1: clarified how the doc-id is determined. Closes: #44864
[debhelper.git] / dh_makeshlibs.1
1 .TH DH_MAKESHLIBS 1 "" "Debhelper Commands" "Debhelper Commands"
2 .SH NAME
3 dh_makeshlibs \- automatically create shlibs file
4 .SH SYNOPSIS
5 .B dh_makeshlibs
6 .I "[debhelper options] [-mmajor] [-V[dependancies]]"
7 .SH "DESCRIPTION"
8 dh_makeshlibs is a debhelper program that automatically scans for shared
9 libraries, and generates a shlibs file for the libraries it finds.
10 .SH OPTIONS
11 .TP
12 .B debhelper options
13 See
14 .BR debhelper (1)
15 for a list of options common to all debhelper commands.
16 .TP
17 .B \-mmajor, \--major=major
18 Instead of trying to guess the major number of the library from the filename
19 of the library, use the major number specified after the -m parameter.
20 .TP
21 .B \-V[dependancies], \--version-info, \--version-info=dependancies
22 By default, the shlibs file generated by this program does not make packages
23 depend on any particular version of the package containing the shared
24 library. It may be necessary for you to add some version dependancy
25 information to the shlibs file. If -V is specified with no dependancy
26 information, the current version of the package is plugged into a dependancy
27 that looks like "packagename (>= packageversion)". If -V is specified with
28 parameters, the parameters can be used to specify the exact dependancy
29 information needed (be sure to include the package name).
30 .SH EXAMPLES
31 .TP
32 .B dh_makeshlibs
33 Assuming this is a package named libfoobar1, generates a shlibs file that
34 looks something like:
35   libfoobar 1 libfoobar1
36 .TP
37 .B dh_makeshlibs \-V
38 Assuming the current version of the package is 1.0-3, generates a shlibs
39 file that looks something like:
40   libfoobar 1 libfoobar1 (>= 1.0-3)
41 .TP
42 .B dh_makeshlibs \-V "'libfoobar1 (>= 1.0)'"
43 Generates a shlibs file that looks something like:
44   libfoobar 1 libfoobar1 (>= 1.0)
45 .SH ENVIRONMENT
46 See
47 .BR debhelper (1)
48 for a list of environment variables that affect all debhelper commands.
49 .SH "SEE ALSO"
50 .BR debhelper (1)
51 .SH BUGS
52 There is no guarantee that the program will get the shlibs file right. For
53 example, it may not correctly guess the major number of your package. In
54 cases like these (and perhaps in general, just to be safe), it is better to
55 create a debian/shlibs file by hand, or force it to use the correct major
56 number by specifying the -m parameter.
57 .P
58 This is a "do what I Mean" type program - you have been warned!
59 .SH AUTHOR
60 Joey Hess <joeyh@master.debian.org>