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

pkgsrc/doc/guide/files/ftp-layout.xml: 1.7 -> 1.8

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

pkgsrc/doc/guide/files/ftp-layout.xml: 1.7 -> 1.8
> revision 1.8
> date: 2007/07/25 17:53:44;  author: rillig;  state: Exp;  lines: +26 -16
> Documented the new filesystem layout on ftp.NetBSD.org.

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

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

--- ftp-layout.xml.orig	2007-07-26 22:07:43.000000000 +0900
+++ ftp-layout.xml	2007-07-26 22:07:43.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: ftp-layout.xml,v 1.7 2006/11/23 11:42:54 yyamano Exp $ -->
+<!-- $NetBSD: ftp-layout.xml,v 1.8 2007/07/25 17:53:44 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: ftp-layout.xml,v 1.7 2006/11/23 11:42:54 yyamano Exp   -->
+<!-- NetBSD: ftp-layout.xml,v 1.8 2007/07/25 17:53:44 rillig Exp   -->
 
 <appendix id="ftp-layout">
 <title>pkgsrc FTP サーバーのディレクトリー配置</title>
@@ -47,23 +47,33 @@
 
 </sect1>
 <sect1 id="ftp-packages">
-<title><filename>packages*</filename>: バイナリーパッケージ</title>
+<title><filename>packages</filename>: バイナリーパッケージ</title>
 
-	<para>この各ディレクトリーはバイナリーパッケージを含んでいます。
-	枝名
-	(200<replaceable>x</replaceable>Q<replaceable>y</replaceable>)
-	のついたディレクトリーは、その枝から作られたパッケージを含んでいます。
-	<filename>packages</filename> ディレクトリーは、pkgsrc-current
-	から作られたパッケージを含んでいます。 (ただし、
-	これらのパッケージは必ずしも最新のものではありません。)</para>
-
-	<para><filename>packages*</filename> 直下には、
-	パッケージを分類するために、
-	オペレーティングシステムとそのバージョン別のディレクトリーがあり、
-	さらにその下に、ハードウェアアーキテクチャー別のディレクトリーがあります。</para>
+	<para>このディレクトリーは、
+	pkgsrc が対応している各種プラットフォーム用のバイナリーパッケージを含んでいます。
+	各プラットフォーム用のサブディレクトリーは <replaceable>OPSYS</replaceable
+	>/<replaceable>ARCH</replaceable
+	>/<replaceable>OSVERSION_TAG</replaceable
+	> のような形式になっています。これらの意味は以下のとおりです。</para>
+
+	<itemizedlist>
+	<listitem><para><varname>OPSYS</varname> は、当該パッケージが構築された対象のオペレーティングシステム名</para></listitem>
+	<listitem><para><varname>ARCH</varname> は、ハードウェアアーキテクチャー</para></listitem>
+	<listitem><para><varname>OSVERSION</varname> は、オペレーティングシステムのバージョン</para></listitem>
+	<listitem><para><varname>TAG</varname> は、安定版の枝の場合は <literal>200<replaceable>x</replaceable>Q<replaceable>y</replaceable></literal>、HEAD の場合は <literal>head</literal></para></listitem>
+	</itemizedlist>
+
+	<para>このような方式となっている理由は、pkgsrc の利用者がバイナリーパッケージを探すときに、
+	サーバー上のディレクトリーを辿って、
+	自分のマシンに最適なバイナリーパッケージを簡単に見つけられるからです。
+	利用者はたいてい、オペレーティングシステムとハードウェアアーキテクチャーを知っているので、
+	OPSYS と ARCH を最初にしています。これらを選べば、
+	OSVERSION と TAG の最適な組合せを選ぶことができます。
+	通常の場合、オペレーティングシステムのバージョンが違っても、
+	パッケージには互換性があるからです。</para>
 
-	<para>各プラットフォーム用のディレクトリーには、
-	バイナリーパッケージ全体が置かれています。
+	<para>これらの各ディレクトリーには、
+	当該プラットフォーム用のバイナリーパッケージ全体が置かれています。
 	<filename>All</filename> というディレクトリーがあり、
 	ここにすべてのバイナリーパッケージを含んでいます。
 	このほか、カテゴリー別のディレクトリーがあり、
Index: ftp-layout.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/ftp-layout.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- ftp-layout.xml	23 Nov 2006 11:42:54 -0000	1.7
+++ ftp-layout.xml	25 Jul 2007 17:53:44 -0000	1.8
@@ -1,4 +1,4 @@
-<!-- $NetBSD: ftp-layout.xml,v 1.7 2006/11/23 11:42:54 yyamano Exp $ -->
+<!-- $NetBSD: ftp-layout.xml,v 1.8 2007/07/25 17:53:44 rillig Exp $ -->
 
 <appendix id="ftp-layout">
 <title>Directory layout of the pkgsrc FTP server</title>
@@ -46,23 +46,33 @@
 
 </sect1>
 <sect1 id="ftp-packages">
-<title><filename>packages*</filename>: Binary packages</title>
+<title><filename>packages</filename>: Binary packages</title>
 
-	<para>These directories contain binary packages. Those
-	directories that have a branch name
-	(200<replaceable>x</replaceable>Q<replaceable>y</replaceable>)
-	contain packages from that particular branch. The directory
-	<filename>packages</filename> contains binary packages from
-	pkgsrc-current. (However, this does not necessarily mean that
-	the packages are still current anymore.)</para>
-
-	<para>Below the <filename>packages*</filename> directories are
-	directories that distinguish the packages by operating system
-	and version, the next directory level specifies the hardware
-	architecture.</para>
+	<para>This directory contains binary packages for the various
+	platforms that are supported by pkgsrc.
+	Each subdirectory is of the form <replaceable>OPSYS</replaceable
+	>/<replaceable>ARCH</replaceable
+	>/<replaceable>OSVERSION_TAG</replaceable
+	>. The meaning of these variables is:</para>
+
+	<itemizedlist>
+	<listitem><para><varname>OPSYS</varname> is the name of the operating system for which the packages have been built,</para></listitem>
+	<listitem><para><varname>ARCH</varname> is the hardware architecture,</para></listitem>
+	<listitem><para><varname>OSVERSION</varname> is the version of the operating system,</para></listitem>
+	<listitem><para><varname>TAG</varname> is either <literal>200<replaceable>x</replaceable>Q<replaceable>y</replaceable></literal> for a stable branch, or <literal>head</literal> for packages built from the HEAD branch.</para></listitem>
+	</itemizedlist>
+
+	<para>The rationale for exactly this scheme is that the pkgsrc users looking for binary packages
+	can quickly click through the directories on the
+	server and find the best binary packages for their machines. Since they
+	usually know the operating system and the hardware architecture, OPSYS
+	and ARCH are placed first. After these choices, they can select the
+	best combination of OSVERSION and TAG together, since it is usually the
+	case that packages stay compatible between different version of the
+	operating system.</para>
 
-	<para>In each of the platform-specific directories, there is a
-	whole binary packages collection. It has a directory called
+	<para>In each of these directories, there is a
+	whole binary packages collection for a specific platform. It has a directory called
 	<filename>All</filename> which contains all binary packages.
 	Besides that, there are various category directories that
 	contain symbolic links to the real binary packages.</para>