#
#  C Object System
#  COS README
# 
#  Copyright 2007+ Laurent Deniau <laurent.deniau@gmail.com>
# 
#  Licensed under the Apache License, Version 2.0 (the "License");
#  you may not use this file except in compliance with the License.
#  You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
# 
#  Unless required by applicable law or agreed to in writing, software
#  distributed under the License is distributed on an "AS IS" BASIS,
#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#  See the License for the specific language governing permissions and
#  limitations under the License.
#

*** IMPORTANT: The C Object System requires GNU make 3.80 or higher ***

Documentation:
--------------

paper and presentation can be found in
path-to-cos/doc/

or after installation to
$(PREFIX)/$(DOCDIR)/cos/

or on arXiv.org

Project information:
--------------------

  - web page: http:/cern.ch/laurent.deniau/cos.html
  - web site: http:/sf.net/projects/cos
  - contact : laurent.deniau@cern.ch

Makefile examples:
------------------

# distrib
path-to-cos/Makefile

# library
path-to-cos/CosBase/Makefile

# program
path-to-cos/CosBase/examples/ex??/Makefile

# tests (program with auto-run)
path-to-cos/CosBase/tests/Makefile

Debugging makefiles:
--------------------

make [target] SHOW=yes

# debug flags
SHOW will show the commands run

Code examples:
--------------

path-to-cos/CosBase/examples
path-to-cos/CosBase/tests

Supported platforms:
--------------------

note: platforms name are detected using the posix command "uname -s"

the list of supported platforms are in the directory
path-to-cos/CosBase/include/cos/cfg/

or after installation to
$(PREFIX)/$(INCDIR)/cos/cfg/

porting on Unixes/Posix compliant platform should be straightforward
porting on Windows requires some Posix-like environment (e.g. Mingw, Cygwin)

Tested platforms:
-----------------

# Systems & Architectures
Linux Ubuntu 8.04, 8.10, 9.04, 9.10 (Debian) on i386   (32-bit) Core2 Duo
Linux Ubuntu 8.04, 8.10, 9.04, 9.10 (Debian) on x86_64 (64-bit) Core2 Duo
Linux SLC 4.0, 5.0 (RedHat) on x86_64 (64-bit) Quad Xeon
Mac OS X Leopard (Darwin) on x86_64 (64-bit) Core2 Duo

# Compilers
gcc 3.2.3, 3.4.6, 4.1.2, 4.2.4, 4.3.2, 4.3.3

Other available platforms (untested):
-------------------------------------
SunOS + gcc
FreeBSD + gcc