diff options
author | wiz <wiz@pkgsrc.org> | 2006-09-10 19:51:49 +0000 |
---|---|---|
committer | wiz <wiz@pkgsrc.org> | 2006-09-10 19:51:49 +0000 |
commit | 06cbeb626e8d820a1da699e80332d2bf9e832d07 (patch) | |
tree | f0c7f1eadc6808781e6b4e391ab307ab16719f7f /doc/guide | |
parent | 94201593d3df9ea4748005ade858c250fdf10d23 (diff) | |
download | pkgsrc-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.xml | 80 | ||||
-rw-r--r-- | doc/guide/files/build.xml | 10 | ||||
-rw-r--r-- | doc/guide/files/buildlink.xml | 8 | ||||
-rw-r--r-- | doc/guide/files/platforms.xml | 36 |
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" > /tmp/common/README</userinput> - &rprompt; <userinput>echo "Another file" > /tmp/common/COPYING</userinput> - &rprompt; <userinput>mkdir /tmp/common/bin</userinput> - &rprompt; <userinput>echo "#!/bin/sh" > /tmp/common/bin/myscript</userinput> - &rprompt; <userinput>echo "echo Hello world" >> /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" > /tmp/common/README</userinput> +&rprompt; <userinput>echo "Another file" > /tmp/common/COPYING</userinput> +&rprompt; <userinput>mkdir /tmp/common/bin</userinput> +&rprompt; <userinput>echo "#!/bin/sh" > /tmp/common/bin/myscript</userinput> +&rprompt; <userinput>echo "echo Hello world" >> /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 >buildlink3.mk</userinput></screen> + <screen> +&cprompt; <userinput>cd pkgsrc/<replaceable>category</replaceable>/<replaceable>pkgdir</replaceable> +&cprompt; createbuildlink >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> |