Patch by Humdinger:

* Slightly improved the wording on the Welcome page
* Corrected some wrong HTML tags here and there
* Improvements on the Bug Reports page
* Added paragraph on file panels on the general GUI page
* Added Filesytem Layout page
* Added Boot Loader page (kernel boot options)
* Added Keyboard Shortcuts page (also moved the paragraph about default command
  key there)
* Prepared index pages for Applications, Preferences, Demos and Desktop Applets


git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@28389 a95241bf-73f2-0310-859d-f6bbb57e9c96
This commit is contained in:
Stephan Aßmus 2008-10-31 09:08:15 +00:00
parent 48ccb49ab0
commit 1e2b06a58b
15 changed files with 623 additions and 21 deletions

View File

@ -0,0 +1,118 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>Applications</title>
<link rel="stylesheet" type="text/css" href="../welcome/welcome.css">
</head>
<body lang="en-US">
<div class="logo">
<img src="../welcome/welcome-images/logo.png" alt="logo">
<div class="title">Applications</div>
</div>
<div class="topnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Previous: <a href="workshop-filetypes+attributes.html">Workshop</a>
&nbsp;&nbsp;&nbsp;
Next: <a href="desktop-applets.html">Desktop Applets</a>
</p>
</div>
<div class="content">
<p>Before diving into all the applications that come with Haiku, let's have a more detailed look at how to install and uninstall programs you downloaded somewhere, for example from a site mentioned on the <a href="../welcome/welcome.html#software">Welcome</a> page.
</p>
<h2><a name="install">Installing applications</a></h2>
<p>Haiku software always comes as an archive. Most of the time it's a ZIP, some old BeOS packages come in Software Valet's PKG format. Software Valet was able to automatically execute installation scripts, so after double-clicking you just select a destination folder and everything's taken care of.<br>
If it's a ZIP archive, double-clicking opens <i>Expander</i> where you also set the destination and unpack it. As explained in the topic <a href="filesystem-layout">Filesystem layout</a>, that destination is either
</p><p><table border="0" cellpadding="0" cellspacing="0">
<tr><td><tt>/boot/common/apps/</tt></td><td>&nbsp;&nbsp;&nbsp;</td><td> for applications available to every user</td></tr>
<tr><td><tt>/boot/home/apps/</tt></td><td>&nbsp;&nbsp;&nbsp;</td><td> for applications only available to yourself</td></tr>
</table>
</p><p>This distinction will only become relevant once Haiku gets multi-user support, of course.
</p><p>Once the archive is unpacked, you should have a look into the newly created folder. Often you find ReadMe files or other documentation of interest.
</p><p>Some programs need further configurations. For example, <a href="tracker-add-ons.html">Tracker Add-Ons</a>, Translators or other system enhancing components have to be put into the right folders. Either you'll find a little script file (often with the suffix <tt>.sh</tt>) like <tt>install</tt> that you simply double click to have all taken care of.<br>
Sometimes you'll find folders that link to the correct destination named "<tt>drag [filename] here...</tt>". So, you simply follow that instruction and you're done.
</p><p>Most of the time, however, nothing of the sort is necessary and you're done after unpacking.<br>
See topic <a href="deskbar.html">Deskbar</a> or LaunchBox to see how to add shortcuts to your newly installed application.
</p>
<h2><a name="uninstall">Uninstalling applications</a></h2
<p>If the installation was done with an install script, chances are, there's an uninstall script as well. In that case, double-click it and you're done.<br>
Otherwise, uninstalling is simply done by deleting the application's folder.
</p><p>This, of course, leaves back possible configuration files in your <tt>~/config/settings</tt> folder. This may be on purpose, if you want to keep those settings in case you'll install it again in the future. Also, when the installation involved those "<tt>drag [filename] here...</tt>" folders, those files are also left behind.
</p><p>One method to quickly get to all the app's files is to do a quick query for a significant part of the application's name. This will reveal the app's binary, its installation folder and its settings as well as possible links in the Deskbar etc. Simply select all relevant files and delete them.
</p>
<h2><a name="list-of-apps">Haiku's applications</a></h2>
<p>Haiku comes with a set of mostly small but essential applications:
</p><p><table border="0" cellpadding="0" cellspacing="5" width="100%">
<tr><td><a href="apps-activitymonitor.html">ActivityMonitor</a></td>
<td valign="top">A tool to track system resources like CPU and memory usage.</td></tr>
<tr><td><a href="apps-bepdf.html">BePDF</a></td>
<td valign="top">A <acronym title="Portable Document Format">PDF</acronym> viewer</td></tr>
<tr><td><a href="apps-cdplayer.html">CDPlayer</a></td>
<td valign="top">A player for audio CDs.</td></tr>
<tr><td><a href="apps-codycam.html">CodyCam</a></td>
<td valign="top">A tool to regularly upload images from a webcam to a server.</td></tr>
<tr><td><a href="apps-deskcalc.html">DeskCalc</a></td>
<td valign="top">A calculator.</td></tr>
<tr><td><a href="apps-diskprobe.html">DiskProbe</a></td>
<td valign="top">A HEX editor for files and volumes.</td></tr>
<tr><td><a href="apps-diskusage.html">DiskUsage</a></td>
<td valign="top">A tool to visualize a disk's memory usage.</td></tr>
<tr><td><a href="apps-drivesetup.html">DriveSetup</a></td>
<td valign="top">A harddisk partitioning tool.</td></tr>
<tr><td><a href="apps-firefox.html">Firefox</a></td>
<td valign="top">Mozilla's famous browser.</td></tr>
<tr><td><a href="apps-icon-o-matic.html">Icon-O-Matic</a></td>
<td valign="top">An app to create Haiku's vector icons.</td></tr>
<tr><td><a href="apps-magnify.html">Magnify</a></td>
<td valign="top">A magnified view of the area around your mouse pointer.</td></tr>
<tr><td><a href="apps-mail.html">Mail</b></td>
<td valign="top">An email client.</td></tr>
<tr><td><a href="apps-mediaplayer.html">MediaPlayer</a></td>
<td valign="top">A player for all supported audio/video files.</td></tr>
<tr><td><a href="apps-midiplayer.html">MidiPlayer</a></td>
<td valign="top">A player for MIDI files.</td></tr>
<tr><td><a href="apps-pe.html">pe</a></td>
<td valign="top">A texteditor with syntax coloring and much more.</td></tr>
<tr><td><a href="apps-people.html">People</a></td>
<td valign="top">A contact manager.</td></tr>
<tr><td><a href="apps-screenshot.html">Screenshot</a></td>
<td valign="top">A tool to take screenshots.</td></tr>
<tr><td><a href="apps-soundrecorder.html">SoundRecorder</a></td>
<td valign="top">A tool to record audio from line-in or a microphone.</td></tr>
<tr><td><a href="apps-stylededit.html">StyledEdit</a></td>
<td valign="top">A text editor.</td></tr>
<tr><td><a href="apps-terminal.html">Terminal</a></td>
<td valign="top">Access to the bash.</td></tr>
<tr><td><a href="apps-tv.html">TV</a></td>
<td valign="top">A viewer for analog TV.</td></tr>
<tr><td><a href="apps-vision.html">Vision</a></td>
<td valign="top">An <acronym title="Internet Relay Chat">IRC</acronym> client.</td></tr>
<tr><td><a href="apps-vlc.html">VLC</a></td>
<td valign="top">The VideoLAN movie player.</td></tr>
<tr><td><a href="apps-wonderbrush.html">WonderBrush</a></td>
<td valign="top">Yellowbite's vector graphics programm.</td></tr>
</table>
</p>
</div>
<div class="bottomnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Previous: <a href="workshop-filetypes+attributes.html">Workshop</a>
&nbsp;&nbsp;&nbsp;
Next: <a href="desktop-applets.html">Desktop Applets</a>
</p>
</div>
</body>
</html>

View File

@ -76,7 +76,7 @@ MIME String 21 &quot;BEOS:TYPE&quot;
131 bytes total in attributes.</pre>
<p>Besides all the "<tt>META:*</tt>" attributes that hold the contact's information, there are two attributes that are managed by the system:
</p><p>
<ul><li><tt>BEOS:TYPE</tt> holds the file type as a MIME string, here "<tt>application/x-person</tt>. It determines the default icon and the application that opens the file when you e.g. double click it.</li>
<ul><li><tt>BEOS:TYPE</tt> holds the file type as a <acronym title="Multipurpose Internet Mail Extensions">MIME</acronym> string, here "<tt>application/x-person</tt>. It determines the default icon and the application that opens the file when you e.g. double click it.</li>
<li>"<tt>_trk/pinfo_le</tt>" is the attribute with which Tracker keeps track of a file's icon position.</li></ul></p>
<p>Note the backslash after "Clara". In Terminal you have to "escape" special characters like '"*\$?!. The space between "Clara" and "Botters" is also one of those. Therefore the backslash is really in front of the space character, and not after "Clara".</li>
<p><br>

View File

@ -0,0 +1,75 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>Boot Loader</title>
<link rel="stylesheet" type="text/css" href="../welcome/welcome.css">
</head>
<body lang="en-US">
<div class="logo">
<img src="../welcome/welcome-images/logo.png" alt="logo">
<div class="title">Boot Loader</div>
</div>
<div class="topnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Next: <a href="filesystem-layout.html">Filesystem layout</a>
</p>
</div>
<div class="content">
<p>Haiku's Boot Loader can help you when you experience hardware related problems or want to choose which Haiku installation to start, if you have more than one (maybe on an installation CD or USB stick).<br>
It's also handy after you installed a software component that acts up and prevents you from booting the system to remove it again. The <i>Disable user add-ons</i> option that's mentioned below, will start Haiku without loading user installed components, e.g. a driver.
</p><p>To enter the Boot Loader options, you have to press the <tt>SPACE BAR</tt> right at the beginning of the boot process. It's easy to miss so you best keep hitting the key until it shows up.
</p><br><p>
</p><p>Once it's there, you're offered three menus:
</p><p><table>
<tr><td><b>Select boot volume</b></td><td>&nbsp;</td><td>Choose which Haiku installation to start.</td></tr>
<tr><td><b>Select safe mode options</b><br>
</td><td>&nbsp;</td><td>There are several options to try in case of hardware related trouble. When moving the selection bar to an option, a short explanation appears at the bottom of the screen.
<p><i>- Safe mode<br>
- Disable user add-ons<br>
- Disable IDE DMA<br>
- Use fail-safe video mode<br>
- Don't call the BIOS<br>
- Disable APM<br>
- Disable ACPI</br>
- Enable on screen debug output</i>
</p><p></p></td></tr>
<tr><td class="onelinetop"><b>Select fail safe video mode</b></td><td>&nbsp;</td><td>If you had to activate the option <i>Use fail-safe video mode</i>, you can set resolution and colour depth.</td></tr>
</table>
</p><br><p>
</p><p>After activating one or more options, you return to the main menu and continue booting, which presents you with this boot screen:
</p>
<img src="bootloader-images/boot-screen.png" alt="boot-screen.png" width="480" height="300">
<br>
<p>If everything works OK, one symbol after another quickly lights up.
<!----- There's an old <a href="http://betips.net/1997/09/09/understanding-the-boot-icons/">BeOS Tip Server entry</a> by Scot Hacker, that's still valid, though some icons have changed since then:
</p><p><table>
<tr><td><b>Atom</b></td><td width="10">&nbsp;</td><td>Indicates the handoff of the bootloader to the Haiku kernel.</td></tr>
<tr><td><b>Atom</b></td><td>&nbsp;</td><td>Indicates the handoff of the bootloader to the Haiku kernel.</td></tr>
<tr><td><b>Atom</b></td><td>&nbsp;</td><td>Indicates the handoff of the bootloader to the Haiku kernel.</td></tr>
<tr><td><b>Atom</b></td><td>&nbsp;</td><td>Indicates the handoff of the bootloader to the Haiku kernel.</td></tr>
<tr><td><b>Atom</b></td><td>&nbsp;</td><td>Indicates the handoff of the bootloader to the Haiku kernel.</td></tr>
<tr><td><b>Atom</b></td><td>&nbsp;</td><td>Indicates the handoff of the bootloader to the Haiku kernel.</td></tr>
<tr><td><b>Atom</b></td><td>&nbsp;</td><td>Indicates the handoff of the bootloader to the Haiku kernel.</td></tr>
</table>
----->
</p>
</div>
<div class="bottomnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Next: <a href="filesystem-layout.html">Filesystem layout</a>
</p>
</div>
</body>
</html>

View File

@ -87,21 +87,20 @@ Below, you'll find the documentation of the most important aspects of Haiku. Nat
<tr><td valign="top"><a href="workshop-filetypes+attributes.html">Workshop: Filetypes, Attributes, Index and Queries</a></td>
<td valign="top">Learn to use some of Haiku's key features by organizing your DVDs.</td></tr>
<!-----
<tr><td valign="top">Applications<ul>
<li><a href="app1.html">Application1</a></li>
<li><a href="app2.html">Application2</a></li>
<li><a href="app3.html">Application3</a></li></ul></td>
<td>Learn how to make the most of Haiku's applications.</td></tr>
<tr><td valign="top">Desktop Applets<ul>
<li><a href="applet1.html">Applet1</a></li>
<li><a href="applet2.html">Applet2</a></li>
<li><a href="applet3.html">Applet3</a></li></ul></td>
<td>Simple tools that will make your life easier</td></tr>
<tr><td valign="top">Preferences<ul>
<li><a href="preference1.html">Preference1</a></li>
<li><a href="preference2.html">Preference2</a></li>
<li><a href="preference3.html">Preference3</a></li></ul></td>
<td>Configuring and setting up the system.</td></tr>
<tr><td valign="top"><a href="applications.html">Applications</a><ul>
<li><a href="applications.html#install">Installing applications</a></li>
<li><a href="applications.html#uninstall">Uninstalling applications</a></li>
<li><a href="applications.html#list-of-apps">Haiku's applications</a></li></ul></td>
<td>Learn how to un/install applications in general and how work with the ones that come with Haiku.</td></tr>
<tr><td valign="top"><a href="desktop-applets.html>Desktop Applets</a><td>
<td>Simple tools to install on your Desktop and Deskbar.</td></tr>
<tr><td valign="top"><a href="preferences.html">Preferences</a></td>
<td>Configuring and setting up your system.</td></tr>
<tr><td valign="top"><a href="demos.html">Demos</a></td>
<td>Games and demo applications.</td></tr>
----->
</table>
</p>

66
docs/userguide/demos.html Normal file
View File

@ -0,0 +1,66 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>Demos</title>
<link rel="stylesheet" type="text/css" href="../welcome/welcome.css">
</head>
<body lang="en-US">
<div class="logo">
<img src="../welcome/welcome-images/logo.png" alt="logo">
<div class="title">Demos</div>
</div>
<div class="topnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Previous: <a href="preferences.html">Preferences</a>
</p>
</div>
<div class="content">
<p>There are some nice little games and demo applications for your entertainment. Most of the demos are targeted to developers who are interested in learning from the code, which is of course open source as is everything Haiku.
</p><p><table border="0" cellpadding="0" cellspacing="5" width="100%">
<tr><td><a href="demos-bsnow.html">BSnow</a></td>
<td valign="top">Let it snow.</td></tr>
<tr><td><a href="demos-chart.html">Chart</a></td>
<td valign="top">Moving through stars and galaxies.</td></tr>
<tr><td><a href="demos-clock.html">Clock</a></td>
<td valign="top">An analog clock.</td></tr>
<tr><td><a href="demos-cortex.html">Cortex</a></td>
<td valign="top">See the media_server in action.</td></tr>
<tr><td><a href="demos-fontdemo.html">FontDemo</a></td>
<td valign="top">A slideshow through all your fonts.</td></tr>
<tr><td><a href="demos-gldirectmode.html">GLDirectMode</a></td>
<td valign="top">A demonstration of OpenGL.</td></tr>
<tr><td><a href="demos-glteapot.html">GLTeapot</a></td>
<td valign="top">The rotating OpenGL rendered teapot.</td></tr>
<tr><td><a href="demos-gradients.html">Gradients</a></td>
<td valign="top">A demonstration of the gradient <acronym title="Application Programming Interface">API</acronym> .</td></tr>
<tr><td><a href="demos-mandelbrot.html">Mandelbrot</a></td>
<td valign="top">Computing fractals.</td></tr>
<tr><td><a href="demos-pairs.html">Pairs</a></td>
<td valign="top">A game to find pairs of matching icons.</td></tr>
<tr><td><a href="demos-playground.html">Playground</b></td>
<td valign="top">Test the drawing <acronym title="Application Programming Interface">API</acronym> .</td></tr>
<tr><td><a href="demos-pulse.html">Pulse</b></td>
<td valign="top">See your CPU's workload.</td></tr>
<tr><td><a href="demos-sudoku.html">Sudoku</b></td>
<td valign="top">This century's "Solitair".</td></tr>
</table>
</p>
</div>
<!----
<div class="bottomnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Previous: <a href="preferences.html>Preferences</a>
</p>
</div>
---->
</body>
</html>

View File

@ -0,0 +1,54 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>Desktop Applets</title>
<link rel="stylesheet" type="text/css" href="../welcome/welcome.css">
</head>
<body lang="en-US">
<div class="logo">
<img src="../welcome/welcome-images/logo.png" alt="logo">
<div class="title">Desktop Applets</div>
</div>
<div class="topnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Previous: <a href="applications.html">Applications</a>
&nbsp;&nbsp;&nbsp;
Next: <a href="preferences.html">Preferences</a>
</p>
</div>
<div class="content">
<p>Haiku provides a few useful tools that can be installed on the Desktop or the Deskbar via its Replicant.
</p><p><table border="0" cellpadding="0" cellspacing="5" width="100%">
<tr><td><a href="applets-launchbox.html">LaunchBox</a></td>
<td valign="top">Shortcuts to your favorite applications.</td></tr>
<tr><td><a href="applets-networkstatus.html">NetworkStatus</a></td>
<td valign="top">Is your connection up?.</td></tr>
<tr><td><a href="applets-processcontroller.html">ProcessController</a></td>
<td valign="top">See and control every running app and service.</td></tr>
<tr><td><a href="workspaces-applet.html">Workspaces</a></td>
<td valign="top">A miniature version of all workspaces.</td></tr>
</table>
</p>
</div>
<!----
<div class="bottomnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Previous: <a href="applications.html">Applications</a>
&nbsp;&nbsp;&nbsp;
Next: <a href="preferences.html">Preferences</a>
</p>
</div>
--->
</body>
</html>

View File

@ -0,0 +1,124 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>Filesystem layout</title>
<link rel="stylesheet" type="text/css" href="../welcome/welcome.css">
</head>
<body lang="en-US">
<div class="logo">
<img src="../welcome/welcome-images/logo.png" alt="logo">
<div class="title">Filesystem layout</div>
</div>
<div class="topnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Previous: <a href="bootloader.html">Boot Loader</a>
&nbsp;&nbsp;&nbsp;
Next: <a href="gui.html">Haiku's GUI</a>
</p>
</div>
<div class="content">
<p>Haiku's filesystem layout is quite transparent, trying to always use non-cryptic names for files and folders, that don't leave the user guessing. Files and folders that are important for the system to function properly, are protected from accidental tempering by showing one of these alerts:
</p>
<img src="filesystem-layout-images/achtung-user.png" alt="achtung-user.png" width="349" height="121">&nbsp;
<img src="filesystem-layout-images/achtung-system.png" alt="achtung-system.png" width="349" height="151">
<br>
<p>The second alert pops up if you try to rename or delete something in the system hierarchy. Here, the "<i>Do it</i>" button will only become clickable when you're holding down the <tt>SHIFT</tt> key.
</p><p>Generally, there are three seperate branches springing from the root folder of the boot volume:
</p><p><table>
<tr><td><tt>/boot/beos/</tt></td><td>&nbsp;</td><td>belongs to the system. Don't touch!</td></tr>
<tr><td><tt>/boot/common/</tt></td><td>&nbsp;</td><td>holds files that are shared between users.</td></tr>
<tr><td><tt>/boot/home/</tt></td><td>&nbsp;</td><td>is your personal folder where you keep your data and settings.</td></tr>
</table>
</p>
<h2><a name="system">The system folder - <tt>/boot/beos/</tt></a></h2>
<p>The fact that it's called "<i>beos</i>" shows Haiku's BeOS heritage. It wasn't renamed yet to ensure backward compatibility with BeOS software.<br>
Whatever it's named, you should not alter what's inside. Every update of Haiku can add, remove or overwrite anything within it. If you want to add functionality, maybe with other Tracker Add-Ons or Translators or maybe another hardware driver, you install these things under your own <tt>/boot/home/</tt> hierarchy or, if it's supposed to be for every user, under <tt>/boot/common/</tt>. As long as Haiku isn't multi-user, this distinction has no apparent effect, as there's only one user with one <i>home</i> folder. But since there will be support for more users than one eventually, it makes sense to learn the right way from the start.
</p><p>So, let's say you want to install a new Translator for the latest image format, you <b>don't</b> simply copy it into the respective system folder. Remember: Don't touch!<br>
Instead, you put it into the mirrored hierarchy under <tt>/boot/common/</tt> or <tt>/boot/home/config/</tt>.
</p><p>In our example the location for Translators in the system folder would be
</p><p><tt>/boot/beos/add-ons/Translators/</tt>
</p><p>So, the user "mirror" folder is either
</p><p><tt>/boot/home/config/add-ons/Translators/</tt><br>
or<br>
<tt>/boot/common/add-ons/Translators/</tt>
</p><p>This has another advantage: If the component you have installed messes things up (which is possible as you install hardware drivers like this, too) you are able to choose "<i>Disable User Add-Ons</i>" from the <a href="bootloader.html">Boot Loader</a> menu and are thus always able to boot without the offending component.
</p><p>Most of the time, however, you won't have to deal with these things at all, since every software that comes from a trusted source should include an installation routine that handles these things.<br>
<!---
If you do want to know more about how things tick in Haiku, have a look at this layout chart of the system folder:
</p><p><i>.... Table to be added ....</i>
<table>
</table>
----->
</p>
<h2><a name="common">The common folder - <tt>/boot/common/</tt></a></h2>
<p>Haiku is not a multi-user system yet. Once it is though, every user has her own <i>home</i> folder that is not accessible to anyone else. Every application or added component like Tracker Add-Ons, Translators etc. as well as any data that's supposed to be shared between different users, go here.
</p>
<h2><a name="home">The home folder - <tt>/boot/home/</tt></a></h2>
<p>This folder belongs to you. Here you can create and delete files and folders as you wish. However, you shouldn't mess too much with the <tt>~/config/</tt> directory and its subfolders. You <i>could</i> delete e.g. the <tt>~/config/settings/</tt> folder without damaging the operating system itself, but who wants to lose all his configurations and application settings? In any case, the system warns you with the at the top mentioned alert.
</p><p>Besides the <tt>~/config/add-ons/</tt> folder, which mirrors the system's add-ons folder for additional components as described above, there are a few other folders of interest. (By the way, the tilde ("<tt>~</tt>") is a shortcut for your home folder, so you don't always have to write "<tt>/boot/home/</tt>" in Terminal.)
</p>
<p><table border="0" cellpadding="2" cellspacing="0">
<tr><td><tt>~/mail</tt></td><td width="10">&nbsp;</td>
<td>By default, this is where your mails are kept.</td></tr>
<tr><td><tt>~/queries</tt></td><td width="10">&nbsp;</td>
<td><a href="queries.html">Queries</a> are stored, by default temporarily for 7 days, in this folder.</td></tr>
<tr><td><tt>~/config/be/</tt></td><td>&nbsp;</td>
<td>Again from our BeOS legacy, the <tt>be</tt> folder contains what's shown in the <a href="deskbar.html#deskbar-menu">Deskbar menu</a>. You can add and remove items either with the Deskbar configuration panel or by putting files, folders or links into this folder directly.</td></tr>
<tr><td><tt>~/config/bin/</tt></td><td>&nbsp;</td>
<td>Complements the system's <tt>/boot/beos/bin/</tt> folder and holds all your command line programs.</td></tr>
<tr><td><tt>~/config/boot/</tt></td><td>&nbsp;</td>
<td>This folder holds the <tt>UserBootscript</tt> which is executed after the system has booted up and the <tt>UserShutdownscript</tt> which will be executed before the system does all the necessary things to safely shut down.</td></tr>
<tr><td><tt>~/config/fonts/</tt></td><td>&nbsp;</td>
<td>Simply copy a TrueType or Postscript font into this folder and its usable right away.</td></tr>
<tr><td><tt>~/config/settings/</tt></td><td>&nbsp;</td>
<td>This folder contains the settings to all applications and a few configurations for the system. Some applications manage their settings in their own subfolders, others simply put their configuration file in there.</td></tr>
<tr><td><tt>~/config/settings/beos_mime/</tt></td><td>&nbsp;</td>
<td>In this <acronym title="Multipurpose Internet Mail Extensions">MIME</acronym> database Haiku keeps track of all the different <a href="filetypes.html">filetypes</a> and their settings.</td></tr>
<tr><td class="onelinetop"><tt>~/config/settings/kernel/drivers/</tt></td><td>&nbsp;</td>
<td>There, one settings files that may be of interest. <tt>kernel</tt> offers some low level configurations like disabling <acronym title="Symmetric Multi Processing">SMP</acronym>, activating serial debugging or enabling advanced power management. You activate a configuration line by removing the commentary symbol "<tt>#</tt>". Be careful here!</td></tr>
<tr><td><tt>~/config/settings/Tracker/</tt></td><td>&nbsp;</td>
<td>Here are some interesting subfolders:</td></tr>
<tr><td align="right"><tt>DefaultFolderTemplate/</tt></td><td width="10"></td><td>Show and arrange all attributes and the window size to your liking. Every new folder you create will use it as a template.</td></tr>
<tr><td align="right"><tt>DefaultQueryTemplates/</tt></td><td></td><td>You can define the layout of query result windows for certain filetypes. See topic <a href="queries.html#result-window">Query: The result window</a>.</td></tr>
<tr><td align="right"><tt>Go/</tt></td><td></td><td>Put links to your favorite locations in here to make them available e.g. in open and save panels. See topic <a href="gui.html#favorites-recent">Haiku's GUI: Favorites and recent folders</a>.</td></tr>
<tr><td align="right"><tt>Tracker New Template/</tt></td><td></td><td>Add a template for any filetype that's then available from Tracker's <i>File | New...</i> menu. See topic <a href="tracker.html#working-with-files">Tracker: Working with files</a>.</td></tr></td></tr>
</table>
</p>
</div>
<div class="bottomnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Previous: <a href="bootloader.html">Boot Loader</a>
&nbsp;&nbsp;&nbsp;
Next: <a href="gui.html">Haiku's GUI</a>
</p>
</div>
</body>
</html>

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

View File

@ -0,0 +1,78 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>Shortcuts and key combinations</title>
<link rel="stylesheet" type="text/css" href="../welcome/welcome.css">
</head>
<body lang="en-US">
<div class="logo">
<img src="../welcome/welcome-images/logo.png" alt="logo">
<div class="title">Shortcuts and key combinations</div>
</div>
<div class="topnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Previous: <a href="tracker-add-ons.html">Tracker Add-Ons</a>
&nbsp;&nbsp;&nbsp;
Next: <a href="deskbar.html">Deskbar</a>
</p>
</div>
<div class="content">
<p>By default, Haiku's option key, to invoke commands from menus for example, is not the usual <tt>CTRL</tt> key, but <tt>ALT</tt> instead. This has historical reasons, because the BeOS was inspired somewhat by MacOS. After you get used to it, it actually feels better as e.g. <tt>ALT+C</tt> and <tt>ALT+V</tt> is reached more conveniently on the keyboard and these commands seemlessly integrate into the <acronym title="Bourne Again Shell">bash</acronym> shell of the Terminal.
</p><p>In any case, you can switch to the maybe more familiar <tt>CTRL</tt> key in the <i>Menu</i> preferences. The user guide will always describes the default configuration with the option key being <tt>ALT</tt>.
</p>
<h2><a name="general">General shortcuts</a></h2>
<p>Here's a table of many of the most commonly used shortcuts that are always awailable, even if there isn't a corresponding menu:
</p><p><table border="0" cellpadding="2" cellspacing="0">
<tr><td><tt>ALT+Fx</tt></td><td width="25"></td><td> Switch to <a href="workspaces.html">Workspace</a> X (<tt>Fx</tt> is the function key corresponding to that workspace).</td></tr>
<tr><td><tt>CTRL+TAB</tt></td><td width="25"></td><td> Hold it to brings up the <a href="twitcher.hml">Twitcher</a>.</td></tr>
<tr><td><tt>CTRL+ALT+DEL</tt></td><td width="25"></td><td> Open the <a href="teammonitor.html">Team Monitor</a>.</td></tr>
<tr><td><tt>ALT+ESC</tt></td><td width="25"></td><td> Enter the menu bar (leave with <tt>ESC</tt>).</td></tr>
<tr><td><tt>ALT+C</tt></td><td></td><td> Copy selection to clipboard.</td></tr>
<tr><td><tt>ALT+X</tt></td><td></td><td> Cut selection to clipboard.</td></tr>
<tr><td><tt>ALT+V</tt></td><td></td><td> Paste the clipboard's contents.</td></tr>
<tr><td><tt>ALT+W</tt></td><td></td><td> Close the current window.</td></tr>
<tr><td><tt>ALT+Q</tt></td><td></td><td> Close the whole application.</td></tr>
</table>
</p>
<h2><a name="tracker-navigation">Shortcuts for Tracker navigation</a></h2>
<p>Additionally to the general shortcuts, here are more for navigating with Tracker:
</p><p><table border="0" cellpadding="2" cellspacing="0">
<tr><td><tt>ALT+CURSOR-UP</tt></td><td width="25"></td><td> Open parent folder.</td></tr>
<tr><td class="onelinetop"><tt>ALT+CURSOR-DOWN or RETURN</tt></td><td></td><td> Open selected folder.</td></tr>
<tr><td><tt>WIN-KEY</tt></td><td></td><td> Holding it while opening a folder will automatically close the parent folder. This also works when navigating with the mouse.</td></tr>
<tr><td><tt>right MENU-KEY</tt></td><td></td><td> Open the Deskbar menu (leave with <tt>ESC</tt>)</td></tr>
<tr><td><tt>ALT+Z</tt></td><td></td><td> Undo the last action. The undo history is only limited by the available memory. Note, that this only works for actions on the file itself, changed attributes and permission settings can't be undone. Also, once a file is removed from </i>Trash</i> it's gone for good.</td></tr>
<tr><td><tt>ALT+SHIFT+Z</tt></td><td></td><td> Redo the action you just reverted with <tt>ALT+Z</tt></td></tr>
</table>
</p>
<h2><a name="other-combos">Other key combinations</a></h2>
<p>You can add or remove items to/from a selection by holding down a modifier key while clicking on a entry (or file in case of Tracker).
</p><p><table border="0" cellpadding="2" cellspacing="0">
<tr><td><tt>SHIFT</tt></td><td width="25"></td><td> This will select everything between the first selected item and the one you click on.</td></tr>
<tr><td><tt>ALT</tt></td><td></td><td> Adds or removes the item you're clicking on from the selection.</td></tr>
</table>
</p><p>In a Tracker window, if you just start typing, Tracker scrolls to and selects the file that best fits your incremental search. If there's no file starting with your typed letters, files that contain the search string anywhere in their name or other displayed attributes are selected. This search is <i>not</i> case-sensitive.<br>
The letters you type appear at the bottom-left, where normally the number of items are listed. After a second it reverts back and you could start a new incremental search.
</p>
</div>
<div class="bottomnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Previous: <a href="tracker-add-ons.html">Tracker Add-Ons</a>
&nbsp;&nbsp;&nbsp;
Next: <a href="deskbar.html">Deskbar</a>
</p>
</div>
</body>
</html>

View File

@ -0,0 +1,80 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>Preferences</title>
<link rel="stylesheet" type="text/css" href="../welcome/welcome.css">
</head>
<body lang="en-US">
<div class="logo">
<img src="../welcome/welcome-images/logo.png" alt="logo">
<div class="title">Preferences</div>
</div>
<div class="topnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Previous: <a href="desktop-applets.html">Desktop Applets</a>
&nbsp;&nbsp;&nbsp;
Next: <a href="demos.html">Demos</a>
</p>
</div>
<div class="content">
<p>While a key philosophy of Haiku is to cut down on options and have sensible defaults instead, there are some things that have to be configured or can be set to individual preference.
</p><p><table border="0" cellpadding="0" cellspacing="5" width="100%">
<tr><td><a href="prefs-appearance.html">Appearance</a></td>
<td valign="top">Configure certain aspects of the graphical interface.</td></tr>
<tr><td><a href="prefs-backgrounds.html">Backgrounds</a></td>
<td valign="top">Set a color or image as background of the Desktop or any other folder.</td></tr>
<tr><td><a href="prefs-datatranslations.html">DataTranslations</a></td>
<td valign="top">Settings for all supported file formats.</td></tr>
<tr><td><a href="prefs-e-mail.html">E-mail</a></td>
<td valign="top">Configure your email accounts.</td></tr>
<tr><td><a href="prefs-fileTypes.html">FileTypes</a></td>
<td valign="top">Add, remove and configure filetypes.</td></tr>
<tr><td><a href="prefs-fonts.html">Fonts</a></td>
<td valign="top">Set your system fonts.</td></tr>
<tr><td><a href="prefs-keyboard.html">Keyboard</a></td>
<td valign="top">Configure repeat delay and rate.</td></tr>
<tr><td><a href="prefs-keymap.html">Keymap</a></td>
<td valign="top">Set the mapping of your keyboard.</td></tr>
<tr><td><a href="prefs-media.html">Media</a></td>
<td valign="top">Audio and video settings like volume and in/output devices.</td></tr>
<tr><td><a href="prefs-menu.html">Menu</a></td>
<td valign="top">Configure the behaviour of menus and the command key (<tt>CTRL/ALT</tt>.</td></tr>
<tr><td><a href="prefs-mouse.html">Mouse</a></td>
<td valign="top">Configure your mouse.</td></tr>
<tr><td><a href="prefs-network.html">Network</a></td>
<td valign="top">Configure your network.</td></tr>
<tr><td><a href="prefs-printers.html">Printers</a></td>
<td valign="top">Add, remove and configure printers.</td></tr>
<tr><td><a href="prefs-screen.html">Screen</a></td>
<td valign="top">Configure resolution, depth and refresh rate.</td></tr>
<tr><td><a href="prefs-screensaver.html">ScreenSaver</a></td>
<td valign="top">Add, remove and configure a screen saver.</td></tr>
<tr><td><a href="prefs-sounds.html">Sounds</a></td>
<td valign="top">Assign a sound to different system events.</td></tr>
<tr><td><a href="prefs-time.html">Time</a></td>
<td valign="top">Set time, date and timezone.</td></tr>
<tr><td><a href="prefs-virtualmemory.html">VirtualMemory</a></td>
<td valign="top">Set the amount of swap space.</td></tr>
</table>
</p>
</div>
<div class="bottomnav">
<p>
<a href="contents.html">Contents</a>
&nbsp;&nbsp;&nbsp;
Previous: <a href="desktop-applets.html">Desktop Applets</a>
&nbsp;&nbsp;&nbsp;
Next: <a href="demos.html">Demos</a>
</p>
</div>
</body>
</html>

View File

@ -25,10 +25,10 @@
<p>Applications can install add-ons so they can be invoked easily on a selection of files from Tracker. Only the add-ons that can handle a specific filetype are presented under <i>Add-Ons</i> from the context menu or the <i>File</i> menu of a Tracker window. Some add-ons don't necessarily need a file to work on and are thus always present.
</p><p>Tracker Add-Ons, or links to applications that can act as add-ons, can be installed in three different locations (see topic <a href="filesystem-layout.html">Filesystem layout</a>):
<table border="0" cellpadding="0" cellspacing="0"> <ul>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td><tt>/boot/beos/system/add-ons/Tracker/</tt></td><td>&nbsp;&nbsp;&nbsp;</td><td> for system provided add-ons</td></tr>
<tr><td><tt>/boot/common/add-ons/Tracker/</tt></td><td>&nbsp;&nbsp;&nbsp;</td><td> for add-ons available to every user</td></tr>
<tr><td><tt>/boot/home/config/add-ons/Tracker/</tt></td><td>&nbsp;&nbsp;&nbsp;</td><td> for add-ons of a specific user</td></tr>
<tr><td><tt>/boot/home/config/add-ons/Tracker/</tt></td><td>&nbsp;&nbsp;&nbsp;</td><td> for add-ons only available to yourself</td></tr>
</table>
</p><p>The file name of an add-on can be suffixed with a dash and capital letter, and is then available via keyboard shortcut. For example, <i>Open Target Folder-T</i> opens with <tt>ALT+AltGr+T</tt> (at least with my keymap, you may have a different key combination).<br>
Of course, you have to take care of possible shortcut collisions when deciding on a shortcut. You can't have the same for different add-ons.

View File

@ -30,7 +30,8 @@ Please follow these guidelines to create helpful bug reports:</p>
<li>Mention which revision from <acronym title="Subversion, the source code management system we use">SVN</acronym> you are running. You can find this information in '<i>About This System...</i>' from the Deskbar menu.<br><br></li>
<li>Describe the problem you are experiencing. Try to be as accurate as you can: describe the actual behavior, and the behavior you expected.<br><br></li>
<li>Describe what steps you need to perform in order to expose the bug. This will help developers reproduce the bug.<br><br></li>
<li>Attach as much information as you have. If it is a GUI bug, or a bug in one of the applications, try to make a screen shot (the <tt>PRINT</tt> key files a <acronym title="Portable Network Graphics image format">PNG</acronym> into <tt>/boot/home/</tt>).<br>If it is a hardware problem, include a copy of the <tt>syslog</tt> file (just query for "<tt>syslog</tt>" to find it).</li>
<li>Attach as much information as you have. If it is a GUI bug, or a bug in one of the applications, try to make a screen shot (the <tt>PRINT</tt> key files a <acronym title="Portable Network Graphics image format">PNG</acronym> into <tt>/boot/home/</tt>).<br>If it is a hardware problem, include a copy of the <tt>syslog</tt> file (just query for "<tt>syslog</tt>" to find it).<br><br></li>
<li>When an application crashed, you should invoke the debugger from the alert that pops up. Entering "<tt>bt</tt>" into the launched debug Terminal, you create a "backtrace" that you should copy into your bugreport.</li>
</ul></li><br>
<li>After the bug has been reported, a developer will look at your bug and try to classify it. Remember, we are all volunteers, and as such, sometimes a bug report might go unanswered for a while. Adding new information when it becomes available usually helps getting a bug picked up quicker, but do not try to 'bump' the bug up by adding non-descriptive comments.<br><br></li>
<li>Remember, reporting a bug is not something you spend a little time on and then you are done. If you reported a bug, then you are part of the Haiku development process. Developers might come up with questions while they are trying to fix your bug. Please stay around to answer these. Consider your participation 'done' when the bug is marked as 'fixed'. Together we can improve Haiku, bit by bit.

View File

@ -161,8 +161,15 @@ div.bottomnav p {
font-size: 0.9em;
}
td {
vertical-align: top;
}
td.onelinetop {
vertical-align: top;
white-space: nowrap;
}
tt {
background-color:rgb(240,240,240)
}

View File

@ -21,7 +21,7 @@
<h2><a name="welcome">Welcome to Haiku!</a></h2>
<p>
Thank you very much for checking out Haiku! This is our first public release. We hope to attract new developers to our project and give future users a chance to check out Haiku. We realize that this <i>alpha release</i> does not yet fully live up to the goals that we have set for ourselves and doesn't offer all the features and well-rounded end-user experience planned for the final R1 version. However, we are hoping that this release will let you discover the great potential in Haiku and share with us in the excitement.
Thank you very much for checking out Haiku! This is our first public release. We hope to attract new developers to our project and give future users a chance to check out Haiku. We realize that this <i>alpha release</i> does not yet fully live up to the goals that we have set for ourselves and doesn't offer all the features and well-rounded end-user experience planned for the final R1 version. However, we hope that this release lets you discover Haiku's great potential and that you share our excitement.
</p>
<h2><a name="bugreport">Beware of Bugs</a></h2>