From ed593bb7d8b07f124be5c04e794a7b5da49fe812 Mon Sep 17 00:00:00 2001 From: wiz Date: Sun, 8 May 2005 13:53:06 +0000 Subject: Use more man page entities, now that we have them. --- doc/guide/files/build.xml | 14 +++++++------- doc/guide/files/faq.xml | 8 ++++---- doc/guide/files/fixes.xml | 6 +++--- doc/guide/files/platforms.xml | 6 +++--- doc/guide/files/plist.xml | 4 ++-- doc/guide/files/submit.xml | 4 ++-- 6 files changed, 21 insertions(+), 21 deletions(-) (limited to 'doc') diff --git a/doc/guide/files/build.xml b/doc/guide/files/build.xml index 3e055b6e805..1e9e3fdce7e 100644 --- a/doc/guide/files/build.xml +++ b/doc/guide/files/build.xml @@ -1,4 +1,4 @@ - + The build process @@ -93,7 +93,7 @@ in X11BASE and some in LOCALBASE. To determine the prefix of an installed package, the EVAL_PREFIX definition can be used. It takes pairs in the - format DIRNAME=<package>, and the make(1) variable + format DIRNAME=<package>, and the &man.make.1; variable DIRNAME will be set to the prefix of the installed package <package>, or ${X11PREFIX} if the package is not installed. @@ -120,7 +120,7 @@ CONFIGURE_ARGS+= --with-guile-prefix=${LOCALBASE} \ Within ${PREFIX}, packages should - install files according to hier(7), with the exception that + install files according to &man.hier.7;, with the exception that manual pages go into ${PREFIX}/man, not ${PREFIX}/share/man. @@ -225,11 +225,11 @@ CONFIGURE_ARGS+= --with-guile-prefix=${LOCALBASE} \ Patchfiles ending in .Z or .gz are uncompressed before they are applied, files ending in .orig or - .rej are ignored. Any special options to patch(1) + .rej are ignored. Any special options to &man.patch.1; can be handed in PATCH_DIST_ARGS. See for more details. - By default patch(1) is given special args to make it fail if the + By default &man.patch.1; is given special args to make it fail if the patches apply with some lines of fuzz. Please fix (regen) the patches so that they apply cleanly. The rationale behind this is that patches that don't apply cleanly may end up being applied in the wrong @@ -363,7 +363,7 @@ make build deinstall - This target does a pkg_delete(1) in the current directory, + This target does a &man.pkg.delete.1; in the current directory, effectively de-installing the package. The following variables can be used to tune the behaviour: @@ -648,7 +648,7 @@ make build diff the output of this command against an already existing PLIST file. - If the package installs files via tar(1) or other + If the package installs files via &man.tar.1; or other methods that don't update file access times, be sure to add these files manually to your PLIST, as the find diff --git a/doc/guide/files/faq.xml b/doc/guide/files/faq.xml index 31f75b36a18..c7538793236 100644 --- a/doc/guide/files/faq.xml +++ b/doc/guide/files/faq.xml @@ -1,4 +1,4 @@ - + Frequently Asked Questions @@ -249,7 +249,7 @@ PKG_RESUME_TRANSFERS=YES into /etc/mk.conf. If, during a fetch step, an incomplete distfile is found, pkgsrc will try to resume it. - You can also use a different program than the default ftp(1) by + You can also use a different program than the default &man.ftp.1; by changing the FETCH_CMD variable. Don't forget to set FETCH_RESUME_ARGS and FETCH_OUTPUT_ARGS if you are not using default @@ -349,7 +349,7 @@ http_proxy=http://orpheus.amdahl.com:80/ fetch-list in /usr/pkgsrc or one of it's subdirectories, carry the resulting list to your machine at work/school and use it there. If you don't have a - NetBSD-compatible ftp(1) (like lukemftp) at work, don't forget + NetBSD-compatible &man.ftp.1; (like lukemftp) at work, don't forget to set FETCH_CMD to something that fetches a URL: @@ -422,7 +422,7 @@ http_proxy=http://orpheus.amdahl.com:80/ When installing packages as non-root user and using the - just-in-time su(1) feature of pkgsrc, it can become annoying to + just-in-time &man.su.1; feature of pkgsrc, it can become annoying to type in the root password for each required package installed. To avoid this, the sudo package can be used, which does password caching over a limited time. To use it, install diff --git a/doc/guide/files/fixes.xml b/doc/guide/files/fixes.xml index 609f6ce6e36..395748bd777 100644 --- a/doc/guide/files/fixes.xml +++ b/doc/guide/files/fixes.xml @@ -1,4 +1,4 @@ - + Notes on fixes for packages @@ -261,7 +261,7 @@ Please also note the BUILD_USES_MSGFMT and BUILD_USES_GETTEXT_M4 definitions, which are provided as convenience definitions. The former works out - whether msgfmt(1) is part of the base system, and, if it isn't, + whether &man.msgfmt.1; is part of the base system, and, if it isn't, installs the devel/gettext package. The latter adds a build dependency on either an installed version of an older gettext package, or if it isn't, installs the @@ -574,7 +574,7 @@ dynamic linker chooses the library with the greater REVISION number. When linking shared object (.so) - files, i.e. files that are loaded via dlopen(3), NOT + files, i.e. files that are loaded via &man.dlopen.3;, NOT shared libraries, use -module -avoid-version to prevent them getting version tacked on. diff --git a/doc/guide/files/platforms.xml b/doc/guide/files/platforms.xml index 30b038b2657..b39510f3351 100644 --- a/doc/guide/files/platforms.xml +++ b/doc/guide/files/platforms.xml @@ -1,4 +1,4 @@ - + Using pkgsrc on systems other than &os; @@ -305,7 +305,7 @@ url="http://freeware.sgi.com/">http://freeware.sgi.com/. Please note that you will need IRIX 6.5.17 or higher, as this is the earliest - version of IRIX providing support for if_indextoname(3), if_nametoindex(3), + version of IRIX providing support for &man.if.indextoname.3;, &man.if.nametoindex.3;, etc. At this point in time, pkgsrc only supports one ABI. That is, you can not @@ -387,7 +387,7 @@ provided by icc, so binaries can be run on other systems which do not have the shared libraries installed. - Libtool, however, extracts a list of libraries from the ld(1) + Libtool, however, extracts a list of libraries from the &man.ld.1; command run when linking a C++ shared library and records it, throwing away the -Bstatic and -Bdynamic options interspersed between the libraries. This means that libtool-linked C++ shared libraries will have a diff --git a/doc/guide/files/plist.xml b/doc/guide/files/plist.xml index 6455baf61b4..74ab556097a 100644 --- a/doc/guide/files/plist.xml +++ b/doc/guide/files/plist.xml @@ -1,4 +1,4 @@ - + PLIST issues @@ -183,7 +183,7 @@ To use one or more files as source for the PLIST used in generating the binary package, set the variable PLIST_SRC to the names of that file(s). - The files are later concatenated using cat(1), and order of things is + The files are later concatenated using &man.cat.1;, and order of things is important. diff --git a/doc/guide/files/submit.xml b/doc/guide/files/submit.xml index 8ff91159a57..6faea4fb626 100644 --- a/doc/guide/files/submit.xml +++ b/doc/guide/files/submit.xml @@ -1,4 +1,4 @@ - + Submitting and Committing @@ -28,7 +28,7 @@ packages here: First, check that your package is complete, compiles and runs well; see and the rest of this document. Next, - generate an uuencoded gzipped tar(1) archive, preferably with all files + generate an uuencoded gzipped &man.tar.1; archive, preferably with all files in a single directory. Finally, send-pr with category pkg, a synopsis which includes the package name and version number, a short -- cgit v1.2.3