Changes between Version 31 and Version 32 of RpmHowToPackagers

Timestamp:

Feb 13, 2015, 6:51:18 PM (9 years ago)

Author:

dmik

Comment:

--

RpmHowToPackagers

@@ -165 +165 @@
 All output files will be written in the %HOME%\rpmbuild tree, regardless of current directory and drive.
 
+== Handling documentation in Info format ==
+
+Many packages provide extended documentation in Info format (`.info` files in `/@unixroot/usr/share/info`). These `.info` files need special processing when the package is installed (and removed) so that the Info reader could properly find them. Many `.spec` files already contain the required commands but they need tailoring to OS/2. This tailoring is rather easy and consists of 3 steps.
+
+1. Fix the `Requires:` statements. You will usually find this in a `.spec` file:
+{{{
+#Requires(post): /sbin/install-info
+#Requires(preun): /sbin/install-info
+}}}
+ Replace this block with these lines:
+{{{
+# @todo Replace with `%info_requires` when it's available. 
+Requires(post): %{_sbindir}/install-info.exe 
+Requires(preun): %{_sbindir}/install-info.exe 
+}}}
+
+2. Fix the post-install script. Replace lines looking like this:
+{{{
+%post
+/sbin/install-info %{_infodir}/foobar.info %{_infodir}/dir 2>/dev/null || :
+}}}
+ with this:
+{{{
+%post 
+# @todo Replace with `%info_post foobar.info` when it's available. 
+if [ -f %{_infodir}/foobar.info ]; then 
+    %{_sbindir}/install-info.exe %{_infodir}/foobar.info %{_infodir}/dir || : 
+fi
+}}}
+
+3. Fix the pre-uninstall script. Replace lines looking like this:
+{{{
+%preun 
+if [ $1 -eq 0 ]; then 
+  /sbin/install-info --delete %{_infodir}/help2man.info \ 
+    %{_infodir}/dir 2>/dev/null || : 
+fi
+}}}
+ with this:
+{{{
+%preun 
+# @todo Replace with `%info_preun foobar.info` when it's available. 
+if [ $1 -eq 0 ]; then 
+    if [ -f %{_infodir}/foobar.info ]; then 
+        %{_sbindir}/install-info.exe --delete %{_infodir}/foobar.info %{_infodir}/dir || : 
+    fi 
+fi
+}}}
+
+Note that the lines you insert contain a `@todo` block which you should leave in. It is to remind to replace these lines with simpler constructs when #119 is fixed.
+
 == OS/2 specific notes ==
 While the syntax of .spec files is the same used under Unix, not everything is currently working in the OS/2 port. Also many packages are already built and manually installed: this means RPM is not aware of their presence.