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

pkgsrc/doc/guide/files/using.xml: 1.20 -> 1.21



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

pkgsrc/doc/guide/files/using.xml: 1.20 -> 1.21

> revision 1.21
> date: 2006/07/29 14:14:23;  author: rillig;  state: Exp;  lines: +52 -8
> Integrated the useful information from the NetBSD guide, chap-pack.xml,
> where the pkgsrc guide did not mention things before. Discarded the rest.

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

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

--- using.xml.orig	2006-12-08 23:25:17.000000000 +0900
+++ using.xml	2006-12-08 23:25:17.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: using.xml,v 1.20 2006/07/23 15:34:10 rillig Exp $ -->
+<!-- $NetBSD: using.xml,v 1.21 2006/07/29 14:14:23 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: using.xml,v 1.20 2006/07/23 15:34:10 rillig Exp   -->
+<!-- NetBSD: using.xml,v 1.21 2006/07/29 14:14:23 rillig Exp   -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
 <title>pkgsrc を使う</title>
@@ -93,7 +93,7 @@
         事もできます。
         </para>
 
-      <screen><prompt>#</prompt> <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/All/package.tgz</userinput></screen>
+      <screen><prompt>#</prompt> <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/All/package</userinput></screen>
 
       <para>パッケージを実行するためにあらかじめ必要な他のパッケージがインストー
         ルされるかもしれない事にも注意してください。一緒にインストールされる他のパッ
@@ -125,6 +125,50 @@
         ができます。 </para>
     </sect2>
 
+<sect2 id="using.pkg_delete">
+<title>パッケージをアンインストールする</title>
+
+	<para>パッケージをアンインストールする方法は、そのパッケージを、
+	ソースコードからインストールしたかバイナリーパッケージからインストールしたかにかかわらず同じです。
+	どちらの方法でインストールされたかは、<command>pkg_delete</command> コマンドは一切関知しません。
+	パッケージの削除は、<command>pkg_delete
+	<replaceable>package-name</replaceable></command> を実行するだけでおこなうことができます。
+	パッケージ名はバージョン番号をつけてもつけなくてもかまいません。
+	一連のパッケージをアンインストールするために、
+	たとえば <literal>*emacs*</literal> のようにワイルドカードを使うこともできます。
+	この場合、ワイルドカードが
+	<literal>pkg_delete</literal> に渡る前にシェルに展開されないようにするため、
+	ワイルドカードはかならずクォートするようにします。</para>
+
+	<para><option>-r</option> オプションは非常に強力です。これを使うと、
+	指定したパッケージに依存しているパッケージをすべて削除してから、
+	指定したパッケージそのものを削除します。たとえば、
+
+<screen>
+    &rprompt; <userinput>pkg_delete -r jpeg</userinput>
+</screen>
+
+	は、jpeg および jpeg を使うすべてのパッケージを削除します。これにより、
+	jpeg パッケージをアップグレードすることが可能になります。</para>
+
+</sect2>
+
+<sect2 id="using.pkg_info">
+<title>インストールされているパッケージの情報を得る</title>
+
+	<para><command>pkg_info</command> は、インストールされているパッケージや、
+	バイナリーパッケージのファイルに関する情報を表示します。</para>
+
+</sect2>
+
+<sect2 id="using.pkg_admin">
+<title>その他の管理用機能</title>
+
+	<para><command>pkg_admin</command> は、パッケージシステムにおける、
+	各種の管理用機能を実行します。</para>
+
+</sect2>
+
     <sect2 id="a-word-of-warning">
       <title>警告</title>
 
@@ -151,10 +195,12 @@
     <sect2 id="requirements">
       <title>必要なもの</title>
 
-      <para> NetBSD システム上で、ソースからパッケージを構築するためには、
-        <quote>comp</quote>および<quote>text</quote>
-        配布物一式をインストールしておく必要があります。X11関連のパッケージを
-        構築する場合は、さらに<quote>xbase</quote>および<quote>xcomp</quote> 配布物一式も必要です。</para>
+      <para>ソースからパッケージを構築するためには、機能する C
+      コンパイラーが必要です。NetBSD の場合は、
+      <quote>comp</quote> および <quote>text</quote>
+      配布物一式をインストールしておく必要があります。X11関連のパッケージを
+      構築する場合は、さらに<quote>xbase</quote>および<quote>xcomp</quote>
+      配布物一式も必要です。</para>
       <!-- FIXME: what about installing x11/XFree86-*? -->
     </sect2>
 
Index: using.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/using.xml,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- using.xml	23 Jul 2006 15:34:10 -0000	1.20
+++ using.xml	29 Jul 2006 14:14:23 -0000	1.21
@@ -1,4 +1,4 @@
-<!-- $NetBSD: using.xml,v 1.20 2006/07/23 15:34:10 rillig Exp $ -->
+<!-- $NetBSD: using.xml,v 1.21 2006/07/29 14:14:23 rillig Exp $ -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
 <title>Using pkgsrc</title>
@@ -30,7 +30,7 @@
 	</tgroup>
 	</informaltable>
 
-	<para>These prebuilt package tools use
+	<para>These pre-built package tools use
 	<filename>/usr/pkg</filename> for the base directory, and
 	<filename>/var/db/pkg</filename> for the database of installed
 	packages. If you cannot use these directories for whatever
@@ -85,7 +85,7 @@
         automatically by giving <command>pkg_add</command> an FTP URL:
         </para>
 
-      <screen><prompt>#</prompt> <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/All/package.tgz</userinput></screen>
+      <screen><prompt>#</prompt> <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/All/package</userinput></screen>
 
       <para>Note that any prerequisite packages needed to run the
         package in question will be installed, too, assuming they are
@@ -116,6 +116,49 @@
         installed program. </para>
     </sect2>
 
+<sect2 id="using.pkg_delete">
+<title>Deinstalling packages</title>
+
+	<para>To deinstall a package, it does not matter whether it was
+	installed from source code or from a binary package. The
+	<command>pkg_delete</command> command does not know it anyway.
+	To delete a package, you can just run <command>pkg_delete
+	<replaceable>package-name</replaceable></command>. The package
+	name can be given with or without version number. Wildcards can
+	also be used to deinstall a set of packages, for example
+	<literal>*emacs*</literal>. Be sure to include them in quotes,
+	so that the shell does not expand them before
+	<literal>pkg_delete</literal> sees them.</para>
+
+	<para>The <option>-r</option> option is very powerful: it
+	removes all the packages that require the package in question
+	and then removes the package itself. For example:
+
+<screen>
+    &rprompt; <userinput>pkg_delete -r jpeg</userinput>
+</screen>
+
+	will remove jpeg and all the packages that used it; this allows
+	upgrading the jpeg package.</para>
+
+</sect2>
+
+<sect2 id="using.pkg_info">
+<title>Getting information about installed packages</title>
+
+	<para>The <command>pkg_info</command> shows information about
+	installed packages or binary package files.</para>
+
+</sect2>
+
+<sect2 id="using.pkg_admin">
+<title>Other administrative functions</title>
+
+	<para>The <command>pkg_admin</command> executes various
+	administrative functions on the package system.</para>
+
+</sect2>
+
     <sect2 id="a-word-of-warning">
       <title>A word of warning</title>
 
@@ -145,11 +188,12 @@
     <sect2 id="requirements">
       <title>Requirements</title>
 
-      <para> To build packages from source on a NetBSD system the
-        <quote>comp</quote> and the <quote>text</quote> distribution
-        sets must be installed. If you want to build X11-related
-        packages the <quote>xbase</quote> and <quote>xcomp</quote>
-        distribution sets are required, too.</para>
+      <para>To build packages from source, you need a working C
+      compiler. On NetBSD, you need to install the
+      <quote>comp</quote> and the <quote>text</quote> distribution
+      sets. If you want to build X11-related packages, the
+      <quote>xbase</quote> and <quote>xcomp</quote> distribution
+      sets are required, too.</para>
       <!-- FIXME: what about installing x11/XFree86-*? -->
     </sect2>