pkgsrc-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[pkgsrc/trunk]: pkgsrc/doc/guide/files Use more man page entities, now that w...
details: https://anonhg.NetBSD.org/pkgsrc/rev/543215bbff71
branches: trunk
changeset: 493524:543215bbff71
user: wiz <wiz%pkgsrc.org@localhost>
date: Sun May 08 13:53:06 2005 +0000
description:
Use more man page entities, now that we have them.
diffstat:
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(-)
diffs (185 lines):
diff -r 8e1a2e51f6b4 -r 543215bbff71 doc/guide/files/build.xml
--- a/doc/guide/files/build.xml Sun May 08 13:52:25 2005 +0000
+++ b/doc/guide/files/build.xml Sun May 08 13:53:06 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.3 2004/12/03 12:48:15 wiz Exp $ -->
+<!-- $NetBSD: build.xml,v 1.4 2005/05/08 13:53:06 wiz Exp $ -->
<chapter id="build">
<title>The build process</title>
@@ -93,7 +93,7 @@
in <varname>X11BASE</varname> and some in <varname>LOCALBASE</varname>.
To determine the prefix of an installed package, the
<varname>EVAL_PREFIX</varname> definition can be used. It takes pairs in the
- format <quote>DIRNAME=<package></quote>, and the make(1) variable
+ format <quote>DIRNAME=<package></quote>, and the &man.make.1; variable
<varname>DIRNAME</varname> will be set to the prefix of the installed
package <package>, or <quote>${X11PREFIX}</quote> if the package is
not installed.</para>
@@ -120,7 +120,7 @@
<listitem>
<para>Within <filename>${PREFIX}</filename>, 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 <filename>${PREFIX}/man</filename>, not
<filename>${PREFIX}/share/man</filename>.</para>
</listitem>
@@ -225,11 +225,11 @@
Patchfiles ending in <filename>.Z</filename> or
<filename>.gz</filename> are uncompressed before they are applied,
files ending in <filename>.orig</filename> or
- <filename>.rej</filename> are ignored. Any special options to patch(1)
+ <filename>.rej</filename> are ignored. Any special options to &man.patch.1;
can be handed in <varname>PATCH_DIST_ARGS</varname>.
See <xref linkend="components.patches"/> for more details.</para>
- <para>By default patch(1) is given special args to make it fail if the
+ <para>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 @@
<term>deinstall</term>
<listitem>
- <para>This target does a pkg_delete(1) in the current directory,
+ <para>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:</para>
@@ -648,7 +648,7 @@
diff the output of this command against an already
existing <filename>PLIST</filename> file.</para>
- <para>If the package installs files via tar(1) or other
+ <para>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
<filename>PLIST</filename>, as the <quote>find
diff -r 8e1a2e51f6b4 -r 543215bbff71 doc/guide/files/faq.xml
--- a/doc/guide/files/faq.xml Sun May 08 13:52:25 2005 +0000
+++ b/doc/guide/files/faq.xml Sun May 08 13:53:06 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: faq.xml,v 1.6 2005/05/07 15:28:40 rillig Exp $ -->
+<!-- $NetBSD: faq.xml,v 1.7 2005/05/08 13:53:06 wiz Exp $ -->
<chapter id="faq"> <?dbhtml filename="faq.html"?>
<title>Frequently Asked Questions</title>
@@ -249,7 +249,7 @@
<varname>PKG_RESUME_TRANSFERS=YES</varname> into
<filename>/etc/mk.conf</filename>. If, during a fetch step, an
incomplete distfile is found, pkgsrc will try to resume it.</para>
- <para>You can also use a different program than the default ftp(1) by
+ <para>You can also use a different program than the default &man.ftp.1; by
changing the <varname>FETCH_CMD</varname> variable.
Don't forget to set <varname>FETCH_RESUME_ARGS</varname> and
<varname>FETCH_OUTPUT_ARGS</varname> if you are not using default
@@ -349,7 +349,7 @@
fetch-list</command> in <filename>/usr/pkgsrc</filename> 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 <varname>FETCH_CMD</varname> to something that fetches a
URL: </para>
@@ -422,7 +422,7 @@
<para>
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 -r 8e1a2e51f6b4 -r 543215bbff71 doc/guide/files/fixes.xml
--- a/doc/guide/files/fixes.xml Sun May 08 13:52:25 2005 +0000
+++ b/doc/guide/files/fixes.xml Sun May 08 13:53:06 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.12 2005/04/17 09:38:26 wiz Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.13 2005/05/08 13:53:06 wiz Exp $ -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>Notes on fixes for packages</title>
@@ -261,7 +261,7 @@
<para> Please also note the <varname>BUILD_USES_MSGFMT</varname>
and <varname>BUILD_USES_GETTEXT_M4</varname> 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 <pkg>devel/gettext</pkg> 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 @@
<listitem>
<para>When linking shared object (<filename>.so</filename>)
- 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 <quote>-module
-avoid-version</quote> to prevent them getting version
tacked on.</para>
diff -r 8e1a2e51f6b4 -r 543215bbff71 doc/guide/files/platforms.xml
--- a/doc/guide/files/platforms.xml Sun May 08 13:52:25 2005 +0000
+++ b/doc/guide/files/platforms.xml Sun May 08 13:53:06 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: platforms.xml,v 1.7 2005/04/10 22:45:25 jschauma Exp $ -->
+<!-- $NetBSD: platforms.xml,v 1.8 2005/05/08 13:53:06 wiz Exp $ -->
<chapter id="platforms">
<title>Using pkgsrc on systems other than &os;</title>
@@ -305,7 +305,7 @@
url="http://freeware.sgi.com/";>http://freeware.sgi.com/</ulink>.</para>
<para>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.</para>
<para>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.</para>
- <para>Libtool, however, extracts a list of libraries from the ld(1)
+ <para>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 -r 8e1a2e51f6b4 -r 543215bbff71 doc/guide/files/plist.xml
--- a/doc/guide/files/plist.xml Sun May 08 13:52:25 2005 +0000
+++ b/doc/guide/files/plist.xml Sun May 08 13:53:06 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: plist.xml,v 1.3 2005/03/24 05:05:34 ben Exp $ -->
+<!-- $NetBSD: plist.xml,v 1.4 2005/05/08 13:53:06 wiz Exp $ -->
<chapter id="plist">
<title>PLIST issues</title>
@@ -183,7 +183,7 @@
<para>To use one or more files as source for the <filename>PLIST</filename> used
in generating the binary package, set the variable
<varname>PLIST_SRC</varname> 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.</para>
</sect1>
diff -r 8e1a2e51f6b4 -r 543215bbff71 doc/guide/files/submit.xml
--- a/doc/guide/files/submit.xml Sun May 08 13:52:25 2005 +0000
+++ b/doc/guide/files/submit.xml Sun May 08 13:53:06 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: submit.xml,v 1.4 2005/02/10 13:39:15 grant Exp $ -->
+<!-- $NetBSD: submit.xml,v 1.5 2005/05/08 13:53:06 wiz Exp $ -->
<chapter id="submit"> <?dbhtml filename="submit.html"?>
<title>Submitting and Committing</title>
@@ -28,7 +28,7 @@
<para>
First, check that your package is complete, compiles and runs well;
see <xref linkend="debug"/> 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, <command>send-pr</command> with category <quote>pkg</quote>, a
synopsis which includes the package name and version number, a short
Home |
Main Index |
Thread Index |
Old Index