[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>