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

pkgsrc/doc/guide/files/submit.xml: 1.6 -> 1.7



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

pkgsrc/doc/guide/files/submit.xml: 1.6 -> 1.7

> revision 1.7
> date: 2005/06/08 23:03:49;  author: wiz;  state: Exp;  lines: +29 -11
> Add a new section describing what to do when changing packages.
> (points to pkgsrc/doc/CHANGES and pkgsrc/doc/TODO, and describes
> the changes-entry target).

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

以下、訳と原文それぞれの新旧の差分です。

--- submit.xml.orig	2006-10-03 22:05:48.000000000 +0900
+++ submit.xml	2006-10-03 22:05:48.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: submit.xml,v 1.6 2005/05/24 12:14:42 wiz Exp $ -->
+<!-- $NetBSD: submit.xml,v 1.7 2005/06/08 23:03:49 wiz Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: submit.xml,v 1.6 2005/05/24 12:14:42 wiz Exp   -->
+<!-- NetBSD: submit.xml,v 1.7 2005/06/08 23:03:49 wiz Exp   -->
 
 <chapter id="submit"> <?dbhtml filename="submit.html"?>
 <title>提出およびコミット</title>
@@ -54,6 +54,35 @@
 
 </sect1>
 
+<sect1 id="general-notes-for-changes">
+<title>パッケージを追加・更新・削除する際の一般的な覚書</title>
+<para>パッケージの追加、更新、移動、および削除は、すべて
+  <filename>pkgsrc/doc/CHANGES</filename> に書いてください。
+  このファイルを、これまでと同じ形式のまま最新の状態に保つことは非常に重要なことです。
+  なぜなら、このファイルはスクリプトにより
+  <ulink url="http://www.NetBSD.org/">www.NetBSD.org</ulink>
+  や他のサイトのページを自動的に更新するために使用されているからです。
+  また、<filename>pkgsrc/doc/TODO</filename> ファイルを確認し、
+  今回更新あるいは削除したパッケージのことが書かれている場合は、
+  その部分を削除してください。</para>
+
+<para>正しい <filename>CHANGES</filename>
+  の項目を作るのを手伝ってくれる make ターゲット、 <command>make
+  changes-entry</command> があります。このターゲットは <varname>CTYPE</varname>
+  および <varname>NETBSD_LOGIN_NAME</varname> というオプションの変数を使います。
+  一般的な使い方は、まず <filename>CHANGES</filename>
+  ファイルを (あとで衝突して修正する必要が起こらないように)
+  最新の状態にした上で、パッケージのディレクトリーに <command>cd</command>
+  します。パッケージを更新した場合は <command>make changes-entry</command>
+  だけで十分です。新規パッケージの追加や、パッケージの移動または削除の場合は、
+  コマンドラインで <varname>CTYPE</varname> 変数を "Added",
+  "Moved" または "Removed" に設定します。ローカルのログイン名が
+  NetBSD のログイン名と異なる場合は、<filename>/etc/mk.conf</filename> で
+  <varname>NETBSD_LOGIN_NAME</varname> を設定することができます。最後に
+  <filename>pkgsrc/doc/CHANGES</filename> の変更を
+  commit するのを忘れないでください。</para>
+</sect1>
+
 <sect1 id="committing-importing">
 <title>コミット: パッケージのCVSへのインポート</title>
 <para>
@@ -84,16 +113,6 @@
 </para>
 
 <para>
-  すべてのパッケージの変更や追加を、<filename>pkgsrc/doc/CHANGES</filename>に記述してください。こ
-  のファイルを、これまでと同じ形式のまま最新の状態に保つことは非常に重要なこ
-  とです。なぜなら、このファイルはスクリプトにより
-  <ulink url="http://www.NetBSD.org/">www.NetBSD.org</ulink> や他のサイト
-  のページを自動的に更新するために使用されているからです。
-  また、pkgsrc/doc/TODO ファイルを確認し、今回更新したパッケージのことが書かれている場合は、
-  その部分を削除してください。
-</para>
-
-<para>
   新しいパッケージを追加する場合は、<quote>cvs
   add</quote>ではなく<quote>cvs import</quote>を使うように
   してください。"cvs import"なら、単一のコマンドですべて記述することができ、
Index: submit.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/submit.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- submit.xml	24 May 2005 12:14:42 -0000	1.6
+++ submit.xml	8 Jun 2005 23:03:49 -0000	1.7
@@ -1,4 +1,4 @@
-<!-- $NetBSD: submit.xml,v 1.6 2005/05/24 12:14:42 wiz Exp $ -->
+<!-- $NetBSD: submit.xml,v 1.7 2005/06/08 23:03:49 wiz Exp $ -->
 
 <chapter id="submit"> <?dbhtml filename="submit.html"?>
 <title>Submitting and Committing</title>
@@ -51,6 +51,34 @@
 
 </sect1>
 
+<sect1 id="general-notes-for-changes">
+<title>General notes when adding, updating, or removing packages</title>
+<para>Please note all package additions, updates, moves, and removals
+  in <filename>pkgsrc/doc/CHANGES</filename>. It's very important
+  to keep this file up to date and conforming to the existing
+  format, because it will be used by scripts to automatically update
+  pages on <ulink url="http://www.NetBSD.org/">www.NetBSD.org</ulink>
+  and other sites. Additionally, check the
+  <filename>pkgsrc/doc/TODO</filename> file and remove the entry
+  for the package you updated or removed, in case it was mentioned
+  there.</para>
+
+<para>There is a make target that helps in creating proper
+  <filename>CHANGES</filename> entries:  <command>make
+  changes-entry</command>. It uses the optional <varname>CTYPE</varname>
+  and <varname>NETBSD_LOGIN_NAME</varname> variables. The general
+  usage is to first make sure that your <filename>CHANGES</filename>
+  file is up-to-date (to avoid having to resolve conflicts later-on)
+  and then to <command>cd</command> to the package directory.  For
+  package updates, <command>make changes-entry</command> is enough.
+  For new packages, or package moves or removals, set the
+  <varname>CTYPE</varname> variable on the command line to "Added",
+  "Moved", or "Removed".  You can set <varname>NETBSD_LOGIN_NAME</varname>
+  in <filename>/etc/mk.conf</filename> if your local login name is
+  not the same as your NetBSD login name. Don't forget to commit
+  the changes to <filename>pkgsrc/doc/CHANGES</filename>!</para>
+</sect1>
+
 <sect1 id="committing-importing">
 <title>Committing: Importing a package into CVS</title>
 <para>
@@ -83,16 +111,6 @@
 </para>
 
 <para>
-  Please note all package updates/additions in
-  <filename>pkgsrc/doc/CHANGES</filename>. It's very
-  important to keep this file up to date and conforming to the existing
-  format, because it will be used by scripts to automatically update pages on
-  <ulink url="http://www.NetBSD.org/">www.NetBSD.org</ulink> and other
-  sites. Additionally, check the pkgsrc/doc/TODO file and remove the entry
-  for the package you updated, in case it was mentioned there.
-</para>
-
-<para>
   For new packages, <quote>cvs import</quote> is preferred to <quote>cvs
   add</quote> because the former gets everything with a single command,
   and provides a consistent tag.