Read Me

                   ['dn "this is better i choreographed and dance in my live :)"
                                                           'project "Userlandia"
                                                              'codename "XanadU"
                                          'from "Barcelona, September 2004-2009"
                                                    'author "Mario Herrera Díaz"
                                                                 'aka "concorr"]


[banner "Welcome to\nUserlandia\nProject"]
********************************************************************************
__        __   _                            _
\ \      / /__| | ___ ___  _ __ ___   ___  | |_ __
 \ \ /\ / / _ \ |/ __/ _ \| '_ ` _ \ / _ \ | __/ _ \
  \ V  V /  __/ | (_| (_) | | | | | |  __/ | || (_) |
   \_/\_/ \___|_|\___\___/|_| |_| |_|\___|  \__\___/

 _   _               _                 _
| | | |___  ___ _ __| | __ _ _ __   __| (_) __ _
| | | / __|/ _ \ '__| |/ _` | '_ \ / _` | |/ _` |
| |_| \__ \  __/ |  | | (_| | | | | (_| | | (_| |
 \___/|___/\___|_|  |_|\__,_|_| |_|\__,_|_|\__,_|

 ____            _           _
|  _ \ _ __ ___ (_) ___  ___| |_
| |_) | '__/ _ \| |/ _ \/ __| __|
|  __/| | | (_) | |  __/ (__| |_
|_|   |_|  \___// |\___|\___|\__|
              |__/

********************************************************************************

Welcome to Userlandia Project (codename XanadU)
===============================================
*Userlandia* codename *XanadU* Project was  born in 2004 in Barcelona/Spain with
specific objectives.


Now Working
===========
- Systems and Toolchains

- Kernel

- Processes Loaders

- Ezine

- Standard Process Stream Format

- Shell Interpreter

- FrontEnd Manager


Get Sources
===========

Subversion
----------
[code 'command]
svn co https://userlandia.svn.sourceforge.net/svnroot/userlandia userlandia


Browse Sources
==============
[ref 'http]
http://userlandia.svn.sourceforge.net/viewvc/userlandia


Repository (way 'CRUX)
======================
[ref 'url]
https://userlandia.svn.sourceforge.net/svnroot/userlandia/repository


Affinity Links (sort by date)
=============================
- [ref 'url] http://vx.org.ua/29a

- [ref 'url] http://mikeux.dyndns.org

- [ref 'url] http://www.anarchyinthetubes.com

- [ref 'url] http://kyuba.org

- [ref 'url] http://piumarta.com


Support Links
=============
- [ref 'url] http://delicious.com/concorr


Project Description
===================
A _Userland  Platform_ that  includes an  input/output standard,  an  kernel and
other  operating  system tools  and  features.  High  portability  between other
platforms,  languages,  systems and  architectures.  The fhillosophy  involves a
permanent improvement, focushing on end users, simplicity and high performance.


Phillosophy and Features
========================
The  Userlandia   phillosophy  involves  a   permanent  improvement.   Features:
performance, usabitity,  communications,  stability,  portability, adaptability,
integration, simplicity, safety, security and hacks.


Software Development Kit (SDK)
==============================
Implementated  cross-platform  apis:  theads,  memory,  ipc/rpc,  diferents libc
cores (std, nostd),  sync,  real-time messages,  timers, Userlandia input/output
standard,   devices,   bridges,   security,   debug,  virtual  directory  (vfs),
networking and others.

C  is  the  original  implementation  language  (other  implementations  in  all
required languages programmation along the time).

Lisp dialects (scheme) for shell programming.


Processes and Loaders
=====================
Programmes that supports the  Userlandia standard of input/output specification.
All  can  be  programmated  with  any  programmation  language  that  permits to
implement the standard mentioned before.

A common console programme is a raw process.

An specific loader  is required according to executable  form process (elf,  pe,
lua bytecode,  lua plain  text,  java bytecode,  lisp,  scheme,  virtualized and
others).


Programmes Design
=================
The design  programme process is  as follows:  context/environment  design (data
structures),  operations design  (methods),  input/output design  (behavior) and
its state machine design.


Systems Toolchains
==================
SDK,  loaders, bridges and libs implementations has nowadays the following ports
(finished or in publication process): linux (x86_64,  arm, mips),  win32, wince,
osx and psp.  GNU gcc compiler, archiver and linker.


Integrated Development Environment (IDE)
========================================
Nowadays  codeblocks (http://www.codeblocks.org/downloads)  are used  as graphic
IDE.  The  codeblocks source  project file  (xml)  is  used  as  source  for xsl
transformations over  other source formats  for project  compilations (Makefile,
Pkgfile, ...).

Vim is used as console IDE (aka for all).

* Now icemake.sx is the main project format*.


Userland Kernel
===============
Userland Kernel  aims to detect  platform over it  is runned  and it  regist all
available  devices  over  its  virtual  filesystem,  be  apart  form  regist all
available device loaders.


Process Environments
====================
Comming Soon!


Bridges
=======
A bridge is  an input/output implementation of Userlandia  standard which uses a
specific communication behavior and technology.


IPC/RPC Device Messages
=======================
Comming Soon!


Systems Sysroots
================
Comming Soon!


Requirements
============
Userlandia require a Userlandia System Toolchain.


Userlandia Project License
==========================
BSD Like License

Copyright (c) 2004, 2005, 2006, 2007, 2008, 2009, Userlandia Project Members.
All rights reserved.

Redistribution  and   use  in  source   and  binary  forms,   with   or  without
modification, are permitted provided that the following conditions are met:

    * Redistributions of source code must retain the above copyright notice,
      this list of conditions and the following disclaimer.

    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.

    * Neither the name of the author nor the names of its contributors may
      be used to endorse or promote products derived from this software
      without specific prior written permission.

THIS  SOFTWARE  AND  DOCUMENTATION IS  PROVIDED  BY  THE  COPYRIGHT  HOLDERS AND
CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,  INCLUDING,  BUT NOT
LIMITED  TO,  THE  IMPLIED  WARRANTIES  OF  MERCHANTABILITY  AND  FITNESS  FOR A
PARTICULAR PURPOSE  ARE DISCLAIMED.  IN NO  EVENT SHALL THE  COPYRIGHT HOLDER OR
CONTRIBUTORS  BE  LIABLE  FOR  ANY  DIRECT,   INDIRECT,   INCIDENTAL,   SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,  BUT NOT LIMITED TO, PROCUREMENT
OF SUBSTITUTE GOODS OR  SERVICES;  LOSS OF USE,  DATA,  OR PROFITS;  OR BUSINESS
INTERRUPTION)  HOWEVER  CAUSED  AND  ON  ANY  THEORY  OF  LIABILITY,  WHETHER IN
CONTRACT,  STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
IN ANY WAY OUT OF THE USE  OF THIS SOFTWARE,  EVEN IF ADVISED OF THE POSSIBILITY
OF SUCH DAMAGE.