1 |
commit: c597495d90090d1d047ad655cbf5ab7a65ba54e1 |
2 |
Author: Mike Pagano <mpagano <AT> gentoo <DOT> org> |
3 |
AuthorDate: Wed May 18 11:11:00 2022 +0000 |
4 |
Commit: Mike Pagano <mpagano <AT> gentoo <DOT> org> |
5 |
CommitDate: Wed May 18 11:11:00 2022 +0000 |
6 |
URL: https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=c597495d |
7 |
|
8 |
linux-mod.eclass: Documentation updates |
9 |
|
10 |
Document functions which did not have any documentation or were not |
11 |
formatted to gentoo specifications |
12 |
|
13 |
Signed-off-by: Mike Pagano <mpagano <AT> gentoo.org> |
14 |
|
15 |
eclass/linux-mod.eclass | 66 ++++++++++++++++++++++++------------------------- |
16 |
1 file changed, 33 insertions(+), 33 deletions(-) |
17 |
|
18 |
diff --git a/eclass/linux-mod.eclass b/eclass/linux-mod.eclass |
19 |
index 93e93b44a99f..111067a429db 100644 |
20 |
--- a/eclass/linux-mod.eclass |
21 |
+++ b/eclass/linux-mod.eclass |
22 |
@@ -227,11 +227,10 @@ convert_to_m() { |
23 |
fi |
24 |
} |
25 |
|
26 |
-# internal function |
27 |
-# |
28 |
-# FUNCTION: update_depmod |
29 |
-# DESCRIPTION: |
30 |
-# It updates the modules.dep file for the current kernel. |
31 |
+# @FUNCTION: update_depmod |
32 |
+# @INTERNAL |
33 |
+# @DESCRIPTION: |
34 |
+# Updates the modules.dep file for the current kernel. |
35 |
update_depmod() { |
36 |
debug-print-function ${FUNCNAME} $* |
37 |
|
38 |
@@ -252,11 +251,10 @@ update_depmod() { |
39 |
fi |
40 |
} |
41 |
|
42 |
-# internal function |
43 |
-# |
44 |
-# FUNCTION: move_old_moduledb |
45 |
-# DESCRIPTION: |
46 |
-# It updates the location of the database used by the module-rebuild utility. |
47 |
+# @FUNCTION: move_old_moduledb |
48 |
+# @INTERNAL |
49 |
+# @DESCRIPTION: |
50 |
+# Updates the location of the database used by the module-rebuild utility. |
51 |
move_old_moduledb() { |
52 |
debug-print-function ${FUNCNAME} $* |
53 |
|
54 |
@@ -272,11 +270,10 @@ move_old_moduledb() { |
55 |
fi |
56 |
} |
57 |
|
58 |
-# internal function |
59 |
-# |
60 |
-# FUNCTION: update_moduledb |
61 |
-# DESCRIPTION: |
62 |
-# It adds the package to the /var/lib/module-rebuild/moduledb database used by the module-rebuild utility. |
63 |
+# @FUNCTION: update_moduledb |
64 |
+# @INTERNAL |
65 |
+# @DESCRIPTION: |
66 |
+# Adds the package to the /var/lib/module-rebuild/moduledb database used by the module-rebuild utility. |
67 |
update_moduledb() { |
68 |
debug-print-function ${FUNCNAME} $* |
69 |
|
70 |
@@ -294,12 +291,10 @@ update_moduledb() { |
71 |
fi |
72 |
} |
73 |
|
74 |
-# internal function |
75 |
-# |
76 |
-# FUNCTION: remove_moduledb |
77 |
-# DESCRIPTION: |
78 |
-# It removes the package from the /var/lib/module-rebuild/moduledb database used by |
79 |
-# the module-rebuild utility. |
80 |
+# @FUNCTION: remove_moduledb |
81 |
+# @INTERNAL |
82 |
+# @DESCRIPTION: |
83 |
+# Removes the package from the /var/lib/module-rebuild/moduledb database used by |
84 |
remove_moduledb() { |
85 |
debug-print-function ${FUNCNAME} $* |
86 |
|
87 |
@@ -329,6 +324,10 @@ set_kvobj() { |
88 |
# einfo "Using KV_OBJ=${KV_OBJ}" |
89 |
} |
90 |
|
91 |
+# @FUNCTION: get-KERNEL_CC |
92 |
+# @RETURN: Name of the C compiler. |
93 |
+# @DESCRIPTION: |
94 |
+# Return name of the C compiler while honoring variables defined in ebuilds. |
95 |
get-KERNEL_CC() { |
96 |
debug-print-function ${FUNCNAME} $* |
97 |
|
98 |
@@ -349,12 +348,11 @@ get-KERNEL_CC() { |
99 |
echo "${kernel_cc}" |
100 |
} |
101 |
|
102 |
-# internal function |
103 |
-# |
104 |
-# FUNCTION: |
105 |
-# USAGE: /path/to/the/modulename_without_extension |
106 |
-# RETURN: A file in /etc/modprobe.d |
107 |
-# DESCRIPTION: |
108 |
+# @FUNCTION: generate_modulesd |
109 |
+# @INTERNAL |
110 |
+# @USAGE: /path/to/the/modulename_without_extension |
111 |
+# @RETURN: A file in /etc/modprobe.d |
112 |
+# @DESCRIPTION: |
113 |
# This function will generate and install the neccessary modprobe.d file from the |
114 |
# information contained in the modules exported parms. |
115 |
# (see the variables MODULESD_<modulename>_ENABLED, MODULESD_<modulename>_EXAMPLES, |
116 |
@@ -503,12 +501,11 @@ generate_modulesd() { |
117 |
return 0 |
118 |
} |
119 |
|
120 |
-# internal function |
121 |
-# |
122 |
-# FUNCTION: find_module_params |
123 |
-# USAGE: A string "NAME(LIBDIR:SRCDIR:OBJDIR)" |
124 |
-# RETURN: The string "modulename:NAME libdir:LIBDIR srcdir:SRCDIR objdir:OBJDIR" |
125 |
-# DESCRIPTION: |
126 |
+# @FUNCTION: find_module_params |
127 |
+# @USAGE: A string "NAME(LIBDIR:SRCDIR:OBJDIR)" |
128 |
+# @INTERNAL |
129 |
+# @RETURN: The string "modulename:NAME libdir:LIBDIR srcdir:SRCDIR objdir:OBJDIR" |
130 |
+# @DESCRIPTION: |
131 |
# Analyze the specification NAME(LIBDIR:SRCDIR:OBJDIR) of one module as described in MODULE_NAMES. |
132 |
find_module_params() { |
133 |
debug-print-function ${FUNCNAME} $* |
134 |
@@ -601,6 +598,9 @@ linux-mod_pkg_setup_binary() { |
135 |
linux-info_pkg_setup; |
136 |
} |
137 |
|
138 |
+# @FUNCTION: strip_modulenames |
139 |
+# @DESCRIPTION: |
140 |
+# Remove modules from being built automatically using the default src_compile/src_install |
141 |
strip_modulenames() { |
142 |
debug-print-function ${FUNCNAME} $* |