diff --git a/en/handbook/ports/chapter.sgml b/en/handbook/ports/chapter.sgml index 3a4d3465ba..caad37acbf 100644 --- a/en/handbook/ports/chapter.sgml +++ b/en/handbook/ports/chapter.sgml @@ -1,7 +1,7 @@ @@ -1110,6 +1110,11 @@ lib/X11/oneko/mouse.xpm It is recommended that you keep all the filenames in this file sorted alphabetically. It will make verifying the changes when you upgrade the port much easier. + + Creating a packing list manually can be a very tedious + task. If the port installs a large numbers of files, creating the packing list + automatically might save time. @@ -1945,7 +1950,7 @@ BUILD_DEPENDS= /nonexistent:${PORTSDIR}/graphics/jpeg:extract There are some more things you have to take into account when you create a port. This section explains the most common of those. - + <command>ldconfig</command> If your port installs a shared library, add a @@ -3941,7 +3946,48 @@ pre-install: [and then the epilogue] .include <bsd.port.mk> - + + + Automated package list creation + + First, make sure your port is almost complete, with only + PLIST missing. Create an empty + PLIST. + + &prompt.root; touch PLIST + + Next, create a new set of directories which your port can be + installed, and install any dependencies. + + &prompt.root; mtree -U -f /etc/mtree/BSD.local.dist -d -e -p /var/tmp/port-name +&prompt.root; make depends PREFIX=/var/tmp/port-name + + Store the directory structure in a new file. + + &prompt.root; (cd /var/tmp/port-name && find * \! -type d) > OLD-DIRS + + If your port honours PREFIX (which it should) + you can then install the port and create the package list. + + &prompt.root; make install PREFIX=/var/tmp +&prompt.root; (cd /var/tmp/port-name && find * \! -type d) > pkg/PLIST + + You must also add any newly created directories to the packing + list. + + &prompt.root; (cd /var/tmp/port-name && find * -type d) | comm -13 OLD-DIRS - | sed -e 's#^#@dirrm#' >> pkg/PLIST + + Finally, you need to tidy up the packing list by hand. I lied + when I said this was all automated. Manual pages should be listed in + the port's Makefile under + MANn, and not in the + package list. User configuration files should be removed, or + installed as + filename.sample. Any + libraries installed by the port should be listed as specified in the + ldconfig section. + + Package Names @@ -4550,5 +4596,4 @@ pre-install: sgml-always-quote-attributes: t sgml-parent-document: ("../handbook.sgml" "part" "chapter") End: ---> - +--> \ No newline at end of file diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml index 3a4d3465ba..caad37acbf 100644 --- a/en_US.ISO8859-1/books/handbook/ports/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/ports/chapter.sgml @@ -1,7 +1,7 @@ @@ -1110,6 +1110,11 @@ lib/X11/oneko/mouse.xpm It is recommended that you keep all the filenames in this file sorted alphabetically. It will make verifying the changes when you upgrade the port much easier. + + Creating a packing list manually can be a very tedious + task. If the port installs a large numbers of files, creating the packing list + automatically might save time. @@ -1945,7 +1950,7 @@ BUILD_DEPENDS= /nonexistent:${PORTSDIR}/graphics/jpeg:extract There are some more things you have to take into account when you create a port. This section explains the most common of those. - + <command>ldconfig</command> If your port installs a shared library, add a @@ -3941,7 +3946,48 @@ pre-install: [and then the epilogue] .include <bsd.port.mk> - + + + Automated package list creation + + First, make sure your port is almost complete, with only + PLIST missing. Create an empty + PLIST. + + &prompt.root; touch PLIST + + Next, create a new set of directories which your port can be + installed, and install any dependencies. + + &prompt.root; mtree -U -f /etc/mtree/BSD.local.dist -d -e -p /var/tmp/port-name +&prompt.root; make depends PREFIX=/var/tmp/port-name + + Store the directory structure in a new file. + + &prompt.root; (cd /var/tmp/port-name && find * \! -type d) > OLD-DIRS + + If your port honours PREFIX (which it should) + you can then install the port and create the package list. + + &prompt.root; make install PREFIX=/var/tmp +&prompt.root; (cd /var/tmp/port-name && find * \! -type d) > pkg/PLIST + + You must also add any newly created directories to the packing + list. + + &prompt.root; (cd /var/tmp/port-name && find * -type d) | comm -13 OLD-DIRS - | sed -e 's#^#@dirrm#' >> pkg/PLIST + + Finally, you need to tidy up the packing list by hand. I lied + when I said this was all automated. Manual pages should be listed in + the port's Makefile under + MANn, and not in the + package list. User configuration files should be removed, or + installed as + filename.sample. Any + libraries installed by the port should be listed as specified in the + ldconfig section. + + Package Names @@ -4550,5 +4596,4 @@ pre-install: sgml-always-quote-attributes: t sgml-parent-document: ("../handbook.sgml" "part" "chapter") End: ---> - +--> \ No newline at end of file diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml index 8a0d5d3b15..f418e01588 100644 --- a/en_US.ISO8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml @@ -1,7 +1,7 @@ @@ -1110,6 +1110,11 @@ lib/X11/oneko/mouse.xpm It is recommended that you keep all the filenames in this file sorted alphabetically. It will make verifying the changes when you upgrade the port much easier. + + Creating a packing list manually can be a very tedious + task. If the port installs a large numbers of files, creating the packing list + automatically might save time. @@ -1945,7 +1950,7 @@ BUILD_DEPENDS= /nonexistent:${PORTSDIR}/graphics/jpeg:extract There are some more things you have to take into account when you create a port. This section explains the most common of those. - + <command>ldconfig</command> If your port installs a shared library, add a @@ -3941,7 +3946,48 @@ pre-install: [and then the epilogue] .include <bsd.port.mk> - + + + Automated package list creation + + First, make sure your port is almost complete, with only + PLIST missing. Create an empty + PLIST. + + &prompt.root; touch PLIST + + Next, create a new set of directories which your port can be + installed, and install any dependencies. + + &prompt.root; mtree -U -f /etc/mtree/BSD.local.dist -d -e -p /var/tmp/port-name +&prompt.root; make depends PREFIX=/var/tmp/port-name + + Store the directory structure in a new file. + + &prompt.root; (cd /var/tmp/port-name && find * \! -type d) > OLD-DIRS + + If your port honours PREFIX (which it should) + you can then install the port and create the package list. + + &prompt.root; make install PREFIX=/var/tmp +&prompt.root; (cd /var/tmp/port-name && find * \! -type d) > pkg/PLIST + + You must also add any newly created directories to the packing + list. + + &prompt.root; (cd /var/tmp/port-name && find * -type d) | comm -13 OLD-DIRS - | sed -e 's#^#@dirrm#' >> pkg/PLIST + + Finally, you need to tidy up the packing list by hand. I lied + when I said this was all automated. Manual pages should be listed in + the port's Makefile under + MANn, and not in the + package list. User configuration files should be removed, or + installed as + filename.sample. Any + libraries installed by the port should be listed as specified in the + ldconfig section. + + Package Names @@ -4550,5 +4596,4 @@ pre-install: sgml-always-quote-attributes: t sgml-parent-document: ("../handbook.sgml" "part" "chapter") End: ---> - +--> \ No newline at end of file diff --git a/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml b/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml index 3a4d3465ba..caad37acbf 100644 --- a/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml +++ b/en_US.ISO_8859-1/books/handbook/ports/chapter.sgml @@ -1,7 +1,7 @@ @@ -1110,6 +1110,11 @@ lib/X11/oneko/mouse.xpm It is recommended that you keep all the filenames in this file sorted alphabetically. It will make verifying the changes when you upgrade the port much easier. + + Creating a packing list manually can be a very tedious + task. If the port installs a large numbers of files, creating the packing list + automatically might save time. @@ -1945,7 +1950,7 @@ BUILD_DEPENDS= /nonexistent:${PORTSDIR}/graphics/jpeg:extract There are some more things you have to take into account when you create a port. This section explains the most common of those. - + <command>ldconfig</command> If your port installs a shared library, add a @@ -3941,7 +3946,48 @@ pre-install: [and then the epilogue] .include <bsd.port.mk> - + + + Automated package list creation + + First, make sure your port is almost complete, with only + PLIST missing. Create an empty + PLIST. + + &prompt.root; touch PLIST + + Next, create a new set of directories which your port can be + installed, and install any dependencies. + + &prompt.root; mtree -U -f /etc/mtree/BSD.local.dist -d -e -p /var/tmp/port-name +&prompt.root; make depends PREFIX=/var/tmp/port-name + + Store the directory structure in a new file. + + &prompt.root; (cd /var/tmp/port-name && find * \! -type d) > OLD-DIRS + + If your port honours PREFIX (which it should) + you can then install the port and create the package list. + + &prompt.root; make install PREFIX=/var/tmp +&prompt.root; (cd /var/tmp/port-name && find * \! -type d) > pkg/PLIST + + You must also add any newly created directories to the packing + list. + + &prompt.root; (cd /var/tmp/port-name && find * -type d) | comm -13 OLD-DIRS - | sed -e 's#^#@dirrm#' >> pkg/PLIST + + Finally, you need to tidy up the packing list by hand. I lied + when I said this was all automated. Manual pages should be listed in + the port's Makefile under + MANn, and not in the + package list. User configuration files should be removed, or + installed as + filename.sample. Any + libraries installed by the port should be listed as specified in the + ldconfig section. + + Package Names @@ -4550,5 +4596,4 @@ pre-install: sgml-always-quote-attributes: t sgml-parent-document: ("../handbook.sgml" "part" "chapter") End: ---> - +--> \ No newline at end of file diff --git a/en_US.ISO_8859-1/books/porters-handbook/book.sgml b/en_US.ISO_8859-1/books/porters-handbook/book.sgml index 8a0d5d3b15..f418e01588 100644 --- a/en_US.ISO_8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO_8859-1/books/porters-handbook/book.sgml @@ -1,7 +1,7 @@ @@ -1110,6 +1110,11 @@ lib/X11/oneko/mouse.xpm It is recommended that you keep all the filenames in this file sorted alphabetically. It will make verifying the changes when you upgrade the port much easier. + + Creating a packing list manually can be a very tedious + task. If the port installs a large numbers of files, creating the packing list + automatically might save time. @@ -1945,7 +1950,7 @@ BUILD_DEPENDS= /nonexistent:${PORTSDIR}/graphics/jpeg:extract There are some more things you have to take into account when you create a port. This section explains the most common of those. - + <command>ldconfig</command> If your port installs a shared library, add a @@ -3941,7 +3946,48 @@ pre-install: [and then the epilogue] .include <bsd.port.mk> - + + + Automated package list creation + + First, make sure your port is almost complete, with only + PLIST missing. Create an empty + PLIST. + + &prompt.root; touch PLIST + + Next, create a new set of directories which your port can be + installed, and install any dependencies. + + &prompt.root; mtree -U -f /etc/mtree/BSD.local.dist -d -e -p /var/tmp/port-name +&prompt.root; make depends PREFIX=/var/tmp/port-name + + Store the directory structure in a new file. + + &prompt.root; (cd /var/tmp/port-name && find * \! -type d) > OLD-DIRS + + If your port honours PREFIX (which it should) + you can then install the port and create the package list. + + &prompt.root; make install PREFIX=/var/tmp +&prompt.root; (cd /var/tmp/port-name && find * \! -type d) > pkg/PLIST + + You must also add any newly created directories to the packing + list. + + &prompt.root; (cd /var/tmp/port-name && find * -type d) | comm -13 OLD-DIRS - | sed -e 's#^#@dirrm#' >> pkg/PLIST + + Finally, you need to tidy up the packing list by hand. I lied + when I said this was all automated. Manual pages should be listed in + the port's Makefile under + MANn, and not in the + package list. User configuration files should be removed, or + installed as + filename.sample. Any + libraries installed by the port should be listed as specified in the + ldconfig section. + + Package Names @@ -4550,5 +4596,4 @@ pre-install: sgml-always-quote-attributes: t sgml-parent-document: ("../handbook.sgml" "part" "chapter") End: ---> - +--> \ No newline at end of file