[cairo-commit] [cairo-www] src/roadster.mdwn

[Carl Worth]

 src/roadster.mdwn |   25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

New commits:
commit 3648de597c0a9d3dac13aae09ff160818401e6f2
Author: Carl Worth <cworth at annarchy.freedesktop.org>
Date:   Sat Sep 8 04:30:30 2007 -0700

    web commit by jgarrett: roadster - Update the build instructions to latest CVS

diff --git a/src/roadster.mdwn b/src/roadster.mdwn
index 017bc3e..97d2873 100644
--- a/src/roadster.mdwn
+++ b/src/roadster.mdwn
@@ -11,17 +11,29 @@ Roadster is available via CVS:
 	cvs -d :pserver:anoncvs at cvs.cairographics.org:/cvs/cairo login
 	cvs -d :pserver:anoncvs at cvs.cairographics.org:/cvs/cairo -z3 co roadster
 
-Roadster requires MySQL embedded server which is in MySQL 4.1.0 up to but not including 5.0.  In order to use with an external MySQL server, or with MySQL 5.0 which requires the external server, apply the patch from [bug 12135][5].
+Build it with:
 
-	./autogen.sh --enable-deprecated
+	cd roadster
+	./autogen.sh
 	make
-	make install
+	sudo make install
+
+Now roadster uses MySQL, so you have to configure the database connection parameters.  Keep in mind that these are only used for the actual connection.  After roadster is connected to the MySQL server, it attempts to create a database called 'roadster' if it doesn't exist and uses that one.  That is, the 'database' connection parameter is used only for connecting to the server, not using that database ([bug 12320][8]).
+
+To specify the connection parameters, create the directory ~/.roadster and edit the file ~/.roadster/roadster.conf.  Put in it (substitute your actual values):
+
+	[mysql]
+	host = $host
+	user = $user
+	password = $password
+	database = $database
+
+If you skip this step, or if you don't specify all of the parameters, roadster will use the defaults (local host, local user, no password, no database name).
 
 Roadster uses data from the Census Bureau's TIGER/Line database to draw its maps.  This is not distributed with Roadster, but it is downloadable by county from the Census Bureau's website.  To download it, repeat these steps for each county you care about:
 
    1.  Find your [counties' FIPS code][2]: choose the state, and observe the 5-digit number next to your county.
    2.  Download the [TIGER/Line street data][1]:  choose the state, and find the file TGR(same 5-digit number).ZIP to download.
-   3.  Rename the file to an all lowercase name:  rename TGR17031.ZIP to tgr17031.zip.  This is a workaround for bug [12134][4].
    4.  In Roadster, choose the menu item Debug - Import Map Data.
    5.  When the file selection dialog pops up, give it the ZIP file.
 
@@ -38,7 +50,6 @@ For comparison, we have a list of other GIS/mapping/GPS applications and librari
    [1]: http://www.census.gov/geo/www/tiger/tiger2006se/tgr2006se.html
    [2]: http://mcdc2.missouri.edu/webrepts/commoncodes/
    [3]: http://lists.freedesktop.org/mailman/listinfo/roadster
-   [4]: https://bugs.freedesktop.org/show_bug.cgi?id=12134
-   [5]: https://bugs.freedesktop.org/show_bug.cgi?id=12135
    [6]: https://bugs.freedesktop.org/enter_bug.cgi?product=roadster
-   [7]: https://bugs.freedesktop.org/buglist.cgi?query_format=advanced&product=roadster&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED
\ No newline at end of file
+   [7]: https://bugs.freedesktop.org/buglist.cgi?query_format=advanced&product=roadster&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED
+   [8]: https://bugs.freedesktop.org/show_bug.cgi?id=12320
\ No newline at end of file