README

aurweb
======

aurweb is a framework for hosting the Arch User Repository (AUR), a collection
of packaging scripts that are created and submitted by the Arch Linux
community. The scripts contained in the repository (PKGBUILDs) can be built
using makepkg and installed via the Arch Linux package manager pacman. The
aurweb project aims to provide the necessary web interface, database schema,
and scripts for a multi-lingual community-driven repository.

Functionality
-------------

* Users may submit source packages that contain a PKGBUILD.
* User accounts with varying permission levels (User, Trusted User, Developer).
* Ability to search for specific submitted packages.
* Display package information by parsing meta-data provided with the packages.
* Users can make comments on package information page.
* Mark packages as out-of-date.
* Vote for well-done and popular user submitted packages.
* Trusted User and Developer can search for and modify accounts.
* Area for Trusted Users to post AUR-related proposals and vote on them.

Directory Layout
----------------

doc::
	aurweb documentation.

po::
	Translation files for strings in the aurweb interface.

scripts::
	aurblup package blacklist tool. Scripts for AUR maintenance.

support::
	Schema for SQL database. Script for dummy data generation.

web::
	Web interface for the AUR.

Links
-----

* The repository is hosted at git://projects.archlinux.org/aurweb.git -- see
  doc/CodingGuidelines for information on submitting patches.

* Discovered bugs can be submitted to the aurweb bug tracker:
  https://bugs.archlinux.org/index.php?project=2

* Questions, comments, and patches related to aurweb can be sent to the AUR
  development mailing list: aur-dev@archlinux.org -- mailing list archives:
  https://mailman.archlinux.org/mailman/listinfo/aur-dev