Directory dependent history and environment, version 2

• REPOBASE — The projects root directory.
• TOPPROJECT — This environment variable is only set for standalone projects. Library projects usually don't define this.
• GIT_AUTHOR_EMAIL, GIT_AUTHOR_NAME, GIT_COMMITTER_EMAIL, GIT_COMMITTER_NAME — Set to the identity to use for that project.
• CFLAGS, CXXFLAGS, CPPFLAGS, LDFLAGS — Whatever is appropriate to use for this project. These environment variables are usually used by configure and/or the Makefile.
• CCACHE_DIR — All my non-standard compilers (installed with --prefix=/usr/local/gcc-$COMPILER_VERSION) are actually scripts, which use ccache when this environment variable is set.
• INSTALL_PREFIX — The install prefix used to configure the project. This is dependend on the compiler version, so that libraries and applications compiled with a specific compiler version will only use eachother (and whatever is installed as part of the Operating System when the library is not available in INSTALL_PREFIX).
• PKG_CONFIG_PATH — Used by pkg-config(1), used in many ./configure scripts.
• PATH — Updated to include the INSTALL_PREFIX.
• LD_LIBRARY_PATH — Updated to include the INSTALL_PREFIX.
• CONFIGURE_OPTIONS — The default configure options to use for this project.
• OUTPUT_DIRECTORY — Where doxygen has to write the documentation to.
• CTAGS_ROOT_SRCDIRS — Additions source dirs for ctags that this project should use. This is being used by some (standarized) entry in my Makefiles.

The following aliases are defined:

• s — This should print all source files of the project. It is mainly used from the command line to grep all sources. For example, to list all source files that use some class name ServerSession, I'd type: grep -l ServerSession `s` without being bothered by where all the source files of this particular project are.
• vi — This alias is redefined in order to tell vim where the tag files for this particular project can be found (as generated with ctags(1)).
• syncwww — Whenever a project contains documentation, the alias syncwww is defined to whatever command needs to be executed to export this documentation, synchronizing the documentation of the current project with the external (public) web pages. Again, not bothering me anymore with project specific details.

The following functions are defined:

• configure — usually, configure () { pushd "$REPOBASE-objdir"; $REPOBASE/configure $CONFIGURE_OPTIONS && echo "Configured with $CONFIGURE_OPTIONS."; popd }
• make — usually, make () { CURDIR=$(pwd); CPUS=`grep '^processor' /proc/cpuinfo | wc --lines`; not_done=1; while [ $not_done -eq 1 ]; do not_done=0; case $1 in -j) shift; CPUS=$1; shift; not_done=1 ;; maintainer-clean) /usr/bin/make -C $REPOBASE-objdir maintainer-clean; cd $REPOBASE && ./autogen.sh ;; ctags | tags) cd $REPOBASE-objdir && ctags --language-force=C++ --regex-C++='/(^|[[:space:];{])using[[:space:]]+([[:alnum:]_]*)[[:space:]]*=/\2/' `s` ;; *) /usr/bin/make -C $REPOBASE-objdir -j $CPUS $@ ;; esac; done; cd $CURDIR }

As an example, the following is my env.source file as used for my cwchessboard project:

  export TOPPROJECT=/home/carlo/projects/cwchessboard
  source $TOPPROJECT/env.compiler
  
  CPPFLAGS=
  LDFLAGS=
  CFLAGS=-g3
  CXXFLAGS=-g3
  
  export CPPFLAGS LDFLAGS CFLAGS CXXFLAGS
  
  # These two are helper variables.
  GCCVER=`$CXX -v 2>&1 | grep '^gcc[ -][Vv]ersion' | sed -e 's/gcc[ -][Vv]ersion //' -e 's/ (.*//' -e 's/ /-/g'`
  INSTALL_PREFIX="/usr/local/install/$GCCVER"
  
  PKG_CONFIG_PATH="$INSTALL_PREFIX/lib/pkgconfig"
  del_path .
  pre_path "$INSTALL_PREFIX/bin"
  pre_path .
  pre_path "$INSTALL_PREFIX/lib" LD_LIBRARY_PATH
  
  export PKG_CONFIG_PATH PATH LD_LIBRARY_PATH INSTALL_PREFIX
  
  alias s='ls $TOPPROJECT/cwchessboard/*.cc $TOPPROJECT/cwchessboard/*.h'
  alias vi='vim -c "set tags=$TOPPROJECT/cwchessboard-objdir/tags"'
  
  export CONFIGURE_OPTIONS="--enable-maintainer-mode --enable-debug --prefix=$INSTALL_PREFIX"
  export OUTPUT_DIRECTORY=/home/carlo/www
  export CTAGS_ROOT_SRCDIRS="/usr/src/gtk/glib-current /usr/src/gtk/gtk+-current"

While a C++ library project, like libcwd, does not set TOPPROJECT, it can use TOPPROJECT to change, for instance, the configure options. This project also defines the alias syncwww:

  source $TOPPROJECT/env.compiler
  
  export GIT_COMMITTER_NAME="Carlo Wood"
  export GIT_COMMITTER_EMAIL="carlo@alinoe.com"
  export GIT_AUTHOR_NAME="Carlo Wood"
  export GIT_AUTHOR_EMAIL="carlo@alinoe.com"
  
  export OUTPUT_DIRECTORY="/home/carlo/www"
  export REPOBASE="/home/carlo/projects/libcwd/libcwd"
  
  # These two are helper variables.
  GCCVER=`$CXX -v 2>&1 | grep '^gcc[ -][Vv]ersion' | sed -e 's/gcc[ -][Vv]ersion //' -e 's/ (.*//' -e 's/ /-/g'`
  INSTALL_PREFIX="/usr/local/install/$GCCVER"
  
  if test "$TOPPROJECT" = "/opt/secondlife/viewers"; then
  if test "$(pwd)" = "$REPOBASE-objdir32"; then
    INSTALL_PREFIX="/sl/i386-linux-gnu/usr"
    CXXFLAGS=-m32
  else
    INSTALL_PREFIX="/sl/x86_64-linux-gnu/usr"
    CXXFLAGS=
  fi
  fi
  
  CPPFLAGS=
  LDFLAGS=
  CFLAGS=
  
  export CPPFLAGS LDFLAGS CFLAGS CXXFLAGS
  
  PKG_CONFIG_PATH="$INSTALL_PREFIX/lib/pkgconfig"
  pre_path "$INSTALL_PREFIX/bin"
  pre_path "$INSTALL_PREFIX/lib" LD_LIBRARY_PATH
  
  export PKG_CONFIG_PATH PATH LD_LIBRARY_PATH
  
  alias s="ls $REPOBASE/*.cc $REPOBASE/include/*.h $REPOBASE/include/libcwd/*.h $REPOBASE/include/libcwd/*.inl $REPOBASE/utils/*.cc"
  alias vi='vim -c "set tags=$REPOBASE-objdir/tags,$REPOBASE-objdir/include/tags,$REPOBASE-objdir/include/libcwd/tags,$REPOBASE-objdir/utils/tags"'
  alias syncwww='rsync -rltz -e /usr/bin/ssh --delete --exclude-from=$REPOBASE-objdir/documentation/www/exclude --verbose $REPOBASE-objdir/documentation/ libcwd-shell:"~/libcwd.www/htdocs"'
  
  export CONFIGURE_OPTIONS="--enable-maintainer-mode --prefix=$INSTALL_PREFIX"
  
  # Compiler colorization.
  add_path /usr/src/crror/crror
  export GOPATH=~/golang
  
  BASENAME=`basename "$TOPPROJECT"`
  if [ "$BASENAME" == ircproxy -o "$BASENAME" == cppgraph ]; then
    CONFIGURE_OPTIONS="$CONFIGURE_OPTIONS --disable-threading"
  fi
  if [ "$BASENAME" == viewers ]; then
    CONFIGURE_OPTIONS="$CONFIGURE_OPTIONS --disable-nonthreading --disable-alloc --disable-location --enable-optimize"
  fi
  if [ "$BASENAME" == slavatar ]; then
    CONFIGURE_OPTIONS="$CONFIGURE_OPTIONS --disable-alloc --enable-optimize"
  fi
  if [ "$BASENAME" == "speech" ]; then
    CONFIGURE_OPTIONS="$CONFIGURE_OPTIONS --disable-location --enable-optimize"
  fi
  if [ "$BASENAME" == "Firmware" ]; then
    CONFIGURE_OPTIONS="$CONFIGURE_OPTIONS --disable-alloc --disable-optimize"
  fi
  if [ "$BASENAME" == "aicxx" ]; then
    CONFIGURE_OPTIONS="$CONFIGURE_OPTIONS --enable-optimize"
  fi
  if [ "$BASENAME" == "memorymodel" ]; then
    CONFIGURE_OPTIONS="$CONFIGURE_OPTIONS --disable-alloc --disable-location --enable-optimize"
  fi