Jeremy Newman : update, convert to markdown syntax, cleanup

[Jeremy Newman]

Module: appdb
Branch: master
Commit: 85526a780e99f833177de92519894f5221732e5d
URL:    http://source.winehq.org/git/appdb.git/?a=commit;h=85526a780e99f833177de92519894f5221732e5d

Author: Jeremy Newman <jnewman at codeweavers.com>
Date:   Mon Nov 14 10:40:13 2016 -0600

update, convert to markdown syntax, cleanup

---

 README | 104 ++++++++++++++++-------------------------------------------------
 1 file changed, 25 insertions(+), 79 deletions(-)

diff --git a/README b/README
index c13d3fc..c624bf6 100644
--- a/README
+++ b/README
@@ -1,93 +1,39 @@
-WineHQ Application Database
-#------------------------------------------------------------------------#
-Authors:
+# WineHQ Application Database
+
+Maintainer:
     Jeremy Newman <jnewman at codeweavers.com>
-    Charles Leop <charles at codeweavers.com>
-    
-Contributors:
-    Paul van Schayck <polleke at gmail.com>
-    Chris Morgan <cmorgan at alum.wpi.edu>
-    Tony Lambregts <tony_lambregts at telusplanet.net>
-    Jonathan Ernst <Jonathan at ErnstFamily.ch>
 
-To install locally for testing/hacking:
-#------------------------------------------------------------------------#
+## To install locally for testing/hacking:
+
+1. Copy AppDB files to somewhere where your web server can access them.
 
-# Symlink from /var/www to the appdb directory
+2. Copy include/config.php.sample to include/config.php
 
-# Copy include/config.php.sample to include/config.php
+3. Edit include/config.php as you see fit, the default name of the database 
+    used in the table creation step below is "apidb", you'll have to modify 
+    these files if you change this in config.php
 
-# Edit include/config.php as you see fit, the default name of the database 
-  used in the table creation step below is "apidb", you'll have to modify 
-  these files if you change this in config.php
-  
-  # NOTE: You must update the APPDB_ROOT entry to be YOUR url to the application database
-          If this the APPDB_ROOT isn't correct your urls will point to the wrong pages.
+    **NOTE:** You must update the APPDB_ROOT entry to be YOUR url to the application database
+    If this the APPDB_ROOT isn't correct your urls will point to the wrong pages.
 
-  # NOTE: if you've changed the name of the database by changing the define of
-    'APPS_DB' in include/config.php you'll have to modify the 'create database' and 'use'
+    **NOTE:** if you've changed the name of the database by changing the define of
+    *APPS_DB* in include/config.php you'll have to modify the *create database* and *use*
     entries in pretty much every file in the /tables/ directory. The recommendation is to
     leave the default value of APPS_DB to keep things simple
 
-# 'cd tables', run './create_tables' to create the database tables
-
-# Look in include/config.php at the 'APPS_DBUSER' and 'APPS_DBPASS' defines. 
-  Ensure that this user and password exist in your mysql users list and that this user
-  has been granted 'SELECT', 'INSERT', 'UPDATE' and 'DELETE' privileges on the database
-  defined by the value of 'APPS_DB' in include/config.php
-
-# Try to open up localhost/appdb, if you get a directory listing
-  Edit your /etc/apache/httpd.conf "DirectoryIndex" to include index.php 
-  so apache will open index.php after not finding index.html/index.htm etc
-
-# Also ensure these options in /etc/apache/php.ini:
-   register_globals 0
-   short_open_tag 0
-   register_long_arrays 0
-   magic_quotes_gpc 0
- Or ensure your appdb directory has AllowOverride' set to 'All' inside 
- httpd.conf to let .htaccess set these settings.
- 
-# An AppDB admin user has been automatically created while running 
-  the create_tables script
-  email: admin at localhost
-  password: testing
-  You should change the password as soon as possible!
-
-#------------------------------------------------------------------------#
-You can either set up a real bugzilla database or a fake one 
-#
-# cd tables, run ./create_bugzilla_tables to create the fake bugzilla tables
-#------------------------------------------------------------------------#
-# or installing a real bugzilla database (hope this helps)
-#
-# download buzilla  (password for cvs is cvs)
-
-cd /var/www/html
-export CVSROOT=:pserver:cvs at cvs.winehq.org:/home/wine
-cvs login
-cvs -z 0 checkout bugzilla
-
-# change directory to bugzilla and change the group ownership to apache.
-
-cd bugzilla
-chgrp -R apache .
-chmod -R g+rX .
-
+4. to create the database tables: `cd tables; ./create_tables`
 
-# change to su and run ./checksetup.pl and fix up what it finds wrong.
-# this may take several runs 
+5. Look in include/config.php at the 'APPS_DBUSER' and 'APPS_DBPASS' defines. 
+    Ensure that this user and password exist in your mysql users list and that this user
+    has been granted 'SELECT', 'INSERT', 'UPDATE' and 'DELETE' privileges on the database
+    defined by the value of 'APPS_DB' in include/config.php
 
-su
-./checksetup.pl
+6. Ensure your appdb directory has *AllowOverride* set to *All* in Apache config to let
+    .htaccess use required PHP settings. Or duplicate the .htaccess/PHP settings in your Apache config.
 
-# in the /etc/httpd/conf/hppt.conf file find "AddHandler cgi-script .cgi" and add the following.
+7. An AppDB admin user has been automatically created while running the create_tables script
 
-<Directory "/var/www/html/bugzilla">
-Options ExecCGI
-AllowOverride Limit
-Order allow,deny
-Allow from all
-</Directory>
+    **email:** admin at localhost **password:** testing
 
-# edit local config as necessary to allow access.
+8. You can either set up a real bugzilla database or a fake one.
+to create the fake bugzilla tables: `cd tables; ./create_bugzilla_tables`