summaryrefslogtreecommitdiffstats
path: root/doc/pkg
diff options
context:
space:
mode:
Diffstat (limited to 'doc/pkg')
-rw-r--r--doc/pkg/basic-expat.mdwn17
1 files changed, 11 insertions, 6 deletions
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: