@@ -5,6 +5,7 @@

 xcuserdata/

 project.xcworkspace/

 *.old

+*.exe

 .bootstrap.auto/

 .bootstrap.local/

 dependencies/

@@ -13,3 +14,5 @@ tmp/

 research/

 addictions/

 mulle-tests/

+tests/include/

+tests/lib/

new file mode 100644

@@ -0,0 +1,22 @@

+language: c

+

+dist: precise

+

+addons:

+  apt:

+    sources:

+      - george-edison55-precise-backports # cmake 3.2.3 / doxygen 1.8.3

+    packages:

+      - cmake

+      - cmake-data

+

+before_install:

+   - git clone https://github.com/Linuxbrew/brew.git ~/.linuxbrew

+   - PATH="$HOME/.linuxbrew/bin:$PATH"

+   - brew update

+   - brew tap mulle-kybernetik/software

+   - brew install mulle-build

+

+script:

+   - mulle-build

+   - mulle-test

@@ -1,36 +1,79 @@

 # mulle-vararg

-A variable argument passing scheme used written in C (C11).

+A variable argument passing scheme written in C (C11).

+

 ## How it works

-### Remember the C argument promotion rules

+**mulle-vararg** assumes that the arguments are not layed out in stack

+alignment fashion but like in a struct. The C promotion rules are still

+observed though.

-1. char and short to int/unsigned int

-2. float to double

+> Remember the C argument promotion rules are

+>

+> 1. char and short to int/unsigned int

+> 2. float to double

+>

-### The arguments are layed out struct-like

+Let's assume there is a compiler that does not use `<stdarg.h>` variable

+arguments but **mulle-vararg** instead. It collects all arguments and packs

+them into a struct, then passes this struct to the function.

-A method like `stringWithFormat:(NSString *) format, ...`

-which is called like this

+A **printf** function being being called like this:

 ```

-[NSString stringWithFormat:@"%d %f %lld", (char) 'x', (float) 0.2, 1848LL];

+printf( "%d %f %lld\n", (char) 'x', (float) 0.2, 1848LL;

 ```

-could access the arguments as if they were embedded in a struct like this

+would access the arguments, as if they were embedded in a struct like this

 ```

 struct

 {

-   NSString  *format;

+   char    *format;

    struct

    {

-      int         value1;

-      double      value2;

+      int         value1;     // standard char -> int promotion

+      double      value2;     // standard float -> double promotion

       long long   value3;

    } varargs;

 } _param;

 ```

-But accessing those values, that's what mulle-vararg does for you.

+**mulle-vararg** provides the necessary functions to read such a struct. It has

+no code to create it.

+

+

+## Install

+

+On OS X and Linux you can use [homebrew](//brew.sh), respectively

+[linuxbrew](//linuxbrew.sh) to install the library:

+

+```

+brew tap mulle-kybernetik/software

+brew install mulle-vararg

+```

+

+On other platforms you can use **mulle-install** from

+[mulle-build](//www.mulle-kybernetik.com/software/git/mulle-build) to install the library:

+

+```

+mulle-install --prefix /usr/local --branch release https://www.mulle-kybernetik.com/repositories/mulle-vararg

+```

+

+

+Otherwise read:

+

+* [How to Build](dox/BUILD.md)

+

+

+## API

+

+* [Vararg](dox/API_VARARG.md)

+

+

+### Platforms and Compilers

+

+All platforms and compilers supported by

+[mulle-c11](//www.mulle-kybernetik.com/software/git/mulle-c11/)

+

deleted file mode 100755

@@ -1,68 +0,0 @@

-#! /bin/sh

-#

-# Generate a formula for mulle-thread

-#

-PROJECT=MulleVararg  # ruby requires camel-case

-TARGET=mulle-vararg

-HOMEPAGE="http://www.mulle-kybernetik.com/software/git/${TARGET}"

-DESC="Variable arguments using offset() and sizeof()"

-

-VERSION="$1"

-[ $# -eq 0 ] || shift

-ARCHIVEURL="${1:-http://www.mulle-kybernetik.com/software/git/${TARGET}/tarball/$VERSION}"

-[ $# -eq 0 ] || shift

-

-set -e

-

-[ "$VERSION" = "" ] && exit 1

-[ "$ARCHIVEURL" = "" ] && exit 1

-

-

-TMPARCHIVE="/tmp/${TARGET}-${VERSION}-archive"

-

-if [ ! -f "${TMPARCHIVE}" ]

-then

-   curl -L -o "${TMPARCHIVE}" "${ARCHIVEURL}"

-   if [ $? -ne 0 -o ! -f "${TMPARCHIVE}" ]

-   then

-      echo "Download failed" >&2

-      exit 1

-   fi

-else

-   echo "using cached file ${TMPARCHIVE} instead of downloading again" >&2

-fi

-

-#

-# anything less than 17 KB is wrong

-#

-size="`du -k "${TMPARCHIVE}" | awk '{ print $ 1}'`"

-if [ $size -lt 17 ]

-then

-   echo "Archive truncated or missing" >&2

-   cat "${TMPARCHIVE}" >&2

-   rm "${TMPARCHIVE}"

-   exit 1

-fi

-

-HASH="`shasum -p -a 256 "${TMPARCHIVE}" | awk '{ print $1 }'`"

-

-cat <<EOF

-class ${PROJECT} < Formula

-  homepage "${HOMEPAGE}"

-  desc "${DESC}"

-  url "${ARCHIVEURL}"

-  version "${VERSION}"

-  sha256 "${HASH}"

-

-  depends_on 'mulle-c11'

-  depends_on 'mulle-build' => :build

-

-  def install

-     system "mulle-install", "-e", "--prefix", "#{prefix}"

-  end

-

-  test do

-  end

-end

-# FORMULA ${TARGET}.rb

-EOF

new file mode 100755

@@ -0,0 +1,231 @@

+#! /bin/sh

+#

+#

+#

+

+generate_brew_formula()

+{

+   local project

+   local target

+   local homepage

+   local desc

+   local version

+   local archiveurl

+   local dependencies

+

+   project="$1"

+   shift

+   target="$1"

+   shift

+   homepage="$1"

+   shift

+   desc="$1"

+   shift

+   version="$1"

+   shift

+   archiveurl="$1"

+   shift

+   dependencies="$1"

+   shift

+

+   [ -z "${version}" ] && exit 1

+   [ -z "${archiveurl}" ] && exit 1

+

+   local tmparchive

+

+   tmparchive="/tmp/${target}-${version}-archive"

+

+   if [ ! -f "${tmparchive}" ]

+   then

+      exekutor curl -L -o "${tmparchive}" "${archiveurl}"

+      if [ $? -ne 0 -o ! -f "${tmparchive}" ]

+      then

+         echo "Download failed" >&2

+         exit 1

+      fi

+   else

+      echo "using cached file ${tmparchive} instead of downloading again" >&2

+   fi

+

+   #

+   # anything less than 17 KB is wrong

+   #

+   size="`exekutor du -k "${tmparchive}" | exekutor awk '{ print $ 1}'`"

+   if [ $size -lt 17 ]

+   then

+      echo "Archive truncated or missing" >&2

+      cat "${tmparchive}" >&2

+      rm "${tmparchive}"

+      exit 1

+   fi

+

+   local hash

+

+   hash="`exekutor shasum -p -a 256 "${tmparchive}" | exekutor awk '{ print $1 }'`"

+

+   exekutor cat <<EOF

+class ${project} < Formula

+   homepage "${homepage}"

+   desc "${desc}"

+   url "${archiveurl}"

+   version "${version}"

+   sha256 "${hash}"

+

+EOF

+

+IFS="

+"

+   for dependency in ${dependencies}

+   do

+      exekutor echo "   depends_on '${dependency}'"

+      shift

+   done

+   IFS="${DEFAULT_IFS}"

+

+   exekutor cat <<EOF

+   depends_on 'mulle-build' => :build

+

+   def install

+      system "mulle-install", "-e", "--prefix", "#{prefix}"

+   end

+

+   test do

+      system "mulle-test"

+   end

+end

+# FORMULA ${TARGET}.rb

+EOF

+}

+

+

+#

+# Boiler plate code from here on. Could put this into a convenient

+# location somewhere (mulle-homebrew ?)

+# From now on need:

+#    TAG

+#    HOMEBREWTAP

+#    RBFILE

+#    ORIGIN

+get_header_version()

+{

+   local filename

+

+   filename="$1"

+   fgrep "${VERSIONNAME}" "${filename}" | \

+   sed 's|(\([0-9]*\) \<\< [0-9]*)|\1|g' | \

+   sed 's|^.*(\(.*\))|\1|' | \

+   sed 's/ | /./g'

+}

+

+

+git_must_be_clean()

+{

+   local name

+   local clean

+

+   name="${1:-${PWD}}"

+

+   if [ ! -d .git ]

+   then

+      fail "\"${name}\" is not a git repository"

+   fi

+

+   clean=`git status -s --untracked-files=no`

+   if [ "${clean}" != "" ]

+   then

+      fail "repository \"${name}\" is tainted"

+   fi

+}

+

+

+# Parameters!

+#

+# ORIGIN

+# TAG

+#

+git_main()

+{

+   local origin

+   local tag

+

+   origin="$1"

+   shift

+   tag="$1"

+   shift

+

+   exekutor git_must_be_clean || exit 1

+

+   local branch

+

+   branch="`exekutor git rev-parse --abbrev-ref HEAD`"

+

+   #

+   # make it a release

+   #

+   exekutor git checkout -B release  || exit 1

+   exekutor git rebase "${branch}"   || exit 1

+

+   # if rebase fails, we shouldn't be hitting tag now

+   exekutor git tag "${tag}"         || exit 1

+

+   exekutor git push "${origin}" release --tags  || exit 1

+   exekutor git push github release --tags       || exit 1

+

+   exekutor git checkout "${branch}"          || exit 1

+   exekutor git push "${origin}" "${branch}"  || exit 1

+}

+

+

+#

+# Expected environment!

+# PROJECT

+# NAME

+# VERSION

+# HOMEPAGE

+# DESC

+# DEPENDENCIES

+# HOMEBREWTAP

+# RBFILE

+#

+homebrew_main()

+{

+   ARCHIVEURL="`eval echo "${ARCHIVEURL}"`"

+

+   redirect_exekutor "${HOMEBREWTAP}/${RBFILE}" \

+      generate_brew_formula "${PROJECT}" \

+                            "${NAME}" \

+                            "${HOMEPAGE}" \

+                            "${DESC}" \

+                            "${VERSION}" \

+                            "${ARCHIVEURL}" \

+                            "${DEPENDENCIES}" || exit 1

+   (

+      exekutor cd "${HOMEBREWTAP}" ;

+      exekutor git add "${RBFILE}" ;

+      exekutor git commit -m "${VERSION} release of ${NAME}" "${RBFILE}" ;

+      exekutor git push origin master

+   )  || exit 1

+}

+

+

+homebrew_initialize()

+{

+   local directory

+

+   if [ -z "${DEFAULT_IFS}" ]

+   then

+      DEFAULT_IFS="${IFS}"

+   fi

+

+   directory="`mulle-bootstrap library-path 2> /dev/null`"

+   [ ! -d "${directory}" ] && echo "failed to locate mulle-bootstrap library" >&2 && exit 1

+   PATH="${directory}:$PATH"

+

+   . "mulle-bootstrap-logging.sh"

+   . "mulle-bootstrap-functions.sh"

+

+   [ ! -d "${HOMEBREWTAP}" ] && fail "failed to locate \"${HOMEBREWTAP}\""

+}

+

+homebrew_initialize

+

@@ -1,79 +1,41 @@

-#! /bin/sh

+#! /bin/sh -x

+#

+# These variables have to be configured on a by project basis

+#

 NAME="mulle-vararg"  # not the ruby name

+DESC="Access variable arguments in struct layout fashion"

+PROJECT=MulleVararg  # ruby requires camel-case

 HEADER="src/mulle_vararg.h"

 VERSIONNAME="MULLE_VARARG_VERSION"

 ORIGIN=public

+DEPENDENCIES=

+HOMEPAGE="https://www.mulle-kybernetik.com/software/git/${NAME}"

 RBFILE="${NAME}.rb"

 HOMEBREWTAP="../homebrew-software"

-

-get_version()

-{

-   local filename

-

-   filename="$1"

-   fgrep "${VERSIONNAME}" "${filename}" | \

-   sed 's|(\([0-9]*\) \<\< [0-9]*)|\1|g' | \

-   sed 's|^.*(\(.*\))|\1|' | \

-   sed 's/ | /./g'

-}

-

-VERSION="`get_version ${HEADER}`"

-TAG="${1:-${VERSION}}"

-

-

-directory="`mulle-bootstrap library-path 2> /dev/null`"

-[ ! -d "${directory}" ] && echo "failed to locate mulle-bootstrap library" >&2 && exit 1

-

-PATH="${directory}:$PATH"

-

-. "mulle-bootstrap-logging.sh"

+# ARCHIVEURL will be evaled later! keep it in single quotes

+ARCHIVEURL='https://www.mulle-kybernetik.com/software/git/${NAME}/tarball/${VERSION}'

-git_must_be_clean()

+main()

 {

-   local name

-   local clean

+   # source it

+   . ./bin/mulle-homebrew/mulle-homebrew.sh

-   name="${1:-${PWD}}"

+   local VERSION  #  upper case for consistency in eval

+   local TAG

-   if [ ! -d .git ]

-   then

-      fail "\"${name}\" is not a git repository"

-   fi

+   #

+   # Version has to be figured out on a per project basis

+   # get_header_version grabs the version from a header

+   #

+   VERSION="`get_header_version ${HEADER}`"

+   TAG="${1:-${VERSION}}"

-   clean=`git status -s --untracked-files=no`

-   if [ "${clean}" != "" ]

-   then

-      fail "repository \"${name}\" is tainted"

-   fi

+   git_main "${ORIGIN}" "${TAG}" || exit 1

+   homebrew_main || exit 1

 }

-

-[ ! -d "${HOMEBREWTAP}" ] && fail "failed to locate \"${HOMEBREWTAP}\""

-

-set -e

-

-git_must_be_clean

-

-branch="`git rev-parse --abbrev-ref HEAD`"

-

-git push "${ORIGIN}" "${branch}"

-

-# seperate step, as it's tedious to remove tag when

-# previous push fails

-

-git tag "${TAG}"

-git push "${ORIGIN}" "${branch}" --tags

-

-./bin/generate-brew-formula.sh "${VERSION}" > "${HOMEBREWTAP}/${RBFILE}"

-(

-   cd "${HOMEBREWTAP}" ;

-   git add "${RBFILE}" ;

-   git commit -m "${TAG} release of ${NAME}" "${RBFILE}" ;

-   git push origin master

-)

-

-git checkout "${branch}"

+main "$@"