summaryrefslogtreecommitdiffstats
path: root/man_pages_other.html
blob: dec25e13e2a4b9413f3fe44e48ee127357b970a3 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
        "https://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html;charset=utf-8" />
<link rel=stylesheet type="text/css" href="style.css" title="style">
<title>
Manual pages from other packages
</title>
</head>

<body>

<!--BEGIN-LINKS-->
<form method="get" action="https://www.google.com/search">
<table border=0 cellpadding=0 cellspacing=0 width="100%">
<tr>
<td align="left">
<font size="-1">

Linux <em>man-pages</em>: &nbsp;
<a href="./index.html">home</a> | 
<a href="https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/README">readme</a> | 
<a href="https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING">contributing</a>
&nbsp; || &nbsp; 
<a href="https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git">git</a> |
<a href="https://man7.org/linux/man-pages/index.html">online pages</a></font>
</td>
<td align="right">
<input type="text" name="q" size=10 maxlength=255 value="">
<input type="hidden" name="sitesearch" value="man7.org/linux/man-pages">
<input type="submit" name="sa" value="Search online pages">
</td>
</tr>
</table>
</form>
<!--END-LINKS-->



<h1>Manual pages from other packages</h1>

    <p>
        Not all Linux man pages are part of the <em>man-pages</em> set.
        In particular,
        most Section 1, 6, and 8 pages come as part of some other package,
        and many pages in Sections 3, 4, and 5 also come from other packages.
        The easiest way to determine which pages are part of the
        <em>man-pages</em> package is to
        <a href="https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/">download the latest version</a>,
        and see if the page is present,
        or look in the
        <a href="https://man7.org/linux/man-pages/index.html">online pages</a>.
    </p>
    <blockquote>
        Alternatively, since release 2.69, all pages that are part of
        the <em>man-pages</em> package contain a COLOPHON section at the end
        of the page which explicitly notes that the page is part of
        <em>man-pages</em> and notes the version of
        <em>man-pages</em> in which the page occurs.
    </blockquote>

    <p>
        If you want to submit a patch for a man page that comes from another
        source, then you need to work out where the page comes from
        (i.e., which package) and who the maintainer of that page is.
        The way to do this depends on your distribution.
    </p>



<h3>RPM-based distributions</h3>

    <p>
        On an RPM-based distribution (e.g., SUSE, Red Hat, Mandriva), you
        can do the following to find out which package owns a particular file.
        For example, suppose we want to find out who maintains the
        <span class="man-page">md(4)</span>
        man page:
    </p>
    <pre class="shell">
        $ <strong>man -w md</strong>
        /usr/share/man/man4/md.4.gz
        $ <strong>rpm -qf /usr/share/man/man4/md.4.gz</strong>
        mdadm-2.5.3-17 </pre>

    <p>
        We then have to find who maintains the
        <span class="pathname">mdadm</span>
        package.
        A web search might help answer the question,
        or if you install the
        <span class="pathname">mdadm</span>
        source package, there will probably be a file
        (typically named "README", "MAINTAINERS", ANNOUNCE", etc.)
        that will identify the maintainer.
    </p>



<h3>Debian-based distributions</h3>

    <p>
        On a Debian-based distribution (e.g., Debian, Knoppix, Ubuntu) you can
        do the following:
    </p>
    <pre class="shell">
        $ <strong>man -w fstab</strong>
        /usr/share/man/man5/fstab.5.gz
        $ <strong>dpkg -S /usr/share/man/man5/fstab.5.gz</strong>
        mount: /usr/share/man/man5/fstab.5.gz
        $ <strong>dpkg -p mount | grep Maintainer</strong>
        Maintainer: LaMont Jones <email@removed> </pre>

    <p>
        Note: this gives you the Debian maintainer of the package in question,
        which is a good address to report to,
        since many packages and man pages are modified by Debian.
        The maintainer of the original package
        can usually be found in a README in
        <span class="pathname">/usr/share/doc/<package-name></span>.
        (Use
        <span class="cmd">dpkg -L mount</span>
        to find all files from the
        <span class="pathname">mount</span> package.)
    </p>



<h3>Gentoo</h3>

    <p>
        On Gentoo, we can use the
        <span class="cmd">equery belongs</span>
        command to do similar:
    </p>
    <pre class="shell">
        $ <strong>equery belongs $(man -w md)</strong> </pre>

    <p>
        FIXME: fill in the details for Gentoo here.
    </p>



<h3>Other distributions</h3>

    <p>
        (FIXME: add instructions for doing the equivalent of the above on
        distributions that use other schemes.)
    </p>

<!--BEGIN-STATCOUNTER-->
<!-- SITETRACKING.linux_man-pages -->
<!-- Start of StatCounter Code -->
<script type="text/javascript">
var sc_project=5618989;
var sc_invisible=1;
var sc_partition=60;
var sc_click_stat=1;
var sc_security="4f8507d7";
</script>

<script type="text/javascript"
src="https://www.statcounter.com/counter/counter.js"></script><noscript><div
class="statcounter"><a title="customisable counter"
href="https://www.statcounter.com/free_hit_counter.html"
target="_blank"><img class="statcounter"
src="https://c.statcounter.com/5618989/0/4f8507d7/1/" alt="customisable
counter" ></a></div></noscript>
<!-- End of StatCounter Code -->
<!--END-STATCOUNTER-->
</body>
</html>