Changeset 29702 for main/trunk/package-kits/linux/ReadMe

Timestamp:

2015-01-30T15:32:26+13:00 (9 years ago)

Author:

Jeremy Symon

Message:

Updated package generation readme

File:

• main/trunk/package-kits/linux/ReadMe (modified) (5 diffs)

main/trunk/package-kits/linux/ReadMe

@@ +1 @@
+Generating:
+    Run './generate' to generate build scripts
+        (prints further usage instructions)
+
+Required Packages:
+    Packages required to build Greenstone are defined in the Greenstone package
+    build scripts, however you will also need the necessary packages for
+    building packages on your current distro.
+    These are:
+        Ubuntu: build-essential, debhelper
+        Arch:   base-devel, <check this>
+        Fedora: <fill out>
+
+Building:
+    Generated packages are found in ./build/<distro>/<package>
+    To build a package, run 'make' in the package directory.
+    If building a package requires other packages to be installed, they may be
+    automatically installed, or if not they should be printed to the terminal.
+    To build all packages, cd into ./build/<distro>/, and run
+        for pkg in *; do test -d $pkg && pushd $pkg && make; popd; done
+    I recommend only doing this if you know all the packages will build
+    successfully.
+
 Patches:
     To generate a patch:
@@ -4 +27 @@
     To apply a patch:
         patch -p0 -i package.patch
-        where -p0 assumes the paths in the patch are valid in the current directory
+        where -p0 assumes the paths in the patch are valid in the current
+        directory
 
     gs2build.patch
@@ -11 +35 @@
     perl-util.patch
         Contains a patch to change the tmp folder for gs2build
-        This is necessary because the original location of the tmp folder was in the gs2build folder, which contains executables, and as such should be read-only.
+        This is necessary because the original location of the tmp folder was
+        in the gs2build folder, which contains executables, and as such should
+        be read-only.
         Thus the tmp folder has been changed to /tmp/greenstone-build
 
@@ -20 +46 @@
         Runs greenstone to set up the environment, then runs GLI
     wvWare
-        Removes itself from $PATH, then runs wvWare (which will be the system wvWare)
+        Removes itself from $PATH, then runs wvWare (which will be the system
+        wvWare)
 
 Gotchas:
@@ -29 +56 @@
 Issues:
     Debian package has lots of warnings
+    Pacman package has lots of file ownership warnings when updating
+        (because we chown the web directory)
+        Maybe chown it back to root in a pre-update script?