doc: module: revert misconversions for MODULE_IMPORT_NS()
authorMasahiro Yamada <masahiroy@kernel.org>
Tue, 3 Dec 2024 10:21:06 +0000 (19:21 +0900)
committerLinus Torvalds <torvalds@linux-foundation.org>
Tue, 3 Dec 2024 16:22:25 +0000 (08:22 -0800)
This reverts the misconversions introduced by commit cdd30ebb1b9f
("module: Convert symbol namespace to string literal").

The affected descriptions refer to MODULE_IMPORT_NS() tags in general,
rather than suggesting the use of the empty string ("") as the
namespace.

Fixes: cdd30ebb1b9f ("module: Convert symbol namespace to string literal")
Signed-off-by: Masahiro Yamada <masahiroy@kernel.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Documentation/core-api/symbol-namespaces.rst
Documentation/translations/it_IT/core-api/symbol-namespaces.rst
Documentation/translations/zh_CN/core-api/symbol-namespaces.rst

index d04639fd8a41c1d0e634da8c34234c381a63d6f1..55886b4e6aea5303d4977e2501d28083a7b416fb 100644 (file)
@@ -106,7 +106,7 @@ inspected with modinfo::
        [...]
 
 
-It is advisable to add the MODULE_IMPORT_NS("") statement close to other module
+It is advisable to add the MODULE_IMPORT_NS() statement close to other module
 metadata definitions like MODULE_AUTHOR() or MODULE_LICENSE(). Refer to section
 5. for a way to create missing import statements automatically.
 
@@ -128,7 +128,7 @@ enable loading regardless, but will emit a warning.
 Missing namespaces imports can easily be detected at build time. In fact,
 modpost will emit a warning if a module uses a symbol from a namespace
 without importing it.
-MODULE_IMPORT_NS("") statements will usually be added at a definite location
+MODULE_IMPORT_NS() statements will usually be added at a definite location
 (along with other module meta data). To make the life of module authors (and
 subsystem maintainers) easier, a script and make target is available to fixup
 missing imports. Fixing missing imports can be done with::
index 55a7978c662b2a0653911406a19cee584ff42a66..df152c2c55db0da35f2e4697771c21562fd996e5 100644 (file)
@@ -107,7 +107,7 @@ modinfo::
        [...]
 
 
-Si consiglia di posizionare la dichiarazione MODULE_IMPORT_NS("") vicino
+Si consiglia di posizionare la dichiarazione MODULE_IMPORT_NS() vicino
 ai metadati del modulo come MODULE_AUTHOR() o MODULE_LICENSE(). Fate
 riferimento alla sezione 5. per creare automaticamente le importazioni
 mancanti.
@@ -131,7 +131,7 @@ emetterà un avviso.
 La mancanza di un'importazione può essere individuata facilmente al momento
 della compilazione. Infatti, modpost emetterà un avviso se il modulo usa
 un simbolo da uno spazio dei nomi che non è stato importato.
-La dichiarazione MODULE_IMPORT_NS("") viene solitamente aggiunta in un posto
+La dichiarazione MODULE_IMPORT_NS() viene solitamente aggiunta in un posto
 ben definito (assieme agli altri metadati del modulo). Per facilitare
 la vita di chi scrive moduli (e i manutentori di sottosistemi), esistono uno
 script e un target make per correggere le importazioni mancanti. Questo può
index 5e698f58b3fec3ce1d3d2f02596dc4377cc81cad..fc7f3797dceef0cf01a648331b443add280f02e2 100644 (file)
@@ -99,7 +99,7 @@
        [...]
 
 
-建议将 MODULE_IMPORT_NS("") 语句添加到靠近其他模块元数据定义的地方,
+建议将 MODULE_IMPORT_NS() 语句添加到靠近其他模块元数据定义的地方,
 如 MODULE_AUTHOR() 或 MODULE_LICENSE() 。关于自动创建缺失的导入
 语句的方法,请参考第5节。
 
@@ -118,7 +118,7 @@ EINVAL方式失败。要允许加载不满足这个前提条件的模块,可
 
 缺少命名空间的导入可以在构建时很容易被检测到。事实上,如果一个模块
 使用了一个命名空间的符号而没有导入它,modpost会发出警告。
-MODULE_IMPORT_NS("")语句通常会被添加到一个明确的位置(和其他模块元
+MODULE_IMPORT_NS()语句通常会被添加到一个明确的位置(和其他模块元
 数据一起)。为了使模块作者(和子系统维护者)的生活更加轻松,我们提
 供了一个脚本和make目标来修复丢失的导入。修复丢失的导入可以用::