Changes between Version 4 and Version 5 of HaikuPorterForPM/BuildRecipes

Timestamp:

06/12/13 05:04:33 (2 years ago)

Author:

zooey

Comment:

--

HaikuPorterForPM/BuildRecipes

@@ -391 +391 @@
 }}}
 
-== Example ==
-
-...TODO...
+== Examples ==
+
+=== A simple example ===
+
+This is the build recipe for `gawk`, which is rather generic. It provides two commands (one of which is just a symlink to the other) and it just requires Haiku for execution.
+
+{{{
+SUMMARY="A pattern scanning and processing language" 
+DESCRIPTION="
+        If you are like many computer users, you would frequently like to make 
+        changes in various text files wherever certain patterns appear, or 
+        extract data from parts of certain lines while discarding the rest. To 
+        write a program to do this in a language such as C or Pascal is a 
+        time-consuming inconvenience that may take many lines of code. The job 
+        is easy with awk, especially the GNU implementation: gawk.
+
+        The awk utility interprets a special-purpose programming language that 
+        makes it possible to handle simple data-reformatting jobs with just a 
+        few lines of code.
+        "
+HOMEPAGE="http://www.gnu.org/software/coreutils" 
+SRC_URI="http://ftp.gnu.org/gnu/gawk/gawk-3.1.8.tar.bz2"
+CHECKSUM_MD5="52b41c6c4418b3226dfb8f82076193bb"
+LICENSE="GNU GPL v3"
+COPYRIGHT="1983-2010 Free Software Foundation, Inc."
+REVISION="2"
+ARCHITECTURES="x86_gcc2 ?x86"
+
+PROVIDES="
+        gawk = $portVersion compat >= 3
+        cmd:awk = $portVersion compat >= 3
+        cmd:gawk = $portVersion compat >= 3
+        "
+REQUIRES="
+        haiku >= $haikuVersion
+        "
+BUILD_REQUIRES="
+        "
+BUILD_PREREQUIRES="
+        haiku_devel >= $haikuVersion
+        cmd:gcc
+        cmd:ld
+        cmd:libtoolize
+        cmd:make
+        cmd:sed
+        "
+
+SOURCE_DIR="$portVersionedName"
+
+BUILD()
+{
+        libtoolize --force --copy --install
+        ./configure $configureDirArgs
+        make
+}
+
+INSTALL()
+{
+        make install
+}
+
+TEST()
+{
+        make check
+}
+}}}
+
+=== An advanced example ===
+
+This is the build recipe for `git`, which depends on a number of other packages at both build- and runtime. Additionally, git provides a number of general sibling packages.
+
+{{{
+SUMMARY="Fast, scalable, distributed revision control system"
+DESCRIPTION="
+        Git is a free and open source distributed version control system designed 
+        to handle everything from small to very large projects with speed and 
+        efficiency.
+
+        Git is easy to learn and has a tiny footprint with lightning fast 
+        performance. It outclasses SCM tools like Subversion, CVS, Perforce, 
+        and ClearCase with features like cheap local branching, convenient 
+        staging areas, and multiple workflows.
+        " 
+HOMEPAGE="http://git-scm.com/" 
+LICENSE="GNU GPL v2"
+COPYRIGHT="2005-2012 Git Authors (see git web site for list)"
+
+SRC_URI="http://git-core.googlecode.com/files/git-1.7.10.2.tar.gz"
+CHECKSUM_MD5="2e2ee53243ab8e7cf10f15c5229c3fce"
+SOURCE_DIR="$portVersionedName"
+PATCHES="git-1.7.10.2.patch"
+
+SRC_URI_2="http://git-core.googlecode.com/files/git-manpages-1.7.10.2.tar.gz"
+CHECKSUM_MD5_2="79bae5456db8366803d28db867892d74"
+
+SRC_URI_3="http://git-core.googlecode.com/files/git-htmldocs-1.7.10.2.tar.gz"
+CHECKSUM_MD5_3="9c401a36aee40d68f5ca3513818e8f29"
+
+REVISION="2"
+
+ARCHITECTURES="x86_gcc2 ?x86"
+
+PROVIDES="
+        git = $portVersion compat >= 1.7
+        cmd:git = $portVersion compat >= 1.7
+        cmd:git_receive_pack = $portVersion compat >= 1.7
+        cmd:git_shell = $portVersion compat >= 1.7
+        cmd:git_upload_archive = $portVersion compat >= 1.7
+        cmd:git_upload_pack = $portVersion compat >= 1.7
+        "
+PROVIDES_arch="
+        git_arch = $portVersion compat >= 1.7
+        cmd:git_archimport = $portVersion compat >= 1.7
+        "
+PROVIDES_cvs="
+        git_cvs = $portVersion compat >= 1.7
+        cmd:git_cvsserver = $portVersion compat >= 1.7
+        "
+PROVIDES_daemon="
+        git_daemon = $portVersion compat >= 1.7
+        cmd:git_daemon = $portVersion compat >= 1.7
+        "
+PROVIDES_email="
+        git_email = $portVersion compat >= 1.7
+        cmd:git_send_email = $portVersion compat >= 1.7
+        "
+PROVIDES_source="
+        git_source = $portVersion compat >= 1.7
+        "
+PROVIDES_svn="
+        git_svn = $portVersion compat >= 1.7
+        cmd:git_svn = $portVersion compat >= 1.7
+        "
+
+REQUIRES="
+        haiku >= $haikuVersion
+        curl
+        expat
+        man
+        openssl
+        perl
+        python
+        zlib
+        cmd:nano
+        "
+REQUIRES_arch="
+        haiku >= $haikuVersion
+        git == $portVersion
+        "
+REQUIRES_cvs="
+        haiku >= $haikuVersion
+        git == $portVersion
+        "
+REQUIRES_daemon="
+        haiku >= $haikuVersion
+        git == $portVersion
+        "
+REQUIRES_email="
+        haiku >= $haikuVersion
+        git == $portVersion
+        "
+REQUIRES_svn="
+        haiku >= $haikuVersion
+        git == $portVersion
+        "
+        
+BUILD_REQUIRES="
+        $REQUIRES
+        cmd:gcc
+        cmd:ld
+        cmd:make
+        cmd:sed
+        cmd:tar
+        "
+BUILD_PREREQUIRES="
+        haiku_devel >= $haikuVersion
+        "
+
+BUILD()
+{
+        make
+}
+
+INSTALL()
+{
+        make strip 
+        make install
+        
+        # replace copies of git binaries with symlinks
+        cd $prefix/bin
+        for program in git*; do 
+                ln -sfn "../lib/git-core/$program" "$program"
+        done
+
+        # copy manpages
+        mkdir -p $manDir
+        cp -rd $sourceDir2/* $manDir/
+
+        # copy html documentation
+        htmlDir=$docDir/html
+        mkdir -p $htmlDir
+        cp -rd $sourceDir3/*.html $htmlDir/
+        rm $htmlDir/git-gui.html
+
+        # copy asciidoc documentation for which there isn't any corresponding html
+        asciidocDir=$docDir/asciidoc
+        mkdir -p $asciidocDir
+        for f in $sourceDir3/*.txt; do
+                html=$sourceDir3/$(basename $f .txt).html
+                if ! [ -e $html ]; then
+                        cp -d $f $asciidocDir/
+                fi
+        done
+        
+        packageEntries arch \
+                documentation/packages/git/html/git-archimport.html \
+                documentation/man/man1/git-archimport.1 \
+                lib/git-core/git-archimport
+                
+        packageEntries cvs \
+                bin/git-cvsserver \
+                documentation/packages/git/html/git-cvsexportcommit.html \
+                documentation/packages/git/html/git-cvsimport.html \
+                documentation/packages/git/html/git-cvsserver.html \
+                documentation/man/man1/git-cvsexportcommit.1 \
+                documentation/man/man1/git-cvsimport.1 \
+                documentation/man/man1/git-cvsserver.1 \
+                documentation/man/man7/gitcvs-migration.7 \
+                lib/git-core/git-cvsexportcommit \
+                lib/git-core/git-cvsimport \
+                lib/git-core/git-cvsserver
+        
+        packageEntries daemon \
+                documentation/packages/git/html/git-credential-cache--daemon.html \
+                documentation/packages/git/html/git-credential-cache.html \
+                documentation/packages/git/html/git-daemon.html \
+                documentation/man/man1/git-credential-cache--daemon.1 \
+                documentation/man/man1/git-credential-cache.1 \
+                documentation/man/man1/git-daemon.1 \
+                lib/git-core/git-credential-cache--daemon \
+                lib/git-core/git-credential-cache \
+                lib/git-core/git-daemon
+                
+        packageEntries email \
+                documentation/packages/git/html/git-send-email.html \
+                documentation/man/man1/git-send-email.1 \
+                lib/git-core/git-send-email
+                
+        packageEntries svn \
+                documentation/packages/git/html/git-svn.html \
+                documentation/man/man1/git-svn.1 \
+                lib/git-core/git-svn
+}
+}}}