UPGRADING: Add note on backward compatible package URLs

Thanks-to: Dave Reisner <d@falconindy.com>
Thanks-to: Dan McGee <dan@archlinux.org>
Signed-off-by: Lukas Fleischer <archlinux@cryptocrack.de>

1 files changed, 17 insertions, 0 deletions

diff --git a/UPGRADING b/UPGRADING
index 331870e2..0f08ab9d 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -22,6 +22,23 @@ ALTER TABLE PackageDepends ADD INDEX (DepName);
 6. Run the upload directory transform script ("scripts/uploadbuckets.sh") and
 rotate the converted directory structure into place.
 
+7. In order to to provide backward compatible package URLs, enable mod_rewrite
+and add the following to your Apache configuration (inside the "VirtualHost"
+container or optionally create a ".htaccess" file in the upload directory):
+
+----
+RewriteEngine on
+RewriteRule ^/packages/([^/]{1,2})([^/]*/(PKGBUILD|.*\.tar\.gz|))$ /packages/$1/$1$2
+----
+
+The following equivalent rule can be used for lighttpd setups:
+
+----
+url.rewrite-once = ( "^/packages/([^/]{1,2})([^/]*/(PKGBUILD|.*\.tar\.gz|))$" => "/packages/$1/$1$2" )
+----
+
+If you use a non-standard URL_DIR, slight modifications might be necessary.
+
 From 1.8.1 to 1.8.2
 -------------------