00README

Layout/Concept

Relies on system commands "barcode", "qrencode", "sam2p"

If your distribution does not provide "barcode", you can download source from:

ftp://mirrors.kernel.org/gnu/barcode/

If your distribution does not provide qrencode, it can be built from source:

http://fukuchi.org/works/qrencode

Gui all lives under "fossbarcode", uses django so you need python-django or
  equivalent

Revision history uses dulwich for the python bindings, available from:

http://www.samba.org/~jelmer/dulwich

By default, typing "make" in the top-level will create the SQLite
  database the app needs, and the documentation.
 
barcode: bulk of the gui code
  models.py is the database/form models
  views.py is the data/form processing code

media: css, images, docs, js, user_data

templates: html pages using django's "template" language for data/form
	   handling (these also have some javascript glue)

The web app can be run "in-place"; otherwise, it expects to be run
from /opt/linuxfoundation/fossbarcode. Typing "make install" (as root) will 
install the application to this location for system use.

To run the gui/server (as user compliance for installed package):
   /opt/linuxfoundation/bin/foss-barcode.py start (for running installed)
   
To run the application in place, you *must* first run "make" to create the
database and docs:
   make
   ./foss-barcode.py start (for running in-place)

"foss-barcode.py stop" will stop the server.

to access the gui: http://127.0.0.1:8000/barcode
admin interface: http://127/0.0.1:8000/admin 
	(username compliance, password compliance)

See fossbarcode/dbsettings.py for information on using a database
engine other than SQLite.