[flint-devel] Brand spanking new FLINT-Lite GIT repository

[Bill H. <goo...@go...>]

Hi all,
I finally figured out how to set up a GIT repo on my new machine and publish
it to the web:

http://selmer.warwick.ac.uk/gitweb/FLINT-Lite.git

(See below if you are curious what this new FLINT-Lite thing is).

You can browse the commits online or even check out a tarball snapshot of
the latest.

If you want to clone this repo to your local machine and play around
(assuming you have git installed):

git clone git://selmer.warwick.ac.uk/FLINT-Lite.git FLINT-Lite

Don't forget to make a branch straight away to play with:

git branch mybranchname

To add files to your repo:

git add filename
git commit

When you make changes and want to commit them to your repo:

git commit -a

If you want to keep up with changes made in my git repo:

git pull

----------------------

FLINT-Lite : what is it?
================

FLINT-Lite is a new version of FLINT with some new features, but in a
nascent stage of development.

It contains the following:

* longlong.h - assembly code for x86_64 only

* profiler - for profiling code

* ulong_extras - provides functions for dealing with unsigned integers. All
functions deal with the full 64 bits (or where noted in special cases a full
53 bits).

Advantages of FLINT-Lite:
==================

* Every function is in a different file and every module in a different
directory

* Every function has a corresponding .txt file in the doc directory

* Every function has a corresponding test function in the test directory

* To add a new function to FLINT-Lite is dead easy:

   - drop the new file in the directory corresponding to the module it
belongs to, e.g. /ulong_extras/mynewfn.c
   - add the new prototype to the relevant .h file in the top level source
directory, e.g. ulong_extras.h
   - drop a test function into the test directory, e.g.
/ulong_extras/test/t-mynewfn.c (you can just cut and paste from existing
test functions to make this easy)

That's it, you're done. You will find make library, make all, make check
will just Do The Right Thing without you having to even look at the
makefile.

* Every function is short and simple and documented, including sketches of
mathematical proofs where necessary

* FLINT-Lite is open for contribution!!

Disadvantages of FLINT-Lite:
====================+

* So far it only works on x86_64 (some changes to longlong.h and the test
code and a couple of functions would be required to port it to other
platforms)

* Obviously not all functions from FLINT are in FLINT-Lite yet

* Only builds with gcc at present

Feel like contributing to fix some of these things?

Also look at the todo.txt in the top level source directory for things that
haven't been done yet, but which might be interesting.

I'm about to move on to a new module, F_mpz, which will be similar to the
F_mpz module in FLINT 1. If anyone would like to work on ulong_extras or
another module (they are dead easy to add, simply move the Makefile from
ulong_extras into a new directory for the new module, add the doc, profile
and test subdirs and make all the obvious changes to the top level source
directory, such as listing your new directory in the list build directories
there).

I've also created a new google group: flint-devel

http://groups.google.co.uk/group/flint-devel?hl=en

Feel free to join!

Bill.