Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/daniel-thompson/librfn

A general utility library from redfelineninja.org.uk
https://github.com/daniel-thompson/librfn

Last synced: about 2 months ago
JSON representation

A general utility library from redfelineninja.org.uk

Awesome Lists containing this project

README

        

librfn - A general utility library
==================================

librfn is a collection of small library utilities collected whilst writing
"stuff" in C and wondering why I was writing the same type of code over and
over again.

It is neither organised nor comprehensive. Instead it is a pick 'n choose
library. If you like the code (and the license) use it. Either by copying the
raw C files into your application or, perhaps better, but integrating librfn
into your git project as either a submodule or subtree.

For library documentation see http://daniel-thompson.github.io/librfn .

Building
--------

Generally speaking librfn expects to be built using the build system of
whatever project it has been integrated into. It has no real dependancies (even
the code the assumes a POSIX OS is fairly clearly separated). It does however
has a simple build system based on the standard GNU autotools in order to allow
the demos and tests to be run from the librfn repo.

Try:

./configure
make
make check
src/fibredemo

If you obtained librfn via git you must generate the configure script and
Makefile templates first:

autoreconf -i

Integrating as a sub-module
---------------------------

Try:

mkdir mycoolapp && cd mycoolapp && git init .
git submodule add https://github.com/daniel-thompson/librfn.git

Integrating as a sub-tree
-------------------------

Try:

mkdir mycoolapp && cd mycoolapp && git init .
git remote add -f librfn https://github.com/daniel-thompson/librfn.git
git subtree add --prefix librfn librfn master --squash

To update to the latest version of librfn:

git fetch librfn master
git subtree pull --prefix librfn librfn master --squash

For some idea of the benefits of subtree over submodule see:
http://blogs.atlassian.com/2013/05/alternatives-to-git-submodule-git-subtree/