New donator - thanks, Michael Roach!
[ikiwiki.git] / docs / howtos / howtoporttodragonfly / index.mdwn
index 0694e9c..c67bf0f 100644 (file)
@@ -29,9 +29,9 @@ Suppose you would want to modify the application foo/bar from the pkgsrc collect
 
 This will restore the changes previously made, which will be a good starting point for the porting. The bmake command could also be used without options to attempt an immediate first compilation. But you might have to change some files first, like the GNU scripts for example.
 
-Suppose that the foo application of the collection is version 1.0. Let's go into the newly extracted source directory located right here<a name="AEN1" href="#FTN.AEN1">[1]</a>:
+Suppose that the bar application of the collection is version 1.0. Let's go into the newly extracted source directory located right here<a name="AEN1" href="#FTN.AEN1">[1]</a>:
 
-       cd /var/obj/pkgsrc/foo/bar/work/foo-1.0
+       cd /usr/pkgobj/bootstrap/work/pkgsrc/foo/bar/work/bar-1.0
 
 Voilà, your ready! The porting of the source code can now begin.
 
@@ -230,16 +230,33 @@ The NetBSD group, which maintains pkgsrc, recommends the use of this definition.
 
 Ideally, a port to DragonFly shall always be at the project level. But realistically, it is faster and easier to modify applications at the pkgsrc level.
 
-Tools for pkgsrc allows you to keep only the patches and some basic information of a package. If you want to use pkgsrc, you'll have to use the tool mkpatches.
+pkgsrc contains the patches and some basic information needed to build a package in the *package directory* (by default `/usr/pkgsrc/<category>/<package>`).
 
-To use this tool, you need to install the pkgtools/pkgdiff package. As indicated earlier in this document, you first need to either extract an existing package or create and extract your own. Then you must keep the original version of each files modified by making a copy of it with the extension .orig. When changes are complete, you can run mkpatches from the directory, say, /usr/pkgsrc/foo/bar. This action will create a set of patches by using the .orig files previously created as a basis. A new directory will be created, here /usr/obj/pkgsrc/foo/bar/work/.newpatches. You then copy this directory like this:
+The `pkgtools/pkgdiff` suite of tools helps with creating and updating patches to a package. Extract the source code into the *work directory* (by default `/usr/pkgobj/bootstrap/work/pkgsrc/<category>/<package>/work/`) by invoking
 
-       mkpatches
-       mv patches patches.old
-       cp -Rp /usr/obj/pkgsrc/foo/bar/work/.newpatches patches
-       bmake distinfo
+        bmake patch
 
-The last command, bmake distinfo, will regenerate the verification file distinfo. From that moment, you can run bmake clean and rebuild the package at will. If you have any other changes to add, you can remove the package again and repeat these steps.
+from the package directory. This fetches the source code if necessary, extracts it and applies any existing pkgsrc patch, saving the unpatched files with a `.orig` extension in the work directory.
+
+To create a new patch, save a copy of the original file with that same `.orig` extension. If it exists, just keep it – do not overwrite or change `.orig` files or your patches will not apply later on! You may choose to use `pkgvi` from the `pkgdiff` suite to automate this.
+
+You can preview the patches using `pkgdiff <file>`. To generate all patches invoke
+
+        mkpatches
+
+from the package directory (not the work directory!) The new patches will be saved in the `patches/` directory along with backups of the previous patchset. When you are content with the generated patches commit them and update the patch checksums:
+
+        mkpatches -c
+        bmake makepatchsum
+
+You may also revert to the old patches by calling `mkpatches -r`.
+
+Now clean up and try to rebuild your package:
+
+        bmake clean
+        bmake
+
+If you have any other changes to add, you can remove the package again and repeat these steps.
 
 ## Submitting a package in pkgsrc
 
@@ -285,7 +302,7 @@ It is also possible to import new packages in pkgsrc-wip. See [http://pkgsrc-wip
       </td>
       <td align="LEFT" valign="TOP">
         <p>
-          Previously, the work directory was created directly in the directory dedicated to the ported application, under the pkgsrc directory. But to preserve the integrity of these directories and to be able to compile on another volume, the working files have been moved under /usr/obj. The source code located in /usr/src followed the same path.
+          Previously, the work directory was created directly in the directory dedicated to the ported application, under the pkgsrc directory. But to preserve the integrity of these directories and to be able to compile on another volume, the working files have been moved under /usr/pkgobj.
         </p>
       </td>
   </tr>