summaryrefslogtreecommitdiff
path: root/doc/guide
diff options
context:
space:
mode:
authorwiz <wiz@pkgsrc.org>2006-09-10 19:51:49 +0000
committerwiz <wiz@pkgsrc.org>2006-09-10 19:51:49 +0000
commit06cbeb626e8d820a1da699e80332d2bf9e832d07 (patch)
treef0c7f1eadc6808781e6b4e391ab307ab16719f7f /doc/guide
parent94201593d3df9ea4748005ade858c250fdf10d23 (diff)
downloadpkgsrc-06cbeb626e8d820a1da699e80332d2bf9e832d07.tar.gz
It seems that the contents of <screen> should start in the first column
for consistency. Make it so.
Diffstat (limited to 'doc/guide')
-rw-r--r--doc/guide/files/binary.xml80
-rw-r--r--doc/guide/files/build.xml10
-rw-r--r--doc/guide/files/buildlink.xml8
-rw-r--r--doc/guide/files/platforms.xml36
4 files changed, 81 insertions, 53 deletions
diff --git a/doc/guide/files/binary.xml b/doc/guide/files/binary.xml
index 27523d23a28..d3ec0b82775 100644
--- a/doc/guide/files/binary.xml
+++ b/doc/guide/files/binary.xml
@@ -1,4 +1,4 @@
-<!-- $NetBSD: binary.xml,v 1.25 2006/09/09 23:40:40 wiz Exp $ -->
+<!-- $NetBSD: binary.xml,v 1.26 2006/09/10 19:51:49 wiz Exp $ -->
<chapter id="binary">
<title>Creating binary packages</title>
@@ -17,8 +17,10 @@
directory in pkgsrc, and run <command>make
package</command>:</para>
- <screen>&rprompt; <userinput>cd misc/figlet</userinput>
- &rprompt; <userinput>make package</userinput></screen>
+ <screen>
+&rprompt; <userinput>cd misc/figlet</userinput>
+&rprompt; <userinput>make package</userinput>
+ </screen>
<para>This will build and install your package (if not already done),
and then build a binary package from what was installed. You can
@@ -209,8 +211,10 @@
interfere with builds, like some libs installed in
<filename>/usr/local</filename>, etc. then become root and type:</para>
- <screen>&rprompt; <userinput>cd /usr/pkgsrc</userinput>
- &rprompt; <userinput>sh mk/bulk/build</userinput></screen>
+ <screen>
+&rprompt; <userinput>cd /usr/pkgsrc</userinput>
+&rprompt; <userinput>sh mk/bulk/build</userinput>
+ </screen>
<para>If for some reason your last build didn't complete (power
failure, system panic, ...), you can continue it by
@@ -390,8 +394,10 @@
<para>Checkout pkgsrc via cvs into
<filename>/usr/sandbox/usr/pkgsrc</filename>:</para>
- <screen>&rprompt; <userinput>cd /usr/sandbox/usr</userinput>
- &rprompt; <userinput>cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -d -P pkgsrc</userinput></screen>
+ <screen>
+&rprompt; <userinput>cd /usr/sandbox/usr</userinput>
+&rprompt; <userinput>cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -d -P pkgsrc</userinput>
+ </screen>
<para>Do not mount/link this to the copy of your pkgsrc tree
you do development in, as this will likely cause problems!</para>
@@ -416,8 +422,10 @@
<para>When the chroot sandbox is set up, you can start
the build with the following steps:</para>
- <screen>&rprompt; <userinput>cd /usr/sandbox/usr/pkgsrc</userinput>
- &rprompt; <userinput>sh mk/bulk/do-sandbox-build</userinput></screen>
+ <screen>
+&rprompt; <userinput>cd /usr/sandbox/usr/pkgsrc</userinput>
+&rprompt; <userinput>sh mk/bulk/do-sandbox-build</userinput>
+ </screen>
<para>This will just jump inside the sandbox and start building. At
the end of the build, mail will be sent with the results of
@@ -483,7 +491,7 @@
into the variable, e.g. my local account is "feyrer", but for my
login "hubertf", I use:</para>
- <screen>RSYNC_DST=hubertf@ftp.NetBSD.org:/pub/NetBSD/packages/pkgsrc-200xQy/NetBSD-a.b.c/arch/upload </screen>
+ <screen>RSYNC_DST=hubertf@ftp.NetBSD.org:/pub/NetBSD/packages/pkgsrc-200xQy/NetBSD-a.b.c/arch/upload</screen>
<para>A separate <filename>upload</filename> directory is used
here to allow "closing" the directory during upload. To do
@@ -501,10 +509,12 @@
for the root account <emphasis>inside the sandbox</emphasis>
(assuming that no keys should be present there usually):</para>
- <screen>&rprompt; <userinput>chroot /usr/sandbox</userinput>
- chroot-&rprompt; <userinput>rm $HOME/.ssh/id-dsa*</userinput>
- chroot-&rprompt; <userinput>ssh-keygen -t dsa</userinput>
- chroot-&rprompt; <userinput>cat $HOME/.ssh/id-dsa.pub</userinput> </screen>
+ <screen>
+&rprompt; <userinput>chroot /usr/sandbox</userinput>
+chroot-&rprompt; <userinput>rm $HOME/.ssh/id-dsa*</userinput>
+chroot-&rprompt; <userinput>ssh-keygen -t dsa</userinput>
+chroot-&rprompt; <userinput>cat $HOME/.ssh/id-dsa.pub</userinput>
+ </screen>
<para>Now take the output of <filename>id-dsa.pub</filename> and
append it to your <filename>~/.ssh/authorized_keys</filename>
@@ -520,9 +530,11 @@
<para>Now after all this works, you can exit the sandbox and start
the upload:</para>
- <screen>chroot-&rprompt; <userinput>exit</userinput>
- &rprompt; <userinput>cd /usr/sandbox/usr/pkgsrc</userinput>
- &rprompt; <userinput>sh mk/bulk/do-sandbox-upload</userinput> </screen>
+ <screen>
+chroot-&rprompt; <userinput>exit</userinput>
+&rprompt; <userinput>cd /usr/sandbox/usr/pkgsrc</userinput>
+&rprompt; <userinput>sh mk/bulk/do-sandbox-upload</userinput>
+ </screen>
<para>The upload process may take quite some time. Use &man.ls.1; or
&man.du.1; on the FTP server to monitor progress of the
@@ -540,10 +552,12 @@
<filename>upload</filename> directory to have them accessible
to everyone:</para>
- <screen>nbftp% <userinput>cd /pub/NetBSD/packages/pkgsrc-200xQy/NetBSD-a.b.c/arch</userinput>
- nbftp% <userinput>mv upload/* .</userinput>
- nbftp% <userinput>rmdir upload</userinput>
- nbftp% <userinput>chmod 755 .</userinput> </screen>
+ <screen>
+nbftp% <userinput>cd /pub/NetBSD/packages/pkgsrc-200xQy/NetBSD-a.b.c/arch</userinput>
+nbftp% <userinput>mv upload/* .</userinput>
+nbftp% <userinput>rmdir upload</userinput>
+nbftp% <userinput>chmod 755 .</userinput>
+ </screen>
</sect2>
</sect1>
@@ -569,22 +583,26 @@
sufficient disk space exists in <filename>/u2</filename> to
hold the ISO 9660 images.</para>
- <screen>&rprompt; <userinput>mkdir /u2/images</userinput>
- &rprompt; <userinput>pkg_add /usr/pkgsrc/packages/All/cdpack</userinput>
- &rprompt; <userinput>cdpack /usr/pkgsrc/packages/All /u2/images</userinput></screen>
+ <screen>
+&rprompt; <userinput>mkdir /u2/images</userinput>
+&rprompt; <userinput>pkg_add /usr/pkgsrc/packages/All/cdpack</userinput>
+&rprompt; <userinput>cdpack /usr/pkgsrc/packages/All /u2/images</userinput>
+ </screen>
<para>If you wish to include a common set of files
(<filename>COPYRIGHT</filename>, <filename>README</filename>,
etc.) on each CD in the collection, then you need to create a
directory which contains these files. e.g.</para>
- <screen>&rprompt; <userinput>mkdir /tmp/common</userinput>
- &rprompt; <userinput>echo "This is a README" &gt; /tmp/common/README</userinput>
- &rprompt; <userinput>echo "Another file" &gt; /tmp/common/COPYING</userinput>
- &rprompt; <userinput>mkdir /tmp/common/bin</userinput>
- &rprompt; <userinput>echo "#!/bin/sh" &gt; /tmp/common/bin/myscript</userinput>
- &rprompt; <userinput>echo "echo Hello world" &gt;&gt; /tmp/common/bin/myscript</userinput>
- &rprompt; <userinput>chmod 755 /tmp/common/bin/myscript</userinput></screen>
+ <screen>
+&rprompt; <userinput>mkdir /tmp/common</userinput>
+&rprompt; <userinput>echo "This is a README" &gt; /tmp/common/README</userinput>
+&rprompt; <userinput>echo "Another file" &gt; /tmp/common/COPYING</userinput>
+&rprompt; <userinput>mkdir /tmp/common/bin</userinput>
+&rprompt; <userinput>echo "#!/bin/sh" &gt; /tmp/common/bin/myscript</userinput>
+&rprompt; <userinput>echo "echo Hello world" &gt;&gt; /tmp/common/bin/myscript</userinput>
+&rprompt; <userinput>chmod 755 /tmp/common/bin/myscript</userinput>
+ </screen>
<para>Now create the images:</para>
diff --git a/doc/guide/files/build.xml b/doc/guide/files/build.xml
index 11b3ffed88c..31356416bdb 100644
--- a/doc/guide/files/build.xml
+++ b/doc/guide/files/build.xml
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.33 2006/09/09 23:47:40 wiz Exp $ -->
+<!-- $NetBSD: build.xml,v 1.34 2006/09/10 19:51:49 wiz Exp $ -->
<chapter id="build">
<title>The build process</title>
@@ -839,9 +839,11 @@ of <varname>MAKE_FILE</varname> is <quote>Makefile</quote>, and
<command>make update</command> for the first time, otherwise you lose
all the packages you wanted to update!):</para>
- <screen><prompt>#</prompt> <userinput>make clean-update</userinput>
- <prompt>#</prompt> <userinput>make clean CLEANDEPENDS=YES</userinput>
- <prompt>#</prompt> <userinput>make update</userinput></screen>
+ <screen>
+<prompt>#</prompt> <userinput>make clean-update</userinput>
+<prompt>#</prompt> <userinput>make clean CLEANDEPENDS=YES</userinput>
+<prompt>#</prompt> <userinput>make update</userinput>
+ </screen>
<para>The following variables can be used either on the command line or in
<filename>/etc/mk.conf</filename> to alter the behaviour of
diff --git a/doc/guide/files/buildlink.xml b/doc/guide/files/buildlink.xml
index aa423f6fbea..5b8f4c4e841 100644
--- a/doc/guide/files/buildlink.xml
+++ b/doc/guide/files/buildlink.xml
@@ -1,4 +1,4 @@
-<!-- $NetBSD: buildlink.xml,v 1.17 2006/09/09 23:49:08 wiz Exp $ -->
+<!-- $NetBSD: buildlink.xml,v 1.18 2006/09/10 19:51:49 wiz Exp $ -->
<chapter id="buildlink">
<title>Buildlink methodology</title>
@@ -172,8 +172,10 @@
command will generate a good starting point for
<filename>buildlink3.mk</filename> files:</para>
- <screen>&cprompt; <userinput>cd pkgsrc/<replaceable>category</replaceable>/<replaceable>pkgdir</replaceable>
- &cprompt; createbuildlink &gt;buildlink3.mk</userinput></screen>
+ <screen>
+&cprompt; <userinput>cd pkgsrc/<replaceable>category</replaceable>/<replaceable>pkgdir</replaceable>
+&cprompt; createbuildlink &gt;buildlink3.mk</userinput>
+ </screen>
<sect2 id="anatomy-of-bl3">
<title>Anatomy of a buildlink3.mk file</title>
diff --git a/doc/guide/files/platforms.xml b/doc/guide/files/platforms.xml
index 3f65a2d6490..cdb6e5e5445 100644
--- a/doc/guide/files/platforms.xml
+++ b/doc/guide/files/platforms.xml
@@ -1,4 +1,4 @@
-<!-- $NetBSD: platforms.xml,v 1.39 2006/09/10 19:30:56 wiz Exp $ -->
+<!-- $NetBSD: platforms.xml,v 1.40 2006/09/10 19:51:49 wiz Exp $ -->
<chapter id="platforms">
<title>Using pkgsrc on systems other than &os;</title>
@@ -214,9 +214,10 @@ file and inspect the contents before extracting it.
<para>Installing the bootstrap kit from source should be as simple as:</para>
<screen>
- &rprompt; <userinput>env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout pkgsrc</userinput>
- &rprompt; <userinput>cd pkgsrc/bootstrap</userinput>
- &rprompt; <userinput>./bootstrap</userinput></screen>
+&rprompt; <userinput>env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout pkgsrc</userinput>
+&rprompt; <userinput>cd pkgsrc/bootstrap</userinput>
+&rprompt; <userinput>./bootstrap</userinput>
+ </screen>
<para>See <xref linkend="getting"/> for other ways to get
pkgsrc before bootstrapping. The given
@@ -355,11 +356,13 @@ file and inspect the contents before extracting it.
<para>If you do not intend to use the FreeBSD ports tools, it's probably a
good idea to move them out of the way to avoid confusion, e.g.</para>
- <screen>&rprompt; <userinput>cd /usr/sbin</userinput>
- &rprompt; <userinput>mv pkg_add pkg_add.orig</userinput>
- &rprompt; <userinput>mv pkg_create pkg_create.orig</userinput>
- &rprompt; <userinput>mv pkg_delete pkg_delete.orig</userinput>
- &rprompt; <userinput>mv pkg_info pkg_info.orig</userinput></screen>
+ <screen>
+&rprompt; <userinput>cd /usr/sbin</userinput>
+&rprompt; <userinput>mv pkg_add pkg_add.orig</userinput>
+&rprompt; <userinput>mv pkg_create pkg_create.orig</userinput>
+&rprompt; <userinput>mv pkg_delete pkg_delete.orig</userinput>
+&rprompt; <userinput>mv pkg_info pkg_info.orig</userinput>
+ </screen>
</listitem>
<listitem>
@@ -555,7 +558,8 @@ file and inspect the contents before extracting it.
installing a package to work around the issue:</para>
<screen>
- &rprompt; <userinput>chmod -R g+w $PKG_DBDIR</userinput></screen>
+&rprompt; <userinput>chmod -R g+w $PKG_DBDIR</userinput>
+ </screen>
</sect3>
</sect2>
@@ -695,11 +699,13 @@ file and inspect the contents before extracting it.
<para>If you do not intend to use the OpenBSD ports tools, it's probably a
good idea to move them out of the way to avoid confusion, e.g.</para>
- <screen>&rprompt; <userinput>cd /usr/sbin</userinput>
- &rprompt; <userinput>mv pkg_add pkg_add.orig</userinput>
- &rprompt; <userinput>mv pkg_create pkg_create.orig</userinput>
- &rprompt; <userinput>mv pkg_delete pkg_delete.orig</userinput>
- &rprompt; <userinput>mv pkg_info pkg_info.orig</userinput></screen>
+ <screen>
+&rprompt; <userinput>cd /usr/sbin</userinput>
+&rprompt; <userinput>mv pkg_add pkg_add.orig</userinput>
+&rprompt; <userinput>mv pkg_create pkg_create.orig</userinput>
+&rprompt; <userinput>mv pkg_delete pkg_delete.orig</userinput>
+&rprompt; <userinput>mv pkg_info pkg_info.orig</userinput>
+ </screen>
</listitem>
<listitem>