This file is indexed.

/usr/src/dahdi-2.10.2~dfsg-1ubuntu1/build_tools/kernel-doc is in dahdi-dkms 1:2.10.2~dfsg-1ubuntu1.

This file is owned by root:root, with mode 0o755.

The actual contents of the file can be viewed below.

 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
#!/bin/sh

# a wrapper to kernel-doc from the kernel source tree
#
# Copyright (C) 2009 by Xorcom <support@xorcom.com>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

# For 'man' version: build_tools/kernel-doc -f man | man -l -

files="drivers/dahdi/dahdi-base.c"
format="html"
kernel="/lib/modules/`uname -r`/build"

usage() {
	me=`basename $0`
	cat <<EOF
$me: wrapper around the kernel's kernel-doc script
Extracts kernel-doc from $files .

$me [options]

Options:
  -f --format: Alternative output format (man, text, docbook. Default: html)
  -k --kernel: kernel source tree. Default: $kernel .
EOF
}

options=`getopt -o f:hk: --long format:,help,kernel: -- "$@"`
if [ $? != 0 ] ; then echo >&2 "Terminating..." ; exit 1 ; fi

eval set -- "$options"

while true ; do
	case "$1" in
		-f|--format) format="$2"; shift ;;
		-h|--help) usage; exit 0;; 
		-k|--kernel) kernel="$2"; shift ;;
		--) shift ; break ;;
	esac
	shift;
done

if [ "$*" != '' ]; then
	files="$*" #FIXME: spaces
fi

script="$kernel/scripts/kernel-doc"
$script -$format $files