summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorrillig <rillig@pkgsrc.org>2006-10-02 16:52:22 +0000
committerrillig <rillig@pkgsrc.org>2006-10-02 16:52:22 +0000
commit125371fc80555c54503c2d1eabf4e954758379b9 (patch)
treed780fd76c3d0a1886778c38d54dfa89f94321783
parent5c845b22e6f9e3911f725024aa3471494bbaea70 (diff)
downloadpkgsrc-125371fc80555c54503c2d1eabf4e954758379b9.tar.gz
After editing the package Makefile, it is usually necessary to run
"bmake clean". The url2pkg program can create packages for Perl modules almost completely.
-rw-r--r--doc/guide/files/creating.xml25
1 files changed, 24 insertions, 1 deletions
diff --git a/doc/guide/files/creating.xml b/doc/guide/files/creating.xml
index 5606728d8ec..d2fe42bea00 100644
--- a/doc/guide/files/creating.xml
+++ b/doc/guide/files/creating.xml
@@ -1,4 +1,4 @@
-<!-- $NetBSD: creating.xml,v 1.1 2006/06/01 08:39:03 rillig Exp $ -->
+<!-- $NetBSD: creating.xml,v 1.2 2006/10/02 16:52:22 rillig Exp $ -->
<chapter id="creating">
<title>Creating a new pkgsrc package from scratch</title>
@@ -69,6 +69,18 @@
-e</command>, which outputs additional
explanations.</para></step>
+ <step><para>In many cases the package is not yet ready to build.
+ You can find instructions for the most common cases in the next
+ section, <xref linkend="creating.common"/>. After you have
+ followed the instructions over there, you can hopefully continue
+ here.</para></step>
+
+ <step><para>Run <command>bmake clean</command> to clean the
+ working directory from the extracted files. Besides these files,
+ a lot of cache files and other system information has been saved
+ in the working directory, which may become wrong after you
+ edited the <filename>Makefile</filename>.</para></step>
+
<step><para>Now, run <command>bmake</command> to build the
package. For the various things that can go wrong in this phase,
consult <xref linkend="fixes"/>.</para></step>
@@ -100,4 +112,15 @@
</procedure>
+<sect1 id="creating.common">
+<title>Common types of packages</title>
+
+<sect2 id="creating.perl-module">
+<title>Perl modules</title>
+
+<para>Simple Perl modules are handled automatically by
+<command>url2pkg</command>, including dependencies.</para>
+
+</sect2>
+</sect1>
</chapter>