[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Documentation/kernel/programming.xml: 1.1 -> 1.4



以下のページの更新をしました。ツッコミをお願いします。

Documentation/kernel/programming.xml: 1.1 -> 1.4

木曜日までに異議がなければ、 commit します。

> revision 1.4
> date: 2005/09/05 20:07:31;  author: rpaulo;  state: Exp;  lines: +12 -20
> Move all ulinks to cvsweb.netbsd.org to <filename role="cvsweb"> so that we
> don't break links randomly like src/share/misc/style link pointed out by
> Andre Luiz de Oliveira <andre@fc.unesp.br> on private email.
> ----------------------------
> revision 1.3
> date: 2005/07/13 21:40:09;  author: rpaulo;  state: Exp;  lines: +5 -9
> Use ANSI function declarations.
> ----------------------------
> revision 1.2
> date: 2005/07/13 20:21:47;  author: rpaulo;  state: Exp;  lines: +9 -8
> /sys link to /usr/src/sys was removed sometime ago, but not in the
> documentation.

で、文章は変わっていません。

以下、訳と原文の差分です。

--- Documentation/kernel/programming.xml.orig	Wed Feb 15 00:51:47 2006
+++ Documentation/kernel/programming.xml	Wed Feb 15 00:51:47 2006
@@ -6,10 +6,10 @@
 <webpage id="ja-Documentation-kernel-programming">
   <config param="desc" value="NetBSD ドキュメンテーション: カーネルプログラミング FAQ"/>
   <config param="cvstag" 
-    value="$NetBSD: programming.xml,v 1.1 2005/07/13 20:12:34 rpaulo Exp $"/>
+    value="$NetBSD: programming.xml,v 1.4 2005/09/05 20:07:31 rpaulo Exp $"/>
 <!-- Based on english version: -->
-<!-- NetBSD: programming.xml,v 1.1 2005/07/13 20:12:34 rpaulo Exp   -->
-  <config param="rcsdate" value="$Date: 2005/07/13 20:12:34 $"/>
+<!-- NetBSD: programming.xml,v 1.4 2005/09/05 20:07:31 rpaulo Exp   -->
+  <config param="rcsdate" value="$Date: 2005/09/05 20:07:31 $"/>
   <head>
 
     <!-- Copyright (c) 1994-2005
@@ -28,8 +28,7 @@
 
 	<para>KNF は Kernel Normal Form の略で、
 	  <filename>/usr/share/misc/style</filename> に記述されている
-	  C のコーディングスタイルです。ソースツリーに <ulink
-	  url="http://cvsweb.NetBSD.org/bsdweb.cgi/usr/src/share/misc/style.?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/usr/src/share/misc/style</ulink>
+	  C のコーディングスタイルです。ソースツリーに <filename role="cvsweb">src/share/misc/style</filename>
 	  として含まれています。</para>
       </sect3>
 
@@ -100,27 +99,23 @@
 	  構成されています。
 
 	  <itemizedlist>
-	    <listitem><ulink
-		url="http://cvsweb.NetBSD.org/bsdweb.cgi/sys/dev/pci/files.pci?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/sys/dev/pci/files.pci</ulink>
+	    <listitem><filename
+		role="cvsweb">src/sys/dev/pci/files.pci</filename>
 	      - アタッチ情報 ('le at pci'を見てください)。</listitem>
-	    <listitem><ulink 
-		url="http://cvsweb.NetBSD.org/bsdweb.cgi/sys/dev/pci/if_le_pci.c?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/sys/dev/pci/if_le_pci.c</ulink> 
+	    <listitem><filename role="cvsweb">src/sys/dev/pci/if_le_pci.c</filename> 
 	      - ドライバーのためのPCI バスのアタッチのコード。</listitem>
 	  </itemizedlist>
 	</para>
 	
 	<para>
 	  <itemizedlist>
-	    <listitem><ulink url="http://cvsweb.NetBSD.org/bsdweb.cgi/src/sys/conf/files?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/sys/conf/files</ulink>
+	    <listitem><filename role="cvsweb">src/sys/conf/files</filename>
 	      - MI コアのアタッチ情報('le:'を見てください)。</listitem>
-	    <listitem><ulink 
-		url="http://cvsweb.NetBSD.org/bsdweb.cgi/src/sys/dev/ic/am7990.c?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/sys/dev/ic/am7990.c</ulink>
+	    <listitem><filename role="cvsweb">src/sys/dev/ic/am7990.c</filename>
 	      - MI ドライバー、24ビットアクセスのコード。</listitem>
-	    <listitem><ulink 
-		url="http://cvsweb.NetBSD.org/bsdweb.cgi/src/sys/dev/ic/am79900.c?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/sys/dev/ic/am79900.c</ulink>
+	    <listitem><filename role="cvsweb">src/sys/dev/ic/am79900.c</filename>
 	      - MI ドライバー、32ビットアクセスのコード。</listitem>
-	  <listitem><ulink 
-		url="http://cvsweb.NetBSD.org/bsdweb.cgi/src/sys/dev/ic/lance.c?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/sys/dev/ic/lance.c</ulink>
+	  <listitem><filename role="cvsweb">src/sys/dev/ic/lance.c</filename>
 	      - MI コアのドライバーのコード。</listitem>
 	  </itemizedlist>
 	</para>
@@ -190,8 +185,7 @@
 	<title>システムコールを追加する</title>
 	
 	<para><code>syscalls.master</code> にエントリーを追加し、syscall スタブを
-	  <code><ulink 
-	      url="http://cvsweb.NetBSD.org/bsdweb.cgi/usr/src/lib/libc/sys/Makefile.inc?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/usr/src/lib/libc/sys/Makefile.inc</ulink></code>
+	  <code><filename role="cvsweb">src/lib/libc/sys/Makefile.inc</filename></code>
 	  の適当な場所に追加してください。</para>
       </sect3>
 	
@@ -223,9 +217,7 @@
 	<para>これが終ると、mmap ルーチンは以下のように実装できます。
 	  <programlisting>
 int
-foommap(dev, off, prot)
-        dev_t dev;
-        int off, prot;
+foommap(dev_t dev, int off, int prot)
 {
 
         if (off &amp; PAGE_MASK)
@@ -256,9 +248,7 @@
 	  <para>若干の修正を加えると以下のようになります。
 	    <programlisting>
 int
-foommap(dev, off, prot)
-        dev_t dev;
-        int off, prot;
+foommap(dev_t dev, int off, int prot)
 {
         paddr_t pa;
 
@@ -294,8 +284,7 @@
 	<title>ユーザーランドからカーネルの構造体へアクセスする</title>
 	
 	<para>良い例が  <code>
-	    <ulink
-	      url="http://cvsweb.NetBSD.org/bsdweb.cgi//usr/src/usr.bin/vmstat/dkstats.c?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/usr/src/usr.bin/vmstat/dkstats.c</ulink></code>
+	    <filename role="cvsweb">src/usr.bin/vmstat/dkstats.c</filename></code>
 	  にあります。ここではディスクの統計情報を読んでいます。</para>
       </sect3>
       
@@ -312,7 +301,7 @@
       <sect3 id="other-related-links">
 	<title>他の関連するリンク</title>
 	
-	<itemizedlist>
+<itemizedlist>
 	  <listitem>&man.driver.9; - デバイスドライバーが利用する
 	    NetBSD の自動コンフィギュレーションのインターフェース</listitem>
 	  <listitem>&man.autoconf.9; - NetBSD の自動コンフィギュレーションフレームワークについての
Index: Documentation/kernel/programming.xml
===================================================================
RCS file: /cvsroot/htdocs/Documentation/kernel/programming.xml,v
retrieving revision 1.1
retrieving revision 1.4
diff -u -r1.1 -r1.4
--- Documentation/kernel/programming.xml	13 Jul 2005 20:12:34 -0000	1.1
+++ Documentation/kernel/programming.xml	5 Sep 2005 20:07:31 -0000	1.4
@@ -6,8 +6,8 @@
 <webpage id="Documentation-kernel-programming">
   <config param="desc" value="NetBSD Documentation: Kernel Programming FAQ"/>
   <config param="cvstag" 
-    value="$NetBSD: programming.xml,v 1.1 2005/07/13 20:12:34 rpaulo Exp $"/>
-  <config param="rcsdate" value="$Date: 2005/07/13 20:12:34 $"/>
+    value="$NetBSD: programming.xml,v 1.4 2005/09/05 20:07:31 rpaulo Exp $"/>
+  <config param="rcsdate" value="$Date: 2005/09/05 20:07:31 $"/>
   <head>
 
     <!-- Copyright (c) 1994-2005
@@ -27,8 +27,7 @@
 	<para>KNF stands for "Kernel Normal Form" - it's a C coding
 	  style documented in
 	  <filename>/usr/share/misc/style</filename>, which is
-	  included in the source tree as <ulink
-	  url="http://cvsweb.NetBSD.org/bsdweb.cgi/usr/src/share/misc/style.?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/usr/src/share/misc/style</ulink>.</para>
+	  included in the source tree as <filename role="cvsweb">src/share/misc/style</filename>.</para>
       </sect3>
 
       <sect3 id="packed-attribute">
@@ -102,27 +101,23 @@
 	  the PCI lance ethernet chip has entries in the following files:
 
 	  <itemizedlist>
-	    <listitem><ulink
-		url="http://cvsweb.NetBSD.org/bsdweb.cgi/sys/dev/pci/files.pci?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/sys/dev/pci/files.pci</ulink>
+	    <listitem><filename
+		role="cvsweb">src/sys/dev/pci/files.pci</filename>
 	      - attach information (look for 'le at pci').</listitem>
-	    <listitem><ulink 
-		url="http://cvsweb.NetBSD.org/bsdweb.cgi/sys/dev/pci/if_le_pci.c?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/sys/dev/pci/if_le_pci.c</ulink> 
+	    <listitem><filename role="cvsweb">src/sys/dev/pci/if_le_pci.c</filename> 
 	      - PCI bus attach code for the driver.</listitem>
 	  </itemizedlist>
 	</para>
 	
 	<para>
 	  <itemizedlist>
-	    <listitem><ulink url="http://cvsweb.NetBSD.org/bsdweb.cgi/src/sys/conf/files?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/sys/conf/files</ulink>
+	    <listitem><filename role="cvsweb">src/sys/conf/files</filename>
 	      - MI core attach information (look for 'le:').</listitem>
-	    <listitem><ulink 
-		url="http://cvsweb.NetBSD.org/bsdweb.cgi/src/sys/dev/ic/am7990.c?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/sys/dev/ic/am7990.c</ulink>
+	    <listitem><filename role="cvsweb">src/sys/dev/ic/am7990.c</filename>
 	      - MI driver 24bit access code.</listitem>
-	    <listitem><ulink 
-		url="http://cvsweb.NetBSD.org/bsdweb.cgi/src/sys/dev/ic/am79900.c?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/sys/dev/ic/am79900.c</ulink>
+	    <listitem><filename role="cvsweb">src/sys/dev/ic/am79900.c</filename>
 	      - MI driver 32bit access code.</listitem>
-	  <listitem><ulink 
-		url="http://cvsweb.NetBSD.org/bsdweb.cgi/src/sys/dev/ic/lance.c?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/sys/dev/ic/lance.c</ulink>
+	  <listitem><filename role="cvsweb">src/sys/dev/ic/lance.c</filename>
 	      - MI core driver code.</listitem>
 	  </itemizedlist>
 	</para>
@@ -202,8 +197,7 @@
 	
 	<para>Add an entry in <code>syscalls.master</code>, and add
 	  the syscall stub to the appropriate place in 
-	  <code><ulink 
-	      url="http://cvsweb.NetBSD.org/bsdweb.cgi/usr/src/lib/libc/sys/Makefile.inc?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/usr/src/lib/libc/sys/Makefile.inc</ulink></code>.</para>
+	  <code><filename role="cvsweb">src/lib/libc/sys/Makefile.inc</filename></code>.</para>
       </sect3>
 	
       <sect3 id="adding_a_sysctl">
@@ -236,9 +230,7 @@
 	  like this:
 	  <programlisting>
 int
-foommap(dev, off, prot)
-        dev_t dev;
-        int off, prot;
+foommap(dev_t dev, int off, int prot)
 {
 
         if (off &amp; PAGE_MASK)
@@ -274,9 +266,7 @@
 	  <para>Then it would look a bit more like this:
 	    <programlisting>
 int
-foommap(dev, off, prot)
-        dev_t dev;
-        int off, prot;
+foommap(dev_t dev, int off, int prot)
 {
         paddr_t pa;
 
@@ -312,8 +302,7 @@
 	<title>Accessing a kernel structure from userland</title>
 	
 	<para>The canonical example for this is:  <code>
-	    <ulink
-	      url="http://cvsweb.NetBSD.org/bsdweb.cgi//usr/src/usr.bin/vmstat/dkstats.c?rev=HEAD&amp;content-type=text/x-cvsweb-markup">/usr/src/usr.bin/vmstat/dkstats.c</ulink></code>
+	    <filename role="cvsweb">src/usr.bin/vmstat/dkstats.c</filename></code>
 	  , which reads disk statistics.</para>
       </sect3>
       
@@ -332,7 +321,7 @@
       <sect3 id="other-related-links">
 	<title>Other related links</title>
 	
-	<itemizedlist>
+<itemizedlist>
 	  <listitem>&man.driver.9; - NetBSD autoconfiguration
 	    interface utilised by device drivers</listitem>
 	  <listitem>&man.autoconf.9; - General description on the