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

pkgsrc/doc/guide/files/fixes.xml: 1.68 -> 1.70



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

pkgsrc/doc/guide/files/fixes.xml: 1.68 -> 1.70

> revision 1.70
> date: 2006/09/03 10:54:55;  author: jmmv;  state: Exp;  lines: +2 -3
> Remove part of a sentence that does not make sense from the new "hicolor theme"
> section.  Found by wiz@.
> ----------------------------
> revision 1.69
> date: 2006/09/01 16:35:38;  author: jmmv;  state: Exp;  lines: +60 -12
> Add some more GNOME-specific packaging and porting information:
> - Document how to handle .desktop files.
> - Document how to handle icons for the hicolor theme.
> - Add a chapter detailing the GNOME meta packages, the packaging of new
>   applications and the updatee procedure.
> 
> Also add some documentation on how to better handle and create patches.

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

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

--- fixes.xml.orig	2006-12-14 00:54:17.000000000 +0900
+++ fixes.xml	2006-12-14 00:54:17.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: fixes.xml,v 1.68 2006/08/12 21:29:40 wiz Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.70 2006/09/03 10:54:55 jmmv Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: fixes.xml,v 1.68 2006/08/12 21:29:40 wiz Exp   -->
+<!-- NetBSD: fixes.xml,v 1.70 2006/09/03 10:54:55 jmmv Exp   -->
 
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
   <title>パッケージを動くようにする</title>
@@ -1582,19 +1582,66 @@
       </orderedlist>
     </sect2>
 
-  </sect1>
 
+    <sect2 id="hicolor-theme">
+      <title>ハイカラーテーマのアイコンをインストールするパッケージ</title>
+
+      <para>パッケージが、
+      <filename>share/icons/hicolor</filename> 以下に画像をインストールするか
+      <filename>share/icons/hicolor/icon-theme.cache</filename> データベースを更新するかあるいはその両方をおこなう場合は、
+      テーマ用の共有ディレクトリーを適切に扱い、キャッシュデータベースを確実に再構築するために、
+      以下の手順を踏む必要があります。</para>
+
+      <orderedlist>
+        <listitem>
+	  <para><filename>../../graphics/hicolor-icon-theme/buildlink3.mk</filename>
+	  をインクルードします。</para>
+        </listitem>
+
+        <listitem>
+          <para>PLIST を確認し、
+	  テーマのキャッシュを参照するエントリーを削除します。</para>
+        </listitem>
 
-  <sect1 id="feedback-to-author">
-    <title>作者へのフィードバック</title>
+        <listitem>
+	  <para>PLIST が <filename>share/icons/hicolor</filename>
+	  階層からアイコン用の共有ディレクトリーを削除しないようにします。
+	  これは自動的に処理されるものだからです。</para>
+        </listitem>
+      </orderedlist>
+
+      <para>後の 2 点について、
+      PLIST がこれらを守っていることを確認する最良の方法は、
+      <command>make print-PLIST</command> を使って作り直すことです。</para>
+    </sect2>
 
-    <para>もしパッケージの不具合を発見し動作するように修正した場合、NetBSD上で動作さ
-      せるために特別な手順が必要だった場合、あるいはさまざまなソフトウェアの拡張
-      をおこなった場合、これらの修正をプログラムのオリジナルの作者へ報告してくだ
-      さい。このようなサポートによって、プログラムの次のリリースにそれらの修正を
-      反映することができます。そして、NetBSDパッケージシステムを使用していない人々
-      も、あなたの努力のおかげで幸せになれます。</para>
 
-    <para>フリーソフトウェアの理念をサポートして下さい。</para>
+    <sect2 id="desktop-files">
+      <title>デスクトップファイルをインストールするパッケージ</title>
+
+      <para>パッケージが、<filename>.desktop</filename> ファイルを
+      <filename>share/applications</filename> 以下にインストールし、そのファイルに
+      MIME 情報が含まれている場合は、それらが MIME データベースに確実に登録されるようにするために、
+      以下の手順を踏む必要があります。</para>
+
+      <orderedlist>
+        <listitem>
+	  <para><filename>../../sysutils/desktop-file-utils/desktopdb.mk</filename>
+	  をインクルードします。</para>
+        </listitem>
+
+        <listitem>
+          <para>PLIST を確認し、
+	  <filename>share/applications/mimeinfo.cache</filename> ファイルを参照するエントリーを削除します。
+	  これは自動的に処理されるものだからです。</para>
+        </listitem>
+      </orderedlist>
+
+      <para>最後の点について、
+      PLIST がこれらを守っていることを確認する最良の方法は、<command>make
+      print-PLIST</command> を使って作り直すことです。</para>
+    </sect2>
+
   </sect1>
+
 </chapter>
Index: fixes.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/fixes.xml,v
retrieving revision 1.68
retrieving revision 1.70
diff -u -r1.68 -r1.70
--- fixes.xml	12 Aug 2006 21:29:40 -0000	1.68
+++ fixes.xml	3 Sep 2006 10:54:55 -0000	1.70
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.68 2006/08/12 21:29:40 wiz Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.70 2006/09/03 10:54:55 jmmv Exp $ -->
 
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
   <title>Making your package work</title>
@@ -1639,20 +1639,67 @@
       </orderedlist>
     </sect2>
 
-  </sect1>
 
+    <sect2 id="hicolor-theme">
+      <title>Packages installing hicolor theme icons</title>
+
+      <para>If a package installs images under the
+      <filename>share/icons/hicolor</filename> and/or updates the
+      <filename>share/icons/hicolor/icon-theme.cache</filename> database,
+      you need to take some extra steps to make sure that the shared
+      theme directory is handled appropriately and that the cache
+      database is rebuilt:</para>
+
+      <orderedlist>
+        <listitem>
+	  <para>Include
+	  <filename>../../graphics/hicolor-icon-theme/buildlink3.mk</filename>.</para>
+        </listitem>
+
+        <listitem>
+          <para>Check the PLIST and remove the entry that refers to the
+	  theme cache.</para>
+        </listitem>
 
-  <sect1 id="feedback-to-author">
-    <title>Feedback to the author</title>
+        <listitem>
+	  <para>Ensure that the PLIST does not remove the shared icon
+	  directories from the <filename>share/icons/hicolor</filename>
+	  hierarchy because they will be handled automatically.</para>
+        </listitem>
+      </orderedlist>
+
+      <para>The best way to verify that the PLIST is correct with
+      respect to the last two points is to regenerate it using
+      <command>make print-PLIST</command>.</para>
+    </sect2>
 
-    <para>If you have found any bugs in the package you make available,
-      if you had to do special steps to make it run under NetBSD or
-      if you enhanced the software in various other ways, be sure
-      to report these changes back to the original author of the
-      program! With that kind of support, the next release of the
-      program can incorporate these fixes, and people not using the
-      NetBSD packages system can win from your efforts.</para>
 
-    <para>Support the idea of free software!</para>
+    <sect2 id="desktop-files">
+      <title>Packages installing desktop files</title>
+
+      <para>If a package installs <filename>.desktop</filename> files
+      under <filename>share/applications</filename> and these include
+      MIME information, you need to take extra steps to ensure that they
+      are registered into the MIME database:</para>
+
+      <orderedlist>
+        <listitem>
+	  <para>Include
+	  <filename>../../sysutils/desktop-file-utils/desktopdb.mk</filename>.</para>
+        </listitem>
+
+        <listitem>
+          <para>Check the PLIST and remove the entry that refers to the
+	  <filename>share/applications/mimeinfo.cache</filename> file.
+	  It will be handled automatically.</para>
+        </listitem>
+      </orderedlist>
+
+      <para>The best way to verify that the PLIST is correct with
+      respect to the last point is to regenerate it using <command>make
+      print-PLIST</command>.</para>
+    </sect2>
+
   </sect1>
+
 </chapter>