Changes between Version 15 and Version 16 of PortingTips

Timestamp:

04/28/09 11:08:22 (6 years ago)

Author:

mmadia

Comment:

added diff_zip, expounded archive nomenclature.

PortingTips

@@ -57 +57 @@
 Also note that doing so may, depending on the project, result in more dependencies but might be easier to handle, for instance when modifying {{{configure.in}}} or {{{Makefile.am}}} instead of an Autoconf-generated {{{configure}}} or Automake-generated {{{Makefile}}}.
 
-== Building to a clean folder and making a binary ==
+== Preparing an archive for distribution ==
 
-Many packages have an option to do a "make install", in many of those cases you can use:[[BR]]
+There are two methods for creating an archive for distribution, using DESTDIR and using diff_zip. [[BR]]  
+[[BR]]
+For both situations, please use the following nomeclature as the <archivename>  : [[BR]]
+<packagename>-<version>-<gcc-version>-<os>-<date>.zip [[BR]]
 {{{
+  <packagename> = is the name of the software.
+  <version> =  the revision number of the actual software.
+  <gcc-version> = [ gcc2 | gcc4 ]
+  <os> = [ haiku | zeta | bone ]
+  <date> YYYY-MM-DD format and can be extracted by running `date +%Y-%m-%d`
+}}}
+[[BR]] 
+DESTDIR is the preferred method : [[BR]]
+{{{
+ mkdir /boot/foo
  make install DESTDIR=/boot/foo
  cd /boot/foo/boot
- zip -ry9 packagename-x.x.x-gccX-haiku-YYYY-MM-DD.zip *
+ zip -r9y <archivename>.zip *
 }}}
-Where x.x.x is the rev of the package, and gccX is gcc2 or gcc4, haiku could also be beos or bone or zeta, YYYY is the 4 digit year, MM is the 2 digit month, DD is the 2 digit day (both zero padded).
+[[BR]]
+diff_zip is an alternate method : [[BR]]
+Some software packages do not support the use of DESTDIR. For these cases, diff_zip is your friend. It was added to Haiku's source tree in [http://lists.berlios.de/pipermail/haiku-commits/2008-April/007561.html revision 24849]. Once the newly compiled software is ready to install, diff_zip is run in a second Terminal session. diff_zip will patiently wait for you to install the software. After installation, return to the second Terminal session to inform diff_zip to archive the newly added files. 
+{{{
+  [terminal 1] make
+  [terminal 2] cd ~/upload
+  [terminal 2] diff_zip -r9y <archivename> -- <paths>
+  [terminal 1] make install
+  [terminal 2] #press enter to activate diff_zip
+}}}
+
 
 == Using CMake ==