[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/pkginstall.xml: 1.7 -> 1.8

Subject: pkgsrc/doc/guide/files/pkginstall.xml: 1.7 -> 1.8
From: kano@na.rim.or.jp (OKANO Takayoshi)
To: www-changes-ja@jp.NetBSD.org
Date: Wed, 25 Oct 2006 00:14:06 +0900 (JST)
Message-Id: <200610241514.AAA41726@shell.rim.or.jp>
Delivered-To: mailing list www-changes-ja@jp.netbsd.org
Mailing-List: contact www-changes-ja-help@jp.netbsd.org; run by ezmlm-idx
以下のページの更新をしました。ツッコミをお願いします。

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

> revision 1.8
> date: 2005/12/29 14:59:03;  author: jlam;  state: Exp;  lines: +45 -9
> Update the pkgsrc guide to reflect the following changes to the pkginstall
> framework:
> 
>    * USE_PKGINSTALL is no longer needed.
> 
>    * X11 font directories should be listed in FONTS_DIRS.<type>
> 
>    * fonts.mk is no longer needed as the functionality has been completely
>      reimplemented within the pkginstall framework.
> 
>    * PKG_UPDATE_FONTS_DB may be set to "yes" or "no" to indicate whether
>      the fonts databases should be updated or not.  This defaults to "yes".

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

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

--- pkginstall.xml.orig	2006-10-25 00:12:30.000000000 +0900
+++ pkginstall.xml	2006-10-25 00:12:30.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: pkginstall.xml,v 1.7 2005/10/23 11:25:58 rillig Exp $ -->
+<!-- $NetBSD: pkginstall.xml,v 1.8 2005/12/29 14:59:03 jlam Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: pkginstall.xml,v 1.7 2005/10/23 11:25:58 rillig Exp   -->
+<!-- NetBSD: pkginstall.xml,v 1.8 2005/12/29 14:59:03 jlam Exp   -->
 
 <chapter id="pkginstall"> <?dbhtml filename="pkginstall.html"?>
 <title>pkginstall の枠組</title>
@@ -32,15 +32,13 @@
     <para>システムシェルの登録。</para>
   </listitem>
 
-</itemizedlist>
+  <listitem>
+    <para>フォントデータベースの自動更新。</para>
+  </listitem>
 
-<para>以下の各節では、上述の各機能について詳しく見てゆきます。
-なお、ここで説明する各機能を使うためには、パッケージの
-<filename>Makefile</filename> に以下の内容を書く必要があります。</para>
+</itemizedlist>
 
-<programlisting>
-    USE_PKGINSTALL= YES
-</programlisting>
+<para>以下の各節では、上述の各機能について詳しく見てゆきます。</para>
 
 <para>本章で説明する機能の多くは、パッケージのインストール後のターゲット
 (<literal>post-install</literal>) を使うだけで簡単に実現できるのではないか、
@@ -480,7 +478,6 @@
 <filename role="pkg">shells/zsh</filename> から抜粋した例を以下に掲げますので、ご覧ください。</para>
 
 <programlisting>
-    USE_PKGINSTALL= YES
     PKG_SHELL=      ${PREFIX}/bin/zsh
 </programlisting>
 
@@ -499,4 +496,44 @@
 
 </sect1>
 
+<!-- ================================================================== -->
+
+<sect1 id="fonts">
+<title>フォント</title>
+
+<para>X11 フォントをインストールするパッケージでは、
+各フォントディレクトリー内のフォントの索引であるデータベースファイルを更新することが必要になります。
+この更新は、pkginstall の枠組内で簡単におこなうことができます。</para>
+
+<para>パッケージが X11 フォントををインストールする時には、
+フォントをインストールするディレクトリーを、
+<varname>FONTS_DIRS.<replaceable>type</replaceable></varname>
+変数に列挙する必要があります。この <replaceable>type</replaceable>
+は、<quote>ttf</quote>,
+<quote>type1</quote>, <quote>x11</quote> のいずれかです。
+こうすると、指定した各ディレクトリーのフォントデータベースファイルを更新するコマンドを実行するフックが、
+インストール用スクリプトに追加されます。
+利便のため、このディレクトリーのパスが相対パスで指定した場合は、
+パッケージのインストール用プレフィックスからの相対位置として扱われるようになっています。<filename
+role="pkg">fonts/dbz-ttf</filename> から抜粋した例を以下に掲げますので、ご覧ください。</para>
+
+<programlisting>
+    FONTS_DIRS.ttf= ${PREFIX}/lib/X11/fonts/TTF
+</programlisting>
+
+<!-- ================================================================== -->
+
+<sect2 id="fonts-disable">
+<title>フォントデータベースの自動更新をしないようにする</title>
+
+<!-- XXX This doesn't really belong here -->
+
+<para>フォントデータベースの自動更新は、管理者が
+<filename>PKG_UPDATE_FONTS_DB</filename> 環境変数を <literal>NO</literal>
+に設定すれば、無効化することができます。</para>
+
+</sect2>
+
+</sect1>
+
 </chapter>
Index: pkginstall.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/pkginstall.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- pkginstall.xml	23 Oct 2005 11:25:58 -0000	1.7
+++ pkginstall.xml	29 Dec 2005 14:59:03 -0000	1.8
@@ -1,4 +1,4 @@
-<!-- $NetBSD: pkginstall.xml,v 1.7 2005/10/23 11:25:58 rillig Exp $ -->
+<!-- $NetBSD: pkginstall.xml,v 1.8 2005/12/29 14:59:03 jlam Exp $ -->
 
 <chapter id="pkginstall"> <?dbhtml filename="pkginstall.html"?>
 <title>The pkginstall framework</title>
@@ -30,15 +30,13 @@
     <para>Registration of system shells.</para>
   </listitem>
 
-</itemizedlist>
+  <listitem>
+    <para>Automatic updating of fonts databases.</para>
+  </listitem>
 
-<para>The following sections inspect each of the above points in detail.
-Note that in order to use any of the described functionalities, you must
-add the following to your package's <filename>Makefile</filename>:</para>
+</itemizedlist>
 
-<programlisting>
-    USE_PKGINSTALL= YES
-</programlisting>
+<para>The following sections inspect each of the above points in detail.</para>
 
 <para>You may be thinking that many of the things described here could be
 easily done with simple code in the package's post-installation target
@@ -475,7 +473,6 @@
 following example, taken from <filename role="pkg">shells/zsh</filename>:</para>
 
 <programlisting>
-    USE_PKGINSTALL= YES
     PKG_SHELL=      ${PREFIX}/bin/zsh
 </programlisting>
 
@@ -494,4 +491,43 @@
 
 </sect1>
 
+<!-- ================================================================== -->
+
+<sect1 id="fonts">
+<title>Fonts</title>
+
+<para>Packages that install X11 fonts should update the database files
+that index the fonts within each fonts directory.  This can easily be
+accomplished within the pkginstall framework.</para>
+
+<para>When a package installs X11 fonts, it must list the directories in
+which fonts are installed in the
+<varname>FONTS_DIRS.<replaceable>type</replaceable></varname> variables,
+where <replaceable>type</replaceable> can be one of <quote>ttf</quote>,
+<quote>type1</quote> or <quote>x11</quote>.  This will add hooks to the
+installation scripts to run the appropriate commands to update the fonts
+database files within each of those directories.  For convenience, if the
+directory path is relative, it is taken to be relative to the package's
+installation prefix.  Consider the following example, taken from <filename
+role="pkg">fonts/dbz-ttf</filename>:</para>
+
+<programlisting>
+    FONTS_DIRS.ttf= ${PREFIX}/lib/X11/fonts/TTF
+</programlisting>
+
+<!-- ================================================================== -->
+
+<sect2 id="fonts-disable">
+<title>Disabling automatic update of the fonts databases</title>
+
+<!-- XXX This doesn't really belong here -->
+
+<para>The automatic update of fonts databases can be disabled by
+the administrator by setting the <filename>PKG_UPDATE_FONTS_DB</filename>
+environment variable to <literal>NO</literal>.</para>
+
+</sect2>
+
+</sect1>
+
 </chapter>
Prev by Date: CVS commit: htdocs
Next by Date: pkgsrc/doc/guide/files/fixes.xml: 1.43 -> 1.44
Prev by thread: pkgsrc/doc/guide/files/devfaq.xml: 1.5 -> 1.6
Next by thread: pkgsrc/doc/guide/files/fixes.xml: 1.43 -> 1.44
Index(es):
- Date
- Thread