OSDN Git Service

[lfsja-git] r11.1-84 対応。
authormatsuand <30614168+matsuand@users.noreply.github.com>
Tue, 19 Apr 2022 04:52:59 +0000 (13:52 +0900)
committermatsuand <30614168+matsuand@users.noreply.github.com>
Tue, 19 Apr 2022 04:52:59 +0000 (13:52 +0900)
16 files changed:
configure
src/appendices/dependencies.ch
src/chapter01/changelog.ch
src/chapter01/jchangelog.ch
src/chapter03/packages.ch
src/chapter08/Makefile.am
src/chapter08/Makefile.in
src/chapter08/jinja2.ch
src/chapter08/markupsafe.ch
src/chapter08/meson.ch
src/chapter08/python.ch
src/chapter08/wheel.ch [new file with mode: 0644]
src/general.ch
src/packages.ch
src/prologue/why.ch
version.ac

index 3c4e756..c792605 100755 (executable)
--- a/configure
+++ b/configure
@@ -4737,7 +4737,7 @@ fi
 
 
 
-TARGETVER=r11.1-76
+TARGETVER=r11.1-84
 if test "x$revspec" = "xsystemd"; then
   TARGETVER="$TARGETVER-systemd"
 fi
index 0642dae..1b57eb3 100644 (file)
 @z
 
 %----------------------------------------------------------------------
+@x Wheel
+          <seg>Python</seg>
+@y
+          <seg>Python</seg>
+@z
+@x
+          <seg>Python</seg>
+@y
+          <seg>Python</seg>
+@z
+@x
+          <seg>No test suite available</seg>
+@y
+          <seg>テストスイートはありません</seg>
+@z
+@x
+          <seg>Jinja2</seg>
+@y
+          <seg>Jinja2</seg>
+@z
+@x
+          <seg>None</seg>
+@y
+          <seg>なし</seg>
+@z
+
+%----------------------------------------------------------------------
 @x XML Parser
           <seg>Bash, Binutils, Coreutils, Expat, GCC, Glibc, Make, and
           Perl</seg>
index bc45661..e92cddf 100644 (file)
       <para>2022-04-15</para>
       <itemizedlist>
         <listitem>
+           <para>[bdubbs] - Add wheel-0.37.1 (Python module).</para>
+        </listitem>
+      </itemizedlist>
+@y
+      <para>2022-04-15</para>
+      <itemizedlist>
+        <listitem>
+           <para>[bdubbs] - wheel-0.37.1 (Python モジュール) 追加。</para>
+        </listitem>
+      </itemizedlist>
+@z
+
+@x
+      <para>2022-04-15</para>
+      <itemizedlist>
+        <listitem>
           <para>[ken] - Patch Xz for a security fix.  Fixes
           <ulink url="&lfs-ticket-root;5047">#5047</ulink>.</para>
         </listitem>
index 28a611e..e37c408 100644 (file)
 
 -->
    <listitem>
+      <para>2022-04-19</para>
+      <itemizedlist>
+        <listitem>
+          <para>[matsuand] -
+          r11.1-84 (<ulink url="&lfs-changeset;18e99c88b">18e99c88b</ulink>) までの対応。
+          </para>
+        </listitem>
+      </itemizedlist>
+   </listitem>
+
+   <listitem>
       <para>2022-04-16</para>
       <itemizedlist>
         <listitem>
index e109981..67393bf 100644 (file)
             https://github.com/vim/vim/tags</ulink> にアクセスしてください。
 @z
 
+@x Wheel
+        <para>Home page: <ulink url="&wheel-home;"/></para>
+        <para>Download: <ulink url="&wheel-url;"/></para>
+@y
+        <para>&Homepage;: <ulink url="&wheel-home;"/></para>
+        <para>&Download;: <ulink url="&wheel-url;"/></para>
+@z
+
 @x XML::Parser
         <para>Home page: <ulink url="&xml-parser-home;"/></para>
         <para>Download: <ulink url="&xml-parser-url;"/></para>
index 1b4ac31..7f84edf 100644 (file)
@@ -82,6 +82,7 @@ CHANGE_FILES = \
        texinfo.ch        \
        util-linux.ch     \
        vim.ch            \
+       wheel.ch          \
        xml-parser.ch     \
        xz.ch             \
        zlib.ch           \
index 53314ac..8d99b88 100644 (file)
@@ -315,6 +315,7 @@ CHANGE_FILES = \
        texinfo.ch        \
        util-linux.ch     \
        vim.ch            \
+       wheel.ch          \
        xml-parser.ch     \
        xz.ch             \
        zlib.ch           \
index e534694..064125e 100644 (file)
 @z
 
 @x
+    <para>Build the package:</para>
+@y
+    <para>パッケージをビルドするために以下を実行します。</para>
+@z
+
+@x
     <para>Install the package:</para>
 @y
     <para>&InstallThePackage;</para>
 @z
 
 @x
-      <segtitle>Installed directories</segtitle>
+      <segtitle>Installed directory</segtitle>
 @y
       <segtitle>&InstalledDirectory;</segtitle>
 @z
 
 @x
-        <seg>/usr/lib/python&python-minor;/site-packages/Jinja2-&jinja2-version;-py&python-minor;.egg</seg>
+         <seg>
+            /usr/lib/python&python-minor;/site-packages/Jinja2-&jinja2-version;.dist-info
+         </seg>
 @y
-        <seg>/usr/lib/python&python-minor;/site-packages/Jinja2-&jinja2-version;-py&python-minor;.egg</seg>
+         <seg>
+            /usr/lib/python&python-minor;/site-packages/Jinja2-&jinja2-version;.dist-info
+         </seg>
 @z
index aec84ca..0a3d3dd 100644 (file)
 @z
 
 @x
-        <!-- Suffix "-linux-<arch>" is different from meson and jinja:
-             This package contains binary code (compiled from C), but meson
-             and jinja only contain Python code.  -->
-        <seg>/usr/lib/python&python-minor;/site-packages/MarkupSafe-&markupsafe-version;-py&python-minor;-linux-<replaceable>&lt;arch&gt;</replaceable>.egg</seg>
+        <seg>
+           /usr/lib/python&python-minor;/site-packages/MarkupSafe-&markupsafe-version;.dist-info
+        </seg>
 @y
-        <!-- Suffix "-linux-<arch>" is different from meson and jinja:
-             This package contains binary code (compiled from C), but meson
-             and jinja only contain Python code.  -->
-        <seg>/usr/lib/python&python-minor;/site-packages/MarkupSafe-&markupsafe-version;-py&python-minor;-linux-<replaceable>&lt;arch&gt;</replaceable>.egg</seg>
+        <seg>
+           /usr/lib/python&python-minor;/site-packages/MarkupSafe-&markupsafe-version;.dist-info
+        </seg>
 @z
index edfb818..9e7c70b 100644 (file)
     </para>
 @z
 
-% @x
-%     <para>At last, move Meson man pages to correct location:</para>
-% @y
-%     <para>
-%     最後に Meson の man ページを適切なディレクトリに移動します。
-%     </para>
-% @z
-
 @x
       <title>The meaning of the install parameters:</title>
 @y
       <title>&MeaningOfParameter1;install&MeaningOfParameter2;</title>
 @z
 
-@x --root=dest
-          <para>By default <command>python3 setup.py install</command>
-          installs various files (such as man pages) into Python Eggs.
-          With a specified root location, <command>setup.py</command> installs
-          these files into a standard hierarchy.  Then the hierarchy
-          can just be copied to the standard location.
-        </para>
+@x -w dist
+           <para>Put the created wheels into the
+           <filename class='directory'>dist</filename> directory.</para>
 @y
-          <para>
-          デフォルトにて <command>python3 setup.py install</command> は、Python Eggs に(man ページを含む)種々のファイルをインストールします。
-          インストールルートを指定すれば <command>setup.py</command> によって各種ファイルは、標準的な階層にインストールされます。
-          そこでこの階層を、標準的な階層としてコピーします。
-          </para>
+           <para>
+           生成された wheel を <filename
+           class='directory'>dist</filename> ディレクトリに配置します。
+           </para>
+@z
+
+@x --find-links dist
+           <para>Install wheels from the
+           <filename class='directory'>dist</filename> directory.</para>
+@y
+           <para>
+           <filename class='directory'>dist</filename> ディレクトリから wheel をインストールします。
+           </para>
 @z
 
 @x
 
 @x
         <seg>meson</seg>
-        <!-- We are using DESTDIR installation here, so the directory layout
-          is different than other Python modules in LFS
-          (Jinja2 & MarkupSafe). -->
-        <seg>/usr/lib/python&python-minor;/site-packages/meson-&meson-version;-py&python-minor;.egg-info and /usr/lib/python&python-minor;/site-packages/mesonbuild</seg>
+        <seg>
+           /usr/lib/python&python-minor;/site-packages/meson-&meson-version;.dist-info and 
+           /usr/lib/python&python-minor;/site-packages/mesonbuild
+        </seg>
 @y
         <seg>meson</seg>
-        <!-- We are using DESTDIR installation here, so the directory layout
-          is different than other Python modules in LFS
-          (Jinja2 & MarkupSafe). -->
-        <seg>/usr/lib/python&python-minor;/site-packages/meson-&meson-version;-py&python-minor;.egg-info, /usr/lib/python&python-minor;/site-packages/mesonbuild</seg>
+        <seg>
+           /usr/lib/python&python-minor;/site-packages/meson-&meson-version;.dist-info,
+           /usr/lib/python&python-minor;/site-packages/mesonbuild
+        </seg>
 @z
 
 @x
index 9296c98..3778eeb 100644 (file)
 @z
 
 @x
+    <para>In serveral places we use the <command>pip3</command> command to
+    install Python 3 programs and modules for all users as
+    <systemitem class='username'>root</systemitem>. This conflicts
+    with the Python developers recommendation to install packages into a
+    virtual environment or the home directory of a regular user (by running
+    <command>pip3</command> as this user). To this end, a multi-line warning
+    is written when using <command>pip3</command> as the
+    <systemitem class='username'>root</systemitem> user.  The main reason
+    of this recommendation is for avoiding a conflict with the system
+    package manager (<command>dpkg</command> for example), but LFS does not
+    have a system-wide package manager so this is not a problem.  If desired,
+    suppress this warning by running the following command:</para>
+@y
+    <para>
+    いくつかの場面において Python 3 プログラムやモジュールをインストールする際には、全ユーザー向けのインストールを行うために <systemitem
+    class='username'>root</systemitem> ユーザーになって <command>pip3</command> コマンドを用いています。
+    このことは Python 開発者が推奨している、仮想環境内にて一般ユーザーにより(そのユーザーが <command>pip3</command> を実行することで)パッケージビルドを行う方法とは相容れないものです。
+    これを行っているため、<systemitem
+    class='username'>root</systemitem> ユーザーとして <command>pip3</command> を用いると、警告メッセージが複数出力されます。
+    開発者がなぜその方法を推奨しているかというと、システムパッケージマネージャー(たとえば <command>dpkg</command>)などと衝突が発生するからです。
+    LFS ではシステムワイドなパッケージマネージャーを利用していないため、このことは問題となりません。
+    警告メッセージを省略したい場合は、以下のコマンドを実行します。
+    </para>
+@z
+
+@x
     <para>If desired, install the preformatted documentation:</para>
 @y
     <para>
diff --git a/src/chapter08/wheel.ch b/src/chapter08/wheel.ch
new file mode 100644 (file)
index 0000000..7335aa0
--- /dev/null
@@ -0,0 +1,99 @@
+%
+% This is part of LFSbookja package.
+%
+% This is a CTIE change file for the original XML source of the LFSbook.
+%
+
+@x
+<?xml version="1.0" encoding="ISO-8859-1"?>
+@y
+<?xml version="1.0" encoding="UTF-8"?>
+@z
+
+@x
+    <para>Wheel is a Python library that is the reference
+    implementation of the Python wheel packaging standard.</para>
+@y
+    <para>
+    Wheel は Python wheel パッケージング標準に基づいた標準実装の Python ライブラリです。
+    </para>
+@z
+
+@x
+    <title>Installation of Wheel</title>
+@y
+    <title>&InstallationOf1;Wheel&InstallationOf2;</title>
+@z
+
+@x
+    <para>Install wheel with the following command:</para>
+@y
+    <para>以下のコマンドを実行して wheel をインストールします。</para>
+@z
+
+@x
+      <title>The meaning of the pip3 options:</title>
+@y
+      <title>&MeaningOfOption1;pip3&MeaningOfOption2;</title>
+@z
+
+@x install
+           <para>Install the package.</para>
+@y
+           <para>&InstallThePackage;</para>
+@z
+
+@x --no-index
+          <para>Prevent pip from fetching files from the online package
+          repository (PyPI). If packages are installed in the correct order,
+          then it won't need to fetch any files in the first place, but this
+          option adds some safety in case of user error.</para>
+@y
+          <para>
+          pip がオンラインパッケージリポジトリ(PyPI) からファイルを取得しないようにします。
+          パッケージ類が適切な順番でインストールされていれば、最初にファイルを取得しておく必要はないはずです。
+          ただしこのオプションをつけておくことで、ユーザーが操作を誤っても安全であるようにします。
+          </para>
+@z
+
+@x $PWD
+           <para>Look for files to install in the current working directory.</para>
+@y
+           <para>
+           インストールするファイルを現在のワーキングディレクトリ内から探し出します。
+           </para>
+@z
+
+@x
+    <title>Contents of Wheel</title>
+@y
+    <title>&ContentsOf1;Wheel&ContentsOf2;</title>
+@z
+
+@x
+      <segtitle>Installed program</segtitle>
+      <segtitle>Installed directory</segtitle>
+@y
+      <segtitle>&InstalledProgram;</segtitle>
+      <segtitle>&InstalledDirectory;</segtitle>
+@z
+
+@x
+        <seg>wheel</seg>
+        <seg>/usr/lib/python&python-minor;/site-packages/wheel</seg>
+@y
+        <seg>wheel</seg>
+        <seg>/usr/lib/python&python-minor;/site-packages/wheel</seg>
+@z
+
+@x
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+@y
+      <bridgehead renderas="sect3">&ShortDescriptions;</bridgehead>
+@z
+
+@x wheel
+            is an utility to unpack, pack, or convert wheel packages
+@y
+            wheel パッケージの解凍、圧縮、変換を行うユーティリティーです。
+@z
index 884567f..4324501 100644 (file)
@@ -47,9 +47,9 @@
 <!ENTITY copyrightdate   "%crdate;">
 ]]>
 
-<!ENTITY jversion        "20220416">
-<!ENTITY jversiond       "20220416">
-<!ENTITY jcorrespondSHA  "1d694184b"> <!-- lfs-git SHA 値; 本箇所での記載のみ -->
+<!ENTITY jversion        "20220419">
+<!ENTITY jversiond       "20220419">
+<!ENTITY jcorrespondSHA  "18e99c88b"> <!-- lfs-git SHA 値; 本箇所での記載のみ -->
 <!ENTITY dir-jversion    "git-ja">
 <!ENTITY dir-jversiond   "git-sysdja">
 @z
index 0200774..72ba907 100644 (file)
 @z
 
 @x
+<!ENTITY wheel-fin-sbu "less than 0.1 SBU">
+@y
+<!ENTITY wheel-fin-sbu "0.1 SBU 以下">
+@z
+
+@x
 <!ENTITY xml-parser-fin-sbu "less than 0.1 SBU">
 @y
 <!ENTITY xml-parser-fin-sbu "0.1 SBU 以下">
index bc2a48d..3a8adab 100644 (file)
         </para>
 @z
 
+@x Wheel
+        <para>This package contains a Python module that is the 
+        reference implementation of the Python wheel packaging standard.
+        </para>
+@y
+        <para>
+        このパッケージは Python wheel パッケージング標準に基づいた標準実装の Python モジュールを提供します。
+        </para>
+@z
+
 @x Vim
         <para>This package contains an editor. It was chosen because of its
         compatibility with the classic vi editor and its huge number of powerful
index d5bcc9d..8ede22c 100644 (file)
@@ -2,4 +2,4 @@ dnl
 dnl  This is part of LFSbookja package.
 dnl 
 dnl m4-include this file to define the current LFS version
-m4_define([lfs_version], [r11.1-76])
+m4_define([lfs_version], [r11.1-84])