From 564b75f0679f5d12d05479918de3ec0134ec8c66 Mon Sep 17 00:00:00 2001 From: Doug Barton Date: Mon, 19 Jul 2010 02:03:45 +0000 Subject: [PATCH] Improve the description of generating the shar file based on discussion in -ports@. s/FreeBSD/&os;/ in the neighborhood --- .../books/porters-handbook/book.sgml | 23 +++++++++++-------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/en_US.ISO8859-1/books/porters-handbook/book.sgml b/en_US.ISO8859-1/books/porters-handbook/book.sgml index b58283fc8c..d9f99fa8ac 100644 --- a/en_US.ISO8859-1/books/porters-handbook/book.sgml +++ b/en_US.ISO8859-1/books/porters-handbook/book.sgml @@ -369,12 +369,17 @@ PLIST_DIRS= lib/X11/oneko linkend="porting-dads">DOs and DON'Ts section. Now that you are happy with your port, the only thing remaining - is to put it in the main FreeBSD ports tree and make everybody else + is to put it in the main &os; ports tree and make everybody else happy about it too. We do not need your work directory or the pkgname.tgz package, so delete - them now. Next, simply include the output of shar `find - port_dir` in a bug report and send it with the - &man.send-pr.1; program (see Bug + them now. Next, assuming your port is called oneko, + cd to the directory above where the + oneko directory is located, and then type the + following: shar `find oneko` > oneko.shar + + Include your oneko.shar file in a bug report + and send it with the &man.send-pr.1; program (see + Bug Reports and General Commentary for more information about &man.send-pr.1;). Be sure to classify the bug report as category ports and class @@ -382,7 +387,7 @@ PLIST_DIRS= lib/X11/oneko confidential!). Also add a short description of the program you ported to the Description field of the PR and - the shar to the Fix field. + the shar file to the Fix field. You can make our work a lot easier, if you use a good @@ -402,10 +407,10 @@ PLIST_DIRS= lib/X11/oneko After you have submitted your port, please be patient. Sometimes it can take a few months before a port is included - in FreeBSD, although it might only take a few days. You can + in &os;, although it might only take a few days. You can view the list of ports - waiting to be committed to FreeBSD. + waiting to be committed to &os;. Once we have looked at your port, we will get back to you if necessary, and put it in the tree. Your name will also appear in the list of @@ -616,7 +621,7 @@ PLIST_DIRS= lib/X11/oneko Unpack a copy of the tarball in a private directory and make whatever changes are necessary to get the port to compile properly - under the current version of FreeBSD. Keep careful + under the current version of &os;. Keep careful track of everything you do, as you will be automating the process shortly. Everything, including the deletion, addition, or modification of files should be doable using an automated script @@ -631,7 +636,7 @@ PLIST_DIRS= lib/X11/oneko Unless explicitly stated, patch files, scripts, and other - files you have created and contributed to the FreeBSD ports + files you have created and contributed to the &os; ports collection are assumed to be covered by the standard BSD copyright conditions.