{"id":282160,"date":"2016-12-07T21:15:03","date_gmt":"2016-12-07T18:15:03","guid":{"rendered":"http:\/\/savepearlharbor.com\/?p=282160"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=282160","title":{"rendered":"\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f Linux \u044f\u0434\u0440\u0430 \u043f\u0435\u0440\u0435\u0445\u043e\u0434\u0438\u0442 \u043d\u0430 sphinx"},"content":{"rendered":"<p>Linux \u044f\u0434\u0440\u043e \u043d\u0430 \u0441\u0435\u0433\u043e\u0434\u043d\u044f\u0448\u043d\u0438\u0439 \u0434\u0435\u043d\u044c \u2014 <a href=\"https:\/\/habrahabr.ru\/post\/314084\/\">\u0441\u0430\u043c\u044b\u0439 \u0434\u0438\u043d\u0430\u043c\u0438\u0447\u043d\u044b\u0439, \u0441\u043b\u043e\u0436\u043d\u044b\u0439, \u043a\u0440\u0443\u043f\u043d\u044b\u0439 \u043f\u0440\u043e\u0435\u043a\u0442 \u0441 \u043e\u0442\u043a\u0440\u044b\u0442\u044b\u043c \u043a\u043e\u0434\u043e\u043c<\/a>. \u041a\u0430\u043a \u0436\u0435 \u043e\u0431\u0441\u0442\u043e\u044f\u0442 \u0434\u0435\u043b\u0430 \u0441 \u0435\u0433\u043e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439? \u0421\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442 \u043f\u0440\u044f\u043c\u0430\u044f \u0441\u0432\u044f\u0437\u044c: \u0447\u0435\u043c \u043a\u0430\u0447\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u0435\u0435 \u0438 \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u0435\u0435 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043f\u0440\u043e\u0435\u043a\u0442\u0430, \u0442\u0435\u043c \u043f\u0440\u043e\u0449\u0435 \u0434\u043b\u044f \u043f\u043e\u0441\u0442\u043e\u0440\u043e\u043d\u043d\u0438\u0445 \u0438\u0437\u0443\u0447\u0438\u0442\u044c \u043e\u0441\u043d\u043e\u0432\u044b \u0434\u0435\u043b\u0430, \u043e\u0441\u0432\u043e\u0438\u0442\u044c\u0441\u044f \u0438 \u0441\u0442\u0430\u0442\u044c \u043f\u043e\u043b\u043d\u043e\u043f\u0440\u0430\u0432\u043d\u044b\u043c \u0443\u0447\u0430\u0441\u0442\u043d\u0438\u043a\u043e\u043c. <\/p>\n<p>  <img decoding=\"async\" src=\"https:\/\/habrastorage.org\/files\/6bd\/c3d\/4dc\/6bdc3d4dc0874030a0a7a5e7bfe86299.jpg\"\/>  <\/p>\n<p>  <\/p>\n<p>  <\/p>\n<p><a href=\"https:\/\/kernel-recipes.org\/en\/2016\/talks\/kernel-documentation-what-we-have-and-where-its-going-2\/\">\u041d\u0430 \u0441\u0435\u043c\u0438\u043d\u0430\u0440\u0435 Kernel Recipies<\/a> \u043c\u0435\u0439\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 Linux \u044f\u0434\u0440\u0430 Jonathan Corbet \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u0430\u043b \u043e \u043d\u044b\u043d\u0435\u0448\u043d\u0435\u043c \u043f\u043e\u043b\u043e\u0436\u0435\u043d\u0438\u0438 \u0434\u0435\u043b \u0441 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439 \u0438 \u043e \u0442\u043e\u043c, \u043a\u0430\u043a \u0431\u0443\u0434\u0435\u0442 \u0441\u043e\u0432\u0435\u0440\u0448\u0430\u0442\u044c\u0441\u044f \u043f\u0435\u0440\u0435\u0445\u043e\u0434 \u043e\u0442 \u0430\u043d\u0430\u0440\u0445\u0438\u0438 \u043a \u043f\u043e\u0440\u044f\u0434\u043a\u0443. <strong>\u041f\u0435\u0440\u0432\u044b\u0435 \u0443\u0441\u043f\u0435\u0445\u0438 \u0432 \u044d\u0442\u043e\u043c \u043d\u0430\u0447\u0438\u043d\u0430\u043d\u0438\u0438 \u0443\u0436\u0435 \u0435\u0441\u0442\u044c<\/strong>. <a href=\"https:\/\/www.kernel.org\/doc\/html\/latest\/\">\u041d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u044b<\/a> \u0431\u044b\u043b\u0438 \u043d\u0435\u0434\u0430\u0432\u043d\u043e \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u044b \u0432 \u043d\u043e\u0432\u044b\u0439 \u0444\u043e\u0440\u043c\u0430\u0442. \u041e \u0442\u043e\u043c \u043a\u0430\u043a \u044d\u0442\u043e \u0431\u044b\u043b\u043e \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u0430\u043d\u043e \u0432\u043d\u0443\u0442\u0440\u0438.<\/p>\n<p><a name=\"habracut\"><\/a>  <\/p>\n<h2>\u0427\u0442\u043e \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u043f\u0430\u043f\u043a\u0430 Documentation?<\/h2>\n<p>  <\/p>\n<p><code>Documentation<\/code> \u2014 \u0435\u0434\u0438\u043d\u0441\u0442\u0432\u0435\u043d\u043d\u0430\u044f \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u044f Linux, \u043a\u043e\u0442\u043e\u0440\u0430\u044f \u043d\u0430\u0447\u0438\u043d\u0430\u0435\u0442\u0441\u044f \u0441 \u0437\u0430\u0433\u043b\u0430\u0432\u043d\u043e\u0439, \u044d\u0442\u043e \u043f\u043e\u0434\u0447\u0435\u0440\u043a\u0438\u0432\u0430\u0435\u0442 \u0435\u0435 \u043e\u0441\u043e\u0431\u0443\u044e \u0440\u043e\u043b\u044c \u0438 \u043f\u043e\u043b\u043e\u0436\u0435\u043d\u0438\u0435, \u043e\u0434\u043d\u0430\u043a\u043e \u0432\u043d\u0443\u0442\u0440\u0438 \u0447\u0435\u0440\u0442 \u043d\u043e\u0433\u0443 \u0441\u043b\u043e\u043c\u0438\u0442.<\/p>\n<p>  <\/p>\n<ul>\n<li>2264 \u0444\u0430\u0439\u043b\u0430<\/li>\n<li>228 \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0439<\/li>\n<li>23 MB \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438, \u043d\u0435 \u0441\u0447\u0438\u0442\u0430\u044f <code>Documentation\/devicetree<\/code><\/li>\n<\/ul>\n<p>  <\/p>\n<blockquote><p><em>Documentation\/* is a gigantic mess, currently organized based on where random passers-by put things down last.<\/em><br \/>   \u2014 Rob Landley, July, 2007.<\/p><\/blockquote>\n<p>  \u0412\u0441\u044f \u044d\u0442\u043e \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442 \u0432 \u0434\u0432\u0443\u0445 \u0438\u043f\u043e\u0441\u0442\u0430\u0441\u044f\u0445: \u043e\u0431\u044b\u0447\u043d\u044b\u0435 txt \u0444\u0430\u0439\u043b\u044b \u0438 \u0448\u0430\u0431\u043b\u043e\u043d\u044b DocBook, \u043e \u043a\u043e\u0442\u043e\u0440\u044b\u0445 \u0435\u0441\u0442\u044c \u0447\u0442\u043e \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u0430\u0442\u044c. \u041f\u0440\u043e\u0441\u0442\u044b\u0435 txt \u0444\u0430\u0439\u043b\u044b <strong>\u043d\u0438\u043a\u0430\u043a \u043c\u0435\u0436\u0434\u0443 \u0441\u043e\u0431\u043e\u0439 \u043d\u0435 \u0441\u0432\u044f\u0437\u0430\u043d\u044b<\/strong>, \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u044b \u0432 \u0440\u0430\u0437\u043d\u043e\u0435 \u0432\u0440\u0435\u043c\u044f \u0440\u0430\u0437\u043d\u044b\u043c\u0438 \u043b\u044e\u0434\u044c\u043c\u0438 \u0438 \u043d\u0435 \u0432\u0441\u0435 \u0438\u0437 \u043d\u0438\u0445 \u043e\u0434\u0438\u043d\u0430\u043a\u043e\u0432\u043e \u043f\u043e\u043b\u0435\u0437\u043d\u044b. \u041d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0438\u0437 \u043d\u0438\u0445 \u0435\u0441\u0442\u044c \u0438\u0437\u0432\u0435\u0441\u0442\u043d\u044b \u0432\u0441\u0435\u043c \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430\u043c \u044f\u0434\u0440\u0430. \u0422\u0430\u043a\u043e\u0432\u044b\u043c\u0438 \u044f\u0432\u043b\u044f\u044e\u0442\u0441\u044f <code>ManagementStyle<\/code>, \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u043d\u044b\u0439 \u041b\u0438\u043d\u0443\u0441\u043e\u043c \u0438\u043b\u0438 <code>CodingStyle<\/code>, \u0441 \u043a\u043e\u0442\u043e\u0440\u043e\u0433\u043e \u043d\u0430\u0447\u0438\u043d\u0430\u044e\u0442 \u0432\u0441\u0435 \u0432\u043e\u043b\u043e\u043d\u0442\u0435\u0440\u044b. \u041c\u043d\u0435 \u043a\u0430\u0436\u0435\u0442\u0441\u044f \u044d\u0442\u0438 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u044b \u0434\u043e\u043b\u0436\u043d\u043e \u043f\u0440\u043e\u0447\u0438\u0442\u0430\u0442\u044c \u0432\u0441\u0435\u043c \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430\u043c, \u043b\u0438\u043d\u0443\u043a\u0441\u043e\u0438\u0434\u0430\u043c \u0438 \u0441\u043e\u0447\u0443\u0432\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u043c.<\/p>\n<p>  <\/p>\n<blockquote><p><em>Btw, when talking about &quot;kernel manager&quot;, it&#8217;s all about the technical lead persons, not the people who do traditional management inside companies. If you sign purchase orders or you have any clue about the budget of your group, you&#8217;re almost certainly not a kernel manager. These suggestions may or may not apply to you.<\/em><\/p><\/blockquote>\n<p>  \u0415\u0441\u043b\u0438 \u0432\u044b \u043f\u043e\u0434\u043f\u0438\u0441\u044b\u0432\u0430\u0435\u0442 \u0440\u0430\u0441\u0445\u043e\u0434\u043d\u044b\u0435 \u043e\u0440\u0434\u0435\u0440\u0430 \u0438 \u0440\u0430\u0437\u0431\u0438\u0440\u0430\u0435\u0442\u0435\u0441\u044c \u0432 \u0431\u044e\u0434\u0436\u0435\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0438, \u0442\u043e\u0433\u0434\u0430 \u0432\u044b \u0442\u043e\u0447\u043d\u043e \u043d\u0435 \u0441\u0442\u0430\u0440\u0448\u0438\u0439 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a \u044f\u0434\u0440\u0430.<\/p>\n<p>  <\/p>\n<p>\u0423\u0442\u0440\u0430\u0442\u0438\u0432\u0448\u0438\u0435 \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u043e\u0441\u0442\u044c \u0434\u043e\u043a\u0438 \u0432\u043d\u0435\u0448\u043d\u0435 \u043d\u0438\u0447\u0435\u043c \u043d\u0435 \u0432\u044b\u0434\u0435\u043b\u044f\u044e\u0442\u0441\u044f \u043e\u0442 \u043e\u0441\u0442\u0430\u043b\u044c\u043d\u044b\u0445. \u041d\u0430\u043f\u0440\u0438\u043c\u0435\u0440, <code>Documentation\/applying-patches.txt<\/code> \u0438\u043d\u0441\u0442\u0440\u0443\u043a\u0442\u0438\u0440\u0443\u0435\u0442 \u043a\u0430\u043a \u0441\u043a\u0430\u0447\u0430\u0442\u044c \u043f\u0430\u0442\u0447\u0438 \u0447\u0435\u0440\u0435\u0437 <code>ftp<\/code> \u0438 \u043f\u0440\u0438\u043c\u0435\u043d\u0438\u0442\u044c \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e \u043a\u043e\u043c\u0430\u043d\u0434\u044b <code>patch<\/code>. \u041f\u043e\u043d\u044f\u0442\u043d\u043e, \u0447\u0442\u043e \u0441\u0435\u0433\u043e\u0434\u043d\u044f \u043d\u0438\u043a\u0442\u043e \u0442\u0430\u043a \u043d\u0435 \u0434\u0435\u043b\u0430\u0435\u0442.<\/p>\n<p>  <\/p>\n<pre><code class=\"bash\"># moving from 2.6.11 to 2.6.12 $ cd ~\/linux-2.6.11                     # change to kernel source dir $ patch -p1 &lt; ..\/patch-2.6.12           # apply the 2.6.12 patch $ cd .. $ mv linux-2.6.11 linux-2.6.12          # rename source dir  # moving from 2.6.11.1 to 2.6.12 $ cd ~\/linux-2.6.11.1                   # change to kernel source dir $ patch -p1 -R &lt; ..\/patch-2.6.11.1      # revert the 2.6.11.1 patch                                         # source dir is now 2.6.11 $ patch -p1 &lt; ..\/patch-2.6.12           # apply new 2.6.12 patch $ cd .. $ mv linux-2.6.11.1 linux-2.6.12        # rename source dir<\/code><\/pre>\n<p>  <\/p>\n<p>\u0420\u0430\u0441\u043a\u043e\u043f\u043a\u0438 \u0438\u043d\u043e\u0433\u0434\u0430 \u0434\u0430\u044e\u0442 \u0443\u0434\u0438\u0432\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u044b. \u041e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f, Linux \u0441 1996 \u0433. <a href=\"http:\/\/www.evertype.com\/standards\/csur\/klingon.html\">\u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442 \u043a\u043b\u0438\u043d\u0433\u043e\u043d\u0441\u043a\u0443\u044e \u043f\u0438\u0441\u044c\u043c\u0435\u043d\u043d\u043e\u0441\u0442\u044c<\/a>. \u0421\u043c\u043e\u0442\u0440\u0438\u043c \u0432 <code>Documentation\/unicode.txt<\/code>.<\/p>\n<p>  <\/p>\n<pre><code>U+F8D0  KLINGON LETTER A U+F8D1  KLINGON LETTER B U+F8D2  KLINGON LETTER CH U+F8D3  KLINGON LETTER D U+F8D4  KLINGON LETTER E U+F8D5  KLINGON LETTER GH U+F8D6  KLINGON LETTER H U+F8D7  KLINGON LETTER I U+F8D8  KLINGON LETTER J U+F8D9  KLINGON LETTER L U+F8DA  KLINGON LETTER M U+F8DB  KLINGON LETTER N U+F8DC  KLINGON LETTER NG U+F8DD  KLINGON LETTER O U+F8DE  KLINGON LETTER P U+F8DF  KLINGON LETTER Q<\/code><\/pre>\n<p>  <\/p>\n<p>\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442 <code>Documentation\/zorro.txt<\/code> \u0442\u0430\u0438\u0442 \u0432 \u0441\u0435\u0431\u0435 \u0441\u0435\u043a\u0440\u0435\u0442\u044b \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u043c\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0434\u0440\u0430\u0439\u0432\u0435\u0440\u043e\u0432 \u0434\u043b\u044f \u041f\u041a \u0441\u0435\u043c\u0435\u0439\u0441\u0442\u0432\u0430 Amiga. \u041d\u0435 \u0443\u0434\u0438\u0432\u0438\u0442\u0435\u043b\u044c\u043d\u043e, \u0447\u0442\u043e \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0439 \u0440\u0430\u0437 \u0434\u043e\u043a\u0443 \u043f\u0440\u0430\u0432\u0438\u043b\u0438 \u0432 2003-\u043c.<\/p>\n<p>  <\/p>\n<p>\u041d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0442\u0435\u043a\u0441\u0442\u044b \u043d\u0430\u0441\u0442\u043e\u043b\u044c\u043a\u043e \u0437\u0443\u0431\u043e\u0434\u0440\u043e\u0431\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435, \u0447\u0442\u043e \u0438\u0445 \u043e\u0441\u0438\u043b\u0438\u0442\u044c \u0441\u043c\u043e\u0433\u0443\u0442 \u043d\u0435 \u0442\u043e\u043b\u044c\u043a\u043e \u043b\u0438\u0448\u044c \u0432\u0441\u0435. \u041a \u0442\u0430\u043a\u043e\u0432\u044b\u043c, \u0414\u0436\u043e\u043d\u0430\u0442\u0430\u043d \u043e\u0442\u043d\u0435\u0441 <code>Documentation\/memory-barriers.txt<\/code>. \u0422\u0435, \u043a\u0442\u043e \u043f\u043e\u043d\u044f\u043b \u043e \u0447\u0435\u043c \u0438\u0434\u0435\u0442 \u0442\u0430\u043c \u0440\u0435\u0447\u044c, \u043f\u043e \u0435\u0433\u043e \u0441\u043b\u043e\u0432\u0430\u043c, \u0441\u043e\u043e\u0431\u0440\u0430\u0436\u0430\u044e\u0442 \u043b\u0443\u0447\u0448\u0435 \u043d\u0435\u0433\u043e \u0438 \u043c\u043d\u043e\u0433\u0438\u0445 \u0434\u0440\u0443\u0433\u0438\u0445.<\/p>\n<p>  <\/p>\n<p>\u0412 \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0430\u0445 \u043d\u0438\u0436\u043d\u0435\u0433\u043e \u0443\u0440\u043e\u0432\u043d\u044f \u0442\u043e\u0436\u0435 \u043c\u043d\u043e\u0433\u043e \u0441\u0442\u0430\u0440\u044c\u044f, \u044d\u0442\u043e\u0442 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442 \u043d\u0430\u0432\u0435\u0440\u043d\u043e\u0435 \u0438\u0437 \u0441\u0430\u043c\u044b\u0445 \u0434\u0440\u0435\u043c\u0443\u0447\u0438\u0445. \u0417\u0430\u0431\u0430\u0432\u043d\u043e, \u0441\u0442\u043e \u043b\u0435\u0442 \u043d\u0430\u0437\u0430\u0434 \u0443 \u043c\u0435\u043d\u044f \u0442\u043e\u0436\u0435 \u0431\u044b\u043b\u0430 \u044d\u043b\u0435\u043a\u0442\u0440\u043e\u043d\u043d\u0430\u044f \u043f\u043e\u0447\u0442\u0430 \u043d\u0430 usa.net, \u043d\u043e \u043f\u043e\u0441\u043b\u0435 \u043e\u0431\u0432\u0430\u043b\u0430 \u043d\u0430 \u0440\u044b\u043d\u043a\u0435 DotCom, \u043e\u043d\u0430 \u0441\u0442\u0430\u043b\u0430 \u043f\u043b\u0430\u0442\u043d\u043e\u0439 \u0438 \u044f \u043f\u0435\u0440\u0435\u0441\u0435\u043b \u043d\u0430 Yahoo.<\/p>\n<p>  <\/p>\n<pre><code class=\"diff\">(5:521)$ less Documentation\/sound\/oss\/MultiSound #! \/bin\/sh # #  Turtle Beach MultiSound Driver Notes #  -- Andrew Veliath &lt;andrewtv@usa.net&gt; # #  Last update:                      September 10, 1998 #  Corresponding msnd driver:        0.8.3<\/code><\/pre>\n<p>  <\/p>\n<p>\u041f\u0440\u0438\u043c\u0435\u0447\u0430\u0442\u0435\u043b\u044c\u043d\u043e \u0442\u043e, \u0447\u0442\u043e \u0437\u0432\u0443\u043a\u043e\u0432\u0430\u044f \u043f\u043e\u0434\u0441\u0438\u0441\u0442\u0435\u043c\u0430 OSS \u0438\u0437 \u043a\u0435\u0440\u043d\u0435\u043b\u0430 \u043f\u043e\u0447\u0442\u0438 \u043f\u043e\u043b\u043d\u043e\u0441\u0442\u044c\u044e \u0432\u044b\u043f\u0438\u043b\u0435\u043d\u0430, \u043d\u043e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u0432\u0441\u0435 \u0442\u0430\u043c \u0436\u0435.<\/p>\n<p>  <\/p>\n<p>\u0422\u0435\u043f\u0435\u0440\u044c \u043e\u0442 \u0447\u0438\u0441\u0442\u043e\u0439 \u0430\u043d\u0430\u0440\u0445\u0438\u0438 plaintext \u0444\u0430\u0439\u043b\u043e\u0432 \u043f\u0435\u0440\u0435\u0439\u0434\u0435\u043c \u043a\u043e \u0432\u0442\u043e\u0440\u043e\u0439, \u0433\u043e\u0440\u0430\u0437\u0434\u043e \u0431\u043e\u043b\u0435\u0435 \u0437\u0430\u043f\u0443\u0442\u0430\u043d\u043d\u043e\u0439 \u0438\u043f\u043e\u0441\u0442\u0430\u0441\u0438 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u044f\u0434\u0440\u0430.<\/p>\n<p>  <\/p>\n<h2>DocBook \u0438 \u0440\u0435\u0431\u044f\u0442\u0430<\/h2>\n<p>  <\/p>\n<p>\u042d\u0442\u0438 34 \u0448\u0430\u0431\u043b\u043e\u043d\u043e\u0432 XML \u0441\u043e \u0432\u0441\u0435\u0439 \u0438\u043d\u0444\u0440\u0430\u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043e\u0439 \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0438 \u0438 \u0435\u0441\u0442\u044c DocBook. \u0412 \u043e\u0442\u043b\u0438\u0447\u0438\u0435 \u043e\u0442 \u043f\u0440\u043e\u0441\u0442\u043e\u0433\u043e \u0442\u0435\u043a\u0441\u0442\u0430, DocBook \u0444\u043e\u0440\u043c\u0430\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 API, \u0444\u0443\u043d\u043a\u0446\u0438\u0439 \u0438 \u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u043d\u0430 \u0432\u044b\u0445\u043e\u0434\u0435 html, pdf \u0438\u043b\u0438 man \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b, \u0441\u0432\u044f\u0437\u0430\u043d\u043d\u044b\u0435 \u043c\u0435\u0436\u0434\u0443 \u0441\u043e\u0431\u043e\u0439 \u043f\u0435\u0440\u0435\u043a\u0440\u0435\u0441\u0442\u043d\u044b\u043c\u0438 \u0441\u0441\u044b\u043b\u043a\u0430\u043c\u0438.<\/p>\n<p>  <\/p>\n<pre><code>(5:522)$ ll Documentation\/DocBook\/*.tmpl |wc -l 34<\/code><\/pre>\n<p>  <\/p>\n<p>\u0418\u0441\u0445\u043e\u0434\u043d\u044b\u0439 \u043a\u043e\u0434 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u0441\u043f\u0435\u0446\u0438\u0430\u043b\u044c\u043d\u044b\u0435 \u0432\u0441\u0442\u0430\u0432\u043a\u0438 \u2014 <code>kerneldoc comments<\/code>. \u0422\u0430\u043a\u0438\u0445 \u0432\u0441\u0442\u0430\u0432\u043e\u043a \u0432 \u043a\u043e\u0434\u0435 \u0441\u0432\u044b\u0448\u0435 55 \u0442\u044b\u0441.<\/p>\n<p>  <\/p>\n<pre><code class=\"diff\">    \/**      * list_add - add a new entry      * @new: new entry to be added      * @head: list head to add it after      *      * Insert a new entry after the specified head.      * This is good for implementing stacks.      *\/<\/code><\/pre>\n<p>  <\/p>\n<p>DocBook \u0448\u0430\u0431\u043b\u043e\u043d \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u0438\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u0438 \u043e \u0442\u043e\u043c, <a href=\"https:\/\/www.kernel.org\/doc\/Documentation\/kernel-doc-nano-HOWTO.txt\">\u043a\u0430\u043a \u0438\u0437 \u0438\u0441\u0445\u043e\u0434\u043d\u0438\u043a\u043e\u0432 \u0432\u044b\u0433\u0440\u0443\u0436\u0430\u0442\u044c \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e<\/a>.<\/p>\n<p>  <\/p>\n<pre><code class=\"diff\">\/*  * Parse file, calling action specific functions for:  * 1) Lines containing !E  * 2) Lines containing !I  * 3) Lines containing !D  * 4) Lines containing !F  * 5) Lines containing !P  * 6) Lines containing !C  * 7) Default lines - lines not matching the above  *\/<\/code><\/pre>\n<p>  <\/p>\n<p>\u0418\u043b\u043b\u044e\u0441\u0442\u0440\u0430\u0446\u0438\u044f \u0438\u0437 \u0444\u0430\u0439\u043b\u0430 <code>Documentation\/DocBook\/networking.tmpl<\/code>.<\/p>\n<p>  <\/p>\n<pre><code class=\"xml\">     &lt;sect1&gt;&lt;title&gt;Socket Buffer Functions&lt;\/title&gt; !Iinclude\/linux\/skbuff.h !Iinclude\/net\/sock.h !Enet\/socket.c !Enet\/core\/skbuff.c !Enet\/core\/sock.c !Enet\/core\/datagram.c !Enet\/core\/stream.c      &lt;\/sect1&gt;<\/code><\/pre>\n<p>  <\/p>\n<p>\u041f\u043e\u0441\u043b\u0435 \u0442\u043e\u0433\u043e \u043a\u0430\u043a \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044c \u043d\u0430\u0431\u0438\u0440\u0430\u0435\u0442 \u043a\u043e\u043c\u0430\u043d\u0434\u0443 <code>make htmldocs<\/code> \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u043c\u0430 <code>scripts\/docproc<\/code> \u043f\u0430\u0440\u0441\u0438\u0442 \u0432 \u0448\u0430\u0431\u043b\u043e\u043d\u0430\u0445 \u0438\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u0438 \u044d\u043a\u0441\u043f\u043e\u0440\u0442\u0430 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0438 \u0434\u043b\u044f \u043a\u0430\u0436\u0434\u043e\u0439 \u0438\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u0438 \u0432\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u0442 \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0435 \u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044f.<\/p>\n<p>  <\/p>\n<ul>\n<li>\u041d\u0430\u0445\u043e\u0434\u0438\u0442 \u0432 \u0443\u043a\u0430\u0437\u0430\u043d\u043d\u044b\u0445 \u0444\u0430\u0439\u043b\u0430\u0445 \u0438\u043d\u0441\u0442\u0440\u0443\u043a\u0446\u0438\u0438 <code>EXPORT_SYMBOL()<\/code>, \u043f\u0430\u0440\u0441\u0438\u0442 \u0438\u0445 \u0438 \u0434\u043e\u0431\u0430\u0432\u043b\u044f\u0435\u0442 \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u044f \u0444\u0443\u043d\u043a\u0446\u0438\u0439 \u0432 \u0441\u043f\u0438\u0441\u043e\u043a \u044d\u043a\u0441\u043f\u043e\u0440\u0442\u0438\u0440\u0443\u0435\u043c\u044b\u0445 \u0441\u0438\u043c\u0432\u043e\u043b\u043e\u0432.<\/li>\n<li>\u0412\u044b\u0437\u044b\u0432\u0430\u0435\u0442 Perl \u0441\u043a\u0440\u0438\u043f\u0442 <code>scripts\/kernel-doc<\/code>, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u043f\u0440\u043e\u0431\u0435\u0433\u0430\u0435\u0442 \u043f\u043e \u0444\u0443\u043d\u043a\u0446\u0438\u044f\u043c, \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430\u043c \u0438 \u0432\u0441\u0435\u043c\u0443 \u043f\u0440\u043e\u0447\u0435\u043c\u0443, \u0447\u0442\u043e \u043d\u0430\u0445\u043e\u0434\u0438\u0442 \u0432 \u0421\u0438 \u043a\u043e\u0434\u0435 \u0434\u043b\u044f \u0442\u043e\u0433\u043e, \u0447\u0442\u043e\u0431\u044b \u0432\u044b\u0446\u0435\u043f\u0438\u0442\u044c \u043e\u0442\u0442\u0443\u0434\u0430 \u043d\u0443\u0436\u043d\u044b\u0435 \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u044f.<\/li>\n<li>\u0412\u044b\u0437\u044b\u0432\u0430\u0435\u0442 \u043f\u043e \u0432\u0442\u043e\u0440\u043e\u043c\u0443 \u043a\u0440\u0443\u0433\u0443 <code>scripts\/kernel-doc<\/code> \u0438 \u0442\u043e\u0442 \u0435\u0449\u0435 \u0440\u0430\u0437 \u0447\u0438\u0442\u0430\u0435\u0442 \u0442\u0435 \u0436\u0435 \u0441\u0430\u043c\u044b\u0435 \u0444\u0430\u0439\u043b\u044b, \u043d\u043e \u043d\u0430 \u044d\u0442\u043e\u0442 \u0440\u0430\u0437 \u0441\u043e\u0437\u0434\u0430\u0435\u0442 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0442\u0435\u0445 \u0441\u0430\u043c\u044b\u0445 \u0444\u0443\u043d\u043a\u0446\u0438\u0439 \u0438 \u0443\u043f\u0430\u043a\u043e\u0432\u044b\u0432\u0430\u0435\u0442 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0432 \u0441\u043d\u0438\u043f\u043f\u0435\u0442\u044b DocBook.<\/li>\n<\/ul>\n<p>  <\/p>\n<p>\u0417\u0430\u0442\u0435\u043c <code>docproc<\/code> \u0440\u0430\u0441\u043f\u0438\u0445\u0438\u0432\u0430\u0435\u0442 \u0432 \u0448\u0430\u0431\u043b\u043e\u043d\u044b \u0441\u043e\u0437\u0434\u0430\u043d\u043d\u044b\u0435 \u0444\u0430\u0439\u043b\u044b \u0441 DocBook \u0444\u043e\u0440\u043c\u0430\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435\u043c. \u0414\u043b\u044f HTML \u0432\u044b\u0437\u044b\u0432\u0430\u0435\u0442\u0441\u044f \u0441\u043a\u0440\u0438\u043f\u0442 <code>scripts\/kernel-doc-xml-ref<\/code>, \u043a\u043e\u0442\u043e\u0440\u044b\u0439 \u0441\u043e\u0437\u0434\u0430\u0435\u0442 \u043f\u0435\u0440\u0435\u043a\u0440\u0435\u0441\u0442\u043d\u044b\u0435 \u0441\u0441\u044b\u043b\u043a\u0438, \u043d\u043e \u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f \u043e\u0442\u0434\u0435\u043b\u044c\u043d\u043e\u0433\u043e \u0448\u0430\u0431\u043b\u043e\u043d\u0430. \u041d\u0430\u043a\u043e\u043d\u0435\u0446, <code>xmlto<\/code> \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0438\u0442 \u043d\u0430 \u0441\u0432\u0435\u0442 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u0432 \u0437\u0430\u0434\u0430\u043d\u043d\u043e\u043c \u0444\u043e\u0440\u043c\u0430\u0442\u0435, \u043d\u043e \u043c\u043e\u0436\u043d\u043e \u0443\u043a\u0430\u0437\u0430\u0442\u044c \u0438 \u0430\u043b\u044c\u0442\u0435\u0440\u043d\u0430\u0442\u0438\u0432\u043d\u0443\u044e \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u043c\u0443 \u0432 <code>Makefile<\/code>.<\/p>\n<p>  <\/p>\n<p>\u042d\u0442\u0430 \u043c\u0435\u0448\u0430\u043d\u0438\u043d\u0430 \u0441\u043a\u0440\u0438\u043f\u0442\u043e\u0432, \u043d\u0435\u0441\u043a\u0443\u0447\u043d\u044b\u0445 XML \u0448\u0430\u0431\u043b\u043e\u043d\u043e\u0432, \u0430\u0434\u0441\u043a\u0438\u0445 \u0440\u0435\u0433\u0443\u043b\u044f\u0440\u043e\u043a<a href=\"#cite_ref-1\"><sup>[1]<\/sup><\/a> \u0431\u044b\u043b\u0430 \u043d\u0435\u043d\u0430\u0434\u0435\u0436\u043d\u043e\u0439 \u0438 \u0442\u043e\u0440\u043c\u043e\u0437\u043d\u0443\u0442\u043e\u0439<a href=\"#cite_ref-2\"><sup>[2]<\/sup><\/a>, \u0430 \u0433\u043b\u0430\u0432\u043d\u043e\u0435 \u2014 \u043d\u0435 \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0438\u043b\u0430 \u0440\u0430\u0434\u0443\u044e\u0449\u0435\u0439 \u0433\u043b\u0430\u0437, \u0441\u0432\u044f\u0437\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438.<\/p>\n<p>  <\/p>\n<h2>Markdown, Asciidoc, Sphinx<\/h2>\n<p>  <\/p>\n<p>\u041f\u043e\u043d\u044f\u0442\u043d\u043e, \u0447\u0442\u043e \u0442\u0430\u043a\u043e\u0435 \u043f\u043e\u043b\u043e\u0436\u0435\u043d\u0438\u0435 \u0434\u0435\u043b \u043d\u0438\u043a\u043e\u0433\u043e \u043d\u0435 \u0443\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u043b\u043e \u0438 \u0414\u0436\u043e\u043d\u0430\u0442\u0430\u043d \u0432\u043c\u0435\u0441\u0442\u0435 \u0441 \u043a\u043e\u043b\u043b\u0435\u0433\u0430\u043c\u0438 \u0438\u0441\u043a\u0430\u043b\u0438 \u0432\u044b\u0445\u043e\u0434 \u0438\u0437 \u0441\u0438\u0442\u0443\u0430\u0446\u0438\u0438. \u0420\u0430\u0441\u0441\u043c\u043e\u0442\u0440\u0435\u0432 \u0438 \u043f\u0435\u0440\u0435\u043f\u0440\u043e\u0431\u043e\u0432\u0430\u0432 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u0432\u0430\u0440\u0438\u0430\u043d\u0442\u043e\u0432, \u0432 \u043a\u043e\u043d\u0446\u0435 \u043e\u0441\u0442\u0430\u043d\u043e\u0432\u0438\u043b\u0438\u0441\u044c \u043d\u0430 \u0441\u0432\u044f\u0437\u043a\u0435 <code>ReStructuredTtext<\/code> \u0438 <code>Sphinx<\/code>.<\/p>\n<p>  <\/p>\n<p>\u0412\u043d\u0430\u0447\u0430\u043b\u0435 \u0431\u044b\u043b\u0438 \u0441\u0444\u043e\u0440\u043c\u0443\u043b\u0438\u0440\u043e\u0432\u0430\u043d\u044b \u043f\u0440\u0438\u043d\u0446\u0438\u043f\u044b. \u041d\u043e\u0432\u0430\u044f \u0441\u0438\u0441\u0442\u0435\u043c\u0430 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 \u0434\u043e\u043b\u0436\u043d\u0430 \u0443\u0434\u043e\u0432\u043b\u0435\u0442\u0432\u043e\u0440\u044f\u0442\u044c \u0442\u0440\u0435\u0431\u043e\u0432\u0430\u043d\u0438\u044f\u043c.<\/p>\n<p>  <\/p>\n<ul>\n<li>\u041b\u0438\u043a\u0432\u0438\u0434\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0431\u0435\u0441\u043f\u043e\u0440\u044f\u0434\u043e\u043a.<\/li>\n<li>\u0423\u043b\u0443\u0447\u0448\u0438\u0442\u044c \u0444\u043e\u0440\u043c\u0430\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435 \u0438 \u0447\u0438\u0442\u0430\u0431\u0435\u043b\u044c\u043d\u043e\u0441\u0442\u044c.<\/li>\n<li>Plaintext.<\/li>\n<li>\u0420\u0430\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e \u043e\u0440\u0433\u0430\u043d\u0438\u0437\u043e\u0432\u0430\u043d\u043d\u044b\u0439 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0439.<\/li>\n<\/ul>\n<p>  <\/p>\n<p>\u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435 \u043b\u0435\u0433\u043a\u043e\u0432\u0435\u0441\u043d\u044b\u0445 \u044f\u0437\u044b\u043a\u043e\u0432 \u0440\u0430\u0437\u043c\u0435\u0442\u043a\u0438 \u043d\u0430\u043f\u0440\u0430\u0448\u0438\u0432\u0430\u043b\u043e\u0441\u044c \u0441\u0430\u043c\u043e \u0441\u043e\u0431\u043e\u0439, \u0438 \u043f\u0435\u0440\u0432\u043e\u0439 \u043f\u043e\u043f\u044b\u0442\u043a\u043e\u0439 \u0441\u0442\u0430\u043b <code>Markdown<\/code>. \u042d\u0442\u043e \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u043b\u043e \u0440\u0435\u0448\u0438\u0442\u044c \u0441\u0440\u0430\u0437\u0443 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u043e \u043f\u0440\u043e\u0431\u043b\u0435\u043c. <strong>\u0412\u043e-\u043f\u0435\u0440\u0432\u044b\u0445<\/strong>, \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0438 \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u043d\u044b\u0435 \u0432 \u0441\u0430\u043c\u043e\u0439 \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u043c\u0435, \u0431\u0443\u0434\u0443\u0442 \u043e\u0431\u043d\u043e\u0432\u043b\u044f\u0442\u044c\u0441\u044f \u0432\u043c\u0435\u0441\u0442\u0435 \u0441 \u043d\u0435\u0439. \u0417\u0430\u0434\u0443\u043c\u043a\u0430 \u0432 \u0446\u0435\u043b\u043e\u043c \u0432\u0435\u0440\u043d\u0430\u044f, \u0445\u043e\u0442\u044c \u0438 \u043e\u043f\u0442\u0438\u043c\u0438\u0441\u0442\u0438\u0447\u043d\u0430\u044f. <strong> \u0412\u043e-\u0432\u0442\u043e\u0440\u044b\u0445<\/strong>, \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f, \u043a\u043e\u0442\u043e\u0440\u0443\u044e \u043f\u0440\u043e\u0449\u0435 \u0441\u043e\u0441\u0442\u0440\u044f\u043f\u0430\u0442\u044c, \u0438\u043c\u0435\u0435\u0442 \u043b\u0443\u0447\u0448\u0438\u0435 \u0448\u0430\u043d\u0441\u044b \u0431\u044b\u0442\u044c \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u043d\u043e\u0439, \u0442\u0430\u043a \u043a\u0430\u043a \u0442\u0435\u043a\u0441\u0442\u043e\u0432\u044b\u0439 <code>MarkDown<\/code> \u0438\u043c\u0435\u0435\u0442 \u0433\u043e\u0440\u0430\u0437\u0434\u043e \u0431\u043e\u043b\u0435\u0435 \u043d\u0438\u0437\u043a\u0438\u0439 \u043f\u043e\u0440\u043e\u0433 \u0432\u0445\u043e\u0436\u0434\u0435\u043d\u0438\u044f \u0447\u0435\u043c <code>DocBook-XML<\/code>.<\/p>\n<p>  <img decoding=\"async\" src=\"https:\/\/habrastorage.org\/files\/244\/897\/22b\/24489722b5914a799779186c14ac4c2f.jpg\"\/>  <\/p>\n<p>  <\/p>\n<p>  <\/p>\n<p>\u0412\u0441\u043a\u043e\u0440\u0435, \u043e\u0434\u043d\u0430\u043a\u043e \u0441\u0442\u0430\u043b\u043e \u043f\u043e\u043d\u044f\u0442\u043d\u043e, \u0447\u0442\u043e <code>MarkDown<\/code> \u043d\u0435 \u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d \u0441\u0430\u043c \u043f\u043e \u0441\u0435\u0431\u0435 \u0430 \u043b\u0438\u0448\u044c \u0432 \u043a\u0430\u0447\u0435\u0441\u0442\u0432\u0435 \u043d\u0430\u0434\u0441\u0442\u0440\u043e\u0439\u043a\u0438 \u0430\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u043e\u0433\u043e \u043d\u0430\u0431\u043e\u0440\u0430 \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u043c. \u041f\u0440\u0438\u0448\u043b\u043e\u0441\u044c \u043a \u043a\u043e\u043b\u043b\u0435\u043a\u0446\u0438\u0438 \u0440\u0435\u0433\u0443\u043b\u044f\u0440\u043e\u043a <code>kernel-doc<\/code> \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u0435\u0449\u0435 \u0438 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0443 <code>MarkDown<\/code>, \u0447\u0442\u043e \u043f\u043e\u0442\u0440\u0435\u0431\u043e\u0432\u0430\u043b\u043e \u043f\u0440\u0438\u0432\u043b\u0435\u0447\u044c \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0443\u044e \u0443\u0442\u0438\u043b\u0438\u0442\u0443 \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0430\u0446\u0438\u0438 <code>pandoc<\/code> (\u0430 \u0437\u0430\u0442\u0435\u043c <code>asciidoc<\/code>). \u0421\u0440\u0435\u0434\u0441\u0442\u0432\u0430 \u0431\u044b\u043b\u0438 \u044f\u0432\u043d\u043e \u043d\u0435 \u0432 \u043b\u0430\u0434\u0443 \u0434\u0440\u0443\u0433 \u0441 \u0434\u0440\u0443\u0433\u043e\u043c, \u0440\u0430\u0437\u043c\u0435\u0442\u043a\u0430 \u043f\u043b\u044b\u043b\u0430, \u043e\u0442\u043b\u0430\u0434\u043a\u0430 \u0443\u0441\u043b\u043e\u0436\u043d\u044f\u043b\u0430\u0441\u044c. \u0422\u043e\u0440\u043c\u043e\u0437\u043e\u0432 \u0441\u0442\u0430\u043b\u043e \u0431\u043e\u043b\u044c\u0448\u0435, \u0430 \u0438\u043d\u0441\u0442\u0440\u0443\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0439 \u0441\u0442\u0430\u043b \u0435\u0449\u0435 \u0431\u043e\u043b\u0435\u0435 \u043a\u0430\u043f\u0440\u0438\u0437\u043d\u044b\u043c.<\/p>\n<p>  <\/p>\n<p>\u0422\u043e\u0433\u0434\u0430 \u0414\u0436\u043e\u043d\u0430\u0442\u0430\u043d \u0441\u043e\u043e\u0431\u0440\u0430\u0437\u0438\u043b, \u0447\u0442\u043e \u0432\u044b\u0445\u043e\u0434 \u0438\u0437 \u0441\u0438\u0442\u0443\u0430\u0446\u0438\u0438 \u043d\u0430\u0434\u043e \u0438\u0441\u043a\u0430\u0442\u044c, \u0434\u0432\u0438\u0433\u0430\u044f\u0441\u044c \u0432 \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u043c \u043d\u0430\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u0438. \u0412\u043c\u0435\u0441\u0442\u043e \u0442\u043e\u0433\u043e, \u0447\u0442\u043e\u0431\u044b \u0443\u0441\u043b\u043e\u0436\u043d\u044f\u0442\u044c \u0446\u0435\u043f\u043e\u0447\u043a\u0443 \u0444\u043e\u0440\u043c\u0430\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0438 \u0432\u0437\u0430\u0438\u043c\u043d\u044b\u0445 \u043f\u0440\u0435\u043e\u0431\u0440\u0430\u0437\u043e\u0432\u0430\u043d\u0438\u0439, \u0441\u043b\u0435\u0434\u0443\u0435\u0442 \u0432\u0437\u044f\u0442\u044c \u0438 <em>\u0432\u044b\u043a\u0438\u043d\u0443\u0442\u044c \u043e\u0442\u0442\u0443\u0434\u0430 \u0447\u0442\u043e-\u0442\u043e \u043b\u0438\u0448\u043d\u0435\u0435<\/em>. \u042d\u0442\u0438\u043c \u043b\u0438\u0448\u043d\u0438\u043c \u043e\u043a\u0430\u0437\u0430\u043b\u0441\u044f DocBook \u0438 \u0432\u0441\u0435, \u0447\u0442\u043e \u0432\u043e\u043a\u0440\u0443\u0433 \u043d\u0435\u0433\u043e. \u0427\u0442\u043e, \u0435\u0441\u043b\u0438 \u0432\u0441\u0435 \u043f\u0435\u0440\u0435\u043d\u0435\u0441\u0442\u0438 \u0432 <code>AsciiDoc<\/code> \u0438 \u0438\u0437 \u043d\u0435\u0433\u043e <strong>\u043d\u0430\u043f\u0440\u044f\u043c\u0443\u044e<\/strong> \u0441\u043e\u0437\u0434\u0430\u0432\u0430\u0442\u044c \u043d\u0435\u043e\u0431\u0445\u043e\u0434\u0438\u043c\u044b\u0435 html, pdf \u0438 man \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b, \u043c\u0438\u043d\u0443\u044f \u0438\u043d\u0444\u0440\u0430\u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0443 DocBook?<\/p>\n<p>  <\/p>\n<p>\u041b\u0435\u0433\u043a\u043e \u0441\u043a\u0430\u0437\u0430\u0442\u044c, \u0442\u0440\u0443\u0434\u043d\u043e \u0440\u0435\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u0442\u044c. <code>AsciiDoc<\/code> \u0442\u044f\u043d\u0443\u043b \u0437\u0430 \u0441\u043e\u0431\u043e\u0439 \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438 Ruby, \u043f\u043b\u043e\u0445\u043e \u043a\u043e\u043d\u0442\u0430\u0447\u0438\u043b \u0441 <code>xmlto<\/code> \u0438 \u0432\u0441\u0435 \u0440\u0430\u0432\u043d\u043e, \u0441\u043a\u043e\u0440\u0435\u0435 \u0434\u043e\u043f\u043e\u043b\u043d\u044f\u043b DocBook, \u043d\u0435\u0436\u0435\u043b\u0438 \u0437\u0430\u043c\u0435\u043d\u044f\u043b \u0435\u0433\u043e, \u0430 \u043b\u0438\u043d\u043a\u043e\u0432\u043a\u0430 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u043e\u0432 \u0432\u0441\u0435 \u0435\u0449\u0435 \u043d\u0435 \u0441\u0440\u0430\u0441\u0442\u0430\u043b\u0430\u0441\u044c. \u0422\u0435\u043c \u043d\u0435 \u043c\u0435\u043d\u0435\u0435, \u0431\u044b\u043b\u043e \u0440\u0435\u0448\u0435\u043d\u043e \u0434\u0432\u0438\u0433\u0430\u0442\u044c\u0441\u044f \u0432\u043f\u0435\u0440\u0435\u0434 \u0432\u043c\u0435\u0441\u0442\u043e \u0442\u043e\u0433\u043e, \u0447\u0442\u043e\u0431\u044b \u0436\u0434\u0430\u0442\u044c \u043d\u0435\u043f\u043e\u043d\u044f\u0442\u043d\u043e \u0447\u0435\u0433\u043e. \u0412 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0438\u0439 \u043c\u043e\u043c\u0435\u043d\u0442 \u0414\u0436\u043e\u043d\u0430\u0442\u0430\u043d \u0432\u0437\u044f\u043b \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0439 \u0442\u0430\u0439\u043c-\u0430\u0443\u0442, \u0435\u0449\u0435 \u0440\u0430\u0437 \u0432\u0437\u0432\u0435\u0441\u0438\u043b \u0432\u0441\u0435 \u0437\u0430 \u0438 \u043f\u0440\u043e\u0442\u0438\u0432 \u0438 \u043f\u0440\u0435\u0434\u043b\u043e\u0436\u0438\u043b \u0432\u0437\u044f\u0442\u044c \u043d\u0430 \u0432\u043e\u043e\u0440\u0443\u0436\u0435\u043d\u0438\u0435 <a href=\"http:\/\/www.sphinx-doc.org\/\">\u043f\u0438\u0442\u043e\u043d\u043e\u0432\u0441\u043a\u0443\u044e \u0441\u0438\u0441\u0442\u0435\u043c\u0443 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 Sphinx<\/a>, \u043e\u0441\u043d\u043e\u0432\u0430\u043d\u043d\u0443\u044e \u043d\u0430 \u043b\u0435\u0433\u043a\u043e\u0432\u0435\u0441\u043d\u043e\u0439 \u0440\u0430\u0437\u043c\u0435\u0442\u043a\u0435 <code>RestructuredText<\/code>.<\/p>\n<p>  <\/p>\n<p>\u041f\u043e\u0447\u0435\u043c\u0443 <em>Sphinx<\/em>?<\/p>\n<p>  <\/p>\n<ul>\n<li>\u0421\u043e\u0437\u0434\u0430\u043d \u0434\u043b\u044f \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u041f\u041e. \u041d\u0430\u043f\u0440\u0438\u043c\u0435\u0440 \u0437\u043d\u0430\u0435\u0442, \u0447\u0442\u043e \u0442\u0430\u043a\u043e\u0435 \u0444\u0443\u043d\u043a\u0446\u0438\u044f.<\/li>\n<li>\u0425\u043e\u0440\u043e\u0448\u043e \u043f\u043e\u0434\u0445\u043e\u0434\u0438\u0442 \u0434\u043b\u044f \u0431\u043e\u043b\u044c\u0448\u0438\u0445 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u043e\u0432 \u0440\u0430\u0441\u0441\u044b\u043f\u0430\u043d\u043d\u044b\u0445 \u043f\u043e \u043c\u043d\u043e\u0436\u0435\u0441\u0442\u0432\u0443 \u0444\u0430\u0439\u043b\u043e\u0432.<\/li>\n<li>\u0427\u0430\u0441\u0442\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u0438 \u0438\u043c\u0435\u0435\u0442 \u0445\u043e\u0440\u043e\u0448\u0443\u044e \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0443<a href=\"#cite_ref-3\"><sup>[3]<\/sup><\/a>. <\/li>\n<li>\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u044b \u043d\u0430\u043a\u043e\u043d\u0435\u0446-\u0442\u043e \u0441\u0432\u044f\u0437\u0430\u043d\u044b \u043c\u0435\u0436\u0434\u0443 \u0441\u043e\u0431\u043e\u0439.<\/li>\n<li>\u0422\u0443\u043b\u0447\u0435\u0439\u043d \u0443\u043f\u0440\u043e\u0441\u0442\u0438\u043b\u0441\u044f, \u0431\u044b\u0441\u0442\u0440\u0435\u0435 \u0441\u0431\u043e\u0440\u043a\u0430.<\/li>\n<\/ul>\n<p>  <\/p>\n<p>\u0414\u043b\u044f \u0442\u043e\u0433\u043e, \u0447\u0442\u043e\u0431\u044b \u0443\u0431\u0435\u0434\u0438\u0442\u044c \u043a\u043e\u043b\u043b\u0435\u0433 \u0414\u0436\u043e\u043d\u0430\u0442\u0430\u043d \u043d\u0430 \u043a\u043e\u043b\u0435\u043d\u043a\u0435 \u043d\u0430\u043f\u0438\u0441\u0430\u043b \u043a\u0440\u0438\u0432\u043e\u0432\u0430\u0442\u044b\u0439 <em>Proof of Concept<\/em>, \u0430 \u0437\u0430\u0442\u0435\u043c Jani Nikula \u043e\u0442\u043f\u043e\u043b\u0438\u0440\u043e\u0432\u0430\u043b \u0435\u0433\u043e \u0438 \u0434\u043e\u0432\u0435\u043b \u0434\u043e \u0443\u043c\u0430. \u0414\u043e\u0432\u043e\u043b\u044c\u043d\u043e \u0431\u044b\u0441\u0442\u0440\u043e \u0441\u0440\u0435\u0434\u0438 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u043b\u0438\u0441\u0442\u043e\u0432 \u0432\u043e\u0437\u043d\u0438\u043a \u043a\u043e\u043d\u0441\u0435\u043d\u0441\u0443\u0441 \u043f\u043e \u0434\u0430\u043d\u043d\u043e\u043c\u0443 \u0432\u043e\u043f\u0440\u043e\u0441\u0443 \u0438 \u0432\u0441\u0435 \u0437\u0430\u0432\u0435\u0440\u0442\u0435\u043b\u043e\u0441\u044c. \u041a\u0441\u0442\u0430\u0442\u0438, <em>\u0442\u0440\u044e\u043a \u0441 PoC, \u0432\u0441\u0435\u0433\u0434\u0430 \u0441\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u0435\u0442<\/em> \u043f\u043e \u0441\u043b\u043e\u0432\u0430\u043c Andrew Morton-\u0430, \u043c\u0435\u0439\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0430 <code>mm<\/code> \u0432\u0435\u0442\u043a\u0438 \u044f\u0434\u0440\u0430. \u0422\u0430\u043a \u043f\u043e\u044f\u0432\u0438\u043b\u0441\u044f Linux, \u0438 \u0442\u0430\u043a \u0434\u043e\u0432\u043e\u043b\u044c\u043d\u043e \u0447\u0430\u0441\u0442\u043e \u0440\u0435\u0448\u0430\u044e\u0442\u0441\u044f \u0441\u043f\u043e\u0440\u043d\u044b\u0435 \u043c\u043e\u043c\u0435\u043d\u0442\u044b, \u043a\u043e\u0433\u0434\u0430 \u043d\u0430\u0434\u043e \u0437\u0430\u043c\u0435\u043d\u0438\u0442\u044c \u0443\u0436\u0430\u0441\u043d\u043e\u0435 \u0440\u0435\u0448\u0435\u043d\u0438\u0435 \u043d\u0435 \u0438\u0434\u0435\u0430\u043b\u044c\u043d\u044b\u043c.<\/p>\n<p>  <\/p>\n<h2>\u0427\u0442\u043e \u0443\u0434\u0430\u043b\u043e\u0441\u044c \u0441\u0434\u0435\u043b\u0430\u0442\u044c \u0438 \u0447\u0442\u043e \u0435\u0449\u0435 \u043f\u0440\u0435\u0434\u0441\u0442\u043e\u0438\u0442<\/h2>\n<p>  <\/p>\n<p>\u0418\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0443\u0436\u0435 \u0447\u0430\u0441\u0442\u0438\u0447\u043d\u043e \u0432\u0438\u0434\u043d\u044b, \u0432 <code>Documentation\/Makefile.sphinx<\/code> \u0438 <code>Documentation\/conf.py<\/code> \u0445\u0440\u0430\u043d\u044f\u0442\u0441\u044f \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 <em>Sphinx<\/em>. \u0422\u0430\u043c \u0436\u0435 \u0438\u043d\u0434\u0435\u043a\u0441 \u0444\u0430\u0439\u043b <code>index.rst<\/code> \u0438 <code>kernel-documentation.rst<\/code>. \u0420\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0438 <code>gpu<\/code> \u0438 <code>media<\/code> \u0432\u043f\u0435\u0440\u0435\u0434\u0438 \u043f\u043b\u0430\u043d\u0435\u0442\u044b \u0432\u0441\u0435\u0439 \u0438 \u0443\u0436\u0435 \u043f\u0435\u0440\u0435\u0432\u0435\u043b\u0438 \u0432\u0441\u044e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e <code>Documentation\/gpu\/<\/code> \u0432 <em>Sphinx<\/em>.<\/p>\n<p>  <\/p>\n<p>\u041f\u0440\u043e\u0446\u0435\u0441\u0441 \u043f\u0435\u0440\u0435\u0445\u043e\u0434\u0430 \u043d\u0430 <em>Sphinx<\/em> \u0431\u0443\u0434\u0435\u0442 \u043f\u0440\u043e\u0438\u0441\u0445\u043e\u0434\u0438\u0442\u044c \u0431\u0435\u0437 \u0448\u043e\u043a\u043e\u0432\u043e\u0439 \u0442\u0435\u0440\u0430\u043f\u0438\u0438, \u0442. \u0435. plaintext \u0444\u0430\u0439\u043b\u044b \u0438 DocBook \u0448\u0430\u0431\u043b\u043e\u043d\u044b \u0431\u0443\u0434\u0443\u0442 \u043f\u043e\u0441\u0442\u0435\u043f\u0435\u043d\u043d\u043e \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c\u0441\u044f \u0432 \u043d\u043e\u0432\u044b\u0439 \u0444\u043e\u0440\u043c\u0430\u0442 \u043f\u043e \u0441\u043e\u0433\u043b\u0430\u0441\u043e\u0432\u0430\u043d\u0438\u044e \u0441 \u043e\u0441\u0442\u0430\u043b\u044c\u043d\u044b\u043c\u0438 \u043c\u0435\u0439\u043d\u0442\u0435\u0439\u043d\u0435\u0440\u0430\u043c\u0438. \u0422\u0430\u043a \u0447\u0442\u043e \u043f\u043e\u043a\u0430 DocBook, \u043d\u0438\u043a\u0443\u0434\u0430 \u043d\u0435 \u0434\u0435\u043d\u0435\u0442\u0441\u044f, \u043e\u0434\u043d\u0430\u043a\u043e \u0434\u043b\u044f \u043d\u043e\u0432\u044b\u0445 rst \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u043e\u0432 <code>docproc<\/code> \u0431\u043e\u043b\u0435\u0435 \u043d\u0435 \u043d\u0443\u0436\u0435\u043d.<\/p>\n<p>  <\/p>\n<p><strong>\u0412\u0435\u0440\u0441\u0438\u044f 4.8<\/strong> \u2014 \u043f\u0435\u0440\u0432\u043e\u0435 \u0441\u0442\u0430\u0431\u0438\u043b\u044c\u043d\u043e\u0435 Linux \u044f\u0434\u0440\u043e \u0441 \u043d\u043e\u0432\u043e\u0439 \u0441\u0438\u0441\u0442\u0435\u043c\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438. \u041b\u0438\u043d\u0443\u0441 \u043f\u0440\u043e\u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u043b \u044d\u0442\u0438 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 \u043f\u0438\u0441\u044c\u043c\u0435, \u0433\u0434\u0435 \u0441 \u0443\u0434\u0438\u0432\u043b\u0435\u043d\u0438\u0435\u043c \u0441\u043e\u043e\u0431\u0449\u0438\u043b, \u0447\u0442\u043e 20 \u043f\u0440\u043e\u0446\u0435\u043d\u0442\u043e\u0432 \u043f\u0430\u0442\u0447\u0430 \u2014 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f.<\/p>\n<p>  <\/p>\n<blockquote><p><em>The merge window has been fairly normal, although the patch itself looks somewhat unusual: over 20% of the patch is documentation updates, due to conversion of drm and media documentation from docbook to Sphinx doc format.<\/em><br \/>  Linux Torvalds (4.8-rc1 release)<\/p><\/blockquote>\n<p>  \u0425\u043e\u0440\u043e\u0448\u0438\u0439 \u043f\u0440\u0438\u043c\u0435\u0440 \u2014 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442 HSI. \u0414\u043e \u0441\u0438\u0445 \u043f\u043e\u0440 \u043e\u043d \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u043e\u0432\u0430\u043b \u0432 \u0434\u0432\u0443\u0445 \u0438\u043f\u043e\u0441\u0442\u0430\u0441\u044f\u0445: plaintext \u0438 DocBook. \u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u044b \u043d\u0438\u043a\u0430\u043a \u0434\u0440\u0443\u0433 \u0441 \u0434\u0440\u0443\u0433\u043e\u043c \u043d\u0435 \u0431\u044b\u043b\u0438 \u0441\u0432\u044f\u0437\u0430\u043d\u044b.<\/p>\n<p>  <\/p>\n<ul>\n<li><code>Documentation\/hsi.txt<\/code><\/li>\n<li><code>Documentation\/DocBook\/device-drivers.tmpl<\/code><\/li>\n<\/ul>\n<p>  <\/p>\n<p>\u041d\u0430\u0447\u0438\u043d\u0430\u044f \u0441 Linux 4.9 \u044d\u0442\u043e \u0431\u0443\u0434\u0435\u0442 \u0435\u0434\u0438\u043d\u044b\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442 <code>Documentation\/drivers-api\/hsi.rst<\/code>. \u0418 \u044d\u0442\u043e \u0442\u043e\u043b\u044c\u043a\u043e \u043d\u0430\u0447\u0430\u043b\u043e \u0431\u043e\u043b\u044c\u0448\u043e\u0433\u043e \u043f\u0443\u0442\u0438!<\/p>\n<p>  <\/p>\n<p>\u0412\u043f\u0435\u0440\u0435\u0434\u0438 \u043d\u0435\u043c\u0430\u043b\u043e \u0440\u0430\u0431\u043e\u0442\u044b. \u0414\u043e\u043b\u0433\u043e\u0441\u0440\u043e\u0447\u043d\u0430\u044f \u0446\u0435\u043b\u044c \u2014 \u043f\u043e\u043b\u043d\u043e\u0441\u0442\u044c\u044e \u0438\u0437\u0431\u0430\u0432\u0438\u0442\u044c\u0441\u044f \u043e\u0442 DocBook \u0438 \u0434\u0432\u0430\u0434\u0446\u0430\u0442\u0438\u043b\u0435\u0442\u043d\u0435\u0439 Perl \u043c\u0430\u0433\u0438\u0438 <code>kernel-doc<\/code>. \u0421\u043b\u0435\u0434\u0443\u0435\u0442 \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u0442\u044c \u0431\u043e\u043b\u0435\u0435 \u0434\u0432\u0443\u0445 \u0442\u044b\u0441\u044f\u0447 \u0442\u0435\u043a\u0441\u0442\u043e\u0432\u044b\u0445 \u0444\u0430\u0439\u043b\u043e\u0432 \u0432 <code>ReStructuredText<\/code>, \u0437\u0430\u0434\u0430\u0442\u044c \u0441\u0442\u0440\u043e\u0433\u0443\u044e \u0438 \u043f\u043e\u043d\u044f\u0442\u043d\u0443\u044e \u0438\u0435\u0440\u0430\u0440\u0445\u0438\u044e \u0444\u0430\u0439\u043b\u043e\u0432\u043e\u0439 \u0441\u0438\u0441\u0442\u0435\u043c\u044b \u0432 <code>Documentation<\/code>, \u0447\u0442\u043e\u0431\u044b \u0442\u0430\u043c \u0431\u044b\u043b \u0442\u0430\u043a\u043e\u0439 \u0436\u0435 \u043f\u043e\u0440\u044f\u0434\u043e\u043a \u043a\u0430\u043a \u0432 \u043f\u0440\u043e\u0441\u0442\u0440\u0430\u043d\u0441\u0442\u0432\u0435 \u0438\u0441\u0445\u043e\u0434\u043d\u0438\u043a\u043e\u0432 \u044f\u0434\u0440\u0430.<\/p>\n<p>  <\/p>\n<p>\u0415\u0441\u043b\u0438 \u0432\u044b \u0436\u0435\u043b\u0430\u0435\u0442\u0435 \u043f\u0440\u0438\u043d\u044f\u0442\u044c \u0443\u0447\u0430\u0441\u0442\u0438\u0435 \u0432 <del>\u043e\u0447\u0438\u0441\u0442\u043a\u0435 \u0430\u0432\u0433\u0438\u0435\u0432\u044b\u0445 \u043a\u043e\u043d\u044e\u0448\u0435\u043d<\/del> \u0440\u0435\u0444\u043e\u0440\u043c\u0435 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 Linux \u044f\u0434\u0440\u0430, \u0434\u0435\u0440\u0437\u0430\u0439\u0442\u0435, \u043e\u0441\u043e\u0431\u044b\u0445 \u0437\u043d\u0430\u043d\u0438\u0439 \u0434\u043b\u044f \u044d\u0442\u043e\u0433\u043e \u043d\u0435 \u0442\u0440\u0435\u0431\u0443\u0435\u0442\u0441\u044f, \u0445\u043e\u0442\u044f \u0437\u043d\u0430\u043d\u0438\u044f \u043f\u0440\u0435\u0434\u043c\u0435\u0442\u043d\u043e\u0439 \u043e\u0431\u043b\u0430\u0441\u0442\u0438, \u043a\u043e\u043d\u0435\u0447\u043d\u043e \u0436\u0435, \u043d\u0435 \u043b\u0438\u0448\u043d\u0438\u0435. \u041d\u0435 \u043c\u0435\u043d\u0435\u0435 \u0432\u0430\u0436\u043d\u043e \u0443\u0447\u0438\u0442\u044c\u0441\u044f \u043d\u043e\u0432\u044b\u043c \u0432\u0435\u0449\u0430\u043c, \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u043e\u0432\u0430\u0442\u044c \u0441\u043e \u0432\u0441\u0435\u043c\u0438 \u0437\u0430\u0438\u043d\u0442\u0435\u0440\u0435\u0441\u043e\u0432\u0430\u043d\u043d\u044b\u043c\u0438 \u0441\u0442\u043e\u0440\u043e\u043d\u0430\u043c\u0438 \u0438 \u043f\u0440\u0438\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0442\u044c\u0441\u044f \u0437\u0434\u043e\u0440\u043e\u0432\u043e\u0433\u043e \u043a\u043e\u043d\u0441\u0435\u0440\u0432\u0430\u0442\u0438\u0437\u043c\u0430 \u0438 \u043f\u0440\u0438\u043d\u0446\u0438\u043f\u0430 \u043f\u043e\u0441\u0442\u0435\u043f\u0435\u043d\u043d\u043e\u0441\u0442\u0438.<\/p>\n<p>  <\/p>\n<h3>\u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u043d\u044b\u0435 \u043c\u0430\u0442\u0435\u0440\u0438\u0430\u043b\u044b<\/h3>\n<p>  <\/p>\n<ul>\n<li><a href=\"https:\/\/lwn.net\/Articles\/671496\/\">The present and future of formatted kernel documentation<\/a><\/li>\n<li><a href=\"https:\/\/lwn.net\/Articles\/692704\/\">Kernel documentation with Sphinx, part 1: how we got here<\/a><\/li>\n<li><a href=\"https:\/\/lwn.net\/Articles\/692705\/\">Kernel documentation with Sphinx, part 2: how it works<\/a><\/li>\n<\/ul>\n<p>  <\/p>\n<hr\/>\n<p>  <\/p>\n<ol>\n<li><a name=\"cite_ref-1\"><\/a><a href=\"#cite_note-1\">\u2191<\/a> \u0414\u043e\u043a\u043b\u0430\u0434\u0447\u0438\u043a \u043d\u0430\u0437\u0432\u0430\u043b <u>kernel-doc<\/u> <i>bunch of regular expressions from the hell<\/i>.  <\/li>\n<li><a name=\"cite_ref-2\"><\/a><a href=\"#cite_note-2\">\u2191<\/a> \u0423 \u043c\u0435\u043d\u044f <u>make htmldocs<\/u> \u0437\u0430\u0432\u0435\u0440\u0448\u0438\u043b\u0441\u044f \u0447\u0435\u0440\u0435\u0437 8 \u043c\u0438\u043d. \u0414\u043b\u044f \u0441\u0440\u0430\u0432\u043d\u0435\u043d\u0438\u044f <u>cpuinfo<\/u> \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0435\u0442 <u>bogomips: 4988.37<\/u>.  <\/li>\n<li><a name=\"cite_ref-3\"><\/a><a href=\"#cite_note-3\">\u2191<\/a> <i>\u0418 \u0447\u0442\u043e \u043e\u0441\u043e\u0431\u0435\u043d\u043d\u043e \u043f\u0440\u0438\u044f\u0442\u043d\u043e, \u043d\u0435 \u043c\u044b \u0435\u0433\u043e \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u043c<\/i>  <\/li>\n<\/ol>\n<p> \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 <a href=\"https:\/\/habrahabr.ru\/post\/316758\/\"> https:\/\/habrahabr.ru\/post\/316758\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Linux \u044f\u0434\u0440\u043e \u043d\u0430 \u0441\u0435\u0433\u043e\u0434\u043d\u044f\u0448\u043d\u0438\u0439 \u0434\u0435\u043d\u044c \u2014 <a href=\"https:\/\/habrahabr.ru\/post\/314084\/\">\u0441\u0430\u043c\u044b\u0439 \u0434\u0438\u043d\u0430\u043c\u0438\u0447\u043d\u044b\u0439, \u0441\u043b\u043e\u0436\u043d\u044b\u0439, \u043a\u0440\u0443\u043f\u043d\u044b\u0439 \u043f\u0440\u043e\u0435\u043a\u0442 \u0441 \u043e\u0442\u043a\u0440\u044b\u0442\u044b\u043c \u043a\u043e\u0434\u043e\u043c<\/a>. \u041a\u0430\u043a \u0436\u0435 \u043e\u0431\u0441\u0442\u043e\u044f\u0442 \u0434\u0435\u043b\u0430 \u0441 \u0435\u0433\u043e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439? \u0421\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442 \u043f\u0440\u044f\u043c\u0430\u044f \u0441\u0432\u044f\u0437\u044c: \u0447\u0435\u043c \u043a\u0430\u0447\u0435\u0441\u0442\u0432\u0435\u043d\u043d\u0435\u0435 \u0438 \u0434\u043e\u0441\u0442\u0443\u043f\u043d\u0435\u0435 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f \u043f\u0440\u043e\u0435\u043a\u0442\u0430, \u0442\u0435\u043c \u043f\u0440\u043e\u0449\u0435 \u0434\u043b\u044f \u043f\u043e\u0441\u0442\u043e\u0440\u043e\u043d\u043d\u0438\u0445 \u0438\u0437\u0443\u0447\u0438\u0442\u044c \u043e\u0441\u043d\u043e\u0432\u044b \u0434\u0435\u043b\u0430, \u043e\u0441\u0432\u043e\u0438\u0442\u044c\u0441\u044f \u0438 \u0441\u0442\u0430\u0442\u044c \u043f\u043e\u043b\u043d\u043e\u043f\u0440\u0430\u0432\u043d\u044b\u043c \u0443\u0447\u0430\u0441\u0442\u043d\u0438\u043a\u043e\u043c. <\/p>\n<p>  <img decoding=\"async\" src=\"https:\/\/habrastorage.org\/files\/6bd\/c3d\/4dc\/6bdc3d4dc0874030a0a7a5e7bfe86299.jpg\"\/>  <\/p>\n<p>  <\/p>\n<p>  <\/p>\n<p><a href=\"https:\/\/kernel-recipes.org\/en\/2016\/talks\/kernel-documentation-what-we-have-and-where-its-going-2\/\">\u041d\u0430 \u0441\u0435\u043c\u0438\u043d\u0430\u0440\u0435 Kernel Recipies<\/a> \u043c\u0435\u0439\u043d\u0442\u0435\u0439\u043d\u0435\u0440 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438 Linux \u044f\u0434\u0440\u0430 Jonathan Corbet \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u0430\u043b \u043e \u043d\u044b\u043d\u0435\u0448\u043d\u0435\u043c \u043f\u043e\u043b\u043e\u0436\u0435\u043d\u0438\u0438 \u0434\u0435\u043b \u0441 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439 \u0438 \u043e \u0442\u043e\u043c, \u043a\u0430\u043a \u0431\u0443\u0434\u0435\u0442 \u0441\u043e\u0432\u0435\u0440\u0448\u0430\u0442\u044c\u0441\u044f \u043f\u0435\u0440\u0435\u0445\u043e\u0434 \u043e\u0442 \u0430\u043d\u0430\u0440\u0445\u0438\u0438 \u043a \u043f\u043e\u0440\u044f\u0434\u043a\u0443. <strong>\u041f\u0435\u0440\u0432\u044b\u0435 \u0443\u0441\u043f\u0435\u0445\u0438 \u0432 \u044d\u0442\u043e\u043c \u043d\u0430\u0447\u0438\u043d\u0430\u043d\u0438\u0438 \u0443\u0436\u0435 \u0435\u0441\u0442\u044c<\/strong>. <a href=\"https:\/\/www.kernel.org\/doc\/html\/latest\/\">\u041d\u0435\u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u044b<\/a> \u0431\u044b\u043b\u0438 \u043d\u0435\u0434\u0430\u0432\u043d\u043e \u043a\u043e\u043d\u0432\u0435\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u044b \u0432 \u043d\u043e\u0432\u044b\u0439 \u0444\u043e\u0440\u043c\u0430\u0442. \u041e \u0442\u043e\u043c \u043a\u0430\u043a \u044d\u0442\u043e \u0431\u044b\u043b\u043e \u0440\u0430\u0441\u0441\u043a\u0430\u0437\u0430\u043d\u043e \u0432\u043d\u0443\u0442\u0440\u0438.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-282160","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/282160","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=282160"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/282160\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=282160"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=282160"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=282160"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}