README

   1 ======================
   2 openSUSE Build Service
   3 ======================
   4
   5 The openSUSE Build Service (OBS) is an open and complete distribution
   6 development platform designed to encourage developers to compile packages for
   7 multiple Linux distributions including openSUSE, Red Hat, Mandriva, Ubuntu,
   8 Fedora and Debian. It typically simplifies the packaging process, so developers
   9 can more easily package a single program for many distributions, and many
  10 openSUSE releases, making more packages available to users regardless of what
  11 distribution they use.
  12
  13
  14 Organization
  15 ============
  16
  17 The openSUSE Build Service consists of several parts, namely the backend, the
  18 api and the webui. The backend implements all the core functionality (i.e. the
  19 business logic), whereas the webui provides a neat browser interface. The api
  20 forms the glue between those components and also serves as the integration
  21 point to other external tools (hence it's name). Therefore the source code is
  22 organized like this:
  23
  24  dist/          - Helpful scripts and utilities
  25  docs/          - Documentation and examples
  26  src/api/       - Api code (Ruby / Ruby on Rails)
  27  src/backend/   - Backend code (Perl)
  28  src/webui/     - Webui code (Ruby / Ruby on Rails)
  29  shared/        - Stuff shared across the different parts
  30
  31
  32 Installation
  33 ============
  34
  35 Please refer to the INSTALL file
  36
  37
  38 License
  39 =======
  40
  41 The OBS source code is released under the terms of the GPL, except where noted.
  42 Additionally, 3rd-party content (like, but not exclusively, the webui icon
  43 theme) may be released under a different license. Please check the respective
  44 files for details.
  45
  46 Further documentation for the Build Service can be found here:
  47
  48   http://en.opensuse.org/Portal:Build_Service
  49
  50 The running build service web interface can be accessed here:
  51
  52   http://build.opensuse.org/
  53
  54
  55     Your openSUSE Build Service Team