From 71b5b9e6b7e92fe1f2c0c49f47af1c1255f41e24 Mon Sep 17 00:00:00 2001
From: pjmattal <pjmattal>
Date: Wed, 6 Apr 2005 02:54:11 +0000
Subject: many changes in prep for launch new doc page added changed AUR to
 community lower-cased unsupported fixed half of the bug with changing
 categories:   categories now can't be changed for packages in community  
 however they can still be changed out from under maintainers by joe users for
 unsupported packages debugged problem with package details not found when
 unsupported uploads were with Category 0 (changed default to 19)

---
 support/schema/aur-schema.sql |  10 +--
 web/html/index.php            |  11 ++-
 web/html/packages.php         |   2 +-
 web/html/pkgsubmit.php        |   8 +-
 web/html/user_docs.html       | 165 ++++++++++++++++++++++++++++++++++++++++++
 web/lib/aur.inc               |   8 +-
 web/lib/pkgfuncs.inc          |  13 +++-
 7 files changed, 196 insertions(+), 21 deletions(-)
 create mode 100644 web/html/user_docs.html

diff --git a/support/schema/aur-schema.sql b/support/schema/aur-schema.sql
index 0656f0e..982014c 100644
--- a/support/schema/aur-schema.sql
+++ b/support/schema/aur-schema.sql
@@ -95,11 +95,11 @@ CREATE TABLE PackageLocations (
 	PRIMARY KEY (ID)
 );
 INSERT INTO PackageLocations (Location) VALUES ('none');
-INSERT INTO PackageLocations (Location) VALUES ('Unsupported');
-INSERT INTO PackageLocations (Location) VALUES ('AUR');
-INSERT INTO PackageLocations (Location) VALUES ('Current');
-INSERT INTO PackageLocations (Location) VALUES ('Extra');
-INSERT INTO PackageLocations (Location) VALUES ('Unstable');
+INSERT INTO PackageLocations (Location) VALUES ('unsupported');
+INSERT INTO PackageLocations (Location) VALUES ('community');
+INSERT INTO PackageLocations (Location) VALUES ('current');
+INSERT INTO PackageLocations (Location) VALUES ('extra');
+INSERT INTO PackageLocations (Location) VALUES ('unstable');
 
 
 -- Information about the actual packages
diff --git a/web/html/index.php b/web/html/index.php
index b05127b..c31dad4 100644
--- a/web/html/index.php
+++ b/web/html/index.php
@@ -77,10 +77,13 @@ html_header();
 print "<table border='0' cellpadding='0' cellspacing='3' width='90%'>\n";
 print "<tr>\n";
 print "  <td align='left' valign='top'>";
-print __("This is where the intro text will go.");
-print __("For now, it's just a place holder.");
-print __("It's more important to get the login functionality finished.");
-print __("After that, this can be filled in with more meaningful text.");
+?>
+Welcome to the AUR! If you're a newcomer, you may want to read the <a href="user_docs.html">User Documentation</a>.
+<?php
+#print __("This is where the intro text will go.");
+#print __("For now, it's just a place holder.");
+#print __("It's more important to get the login functionality finished.");
+#print __("After that, this can be filled in with more meaningful text.");
 print "  </td>";
 # XXX Is this the proper way to add some spacing between table cells?
 #
diff --git a/web/html/packages.php b/web/html/packages.php
index a211b34..48fc9a0 100644
--- a/web/html/packages.php
+++ b/web/html/packages.php
@@ -198,7 +198,7 @@ if (isset($_REQUEST["do_Flag"])) {
 				$q = "SELECT Packages.ID FROM Packages, PackageLocations ";
 				$q.= "WHERE Packages.ID IN (" . $delete . ") ";
 				$q.= "AND Packages.LocationID = PackageLocations.ID ";
-				$q.= "AND PackageLocations.Location = 'Unsupported' ";
+				$q.= "AND PackageLocations.Location = 'unsupported' ";
 				$q.= "AND AURMaintainerUID IN (0,  " . uid_from_sid($_COOKIE["AURSID"]) . ")";
 				$result = db_query($q, $dbh);
 				if ($result != Null && mysql_num_rows($result) > 0) {
diff --git a/web/html/pkgsubmit.php b/web/html/pkgsubmit.php
index bd635f4..a73ca5a 100644
--- a/web/html/pkgsubmit.php
+++ b/web/html/pkgsubmit.php
@@ -330,7 +330,8 @@ if ($_COOKIE["AURSID"]) {
 				#
 				$q = "UPDATE Packages SET ";
 				$q.="Name='".mysql_escape_string($new_pkgbuild['pkgname'])."', ";
-				$q.="Version='".mysql_escape_string($new_pkgbuild['pkgver'])."',";
+				$q.="Version='".mysql_escape_string($new_pkgbuild['pkgver'])."-".
+				  mysql_escape_string($new_pkgbuild['pkgrel'])."',";
 				$q.="CategoryID=".mysql_escape_string($_REQUEST['category']).", ";
 				$q.="Description='".mysql_escape_string($new_pkgbuild['pkgdesc'])."', ";
 				$q.="URL='".mysql_escape_string($new_pkgbuild['url'])."', ";
@@ -389,7 +390,8 @@ if ($_COOKIE["AURSID"]) {
 				$q.= " SubmittedTS, SubmitterUID, MaintainerUID, FSPath, URLPath) ";
 				$q.= "VALUES ('";
 				$q.= mysql_escape_string($new_pkgbuild['pkgname'])."', '";
-				$q.= mysql_escape_string($new_pkgbuild['pkgver'])."', ";
+				$q.= mysql_escape_string($new_pkgbuild['pkgver'])."-".
+				  mysql_escape_string($new_pkgbuild['pkgrel'])."', ";
 				$q.= mysql_escape_string($_REQUEST['category']).", '";
 				$q.= mysql_escape_string($new_pkgbuild['pkgdesc'])."', '";
 				$q.= mysql_escape_string($new_pkgbuild['url']);
@@ -478,7 +480,7 @@ if ($_COOKIE["AURSID"]) {
 			print __("Package Category").":</td>\n";
 			print "	<td span='f4' align='left'>";
 			print "<select name='category'>";
-			print "<option value='0'> " . __("Select Category") . "</option>";
+			print "<option value='19'> " . __("Select Category") . "</option>";
 			while (list($k, $v) = each($pkg_categories)) {
 				print "<option value='".$k."'> " . $v . "</option>";
 			}
diff --git a/web/html/user_docs.html b/web/html/user_docs.html
new file mode 100644
index 0000000..15f232b
--- /dev/null
+++ b/web/html/user_docs.html
@@ -0,0 +1,165 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+  <meta content="text/html; charset=ISO-8859-1"
+ http-equiv="content-type">
+  <title>AUR User Documentation</title>
+</head>
+<body>
+<h2>Arch User Repository (AUR)</h2>
+The Arch User Repository (AUR) is ready! This release
+does not contain every feature everyone wanted, but at this stage we
+think we've implemented the most important features, and we need you to
+help us make sure they are working properly and reliably. A few months
+after the initial release, we'll start to prioritize
+features necessary for the next revision. We'll weigh the suggestions
+given and decide what additional features to add.<br>
+<h3><a href="http://bugs.archlinux.org/index.php?tasks=all&amp;project=2">Leave your feedback in Flyspray!</a></h3>
+<h3>Introduction to the AUR<br>
+</h3>
+The AUR is a place for community members and TUs (Trusted Users) to
+work together to bring new packages to Arch Linux users. A TU is a
+special community member who has earned the trust of the core
+Arch developers and who wants to help build, test, and debug new Arch
+packages contributed by members of the community. Only a TU can build a
+binary package and add it to the "community"
+repository, which is then accessible via pacman -S.<br>
+<span style="font-weight: bold;"><br>
+</span>Any community member may upload new PKGBUILD directory tarballs
+from the AUR
+web interface. Those packages will appear in the unsupported
+repository, and
+can be viewed and built by other community members, even though they
+are not yet available in binary form via pacman -S.<br>
+<br>
+The AUR system
+incorporates a voting system which allows members to vote for the
+packages in the unsupported repo that they think are useful or interesting. If
+a TU thinks a package is interesting or has received enough votes,
+the TU may choose to adopt the package. The TU builds the package,
+performs some rudimentary testing, and adds it
+to the community repository, where it can be accessed by any user subscribing
+to the AUR repository by running pacman -S. From that point on, the TU
+will maintain the
+package in the community repository, and all updates for the package must go
+through a TU.<br>
+<br>
+If a package gets enough votes or is otherwise deemed interesting by
+the core Arch development team, the package may be
+promoted into the extra or current repository. At that point, the
+package is removed from the AUR and is maintained by the core Arch
+developers. Alternately, if a TU loses interest in a package, the TU
+may abandon the package or remove it from the AUR altogether.<br>
+<br>
+<h3>Feedback</h3>
+We will need your feedback. There is a <a
+ href="http://bugs.archlinux.org/index.php?tasks=all&amp;project=2">project
+set up in Flyspray</a> for the AUR. Please leave your feedback there.
+Though it will be tempting to email the AUR developers, remember that
+they will get a lot of email and they won't be able to find yours later
+when they're going through the feedback. If you put your bugs,
+comments, and suggestions in Flyspray, they are guaranteed not to get
+lost.<br>
+<br>
+Flyspray is incredibly easy to use. Take a moment to create an account
+as soon as you can.<br>
+<br>
+<h3>Using the AUR Repository</h3>
+To access the AUR repository from pacman, add the following to your
+pacman.conf:<br>
+<br>
+<code>[community]<br>
+	Server = ftp://ftp.archlinux.org/community</code><br>
+<br>
+<h3>What The AUR Means to a Community Member</h3>
+If you're an Arch Linux community member, the AUR represents a giant
+step forward in your ability to effectively contribute your work in
+building Arch packages to the rest of the Arch Linux community. The
+following steps must ye take to get started:<br>
+<ol>
+  <li>Set yourself up to access the community repository, if desired, by
+adding the above lines to your pacman.conf.<br>
+  </li>
+  <li>Visit the <a href="http://aur.archlinux.org">AUR Site</a>.</li>
+  <li>Create a new user account.</li>
+  <li>Begin uploading packages you have created. You should upload a
+.tar.gz file containing the PKGBUILD directory. You should not include
+a binary package file in your upload, just the PKGBUILD and related
+necessary files for building the package. (Imagine your package had
+been accepted into current or extra; we want just the files that would
+be fetched by abs in /var/abs.)<br>
+  </li>
+  <li>Review the other packages in the repository, and vote for the
+ones you find most interesting. If you're especially interested, browse
+the package contents and build other packages yourself.</li>
+</ol>
+<h3>What The AUR Means to a Trusted User (TU) or an Arch Developer<br>
+</h3>
+If you are an Arch Linux Trusted User (TU) or an Arch developer, and
+you want to get started on the beta, do the following:<br>
+<ol>
+  <li>Set your machine up to access the community repository.</li>
+  <li>Run <code>pacman -S tupkg</code> to download the TU package
+download tool.<br>
+  </li>
+  <li>Visit the <a href="http://aur.archlinux.org">AUR Site</a>.</li>
+  <li>Create a new user account, using your usual user id.<br>
+  </li>
+  <li>Email on the TU or developer email list list and ask to have your login modified to modified to have TU/developer status.<br>
+This
+step is necessary so we can make sure that the right people are getting the right access.<br>
+  </li>
+  <li>Check out the CVS tree for the community repository. To do this,
+execute the following commands:<br>
+    <br>
+    <code># export
+CVSROOT=":pserver:&lt;userid&gt;@cvs.archlinux.org:/home/cvs-community"<br>
+# cvs login<br>
+# cvs co community</code><br>
+    <br>
+If you're
+a TU, you should already have an account in this new
+repository. If you are a developer, email Jason (jason at archlinux dot
+org) and he'll set up access for you.<br>
+  </li>
+  <li>Build binary packages for things you wish to place in the community repo,
+and add the PKGBUILD and accompanying necessary files to the CVS
+repository. You can do this with:<br>
+    <br>
+    <code>cvs add &lt;directory&gt;<br>
+cd &lt;directory&gt;<br>
+cvs add PKGBUILD<br>
+.<br>
+.<br>
+cvs commit</code><br>
+    <br>
+  </li>
+  <li>Upload the binary packages using the "tupkg" tool. Run<span
+ style="font-family: monospace;">:<br>
+    </span><code><br>
+tupkg
+--host
+subzero.elys.com --user &lt;userid&gt; --password &lt;password&gt;
+&lt;packagefile.pkg.tar.gz&gt;</code><br>
+    <br>
+Note that this is your <span style="font-weight: bold;">AUR login
+password</span> -- the one you assign when you create your account, not
+your CVS password, in case they are different.<br>
+  </li>
+  <li>Once your packages are uploaded successfully, tag the newly
+created package files with the CURRENT tag in cvs. You can do this with:<br>
+    <code><br>
+cvs tag -cFR CURRENT &lt;newpackagebuilddir&gt;</code> <br>
+    <br>
+  </li>
+  <li>In 5-10 minutes, the automated script will add them to the community
+repository. Verify that they appear both in the web interface and
+become
+available via <code>pacman -Sy &lt;package&gt;</code> from the community
+repository.</li>
+<li>Select the newly added or updated package in the AUR web
+interface and set yourself as the maintainer.<br>
+  </li>
+</ol>
+</body>
+</html>
diff --git a/web/lib/aur.inc b/web/lib/aur.inc
index 361ab04..793ef7c 100644
--- a/web/lib/aur.inc
+++ b/web/lib/aur.inc
@@ -373,10 +373,10 @@ function html_header() {
 	# XXX CSS help - a:link, a:visited, etc are defined, but I don't want to
 	# use the defaults.  Is this the way to override them?
 	#
-	print "<a href='".$_SERVER["PHP_SELF"]."?setlang=en'><span class='sideBarSmallHeader'>English</span></a> ";
-	print "<a href='".$_SERVER["PHP_SELF"]."?setlang=es'><span class='sideBarSmallHeader'>Español</span></a> ";
-	print "<a href='".$_SERVER["PHP_SELF"]."?setlang=de'><span class='sideBarSmallHeader'>Deutsch</span></a> ";
-	print "<a href='".$_SERVER["PHP_SELF"]."?setlang=fr'><span class='sideBarSmallHeader'>Français</span></a>";
+	#print "<a href='".$_SERVER["PHP_SELF"]."?setlang=en'><span class='sideBarSmallHeader'>English</span></a> ";
+	#print "<a href='".$_SERVER["PHP_SELF"]."?setlang=es'><span class='sideBarSmallHeader'>Español</span></a> ";
+	#print "<a href='".$_SERVER["PHP_SELF"]."?setlang=de'><span class='sideBarSmallHeader'>Deutsch</span></a> ";
+	#print "<a href='".$_SERVER["PHP_SELF"]."?setlang=fr'><span class='sideBarSmallHeader'>Français</span></a>";
 	print "                </td>\n";
 	print "            </tr>\n";
 	print "            </table>\n";
diff --git a/web/lib/pkgfuncs.inc b/web/lib/pkgfuncs.inc
index a72b5f5..bef6300 100644
--- a/web/lib/pkgfuncs.inc
+++ b/web/lib/pkgfuncs.inc
@@ -296,11 +296,16 @@ function package_details($id=0) {
 			print "</tr>\n";
 			print "<tr>\n";
 			print "  <td colspan='2'><span class='f3'>";
-			$edit_cat = "<a href='/pkgedit.php?change_Category=1&ID=";
-			$edit_cat .= intval($_REQUEST["ID"])."'>".$row["Category"]."</a>";
-			$edit_cat .= " &nbsp;<span class='fix'>(";
-			$edit_cat .= __("change category").")</span>";
+			if ($row["Location"] == "unsupported") {
+			  $edit_cat = "<a href='/pkgedit.php?change_Category=1&ID=";
+			  $edit_cat .= intval($_REQUEST["ID"])."'>".$row["Category"]."</a>";
+			  $edit_cat .= " &nbsp;<span class='fix'>(";
+			  $edit_cat .= __("change category").")</span>";
+			} else {
+				$edit_cat = $row["Category"];
+			}
 			print $row["Location"]." :: ".$edit_cat."</span></td>";
+
 			print "</tr>\n";
 			print "<tr>\n";
 			print "  <td colspan='2'><span class='f3'>".__("Maintainer").": ";
-- 
cgit v1.2.3-54-g00ecf