README

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

RLSD, the Retro Linux-libre Software Distribution, is a small, "live" operating
system with GNU/Linux-libre (http://linux-libre.fsfla.org/) and retro
applications for the x86 and x86_64 architectures. It revives old hardware and
the way computing used to be in the late 90's.

RLSD's development follows the guidelines in the project manifest described in
MANIFEST.

RLSD consists of free software: software that respects the user's freedom. RLSD
is free to study, modify and share. To read more about free software, see
http://www.gnu.org/philosophy/free-sw.html.

For more information, see the project homepage (http://rlsd.dimakrasner.com/).

Running
=======

RLSD is available as regular, bootable ISO9660 images, or as a chroot
environment similar to crouton (https://github.com/dnschneid/crouton).

To set up a RLSD chroot environment:
  wget http://goo.gl/fFZwXC
  sudo sh fFZwXC

Daily builds of RLSD are available through its homepage.

Building
========

RLSD is built from source. It is cross-compiled through Trisquel
(http://www.trisquel.info/) 7 x86_64.

The whole process is automated; there's a script (http://goo.gl/8x9id4) that
generates a clean, up-to-date build environment, then cross-compiles the entire
RLSD inside it.

To build a 64-bit RLSD:
  wget http://goo.gl/8x9id4
  sudo sh 8x9id4 ./rlsd-chroot
  sudo ls ./rlsd-chroot/root/rlsd/releases

Alternatively, to build a 32-bit variant, use setarch(1), e.g:
  sudo setarch i486 sh 8x9id4 ./rlsd-chroot

It is highly recommended to read the script first, as it installs debootstrap on
the host. It should run on Trisquel 7, although it should work on any comparable
distribution with debootstrap after minor adjustments.

Credits and Legal Information
=============================

RLSD consists of many packages; each has its own license, detailed under RLSD's
/usr/share/doc.

The icons included in RLSD's file system skeleton were taken from the
public-domain Tango Desktop Project (http://tango.freedesktop.org/).

The rest of RLSD (its build system, file system skeleton, etc') is free and
unencumbered software released under the terms of the MIT license; see COPYING
for the license text.

The ASCII art logo at the top was made using FIGlet (http://www.figlet.org/).