--- /dev/null
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+
+<html>
+
+<head>
+<title>Browser Switchboard - default browser selection for Maemo</title>
+</head>
+
+<body>
+<h1>Browser Switchboard</h1>
+<p>Browser Switchboard (formerly browser-proxy) is a program which allows
+you to choose which browser to use as the default browser on Maemo devices.
+It supports MicroB, Tear, Fennec/Mobile Firefox, and Midori out of the box,
+and can also be used to launch MicroB without having browserd running.</p>
+
+<h2>Current Release</h2>
+<p>Version 3.0rc1 (2009/12/18) (<a href="https://garage.maemo.org/frs/download.php/7081/browser-switchboard_3.0rc1-1_armel.deb">Diablo package</a>)</p>
+<ul>
+<li>Release candidate -- not (yet) a stable release</li>
+<li>Add a control panel applet to help configure the UI</li>
+<li>Reimplement the core D-Bus proxy in C to improve speed and memory footprint</li>
+<li>Default to launching MicroB as the default browser if unconfigured -- if you were using Browser Switchboard to launch Tear, you need to explicitly set Tear as the default browser using the UI (or by configuring by hand)</li>
+<li><b>EXPERIMENTAL</b> Fremantle support (see <a href="https://garage.maemo.org/frs/?group_id=1159">download page</a> for source and packages). BACK UP before installing, and let me know how it goes!</li>
+</ul>
+<p>Version 2.2 (2009/12/14) (<a href="https://garage.maemo.org/frs/download.php/7038/browser-switchboard_2.2-1_all.deb">Diablo package</a>)</p>
+<ul>
+<li>Rename the package to browser-switchboard</li>
+<li>Move the config file to /home/user/.config/browser-switchboard, and
+fall back to the old location if no config file is found</li>
+<li>If no config file is found and Tear isn't installed, launch MicroB;
+this avoids breaking link opening on a system with a freshly installed
+browser-switchboard package and Tear not installed</li>
+<li>Package no longer depends on Tear; should make it easier for users of
+other alternative browsers to use Browser Switchboard</li>
+<li>substantial documentation update</li>
+</ul>
+
+<h2>Getting Browser Switchboard</h2>
+<p>Source code, packages for Diablo, and EXPERIMENTAL packages for Fremantle
+can be found on the maemo Garage
+<a href="https://garage.maemo.org/frs/?group_id=1159">download page</a>.
+Packages can also be installed from the maemo
+<a href="http://wiki.maemo.org/Extras-devel">extras-devel repository</a>
+(though don't blindly enable extras-devel and install/upgrade — see
+the linked page first!)</p>
+
+<h2>Quick Start</h2>
+<ol>
+<li>Download the binary package: browser-switchboard_X.Y-Z_all.deb
+(where X.Y-Z is the version number, of course).</li>
+<li>Install the package using the Application Manager (on Diablo, open the
+Application Manager, then select Application->Install from file in the
+menu).</li>
+</ol>
+
+<p><img src="cpapplet-diablo.jpg" width=320 alt="Browser Switchboard control panel UI"><br>
+You can now select the default browser by using the Browser Switchboard
+applet in the Control Panel. Links in most applications, locally-saved
+web pages opened from the file manager, and (for Maemo 4.x) entries in
+the Web sidebar panel will open in the browser that you select as the
+default. If you don't configure a default browser, MicroB will continue
+to be used as the default browser.</p>
+
+<p>No matter which browser you select as the default, MicroB can always be
+opened via the Web menu entry in the applications menu (for Maemo 4.x,
+located in the Internet menu by default), or by running "browser" from
+the shell. While MicroB is open, it will receive all links from other
+applications; closing MicroB will restore your chosen default browser.</p>
+
+<p>Some users have reported that a restart may be necessary to ensure that
+Browser Switchboard is functioning. If you experience trouble after
+installing the package, try rebooting your device first.</p>
+
+<h2>Documentation</h2>
+<p>See the
+<a href="https://git.maemo.org/projects/browser-switch/?p=browser-switch;a=blob_plain;f=README;hb=HEAD">README</a>
+for further instructions on how to configure and use Browser Switchboard.</p>
+
+<h2>Support</h2>
+<p>You can email your question to the maintainers (see below), or you can take
+it to the
+<a href="http://talk.maemo.org/showthread.php?t=28539">Tear thread</a>
+on the talk.maemo.org forums.</p>
+
+<h2>Development</h2>
+<p>The latest source is available via a Git repository; you can check it out
+by running</p>
+<pre>
+git clone https://git.maemo.org/projects/browser-switch
+</pre>
+<p>from a shell. You can also
+<a href="https://git.maemo.org/projects/browser-switch/?p=browser-switch;a=summary">browse the repository</a> using gitweb.</p>
+
+<p>Bug reports and patches can be emailed to the maintainers, or posted on the
+forum thread.</p>
+
+<h2>Maintainers</h2>
+<p>Steven Luo
+<<a href="mailto:steven+maemo [at] steven676.net">steven+maemo [at] steven676.net</a>>
+is the primary maintainer of Browser Switchboard, with assistance from Jason
+Simpson (the original developer).</p>
+</body>
+
+</html>
projects / browser-switch / commitdiff
