Changes between Version 7 and Version 8 of GoogleCodeInTaskInstallHaikuporter

Timestamp:

Jan 16, 2018, 6:09:52 AM (7 years ago)

Author:

humdinger

Comment:

More details, corrections. Hopefully cuts down work for next GCI

GoogleCodeInTaskInstallHaikuporter

@@ -1 +1 @@
 == Install and run HaikuPorter ==
-
-You're required to run a [http://download.haiku-os.org/nightly-images/x86_gcc2_hybrid/haiku-nightly-hrev50749-x86_gcc2_hybrid-anyboot.zip Haiku nightly image] for this task.
 
 Haiku uses HaikuDepot as its package manager, but this requires packages and a way to build these packages. We use the tool HaikuPorter to to do this by telling it to read 'recipe' files that contain all the instructions needed to successfully build the package for Haiku. These recipes files can be found in a database called HaikuPorts, which it hosted on GitHub.
 
-Head over to the [https://github.com/haikuports/haikuports/wiki wiki on the HaikuPorts website] and go to the section "Install and run HaikuPorter" and follow the instructions on how to install HaikuPorter and the HaikuPorts database.  Edit your haikuports.conf file to put your username in as the packager, for email address put your username "@gci.test".
+=== Install and configure ===
 
-When you are done, check that haikuporter is working fine by building a simple recipe ("which" is a good choice). This will allow you to make sure everything is configured properly and working as expected. Provide a copy of the build log (haikuporter output to terminal) and/or a screenshot of the package (it is created in the packages/ folder in your haikuports directory) so we can check you completed the work.
+Head over to the [https://github.com/haikuports/haikuports/wiki wiki on the HaikuPorts website] and go to the section ''Setting Up HaikuPorts'' and follow the instructions on how to install HaikuPorter and the HaikuPorts database.  Edit your haikuports.conf file to put your username in as the packager, for email address put your username "@gci.test".
+See the ''Tips'' section on that same wiki page to add an alias ''hp'' that saves having to type haikuporter with all its standard parameters.
+
+=== Build a package ===
+
+''haikuporter --help'' shows the syntax and available parameters you need to build a package.
+
+Check that haikuporter is working fine by building a simple recipe ("weather" is a good choice). This will allow you to make sure everything is configured properly and working as expected.
+
+=== What to submit at the GCI task ===
+
+* Copy & paste the whole output when you build the package, including your haikuporter commandline, into a text file and upload it at the GCI site.
+* Find the package you've built and double-click to open in HaikuDepot. Install it and open the application (if it's a GUI app like Weather). Take a screenshot of the whole screen and upload it at the GCI site.
+
+=== Troubleshooting ===
+
+If despite all efforts something just doesn't work, always copy&paste all you wrote in Terminal and what was printed back out into a textfile to upload it at the GCI site. That works much better than screenshots.