docs: deprecate kernel-doc-nano-HOWTO.txt
authorJonathan Corbet <corbet@lwn.net>
Wed, 20 Jul 2016 22:43:41 +0000 (16:43 -0600)
committerJonathan Corbet <corbet@lwn.net>
Wed, 20 Jul 2016 22:45:37 +0000 (16:45 -0600)
Now that the new Sphinx world order is taking over, the information in
kernel-doc-nano-HOWTO.txt is outmoded.  I hate to remove it altogether,
since it's one of those files that people expect to find.  But we can add a
warning and fix all the other pointers to it.

Reminded-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/00-INDEX
Documentation/CodingStyle
Documentation/development-process/4.Coding
Documentation/kernel-doc-nano-HOWTO.txt
Documentation/zh_CN/CodingStyle

index cd077ca0e1b86dfba53b3bd2d0fa62724eb24eb4..cb9a6c6fa83b2288792d10e046cfd56c0ba668b5 100644 (file)
@@ -255,10 +255,10 @@ kbuild/
        - directory with info about the kernel build process.
 kdump/
        - directory with mini HowTo on getting the crash dump code to work.
-kernel-doc-nano-HOWTO.txt
-       - mini HowTo on generation and location of kernel documentation files.
 kernel-docs.txt
        - listing of various WWW + books that document kernel internals.
+kernel-documentation.rst
+       - how to write and format reStructuredText kernel documentation
 kernel-parameters.txt
        - summary listing of command line / boot prompt args for the kernel.
 kernel-per-CPU-kthreads.txt
index 9a70ddd16584bd92b1f834286adf6706ced4f0dc..a096836723cad4e0a57619ee2263d7be0276c1d9 100644 (file)
@@ -458,7 +458,7 @@ of the function, telling people what it does, and possibly WHY it does
 it.
 
 When commenting the kernel API functions, please use the kernel-doc format.
-See the files Documentation/kernel-doc-nano-HOWTO.txt and scripts/kernel-doc
+See the files Documentation/kernel-documentation.rst and scripts/kernel-doc
 for details.
 
 Linux style for comments is the C89 "/* ... */" style.
index e3cb6a56653a69fa3b223ccc7ba565cec5802f8d..9a3ee77cefb19ad427f950ea2f2155cc5bf4e2a6 100644 (file)
@@ -346,7 +346,7 @@ which have not been so documented, there is no harm in adding kerneldoc
 comments for the future; indeed, this can be a useful activity for
 beginning kernel developers.  The format of these comments, along with some
 information on how to create kerneldoc templates can be found in the file
-Documentation/kernel-doc-nano-HOWTO.txt.
+Documentation/kernel-documentation.rst.
 
 Anybody who reads through a significant amount of existing kernel code will
 note that, often, comments are most notable by their absence.  Once again,
index 78f69cdc9b3fbcec6f32beb179eb4c8732883d5a..062e3af271b79012d2364bdae7a04b6e4155cc4b 100644 (file)
@@ -1,3 +1,6 @@
+NOTE: this document is outdated and will eventually be removed.  See
+Documentation/kernel-documentation.rst for current information.
+
 kernel-doc nano-HOWTO
 =====================
 
index bbb9d6ae05ca1ea688bedc854ea9ff7652eb6295..12717791baac0bba887c55aad9b359fc12f9e42a 100644 (file)
@@ -399,7 +399,7 @@ C是一个简朴的语言,你的命名也应该这样。和 Modula-2 和 Pasca
 些事情的原因。
 
 当注释内核API函数时,请使用 kernel-doc 格式。请看
-Documentation/kernel-doc-nano-HOWTO.txt和scripts/kernel-doc 以获得详细信息。
+Documentation/kernel-documentation.rst和scripts/kernel-doc 以获得详细信息。
 
 Linux的注释风格是 C89 “/* ... */” 风格。不要使用 C99 风格 “// ...” 注释。