From 0e2c5a9e0e11d03d37900c1ab2958c97831a4c95 Mon Sep 17 00:00:00 2001 From: P. J. McDermott Date: Tue, 02 Sep 2014 12:41:13 -0400 Subject: doc/pkg/basic-expat: Link to oh-* manual pages --- (limited to 'doc') diff --git a/doc/pkg/basic-expat.mdwn b/doc/pkg/basic-expat.mdwn index a3791c0..1ed902f 100644 --- a/doc/pkg/basic-expat.mdwn +++ b/doc/pkg/basic-expat.mdwn @@ -197,8 +197,9 @@ look like this: oh-autobuild touch $@ -Read the manual pages and/or source code of **oh-autoconfigure**(1) and -**oh-autobuild**(1) to learn more about what they do. +Read the manual pages and/or source code of +[[**oh-autoconfigure**(1)|dev/opkhelper/oh-autoconfigure.1]] and +[[**oh-autobuild**(1)|dev/opkhelper/oh-autobuild.1]] to learn more about what they do. The `touch $@` command is recommended by SPF 2.0: @@ -244,7 +245,8 @@ The `install` target is declared as depending on the `build` target: install: build -Read the manual page and/or source code of **oh-autoinstall**(1) to learn more +Read the manual page and/or source code of +[[**oh-autoinstall**(1)|dev/opkhelper/oh-autoinstall.1]] to learn more about what it does. Install Expat: @@ -382,7 +384,8 @@ since it documents the `xmlwf` utility. Binary Package Data Files ------------------------- -The **oh-installfiles**(1) utility of opkhelper, which we'll be using to install +The [[**oh-installfiles**(1)|dev/opkhelper/oh-installfiles.1]] utility of +opkhelper, which we'll be using to install files into *binary package data directories*, requires a `files` file for each binary package that is to provide data files. @@ -494,7 +497,8 @@ We don't need this, and we can simply delete it in the `install` target. Next, note that some file permissions aren't entirely correct. For example, `libexpat.so.1.6.0` is executable, but almost all libraries need not be. -So we can call **oh-fixperms**(1) in our `install` target to automatically set +So we can call [[**oh-fixperms**(1)|dev/opkhelper/oh-fixperms.1]] in our +`install` target to automatically set correct permissions for us. Finally, note that the executable and linkable objects are not stripped: they @@ -505,7 +509,8 @@ contain all of their symbols, including those only needed for debugging. $ file tmp/xmlwf.data/usr/bin/xmlwf tmp/xmlwf.data/usr/bin/xmlwf: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked (uses shared libs), for GNU/Linux 2.6.26, BuildID[sha1]=0xdb5f686930b13b8a5e7519efb446a2da14de9856, not stripped -We can call **oh-strip**(1) in our `install` target to automatically strip +We can call [[**oh-strip**(1)|dev/opkhelper/oh-strip.1]] in our `install` target +to automatically strip objects for us. So our `build` makefile should now look like this: -- cgit v0.9.1