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

[Carl Worth]

 src/roadster.mdwn |   41 ++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 40 insertions(+), 1 deletion(-)

New commits:
commit 7d12e131572c965c41cb40cbe8561613ebf32a7e
Author: jgarrett <jeff at jgarrett.org>
Date:   Fri Aug 24 03:36:31 2007 -0700

    Add roadster build/use/bugzilla sections

diff --git a/src/roadster.mdwn b/src/roadster.mdwn
index 9b1dbf6..cd2bad5 100644
--- a/src/roadster.mdwn
+++ b/src/roadster.mdwn
@@ -1,3 +1,42 @@
 [[meta title="Roadster"]]
 
-Roadster is a cairo-based mapping software.
\ No newline at end of file
+Roadster is a cairo-based GPS mapping software.
+
+## Screenshots
+
+## Building and Using Roadster
+
+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].
+
+	./autogen.sh --enable-deprecated
+	make
+	make install
+
+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.
+
+After the import has completed, dismiss the dialog and you are free to begin.  To get started, type an address in the search box in the upper right and press enter.
+
+## Need Help?
+
+The [mailing list][3] is the central means of communication for both development and users.  If you have a question, ideas, or patches, please do visit.  If you think you've found a bug in roadster, please do report it to the mailing list or [directly enter it into bugzilla][6].  Please do [check the list of current bugs][7] to see if someone else has already reported your bug.
+
+## Roadmap
+
+   [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