Haiku/userguide
1
0
Fork 0
mirror of https://review.haiku-os.org/userguide synced 2024-11-23 15:18:25 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

* Small improvements here and there, esp. heading hierarchy.

Browse Source 
* Renamed "Showimage" to "ShowImage". Thanks mmadia.
* Some more tweaking of box padding in the CSS.
* Added "Expander", adjusted contents of applications.html


git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@29648 a95241bf-73f2-0310-859d-f6bbb57e9c96
This commit is contained in:
Joachim Seemer 2009-03-22 08:45:56 +00:00
parent 6ae15030c9
commit 71fc2fd7cd
30 changed files with 185 additions and 188 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
userguide/en/applications.html
View File

@ -40,7 +40,7 @@
<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 id="install" name="install">Installing applications</a></h2>
<h1><a id="install" name="install">Installing applications</a></h1>
<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 <span class="app">Expander</span> 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>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
@ -52,15 +52,15 @@ If it's a ZIP archive, double-clicking opens <span class="app">Expander</span> w
<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 <span class="cli">.sh</span>) like <span class="cli">install</span> that you simply double click to have all taken care of.<br />
Sometimes you'll find folders that link to the correct destination named "<span class="cli">drag [filename] here...</span>". 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>
See topic <a href="deskbar.html">Deskbar</a> or <a href="desktop-applets/desktop-applets-launchbox.html">LaunchBox</a> to see how to add shortcuts to your newly installed application.</p>
<h2><a id="uninstall" name="uninstall">Uninstalling applications</a></h2>
<h1><a id="uninstall" name="uninstall">Uninstalling applications</a></h1>
<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 <span class="path">~/config/settings</span> 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 "<span class="cli">drag [filename] here...</span>" folders, those files are also left behind.</p>
<p>This, of course, leaves back possible configuration files in your <span class="path">~/config/settings</span> folder. This may be on purpose, if you want to keep those settings in case you'll install the program again in the future. Also, when the installation involved those "<span class="cli">drag [filename] here...</span>" 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 id="list-of-apps" name="list-of-apps">Haiku's applications</a></h2>
<h1><a id="list-of-apps" name="list-of-apps">Haiku's applications</a></h1>
<p>Haiku comes with a set of mostly small but essential applications. You'll find all of them at <span class="path">/boot/beos/apps/</span> or <span class="path">/boot/common/apps/</span>. Applications that are not usually launched by a double-click on a data file (e.g. ShowImage for image files) can be found in the <span class="menu">Applications</span> menu of the Deskbar.</p>
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
<tr><td style="width:24px;"><img src="../images/apps-images/activitymonitor-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="applications/apps-activitymonitor.html">ActivityMonitor</a></td><td style="width:10px;">&#160;</td>
@ -82,7 +82,7 @@ Otherwise, uninstalling is simply done by deleting the application's folder.</p>
<tr><td style="width:24px;"><img src="../images/apps-images/drivesetup-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="applications/apps-drivesetup.html">DriveSetup</a></td><td>&#160;</td>
<td valign="top"><span style="color:silver">A harddisk partitioning tool. [<i>still missing</i>]</span></td></tr>
<tr><td style="width:24px;"><img src="../images/apps-images/expander-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="applications/apps-expander.html">Expander</a></td><td>&#160;</td>
<td valign="top"><span style="color:silver">A tool to unpack common archives. [<i>still missing</i>]</span></td></tr>
<td valign="top">A tool to unpack common archives.</td></tr>
<tr><td style="width:24px;"><img src="../images/apps-images/icon-o-matic-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="applications/apps-icon-o-matic.html">Icon-O-Matic</a></td><td>&#160;</td>
<td valign="top"><span style="color:silver">An app to create Haiku's vector icons. [<i>still missing</i>]</span></td></tr>
<tr><td style="width:24px;"><img src="../images/apps-images/installer-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="applications/apps-installer.html">Installer</a></td><td>&#160;</td>

2
userguide/en/applications/apps-diskprobe.html
View File

@ -49,7 +49,7 @@ width="64" height="64" />DiskProbe</h1>
</p><p><img id="diskprobe" src="../../images/apps-images/diskprobe.png" alt="diskprobe.png" width="559" height="232" /></p>
<p>The main view shows always one block of data, the size of which can be adjusted with <span class="menu">View | BlockSize</span>. To the left is the offset to the start of the block, in the middle the data as HEX values and to the right the same as ASCII symbols.<br />
You can move from block to block with the slider above or with <span class="key">ALT</span>&#160;<span class="key">&larr;</span> and <span class="key">ALT</span>&#160;<span class="key">&rarr;</span> and switch between the HEX and ASCII columns with <span class="key">TAB</span>.</p>
<p><span class="menu">Block | Selection</span> will not only show the selection with different endianess (and different radix), it will also interprete the selection as a block offset that you can jump to. It will be greyed out if the position is outside of the file/device.<br />
<p><span class="menu">Block | Selection</span> will not only show the selection with different endianess (and different radix), it will also interprete the selection as a block offset that you can jump to. It will be grayed out if the position is outside of the file/device.<br />
This is a handy feature mostly when looking at file systems, as they often contain pointers to other blocks.</p>
<p>If the file you're probing includes attributes, the <span class="menu">Attributes</span> menu can be used to open any of them in a new DiskProbe window. Here's the copyright attribute of the <span class="app">AboutSystem</span> application:
</p><p><img id="diskprobe-attribute" src="../../images/apps-images/diskprobe-about-attr.png" alt="diskprobe-about-attr.png" width="559" height="232" /></p>

23
userguide/en/applications/apps-expander.html
View File

@ -5,7 +5,7 @@
<head>
<!--
*
* Copyright 2008, Haiku. All rights reserved.
* Copyright 2008-2009, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -39,14 +39,27 @@
<h1><img src="../../images/apps-images/expander-icon_64.png" alt="expander-icon_64.png"
width="64" height="64" />Expander</h1>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
<tr><td>Deskbar:</td><td style="width:15px;"></td><td><span class="menu">---</span></td></tr>
<tr><td>Deskbar:</td><td style="width:15px;"></td><td><i>No entry, normally launched via double-clicking a supported file.</i></td></tr>
<tr><td>Location:</td><td></td><td><span class="path">/boot/beos/apps/Expander</span></td></tr>
<tr><td>Settings:</td><td></td><td><span class="path">~/config/settings/Expander_Settings</span></td></tr>
</table>
<p>Documentation is still missing. If you want to work on it, please announce it on the <a href="http://www.freelists.org/list/haiku-doc">Documentation mailing list</a> to avoid duplication.</p>
<p>Expander is a small tool to quickly unpack the most common archives, among them zip, gzip, bzip2, rar and tar.gz.<br />
Just double-click an archive to see this simple interface:</p>
<p><img id="expander" src="../../images/apps-images/expander.png" alt="expander.png" width="480" height="257" /></p>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
<tr><td style="width:80px;"><span class="button">Source</span></td><td style="width:70px;"><span class="key">ALT</span>&#160;<span class="key">S</span></td><td>will open a file dialog to find an archive to unpack.</td></tr>
<tr><td><span class="button">Destination</span></td><td><span class="key">ALT</span>&#160;<span class="key">D</span></td><td>will open a file dialog to set the destination.</td></tr>
<tr><td><span class="button">Expand</span></td><td><span class="key">ALT</span>&#160;<span class="key">E</span></td><td>will start the unpacking. It can be aborted with <span class="key">ALT</span>&#160;<span class="key">K</span>.</td></tr>
</table>
<p>You can toggle the display of the file listing by un/checking <i>Show Contents</i> or pressing <span class="key">ALT</span>&#160;<span class="key">L</span>.</p>
<div class="box-info">Expander can only unpack whole archives.<br />
You can't select individual files to expand or add/remove files from the archive.</div>
<p><span class="menu">Edit | Preferences...</span> or <span class="key">ALT</span>&#160;<span class="key">P</span> opens a preference panel that offers some useful settings to adjust Expander's behavior.<br />
The options are all self-explanatory:
<p><img id="preferences" src="../../images/apps-images/expander-preferences.png" alt="expander-preferences.png" width="362" height="327" /></p>
</div>
<!--
<div class="bottomnav">
<p>
<a href="../applications.html">Applications</a>
@ -56,6 +69,6 @@ width="64" height="64" />Expander</h1>
Next: <a href="apps-icon-o-matic.html">Icon-O-Matic</a>
</p>
</div>
-->
</body>
</html>

10
userguide/en/applications/apps-showimage.html
View File

@ -15,14 +15,14 @@
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="robots" content="all" />
<title>Showimage</title>
<title>ShowImage</title>
<link rel="stylesheet" type="text/css" href="../../../Haiku-doc.css" />
</head>
<body>
<div class="logo">
<img src="../../images/logo.png" alt="logo" width="372" height="86" />
<div class="title">Showimage</div>
<div class="title">ShowImage</div>
</div>
<div class="topnav">
<p>
@ -37,12 +37,12 @@
<div class="content">
<h1><img src="../../images/apps-images/showimage-icon_64.png" alt="showimage-icon_64.png"
width="64" height="64" />Showimage</h1>
width="64" height="64" />ShowImage</h1>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
<tr><td>Deskbar:</td><td style="width:15px;"></td><td><i>No entry, normally launched via
double-clicking a supported file.</i></td></tr>
<tr><td>Location:</td><td></td><td><span class="path">/boot/beos/apps/Showimage</span></td></tr>
<tr><td>Settings:</td><td></td><td><span class="path">~/config/settings/Showimage_settings</span></td></tr>
<tr><td>Location:</td><td></td><td><span class="path">/boot/beos/apps/ShowImage</span></td></tr>
<tr><td>Settings:</td><td></td><td><span class="path">~/config/settings/ShowImage_settings</span></td></tr>
</table>
<p>Documentation is still missing. If you want to work on it, please announce it on the <a href="http://www.freelists.org/list/haiku-doc">Documentation mailing list</a> to avoid duplication.</p>

10
userguide/en/attributes.html
View File

@ -5,7 +5,7 @@
<head>
<!--
*
* Copyright 2008, Haiku. All rights reserved.
* Copyright 2008-2009, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -44,14 +44,14 @@
<p>As you can see, these are all 0-sized files with attached attributes, the E-mail attribute of "John Nox" being edited right in Tracker.</p>
<p>If you index these attributes, as People, Email or audio files are by default, they are also searchable with Haiku's fast query system.</p>
<h2><a id="attributes-tracker" name="attributes-tracker">Attributes in Tracker</a></h2>
<h1><a id="attributes-tracker" name="attributes-tracker">Attributes in Tracker</a></h1>
<p>Attributes are displayed quite similar to a database or spreadsheet. Using Tracker you can choose which attributes to display (columns) and sort file listings (rows) accordingly.</p>
<p>To do this, open a Tracker window, click on the <span class="menu">Attributes</span> menu, and select the attributes you want to display. Alternatively, simply right-click onto a column heading and mark the items in the context menu. You can rearrange the columns by a simple drag&amp;drop of the column heading. Moving a column out of a window, is a fast way to get rid of columns you don't need.</p>
<p>Double-click on the line between two attributes in the heading to automatically resize a column to its optimal width.</p>
<p>Click on a column heading to toggle the sorting order from ascending to descending. You can establish a secondary sort order by pressing the <span class="key">SHIFT</span> key while clicking on a column heading. Doing that you can, for example, sort your People files by company and within that order sort by contact name. See the above screenshot as an example. The secondary sort order is marked by a dotted line under the heading.</p>
<p>Editing these attributes is as simple as renaming a file: Either click on an entry or press <span class="key">ALT</span>&#160;<span class="key">E</span> and move between the attibutes with <span class="key">TAB</span> and <span class="key">SHIFT</span>&#160;<span class="key">TAB</span>. <span class="key">ESC</span> leaves the editing mode without applying the changes.</p>
<p>Editing these attributes is as simple as renaming a file: Either click on an entry or press <span class="key">ALT</span>&#160;<span class="key">E</span> and move between the attributes with <span class="key">TAB</span> and <span class="key">SHIFT</span>&#160;<span class="key">TAB</span>. <span class="key">ESC</span> leaves the editing mode without applying the changes.</p>
<h2><a id="attributes-terminal" name="attributes-terminal">Attributes in Terminal</a></h2>
<h1><a id="attributes-terminal" name="attributes-terminal">Attributes in Terminal</a></h1>
<p>If you prefer to use the commandline or plan to work with many files using scripting, there are several commands for controlling attributes from Terminal:</p>
<ul><li><b>listattr</b> - lists a file's attributes, but doesn't show the contents of the attributes.<br />
<pre>usage: listattr 'filename' ['filename' ...]</pre>
@ -85,7 +85,7 @@ MIME String 21 &quot;BEOS:TYPE&quot;
<ul>
<li><p><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.</p></li>
<li><p>"<tt>_trk/pinfo_le</tt>" is the attribute with which Tracker keeps track of a file's icon position.</p></li></ul>
<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".</p></li>
<div class="box-info">Note the backslash after "Clara". In Terminal you have to "escape" special characters like <tt>'"*\$?!</tt>. 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".</div></li>
</ul>
<p><br /></p>
<ul><li><b>catattr</b> - displays the contents of a specific attribute of a file.

7
userguide/en/bootloader.html
View File

@ -36,7 +36,7 @@
<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 />
<p>Haiku's Boot Loader can help 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 <span class="key">SPACE BAR</span> 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>
<p><br /></p>
@ -53,9 +53,8 @@ It's also handy after you installed a software component that acts up and preven
- Disable APM<br />
- Disable ACPI<br />
- Enable on screen debug output</i>
</p>
<p>&#160;</p></td></tr>
<tr><td class="onelinetop"><b>Select fail safe video mode</b></td><td>&#160;</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>
</p></td></tr>
<tr><td class="onelinetop"><b>Select fail safe video mode</b></td><td>&#160;</td><td>If you had to activate the option <i>Use fail-safe video mode</i>, you can set resolution and color depth.</td></tr>
</table>
<p><br /></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>

22
userguide/en/deskbar.html
View File

@ -5,7 +5,7 @@
<head>
<!--
*
* Copyright 2008, Haiku. All rights reserved.
* Copyright 2008-2009, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -41,13 +41,13 @@
<img src="../images/deskbar-images/positions.png" alt="positions" width="640" height="480" />
<p>You can move the Deskbar to any corner or as a bar along the upper or lower border of the screen by gripping the knobbly area on the left side of the tray and drag&amp;drop it into the new position. You can also fold it into a more compact layout by drag&amp;dropping the knobbly area onto the Deskbar menu.</p>
<h2><a id="deskbar-menu" name="deskbar-menu">The Deskbar Menu</a></h2>
<h1><a id="deskbar-menu" name="deskbar-menu">The Deskbar Menu</a></h1>
<p>A menu opens when you click on the Deskbar's uppermost part:</p>
<img src="../images/deskbar-images/settings.png" alt="settings.png" width="521" height="309" />
<ul>
<li><p><b>About This System...</b> - Shows some basic information of the system, licenses and the credits of the Haiku project.</p></li>
<li><p><b>Find...</b> - Opens the query dialog.</p></li>
<li><p><b>Find...</b> - Opens the <a href="queries.html">Query</a> dialog.</p></li>
<li><p><b>Show Replicants</b> - Shows/hides the little Replicant widget you use to drag it around, remove or access its context menu.</p></li>
<li><p><b>Deskbar Settings</b></p>
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
@ -69,23 +69,23 @@
<li><p><b>Applications, Demos, Deskbar Applets, Preferences</b> - List of installed applications, demos, applets and preferences (see <span class="menu">Configure Deskbar Menu...</span> below).</p></li>
</ul>
<h3>Configure Deskbar Menu...</h3>
<h2>Configure Deskbar Menu...</h2>
<img src="../images/deskbar-images/configure.png" alt="configure.png" width="359" height="416" />
<p>In this panel you set how many recent documents, folders and applications are shown in the Deskbar, or if you show them at all.</p>
<p>In this panel you set the number of recent documents, folders and applications that are shown in the Deskbar, or if you show them at all.</p>
<p>Here, you also configure folders and their contents, which are by default Applications, Demos, Deskbar Applets, and Preferences. You can add your own entries and edit or remove items.<br />
This part of the panel is just a representation of the folder <span class="path">/boot/home/config/be/</span>. You can just as well link or copy files and folders directly in Tracker to configure your Deskbar.<br />
Another method is to simply drag a file or folder and drop it where you want it into the Deskbar.</p>
This part of the panel is just a representation of the folder <span class="path">/boot/home/config/be/</span>. You can just as well link or copy files and folders directly in Tracker to configure your Deskbar.</p>
<p>Even easier is it to simply drag a file or folder and drop it where you want it into the Deskbar.</p>
<h2><a id="tray" name="tray">The Tray</a></h2>
<h1><a id="tray" name="tray">The Tray</a></h1>
<img src="../images/deskbar-images/calendar.png" alt="calendar.png" width="229" height="210" />
<p>Among other things, the tray's housing the clock. Left-click it to toggle between date and time. Right-click it to hide/show it or launch the <a href="prefs-time.html">Time</a> preferences to set it.<br />
<p>Among other things, the tray is housing the clock. Left-click it to toggle between date and time. Right-click it to hide/show it or launch the <a href="prefs-time.html">Time</a> preferences to set it.<br />
Here you can also launch a calendar that also appears, when you hold down the left mouse button on the clock for a little time.</p>
<p>Any program can install an icon in the tray to provide an interface to the user. The email system, for instance, shows a different symbol when there's unread mail and offers a context menu to e.g. create or check for new mail. <span class="app">ProcessController</span> is another example that uses its icon in the tray to provide information (CPU/memory usage) and to offer a context menu.</p>
<h2><a id="list-of-apps" name="list-of-apps">The list of running programs</a></h2>
<h1><a id="list-of-apps" name="list-of-apps">The list of running programs</a></h1>
<img src="../images/deskbar-images/list-of-apps.png" alt="list-of-apps.png" width="229" height="306" />
<p>You can change to a specific running application by clicking on its entry in the Deskbar and choosing (one of) its windows, from the submenu. By right-clicking you can minimize or close a window or the entire application.</p>
<p>If you activated Expanders in the Deskbar settings, you can show/hide the list of windows directly under an application's entry.</p>
<p>If you activated Expanders in the Deskbar settings, you can expand/collapse the list of windows directly under an application's entry.</p>
<p>In front of every application's windows is a symbol providing info on its state. A bright symbol means a window is visible, a dark one that it's minimized. Three lines in front of a symbol shows that it's not on the current workspace.</p>
</div>

4
userguide/en/desktop-applets.html
View File

@ -5,7 +5,7 @@
<head>
<!--
*
* Copyright 2008, Haiku. All rights reserved.
* Copyright 2008-2009, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -36,7 +36,7 @@
<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>Haiku provides a few useful tools that can be installed on the Desktop or the Deskbar via their Replicants.</p>
<table summary="desktop-applets" border="0" cellpadding="2" cellspacing="0">
<tr><td style="width:24px;"><img src="../images/desktop-applets-images/launchbox-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="desktop-applets/desktop-applets-launchbox.html">LaunchBox</a></td><td style="width:10px;">&#160;</td>
<td valign="top">Shortcuts to your favorite applications.</td></tr>

10
userguide/en/filesystem-layout.html
View File

@ -40,14 +40,14 @@
<img src="../images/filesystem-layout-images/achtung-user.png" alt="achtung-user.png" width="349" height="121" />&#160;
<img src="../images/filesystem-layout-images/achtung-system.png" alt="achtung-system.png" width="349" height="151" />
<p>The second alert pops up if you try to rename or delete something in the system hierarchy. Here, the "<span class="button">Do it</span>" button will only become clickable when you're holding down the <span class="key">SHIFT</span> key.</p>
<p>Generally, there are three seperate branches springing from the root folder of the boot volume:</p>
<p>Generally, there are three separate branches springing from the root folder of the boot volume:</p>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
<tr><td><span class="path">/boot/beos/</span></td><td>&#160;</td><td>belongs to the system. Don't touch!</td></tr>
<tr><td><span class="path">/boot/common/</span></td><td>&#160;</td><td>holds files that are shared between users.</td></tr>
<tr><td><span class="path">/boot/home/</span></td><td>&#160;</td><td>is your personal folder where you keep your data and settings.</td></tr>
</table>
<h2><a id="system" name="system">The system folder - <span class="path">/boot/beos/</span></a></h2>
<h1><a id="system" name="system">The system folder - <span class="path">/boot/beos/</span></a></h1>
<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 <span class="path">/boot/home/</span> hierarchy or, if it's supposed to be for every user, under <span class="path">/boot/common/</span>. 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 />
@ -69,10 +69,10 @@ If you do want to know more about how things tick in Haiku, have a look at this
-->
</p>
<h2><a id="common" name="common">The common folder - <span class="path">/boot/common/</span></a></h2>
<h1><a id="common" name="common">The common folder - <span class="path">/boot/common/</span></a></h1>
<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 id="home" name="home">The home folder - <span class="path">/boot/home/</span></a></h2>
<h1><a id="home" name="home">The home folder - <span class="path">/boot/home/</span></a></h1>
<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 <span class="path">~/config/</span> directory and its subfolders. You <i>could</i> delete e.g. the <span class="path">~/config/settings/</span> 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 <span class="path">~/config/add-ons/</span> 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 "<span class="path">/boot/home/</span>" in Terminal.)</p>
<table summary="layout" border="0" cellspacing="0" cellpadding="4">
@ -101,7 +101,7 @@ If you do want to know more about how things tick in Haiku, have a look at this
<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"><span class="path">~/config/settings/kernel/drivers/</span></td><td>&#160;</td>
<td>There, one settings files that may be of interest. <span class="cli">kernel</span> 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>
<td>There's one settings file that may be of interest: <span class="cli">kernel</span> 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><span class="path">~/config/settings/Tracker/</span></td><td>&#160;</td>
<td>Here are some interesting subfolders:</td></tr>

22
userguide/en/filetypes.html
View File

@ -38,31 +38,26 @@
<p>Other than Windows, Haiku doesn't rely on the 3-letter file extension for a file type (e.g. .txt, .jpg, .mp3). This method is only a last resort fallback. Haiku uses <acronym title="Multipurpose Internet Mail Extensions">MIME</acronym> types just like it's custom on the internet.</p>
<h3><a id="specific-file" name="specific-file">Setting the filetype of a specific file</a></h3>
<h1><a id="specific-file" name="specific-file">Setting the filetype of a specific file</a></h1>
<p>You can change the type of a specific file, its icon and the associated application. Select the file and invoke the <span class="menu">Add-Ons | Filetype add-on</span> from the right-click context menu.</p>
<img src="../images/filetypes-images/filetype-addon.png" alt="filetype-addon.png" width="288" height="212" />
<h3><a name="filetype">The File Type</a></h3>
<h2><a name="filetype">The File Type</a></h2>
<p>This is a JPEG file, it's MIME string image/jpeg. Let's say you definitely know that it's not a JPEG but a GIF. You can change that either by entering the correct MIME string by hand or with one of the two buttons below the textbox:</p>
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
<tr><td><span class="button">Select...</span></td><td>&#160;</td><td>shows a hierarchical list of filetypes where you navigate to <tt>image | GIF Image</tt>.</td></tr>
<tr><td><span class="button">Same as...</span></td><td>&#160;</td><td>opens a file dialog where you choose any file that already has the filetype you're looking for.</td></tr>
</table>
<h3><a id="preferred-app" name="preferred-app">The Preferred Application</a></h3>
<h2><a id="preferred-app" name="preferred-app">The Preferred Application</a></h2>
<p>This drop-down menu shows a list of all applications that can handle this particular filetype. From here you can choose which program should open this specific file when it's double-clicked. You could, for example, change a HTML file's preferred application from the browser to a text editor while you're working on it. Every other HTML file still opens in the browser, only this particular one starts in your text editor.</p>
<p>The <span class="menu">Default Application</span> is the one that's set globally for that filetype. If you don't find the program you want to associate with this file in the drop-down menu, you'll again find the buttons <span class="button">Select...</span> and <span class="button">Same As...</span> which do the similar thing described under "The File Type" above.</p>
<h3><a id="icon" name="icon">The Icon</a></h3>
<h2><a id="icon" name="icon">The Icon</a></h2>
<p>If you're wondering why the icon well on the top right is empty: Icons are normally inherited from the system default for that filetype. You can open the <span class="app">Filetype Add-On</span> of a file that contains an icon and drag&amp;drop it into your file's icon well. Or you double-click the icon well and create or edit your own icon in <span class="app">Icon-O-Matic</span>.</p>
<h2><a id="filetypes-preferences" name="filetypes-preferences">Global settings with the Filetypes Preferences</a></h2>
<p>The <span class="app">Filetypes</span> preferences don't deal with individual files but with global settings of filetypes. You can change default icons and preferred applications or add, remove, or alter attributes of whole filetypes. You can even create your own filetype from scratch.</p>
<p>All filetypes and their configurations are stored in <span class="path">/boot/home/config/settings/beos_mime/</span>. Before you start experimenting, it may be prudent to make a backup of that folder...</p>
<p>To learn more about the <span class="app">Filetypes</span> preferences see the workshop: <a href="workshop-filetypes+attributes.html">Filetypes, Attributes, Index and Queries</a>.</p>
<h2><a id="settings-apps" name="settings-apps">Special settings for applications</a></h2>
<h1><a id="settings-apps" name="settings-apps">Special settings for applications</a></h1>
<p>If you invoke the <span class="app">Filetype Add-On</span> on an executable (here: <span class="app">StyledEdit</span>), you'll get a different dialog:</p>
<img src="../images/filetypes-images/filetype-addon-stylededit.png" alt="filetype-addon-stylededit.png" width="353" height="422" />
<p>On top, you'll see, instead of a standardized MIME string, the unique application signature. With it, the system finds the program wherever it's installed.</p>
@ -72,11 +67,16 @@
<tr><td><span class="menu">Multiple Launch</span></td><td>&#160;</td><td>Many instances of the app can run simultaneously.</td></tr>
<tr><td class="onelinetop"><span class="menu">Exclusive Launch</span></td><td>&#160;</td><td>Really only one instance with that app's signature is allowed to run at a time.</td></tr>
<tr><td><span class="menu">Args Only</span></td><td>&#160;</td><td>Indicates the app doesn't respond to messages.</td></tr>
<tr><td><span class="menu">Background App</span></td><td>&#160;</td><td>The app won't appear in Twitcher or the list of running apps of the Deskbar.</td></tr>
<tr><td><span class="menu">Background App</span></td><td>&#160;</td><td>The app won't appear in <a href="twitcher.html">Twitcher</a> or the list of running apps of the Deskbar.</td></tr>
</table>
<p>Then there's the list of supported filetypes. You can add (and remove) filetypes if you think the application can handle them. As a consequence, the app will appear in the menu for preferred applications or Tracker's <span class="menu">Open with...</span> context menu when you right-click on a file of that type.</p>
<p>At the bottom are version and copyright information. Like the application signature, they are filled in by the app's author and shouldn't be altered.</p>
<h1><a id="filetypes-preferences" name="filetypes-preferences">Global settings with the Filetypes Preferences</a></h1>
<p>The <span class="app">Filetypes</span> preferences don't deal with individual files but with global settings of filetypes. You can change default icons and preferred applications or add, remove, or alter attributes of whole filetypes. You can even create your own filetype from scratch.</p>
<p>All filetypes and their configurations are stored in <span class="path">/boot/home/config/settings/beos_mime/</span>. Before you start experimenting, it may be prudent to make a backup of that folder...</p>
<p>To learn more about the <span class="app">Filetypes</span> preferences see the workshop: <a href="workshop-filetypes+attributes.html">Filetypes, Attributes, Index and Queries</a>.</p>
</div>
<div class="bottomnav">

8
userguide/en/gui.html
View File

@ -51,14 +51,14 @@
<li><p>The resize button. Dragging anywhere else on a window's border will move the window.</p></li>
</ol>
<h2><a id="open-save-panel" name="open-save-panel">Open and save panels</a></h2>
<h1><a id="open-save-panel" name="open-save-panel">Open and save panels</a></h1>
<p>When opening or saving a file from any application, a panel like this opens:</p>
<img src="../images/gui-images/open-save.png" alt="open-save.png" width="645" height="362" />
<p>It has all the usual things: A list of files of the current folder to choose from, in case of a save panel, a text field to enter a filename and a drop-down menu for different file formats and their settings.<br />
You can enter parent folders with the drop-down menu above the file listing.</p>
<p>If you already have a Tracker window with the location for a file open, you can simply drag either any file or the folder-representation (i.e. the symbol to the far right in its menubar) into the panel. This changes the panel to that new location.</p>
<p>If you already have a Tracker window with the location for a file open, you can simply drag either any file or the folder-representation (i.e. the symbol to the far right in its menu bar) into the panel. This changes the panel to that new location.</p>
<h3><a id="open-save-shortcuts" name="open-save-shortcuts">Keyboard shortcuts</a></h3>
<h2><a id="open-save-shortcuts" name="open-save-shortcuts">Keyboard shortcuts</a></h2>
<p>You can use many of the shortcuts also used in Tracker. Besides the commands that are also available through the <span class="menu">File</span> menu, there are a few not that obvious:</p>
<table summary="shortcuts" border="0" cellspacing="0" cellpadding="2">
<tr><td><span class="key">ALT</span>&#160;<span class="key">N</span></td><td></td><td> Creates a new folder.</td></tr>
@ -69,7 +69,7 @@ You can enter parent folders with the drop-down menu above the file listing.</p>
<tr><td><span class="key">ALT</span>&#160;<span class="key">H</span></td><td></td><td> Takes you to your Home folder.</td></tr>
</table>
<h3><a id="favorites-recent" name="favorites-recent">Favorites and recent folders</a></h3>
<h2><a id="favorites-recent" name="favorites-recent">Favorites and recent folders</a></h2>
<p>The menu <span class="menu">Favorites</span> provides recently visited folders and favorite locations that you can set up yourself. As indicated by the little arrow, you can also use these locations to navigate further down the hierarchy via submenus.</p>
<img src="../images/gui-images/favorites.png" alt="favorites.png" width="455" height="209" />
<p>To add a Favorite, you simply navigate to your destination and choose <span class="menu">Favorites | Add Current Folder</span>. From now on it will appear in every open/save panel. To remove a Favorite, choose <span class="menu">Favorites | Configure Favorites...</span> and delete its entry.<br />

2
userguide/en/index.html
View File

@ -39,7 +39,7 @@
<p><a href="attributes.html">Attributes</a> and <a href="queries.html">Queries</a> are key features of Haiku. While attributes are useful on their own, to display additional information on a file, for a query on them, they need to be indexed. It puts them into a lookup table, which in turn makes queries lightning fast.<br />
The index is part of the filesystem and is kept for every volume/partition separately.</p>
<h2>Indexing commands in Terminal</h2>
<h1>Indexing commands in Terminal</h1>
<p>There are several commands to manage the index:</p>
<ul>
<li><b>lsindex</b> - Displays the indexed attributes on the current volume/partition.

61
userguide/en/keyboard-shortcuts.html
View File

@ -5,7 +5,7 @@
<head>
<!--
*
* Copyright 2008, Haiku. All rights reserved.
* Copyright 2008-2009, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -39,72 +39,57 @@
<p>By default, Haiku's option key, to invoke commands from menus for example, is not the usual <span class="key">CTRL</span> key, but <span class="key">ALT</span> 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. <span class="key">ALT</span>&#160;<span class="key">C</span> and <span class="key">ALT</span>&#160;<span class="key">V</span> is reached more conveniently on the keyboard and these commands seamlessly integrate into the <acronym title="Bourne Again Shell">bash</acronym> shell of the Terminal, where <span class="key">CTRL</span>&#160;<span class="key">C</span> quits the running process.</p>
<p>In any case, you can switch to the maybe more familiar <span class="key">CTRL</span> key in the <a href="prefs-menu.html">Menu</a> preferences. The user guide will always describes the default configuration with option key being <span class="key">ALT</span>.</p>
<h2><a id="general" name="general">General shortcuts</a></h2>
<h1><a id="general" name="general">General shortcuts</a></h1>
<p>Here's a table of many of the most commonly used shortcuts that are always available, even if there isn't a corresponding menu:</p>
<table summary="shortcuts" border="0" cellspacing="0" cellpadding="4">
<tr><td><span class="key">ALT</span>&#160;<span class="key">Fx</span></td><td style="width:15px;"></td><td>Switches to <a href="workspaces.html">Workspace</a> X (<span class="key">Fx</span> is the function key corresponding to that workspace).</td></tr>
<tr><td><span class="key">CTRL</span>&#160;<span class="key">TAB</span></td><td></td><td>Hold down to bring up the <a href="twitcher.hml">Twitcher</a>.</td></tr>
<tr><td><span class="key">CTRL</span>&#160;<span class="key">ALT</span>&#160;<span class="key">DEL</span></td><td></td><td>Opens the <a href="teammonitor.html">Team Monitor</a>.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">ESC</span></td><td></td><td>Enters the menu bar (leave with <span class="key">ESC</span>).</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">C</span></td><td></td><td>Copies selection to clipboard.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">X</span></td><td></td><td>Cuts selection to clipboard.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">C</span></td><td></td><td>Copies the selection to the clipboard.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">X</span></td><td></td><td>Cuts the selection to the clipboard.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">V</span></td><td></td><td>Pastes the clipboard's contents.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">W</span></td><td></td><td>Closes the current window.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">Q</span></td><td></td><td>Closes the whole application.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">Q</span></td><td></td><td>Quits an application.</td></tr>
</table>
<h2><a id="tracker-navigation" name="tracker-navigation">Shortcuts for Tracker navigation</a></h2>
<p>Additionally to the general shortcuts, here are more for navigating with Tracker:</p>
<h1><a id="tracker-navigation" name="tracker-navigation">Shortcuts for Tracker navigation</a></h1>
<p>Additionally to the general shortcuts, here are some more for navigating with Tracker:</p>
<table summary="shortcuts" border="0" cellspacing="0" cellpadding="4">
<tr><td><span class="key">ALT</span>&#160;<span class="key">&uarr;</span></td><td style="width:15px;"></td><td>Opens the parent folder.</td></tr>
<tr><td class="onelinetop"><span class="key">ALT</span>&#160;<span class="key">&darr;</span> or <span class="key">ENTER</span></td><td></td><td>Opens the selected folder.</td></tr>
<tr><td><span class="key">WIN-KEY</span></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><span class="key">right MENU-KEY</span></td><td></td><td>Opens the Deskbar menu (leave with <span class="key">ESC</span>)</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">Z</span></td><td></td><td>Undo 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><span class="key">ALT</span>&#160;<span class="key">SHIFT</span>&#160;<span class="key">Z</span></td><td></td><td>Redo the action you just reverted with <span class="key">ALT</span>&#160;<span class="key">Z</span></td></tr>
<tr><td><span class="key">WIN</span></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><span class="key">right MENU</span></td><td></td><td>Opens the Deskbar menu (leave with <span class="key">ESC</span>).</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">Z</span></td><td></td><td>Undo last action. The undo history is only limited by the available memory. Note, this only works for actions on the file itself, changed attributes and permission settings can't be undone with this. Also, once a file is removed from <i>Trash</i> it's gone for good.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">SHIFT</span>&#160;<span class="key">Z</span></td><td></td><td>Redo the action you just reverted with <span class="key">ALT</span>&#160;<span class="key">Z</span>.</td></tr>
</table>
<h2><a id="terminal" name="terminal">Shortcuts in Terminal</a></h2>
<h1><a id="terminal" name="terminal">Shortcuts in Terminal</a></h1>
<table summary="shortcuts" border="0" cellspacing="0" cellpadding="4">
<tr><td><span class="key">ALT</span>&#160;<span class="key">N</span></td><td style="width:15px;"></td><td>Opens another Terminal session in a new
window.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">T</span></td><td></td><td>Opens another Terminal session in a new
tab.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">N</span></td><td style="width:15px;"></td><td>Opens another Terminal session in a new window.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">T</span></td><td></td><td>Opens another Terminal session in a new tab.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">1</span>, <span class="key">2</span>, <span class="key">3</span>...</td><td></td><td>Switches to the corresponding tab.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">G</span></td><td></td><td>Switch to the next Terminal window.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">+</span>, <span class="key">-</span></td><td></td><td>Increase/Decrease font size.</td></tr>
<tr><td><span class="key">ALT</span>&#160;<span class="key">ENTER</span></td><td></td><td>Enter/leave fullscreen mode.</td></tr>
<tr><td class="onelinetop"><span class="key">SHIFT</span>&#160;<span class="key">&uarr;</span>/<span class="key">&darr;</span></td><td></td><td>Scrolls the Terminal
output up/down one line.</td></tr>
<tr><td class="onelinetop"><span class="key"> SHIFT</span>&#160;<span class="key">PAGE UP/DOWN </span></td><td></td><td> Scrolls the Terminal
output up/down one page.</td></tr>
<tr><td><span class="key">TAB</span></td><td></td><td>Tab-completion. After entering a few
letters, press <span class="key">TAB</span> once to auto-complete a filename or path. If
there are more than one match, it stops where the name starts to differ
and you have to provide some more letters to further distinguish them.
You can also press <span class="key">TAB</span> twice to have all matches
listed.</td></tr>
<tr><td><span class="key">&uarr;</span>/<span class="key">&darr;</span></td><td></td><td>Moves up or down in a list of
all previously entered commands.</td></tr>
<tr><td class="onelinetop"><span class="key">SHIFT</span>&#160;<span class="key">&uarr;</span>/<span class="key">&darr;</span></td><td></td><td>Scrolls the Terminal output up/down one line.</td></tr>
<tr><td class="onelinetop"><span class="key"> SHIFT</span>&#160;<span class="key">PageUP</span>/<span class="key">PageDOWN</span></td><td></td><td> Scrolls the Terminal output up/down one page.</td></tr>
<tr><td><span class="key">TAB</span></td><td></td><td>Tab-completion. After entering a few letters, press <span class="key">TAB</span> once to auto-complete a filename or path. If there is more than one match, it stops where the name starts to differ and you have to provide some more letters to further distinguish them. You can also press <span class="key">TAB</span> twice to have all matches listed.</td></tr>
<tr><td><span class="key">&uarr;</span>/<span class="key">&darr;</span></td><td></td><td>Moves up or down in a history of all previously entered commands.</td></tr>
<tr><td><span class="key">CTRL</span>&#160;<span class="key">R</span></td><td></td><td>Bash history. All the commands you enter
are stored in the file <span class="path">~/.bash_history</span>. Press <span class="key">CTRL</span>&#160;<span class="key">R</span>
and start to enter a command and you'll be provided with the first match
from the bash history. Keep pressing <span class="key">CTRL</span>&#160;<span class="key">R</span> until you find the
right command line and press enter to execute it.</td></tr>
<tr><td><span class="key">CTRL</span>&#160;<span class="key">C</span></td><td></td><td>Stops the currently running
command.</td></tr>
<tr><td><span class="key">CTRL</span>&#160;<span class="key">D</span></td><td></td><td>Closes the current Terminal
session.</td></tr>
are stored in the file <span class="path">~/.bash_history</span>. Press <span class="key">CTRL</span>&#160;<span class="key">R</span> and start to enter a command and you'll be provided with the first match from the bash history. Keep pressing <span class="key">CTRL</span>&#160;<span class="key">R</span> until you find the right command line and press enter to execute it.</td></tr>
<tr><td><span class="key">CTRL</span>&#160;<span class="key">C</span></td><td></td><td>Stops the currently running command.</td></tr>
<tr><td><span class="key">CTRL</span>&#160;<span class="key">D</span></td><td></td><td>Closes the current Terminal session.</td></tr>
</table>
<h2><a id="other-combos" name="other-combos">Other key combinations</a></h2>
<h1><a id="other-combos" name="other-combos">Other key combinations</a></h1>
<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>
<table summary="shortcuts" border="0" cellspacing="0" cellpadding="4">
<tr><td><span class="key">SHIFT</span></td><td style="width:15px;"></td><td>This will select everything between the first selected item and the one you click on.</td></tr>
<tr><td><span class="key">ALT</span></td><td></td><td>Adds or removes the item you're clicking on from the selection.</td></tr>
</table>
<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>
The letters you type appear at the bottom-left, where normally the number of items is listed. After a second it reverts back and you could start a new incremental search.</p>
</div>

6
userguide/en/preferences.html
View File

@ -56,9 +56,9 @@
<tr><td style="width:24px;"><img src="../images/prefs-images/keymap-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/prefs-keymap.html">Keymap</a></td><td>&#160;</td>
<td valign="top">Set the mapping of your keyboard.</td></tr>
<tr><td style="width:24px;"><img src="../images/prefs-images/media-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/prefs-media.html">Media</a></td><td>&#160;</td>
<td valign="top">Audio and video settings like volume and in/output devices.</td></tr>
<td valign="top">Audio and video settings like in/output devices and the system's audio mixer.</td></tr>
<tr><td style="width:24px;"><img src="../images/prefs-images/menu-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/prefs-menu.html">Menu</a></td><td>&#160;</td>
<td valign="top">Configure the behaviour of menus and the command key (<span class="key">CTRL</span>/<span class="key">/ALT</span>).</td></tr>
<td valign="top">Configure the behavior of menus and the command key (<span class="key">CTRL</span>/<span class="key">ALT</span>).</td></tr>
<tr><td style="width:24px;"><img src="../images/prefs-images/mouse-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/prefs-mouse.html">Mouse</a></td><td>&#160;</td>
<td valign="top">Configure your mouse.</td></tr>
<tr><td style="width:24px;"><img src="../images/prefs-images/network-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/prefs-network.html">Network</a></td><td>&#160;</td>
@ -70,7 +70,7 @@
<tr><td style="width:24px;"><img src="../images/prefs-images/screensaver-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/prefs-screensaver.html">ScreenSaver</a></td><td>&#160;</td>
<td valign="top">Add, remove and configure a screen saver.</td></tr>
<tr><td style="width:24px;"><img src="../images/prefs-images/sounds-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/prefs-sounds.html">Sounds</a></td><td>&#160;</td>
<td valign="top">Assign a sound to different system events.</td></tr>
<td valign="top">Assign sounds to different system events.</td></tr>
<tr><td style="width:24px;"><img src="../images/prefs-images/time-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/prefs-time.html">Time</a></td><td>&#160;</td>
<td valign="top">Set time, date and timezone.</td></tr>
<tr><td style="width:24px;"><img src="../images/prefs-images/tracker-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/prefs-tracker.html">Tracker</a></td><td>&#160;</td>

22
userguide/en/preferences/prefs-appearance.html
View File

@ -5,7 +5,7 @@
<head>
<!--
*
* Copyright 2008, Haiku. All rights reserved.
* Copyright 2008-2009, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -42,35 +42,35 @@
</table>
<p>The Appearance preferences lets you change some aspects of Haiku's visuals.</p>
<h2><a id="colors" name="colors">Colors</a></h2>
<h1><a id="colors" name="colors">Colors</a></h1>
<img src="../../images/prefs-images/appearance-colors.png" alt="appearance-colors.png" width="460" height="337" />
<p>In the first tab, <span class="menu">Colors</span>, you can change the colors of different parts of the user interface. The color well accepts drag&amp;drops from other programs, letting you drag colors over from e.g. <span class="app">WonderBrush</span>, <span class="app">Icon-O-Matic</span> or the <span class="app">Backgrounds</span> panel.</p>
<h2><a id="antialiasing" name="antialiasing">Antialiasing</a></h2>
<h1><a id="antialiasing" name="antialiasing">Antialiasing</a></h1>
<img src="../../images/prefs-images/appearance-antialiasing.png" alt="appearance-antialiasing.png" width="460" height="337" />
<p>The second tab, <span class="menu">Antialiasing</span>, provides different settings for how things are rendered on screen.</p>
<h3>Glyph hinting</h3>
<h2>Glyph hinting</h2>
<p>An activated <span class="menu">Glyph hinting</span> aligns all letters in such a way that their vertical and horizontal edges rest exactly between two pixels. The result is a perfect contrast, especially when dealing with black on white. Text appears crisper. There's also a setting for "<span class="menu">Monospaced Fonts Only</span>" that's especially helpful with low resolution devices like netbooks. Small fonts can look pretty bad when hinting is turned on, but with this setting you still have the advantage of hinting for text editors and Terminal.</p>
<p>See the difference hinting makes with these magnified screenshots:</p>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
<tr><td style="text-align:center; font-style:italic"><img src="../../images/prefs-images/appearance-glyph-off.png" alt="appearance-glyph-off.png" width="296" height="207" /><br />Hinting: off</td><td style="width:15px;"></td><td style="text-align:center; font-style:italic"><img src="../../images/prefs-images/appearance-glyph-on.png" alt="appearance-glyph-on.png" width="296" height="207" /><br />Hinting: on</td></tr>
</table>
<p>It should be pointed out that all the <span class="app">Magnify</span> windows on this page are of course renderend themselves with the different options as well. So, you get a realworld impression of the settings by comparing, for example, the bold yellow tab title or the text "33 x 15 @ 8 pixels/pixel".</p>
<p>It should be pointed out that all the <span class="app">Magnify</span> windows on this page are of course rendered themselves with the different options as well. So, you get a real world impression of the settings by comparing, for example, the bold yellow tab title or the text "33 x 15 @ 8 pixels/pixel".</p>
<h3>Antialiasing type</h3>
<p>Another technique to improve rendering is <i>Antialiasing</i>, which supports all vector graphics as well as text. It smoothes lines by changing the color of certain pixels. There are two methods for that:</p>
<p><span class="menu">Greyscale</span> changes the intensity of pixels at the edge.<br />
<h2>Antialiasing type</h2>
<p>Another technique to improve rendering is <i>Antialiasing</i>, which supports all vector graphics as well as text. It smooths lines by changing the color of certain pixels. There are two methods for that:</p>
<p><span class="menu">Grayscale</span> changes the intensity of pixels at the edge.<br />
<span class="menu">LCD subpixel</span> does an even better job, especially with (high resolution) LCD monitors. Instead of the intensity of a pixel, it changes its color which moves an edge by a fraction of a pixel, because LCD displays produce every pixel with a red, green and blue component.</p>
<p>Again, the two different methods with magnified screenshots:</p>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
<tr><td style="text-align:center; font-style:italic"><img src="../../images/prefs-images/appearance-glyph-off.png" alt="appearance-glyph-off.png" width="296" height="207" /><br />Greyscale, Hinting: off</td><td style="width:15px;"></td><td style="text-align:center; font-style:italic"><img src="../../images/prefs-images/appearance-subpixel.png" alt="appearance-subpixel.png" width="296" height="207" /><br />LCD subpixel, Hinting: off</td></tr>
<tr><td style="text-align:center; font-style:italic"><img src="../../images/prefs-images/appearance-glyph-off.png" alt="appearance-glyph-off.png" width="296" height="207" /><br />Grayscale, Hinting: off</td><td style="width:15px;"></td><td style="text-align:center; font-style:italic"><img src="../../images/prefs-images/appearance-subpixel.png" alt="appearance-subpixel.png" width="296" height="207" /><br />LCD subpixel, Hinting: off</td></tr>
</table>
<p>Subpixel based antialiasing adds a slight colored shine to objects. Something not everyone tolerates. In Haiku you can mix the two antialiasing methods and find the right setting for you by using a slider.</p>
<div class="box-info">The subpixel based antialiasing in combination with the glyph hinting is subject of a software patent and is therefore not available by default. Depending on where in the world you live, you may get an unlocked version. Sorry about that. Talk with your representative.</div>
<p>If you do activate hinting plus LCD subpixel rendering by changing the source and recompiling, this is how it looks compared to hinting with Greyscale:</p>
<p>If you do activate hinting plus LCD subpixel rendering by changing the source and recompiling, this is how it looks compared to hinting with Grayscale:</p>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
<tr><td style="text-align:center; font-style:italic"><img src="../../images/prefs-images/appearance-glyph-on.png" alt="appearance-glyph-on.png" width="296" height="207" /><br />Greyscale, Hinting: on</td><td style="width:15px;"></td><td style="text-align:center; font-style:italic"><img src="../../images/prefs-images/appearance-glyph-on-subpixel.png" alt="appearance-glyph-on-subpixel.png" width="296" height="207" /><br />LCD subpixel, Hinting: on</td></tr>
<tr><td style="text-align:center; font-style:italic"><img src="../../images/prefs-images/appearance-glyph-on.png" alt="appearance-glyph-on.png" width="296" height="207" /><br />Grayscale, Hinting: on</td><td style="width:15px;"></td><td style="text-align:center; font-style:italic"><img src="../../images/prefs-images/appearance-glyph-on-subpixel.png" alt="appearance-glyph-on-subpixel.png" width="296" height="207" /><br />LCD subpixel, Hinting: on</td></tr>
</table>
<p><br /></p>
<p>At the bottom of the panel are two buttons:</p>

2
userguide/en/preferences/prefs-datatranslations.html
View File

@ -41,7 +41,7 @@ width="64" height="64" />DataTranslations</h1>
<table summary="quickinfo" border="0" cellspacing="0" cellpadding="2">
<tr><td>Deskbar:</td><td style="width:15px;"></td><td><span class="menu">Preferences</span></td></tr>
<tr><td>Location:</td><td></td><td><span class="path">/boot/beos/preferences/DataTranslations</span></td></tr>
<tr><td>Settings:</td><td></td><td><span class="path">~/config/settings/*</span> - Every Translator creates it's own settings file here after you've changes its defaults.<br />
<tr><td>Settings:</td><td></td><td><span class="path">~/config/settings/*</span> - Every Translator creates its own settings file here after you've changes its defaults.<br />
<span class="path">~/config/settings/system/DataTranslations settings</span> - Stores the panel's window position.</td></tr>
</table>
<p>Every application has the ability to open and save every file format for which there's a Translator installed. The settings for these Translators are configured in the DataTranslations preferences.</p>

16
userguide/en/preferences/prefs-e-mail.html
View File

@ -46,12 +46,12 @@ width="64" height="64" />E-mail</h1>
<p>Haiku provides a system that retrieves e-mail regularly via a mail_daemon and saves each mail as a single text file. It parses the mail and fills its attributes with all necessary header information, like from, to, subject and its unread status. Now it can be queried by you or any application. This system also makes switching e-mail clients easy as all the data and your configuration stays the same.<br />
The configuration is done in the E-Mail preference panel.</p>
<h2><a id="creating" name="creating">Creating a new e-mail account</a></h2>
<h1><a id="creating" name="creating">Creating a new e-mail account</a></h1>
<p>Let's go through the process of setting up an e-mail account.<br />
You start by clicking the <span class="button">Add</span> button to create a new, unnamed account. Then you declare the <i>Account Type</i> which is either <span class="menu">Receive Mail Only</span>, <span class="menu">Send Mail Only</span>, or the most usual type, <span class="menu">Send and Receive Mail</span>.</p>
<p>Now you enter an <i>Account Name</i>, your <i>Real Name</i> and the <i>Return Address</i> where replies will be sent to.</p>
<h2><a id="incoming" name="incoming">Setting up incoming e-mail</a></h2>
<h1><a id="incoming" name="incoming">Setting up incoming e-mail</a></h1>
<p>Click on <span class="menu">Incoming</span> under your account's name to set up how e-mails are received.</p>
<img src="../../images/prefs-images/e-mail-in.png" alt="e-mail-in.png" width="491" height="472" />
<p>From the drop-down menu you choose the protocol used by your provider. <span class="menu">IMAP</span> and <span class="menu">POP3</span> are supported.</p>
@ -62,25 +62,25 @@ You start by clicking the <span class="button">Add</span> button to create a new
<p>You can change the <i>Location</i> of your inbox (default: <span class="path">/boot/home/mail/in/</span>), which is useful if you'd like to separate the mails from different accounts into their own folders. However, queries let you sort things out just as well.</p>
<p>Last on this page, you can opt to only <span class="menu">Partially download messages</span> that are larger than a certain size. This will only get the header and you can decide if you want to download the rest of the message plus possible attachments after seeing the subject and who sent it. Useful if you have a slow connection.</p>
<h2><a id="outgoing" name="outgoing">Setting up outgoing e-mail</a></h2>
<h1><a id="outgoing" name="outgoing">Setting up outgoing e-mail</a></h1>
<p>Click on <span class="menu">Outgoing</span> under your account's name to set up how e-mails are sent.</p>
<img src="../../images/prefs-images/e-mail-out.png" alt="e-mail-out.png" width="491" height="472" />
<p>As with incoming mail, you can also change the <i>Location</i> of your outbox (default: <span class="path">/boot/home/mail/out/</span>).</p>
<p>Next is the <i>SMTP Server</i> address for outgoing mails. As with the incoming server before, you can use a specific port if needed, e.g. <tt>mail.your-provider.org:1200</tt>.</p>
<p>If you need to login, you change the <i>Login Type</i> to <span class="menu">ESMTP</span> and enter username and password above. The other type is used for providers that need you to check for mail with <span class="menu">POP3 before SMTP</span> for identification.</p>
<h2><a id="filters" name="filters">Setting up e-mail filters</a></h2>
<h1><a id="filters" name="filters">Setting up e-mail filters</a></h1>
<p>If you want to filter your incoming email, you click on <span class="menu">E-Mail Filters</span> under your account's name to set up automatic sorting. You can add any number of filters that are applied one after the other. You can rearrange them by drag&amp;dropping them to their new position.<br />
Besides the <span class="menu">R5 Daemon Filter</span> that's used for backward compatibility, there are two other <span class="menu">Incoming Mail Filters</span> you can add.</p>
<h3>Spam Filter</h3>
<h2>Spam Filter</h2>
<img src="../../images/prefs-images/e-mail-filter-spam.png" alt="e-mail-filter-spam.png" width="491" height="472" />
<p>The spam filter uses statistical methods to classify a mail as unwanted spam. It assigns a value between 0 and 1 to it and you can decide what are the limits for a genuine mail and what will be considered spam.<br />
You can have that spam rating added to the start of the subject.<br />
Also, the spam filter can learn from all incoming e-mail. Of course, you'll have to teach it by sorting out the false positives, mails that were mistakenly marked as spam. You'll find more on that when we discuss the application <span class="app">Mail</span>.</p>
<p>Together with the following <span class="menu">Match Header</span> filter, you're able to automatically sort out detected spam mails.</p>
<h3>Match Header</h3>
<h2>Match Header</h2>
<img src="../../images/prefs-images/e-mail-filter-header.png" alt="e-mail-filter-header.png" width="491" height="472" />
<p>This filter compares a header to a search pattern and performs some action when it matches.<br />
With the first text field you specify which header to check against. These are available:</p>
@ -115,11 +115,11 @@ With the first text field you specify which header to check against. These are a
<p>The second text field holds your search pattern. It accepts <a href="http://en.wikipedia.org/wiki/Regular_expression" class='external free' title="http://en.wikipedia.org/wiki/Regular expression" rel="nofollow">regular expressions</a> which gives it great flexibility, while unfortunately complicating things a bit. Read up on it a bit, it's well worth it and simple search patterns aren't <i>that</i> complicated at all.</p>
<p>With the drop-down menu below it, you assign an action when the pattern matches. You can move or delete a mail, set the status to "Read" or anything else or set the e-mail account you'll reply with.</p>
<h3>Outgoing Mail Filters</h3>
<h2>Outgoing Mail Filters</h2>
<p>At this moment, there's only one filter that deals with outgoing mail: <span class="cli">fortune</span>.
<br />It will attach a randomly chosen funny or wise "fortune cookie" to the end of every mail before it's sent out. You can do a dry run by issuing the command <span class="cli">fortune</span> in a Terminal.</p>
<h2><a id="settings" name="settings">Setting up the mail_daemon</a></h2>
<h1><a id="settings" name="settings">Setting up the mail_daemon</a></h1>
<p>Now that your incoming and outgoing mail servers (and maybe some filters, too), are configured, you have to tell the mail_server that does all the actual mail checking and fetching how to do its job.</p>
<img src="../../images/prefs-images/e-mail-settings.png" alt="e-mail-settings.png" width="491" height="472" />
<p>Under <i>Mail Checking</i> you configure the interval at which the account's mail server is probed for new mail.<br />

4
userguide/en/preferences/prefs-fonts.html
View File

@ -5,7 +5,7 @@
<head>
<!--
*
* Copyright 2008, Haiku. All rights reserved.
* Copyright 2008-2009, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -51,7 +51,7 @@
<tr><td><span class="button">Revert</span></td><td>&#160;</td><td>brings back the settings that were active when you started the Fonts preferences.</td></tr>
</table>
<h2><a id="install" name="install">Installing new fonts</a></h2>
<h1><a id="install" name="install">Installing new fonts</a></h1>
<p>You install new fonts by copying them into their respective user folder, i.e. <span class="path">/boot/common/fonts/</span> or <span class="path">/boot/home/config/fonts/</span> (see topic <a href="filesystem-layout.html">Filesystem layout</a>).</p>
</div>

6
userguide/en/preferences/prefs-screensaver.html
View File

@ -5,7 +5,7 @@
<head>
<!--
*
* Copyright 2008, Haiku. All rights reserved.
* Copyright 2008-2009, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -46,7 +46,7 @@ width="64" height="64" />ScreenSaver</h1>
<p>The panel of the ScreenSaver preferences is split into two tabs:
</p>
<h2><a name="fade">Fade</a></h2>
<h1><a name="fade">Fade</a></h1>
<img src="../../images/prefs-images/screensaver-fade.png" alt="screensaver-fade.png" width="457" height="357">
<br />
<p>The top checkbox enables/disables the screen saver.<br />
@ -59,7 +59,7 @@ The other, after how many minutes you need a password to unlock your machine.
<p>By clicking into different corners of the two screens at the bottom, you tell the system when to immediately start the screen saver or when to prevent it from kicking in when you rest the mouse in the indicated corner. Click in the middle of the screens to disable that feature again.
</p>
<h2><a name="modules">Modules</a></h2>
<h1><a name="modules">Modules</a></h1>
<img src="../../images/prefs-images/screensaver-modules.png" alt="screensaver-modules.png" width="473" height="357">
<br />
<p>The second tab shows a list of all installed screen saver modules and their individual settings. You can test your settings with the <span class="button">Test</span> button below the list and add modules with the <span class="button">Add...</span> button beside it. Other ways to install new screen savers is by a simple drag&amp;drop into the list. Of course, you can also copy/delete a module's file in its respective user folder, i.e. <span class="path">/boot/common/add-ons/screensavers/</span> or <span class="path">/boot/home/config/add-ons/screensavers/</span> (see topic <a href="../filesystem-layout.html">Filesystem layout</a>).

6
userguide/en/preferences/prefs-time.html
View File

@ -5,7 +5,7 @@
<head>
<!--
*
* Copyright 2008, Haiku. All rights reserved.
* Copyright 2008-2009, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -46,7 +46,7 @@
</table>
<p>The panel of the Time preferences is split into two tabs:</p>
<h2><a id="date-time" name="date-time">Date &amp; Time</a></h2>
<h1><a id="date-time" name="date-time">Date &amp; Time</a></h1>
<img src="../../images/prefs-images/time-time.png" alt="time-time.png" width="495" height="348" />
<p>On the left side, you can set the day of the month by simply clicking on it in the calendar. You change the month and year by clicking on it and using the up/down arrows to the right or the cursor keys on your keyboard.</p>
<p>Similarly, you set the time. There are two modes for the clock:</p>
@ -55,7 +55,7 @@
<tr><td><span class="menu">GMT</span></td><td>&#160;</td><td>to display Greenwich Mean Time.</td></tr>
</table>
<h2><a id="timezone" name="timezone">Timezone</a></h2>
<h1><a id="timezone" name="timezone">Timezone</a></h1>
<img src="../../images/prefs-images/time-timezone.png" alt="time-timezone.png" width="495" height="348" />
<p>Simply find and choose your location from the drop-down menu and the list of cities and press <span class="button">Set Time Zone</span> to set your zone.</p>
<p><span class="button">Revert</span> brings back the settings that were active when you started the Time preferences.</p>

2
userguide/en/preferences/prefs-tracker.html
View File

@ -44,7 +44,7 @@
</table>
<p><br /></p>
<p>The Tracker preference panel is also available from every Tracker window with the menu <span class="menu">Window | Preferences...</span>.<br />
It's functions are discussed in the topic on <a href="../tracker.html#tracker-preferences">Tracker</a>.</p>
Its functions are discussed in the topic on <a href="../tracker.html#tracker-preferences">Tracker</a>.</p>
<!--
<div class="bottomnav">

26
userguide/en/queries.html
View File

@ -38,7 +38,7 @@
<p>A query is a file search based on file attributes and can be performed within Tracker or in Terminal. Queries are saved in <span class="path">/boot/home/queries/</span> and by default last seven days before being purged. Note, that these aren't static result lists of your search, but are the query formulas which trigger a new search whenever you open them.</p>
<h2><a id="find-window" name="find-window">The Find window</a></h2>
<h1><a id="find-window" name="find-window">The Find window</a></h1>
<p>You start a query by invoking the <span class="menu">Find...</span> menu either from the Deskbar menu or any Tracker window or the Desktop (which is actually a fullscreen Tracker window). The shortcut is <span class="key">ALT</span>&#160;<span class="key">F</span>. You're presented with the Find window:</p>
<img src="../images/queries-images/basic-query.png" alt="basic-query.png" width="517" height="292" />
<ol>
@ -58,21 +58,21 @@ types.</p></li>
<li><p>You can drag&amp;drop the icon to save the query.</p></li>
</ol>
<h2><a id="basic-query" name="basic-query">Basic queries - "by Name"</a></h2>
<h1><a id="basic-query" name="basic-query">Basic queries - "by Name"</a></h1>
<p>If you simply want to find all files on your mounted disks that match a certain pattern, simply leave the search method at "<span class="menu">by Name</span>", enter the search term into the text box and press <span class="key">ENTER</span>.</p>
<h2><a id="adv-query" name="adv-query">Advanced queries - "by Attribute"</a></h2>
<p>You can create more advanced queries by searching within the attributes of specific file types. For that to work, these attributes have to be indexed (see <a href="index.html">Index</a>).</p>
<h1><a id="adv-query" name="adv-query">Advanced queries - "by Attribute"</a></h1>
<p>You can create more advanced queries by searching within the attributes of specific file types. For that to work, these attributes have to be <a href="index.html">indexed</a>.</p>
<img src="../images/queries-images/query-window.png" alt="query-window.png" width="441" height="172" />
<p>You start by setting the filetype from "<span class="menu">All files and folders</span>" to "<span class="menu">text | E-mail</span>" and change the search method to "<span class="menu">by Attribute</span>.</p>
<p>This adds a drop-down menu to the left of the textbox and the buttons "<span class="button">Add</span> and <span class="button">Remove</span> under that. From the menu you choose which attribute to query. With "<span class="button">Add</span> and <span class="button">Remove</span> you can query additional attributes or remove them again. These attributes can be logically linked with AND/OR.</p>
<p>You start by setting the filetype from "<span class="menu">All files and folders</span>" to "<span class="menu">text | E-mail</span>" and change the search method to "<span class="menu">by Attribute</span>".</p>
<p>This adds a drop-down menu to the left of the textbox and the buttons "<span class="button">Add</span> and <span class="button">Remove</span> under that. From the menu you choose which attribute to query. With <span class="button">Add</span> and <span class="button">Remove</span> you can query additional attributes or remove them again. These attributes can be logically linked with AND/OR.</p>
<p>Let's do an email query as an example:</p>
<img src="../images/queries-images/query-window-filled.png" alt="query-window-filled.png" width="441" height="262" />
<p>This is your Find window when you're looking for all emails Clara Botter has sent to you in the last two months that had in the subject "vibraphone" or "skepticality".</p>
<p>This is your Find window when you're looking for all emails Clara Botters has sent to you in the last two months that had in the subject "vibraphone" or "skepticality".</p>
<h2><a id="more-adv-query" name="more-adv-query">Even more advanced queries - "by Formula"</a></h2>
<h1><a id="more-adv-query" name="more-adv-query">Even more advanced queries - "by Formula"</a></h1>
<p>Typing in a formula query by hand is daunting and really quite unpractical. It still has its uses.</p>
<p>Take the above query by attribute of Clara's mails concerning vibraphones etc. If you have all the attributes and their search terms set, try switching to "<span class="menu">by Formula</span> mode and be overwhelmed by this one line query string:</p>
<p>Take the above query by attribute of Clara's mails concerning vibraphones etc. If you have all the attributes and their search terms set, try switching to "<span class="menu">by Formula</span>" mode and be overwhelmed by this one line query string:</p>
<img src="../images/queries-images/formula-query.png" alt="formula-query.png" width="441" height="173" />
<p>Once more as text, edited for readability:</p>
<pre>(((((MAIL:from==&quot;*[cC][lL][aA][rR][aA] [bB][oO][tT][tT][eE][rR][sS]*&quot;)
@ -84,19 +84,19 @@ types.</p></li>
<ul>
<li><p>You could copy and paste the string into an email, forum or IRC for others to use or debug.</p></li>
<li><p>You can use this method to construct a query in <span class="menu">Attribute</span> mode and then switch to <span class="menu">Formula</span> mode, to comfortably generate a search string to use for a query in Terminal or a script.</p></li>
<li><p>You can fine tune your query by inserting parenthesis where needed, make parts case-sensitive or negate logical combinations by changing. e.g. "<tt>==</tt>" to "<tt>!=</tt>" for a NOT AND. All you need is a basic understanding of <a href="http://en.wikipedia.org/wiki/Regular_expression" class='external free' title="http://en.wikipedia.org/wiki/Regular expression" rel="nofollow">regular expressions</a> and maybe some scripting basics.</p></li>
<li><p>You can fine tune your query by inserting parenthesis where needed, make parts case-sensitive or negate logical combinations by changing. e.g. "<tt>==</tt>" to "<tt>!=</tt>" for a NOT AND. All you need is a basic understanding of <a href="http://en.wikipedia.org/wiki/Regular_expression" class='external free' title="http://en.wikipedia.org/wiki/Regular expression">regular expressions</a> and maybe some scripting basics.</p></li>
</ul>
<h2><a id="result-window" name="result-window">The result window</a></h2>
<h1><a id="result-window" name="result-window">The result window</a></h1>
<p>After you start a search, the Find window will be replaced by a result window. Here is an example that queried for "server":</p>
<img src="../images/queries-images/result-window.png" alt="result-window.png" width="704" height="359" />
<p>Besides the grey background, result windows work exactly like any other Tracker window. Some things are worth noting:</p>
<p>Besides the gray background, result windows work exactly like any other Tracker window. Some things are worth noting:</p>
<ul>
<li><p>You can open the folder a file resides in by double clicking on its path attribute.</p></li>
<li><p>With <span class="menu">File | Edit Query</span> or <span class="key">ALT</span>&#160;<span class="key">G</span> you get back to your Find window to refine your query.</p></li>
<li><p>A query is live, i.e. if a file that matches your search criteria appears or disappears from your system, this change is reflected in your results in real-time.</p></li>
</ul>
<p>You can assign a sensible attribute layout for query results of a specific filetype. Open the folder containing files of the filetype you'd like to create a template for and arrange the attributes how you'd like to have query results presented. Copy this layout with <span class="menu">Attributes | Copy Attributes</span>.</p>
<p>You can assign a sensible attribute layout for query results of a specific filetype. Open a folder containing files of the filetype you'd like to create a template for and arrange the attributes how you'd like to have query results presented. Copy this layout with <span class="menu">Attributes | Copy Attributes</span>.</p>
<p>Open <span class="path">/boot/home/config/settings/Tracker/DefaultQueryTemplates</span>, create a new folder and rename it to <i>group/filetype</i>, replacing slashes with underscores, e.g."audio_x-mp3". Open the new folder and paste in the layout with <span class="menu">Attributes | Paste Attributes</span>.</p>
</div>

12
userguide/en/tracker-add-ons.html
View File

@ -39,14 +39,14 @@
<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 <span class="menu">Add-Ons</span> from the context menu or the <span class="menu">File</span> 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>):</p>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
<tr><td><span class="path">/boot/beos/system/add-ons/Tracker/</span></td><td>&#160;&#160;&#160;</td><td> for system provided add-ons</td></tr>
<tr><td><span class="path">/boot/common/add-ons/Tracker/</span></td><td>&#160;&#160;&#160;</td><td> for add-ons available to every user</td></tr>
<tr><td><span class="path">/boot/home/config/add-ons/Tracker/</span></td><td>&#160;&#160;&#160;</td><td> for add-ons only available to yourself</td></tr>
<tr><td><span class="path">/boot/beos/system/add-ons/Tracker/</span></td><td>&#160;&#160;&#160;</td><td> for system provided add-ons.</td></tr>
<tr><td><span class="path">/boot/common/add-ons/Tracker/</span></td><td>&#160;&#160;&#160;</td><td> for add-ons available to every user.</td></tr>
<tr><td><span class="path">/boot/home/config/add-ons/Tracker/</span></td><td>&#160;&#160;&#160;</td><td> for add-ons only available to yourself.</td></tr>
</table>
<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, <span class="menu">Open Target Folder-T</span> opens with <span class="key">ALT</span>&#160;<span class="key">AltGr</span>&#160;<span class="key">T</span> (at least with my keymap, you may have a different key combination).<br />
<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, <span class="app">Open Target Folder-T</span> opens with <span class="key">ALT</span>&#160;<span class="key">AltGr</span>&#160;<span class="key">T</span> (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.</p>
<h2><a id="system-add-ons" name="system-add-ons">Haiku's Tracker Add-Ons</a></h2>
<h1><a id="system-add-ons" name="system-add-ons">Haiku's Tracker Add-Ons</a></h1>
<p>These Tracker Add-Ons come with every Haiku installation:</p>
<table summary="layout" border="0" cellspacing="0" cellpadding="4">
<tr><td class="onelinetop"><b>Background</b><i>-B</i></td>
@ -54,7 +54,7 @@ Of course, you have to take care of possible shortcut collisions when deciding o
<tr><td class="onelinetop"><b>DiskUsage</b><i>-I</i></td>
<td valign="top">Starts the <a href="applications/apps-diskusage.html">DiskUsage</a> application with the according folder as basis.</td></tr>
<tr><td class="onelinetop"><b>FileType</b><i>-F</i></td>
<td valign="top">Invoked on a file, opens its specific <a href="filetypes.html">FileType</a> panel, otherwise the FileTypes preferences are launched.</td></tr>
<td valign="top">Invoked on a file, opens its specific <a href="filetypes.html">FileType</a> panel, otherwise the general FileTypes preferences are launched.</td></tr>
<tr><td class="onelinetop"><b>Open Target Folder</b><i>-T</i></td>
<td valign="top">It can only be used on a linked file and opens the folder that file lives in.</td></tr>
<tr><td class="onelinetop"><b>TextSearch</b><i>-G</i></td>

28
userguide/en/tracker.html
View File

@ -39,28 +39,28 @@
<p>The Tracker is the graphical interface to all your files. It let's you create new files and folders or find, launch or rename as well as copy or delete existing ones.</p>
<p>Being an application like any other (the Desktop with its icons is really just a fullscreen window in the background), Tracker appears with its windows in the Deskbar and can be quit and restarted. The easiest way to quit and restart a crashed or frozen Tracker (or a wayward Deskbar) is to call the <a href="teammonitor.html">Team Monitor</a>.</p>
<h2><a id="mounting-volumes" name="mounting-volumes">Mounting Volumes</a></h2>
<h1><a id="mounting-volumes" name="mounting-volumes">Mounting Volumes</a></h1>
<p>In order to access a harddisk, CD, USB stick etc., you first have to mount the volume, that is, let the system know it's there. This is done with a right-click on the Desktop or an already mounted volume (like the boot disk) and choosing the volume from the <span class="menu">Mount</span> submenu.</p>
<img src="../images/tracker-images/mount-settings.png" alt="drill-down.png" width="581" height="290" />
<p>There are also <span class="menu">Mount Settings</span> so you don't have to mount everything manually after every bootup.<br />
The above settings will mount all disks on bootup that were mounted previously and will automatically mount any storage device you connect/insert.</p>
The above settings will automatically mount any storage device you connect/insert and also mount all disks on bootup that were mounted previously.</p>
<div class="box-warning">Before you disconnect e.g. a harddrive or USB stick, make sure you have successfully unmounted the volume. This guarantees that all data transfer has finished. Otherwise you may lose data or corrupt the disk!</div>
<h2><a id="navigating" name="navigating">Navigating</a></h2>
<h1><a id="navigating" name="navigating">Navigating</a></h1>
<p>Moving through your folders is one of Trackers main purposes, just like the file managers on other platforms. Haiku's Tracker has some unique features that will help you doing that efficiently.</p>
<p>Instead of double-clicking your way down folder after folder, there's a better way to drill down:</p>
<img src="../images/tracker-images/drill-down.png" alt="drill-down.png" width="603" height="303" />
<p>Right-click onto a folder, and at the top of the usual context menu you'll find a submenu of the current folder that let's you navigate down a level. Just move down the hierarchy until you find the file or folder you're looking for and click on it to open it. The above shows the contents of the folder <span class="path">/boot/beos/system/</span>.<br /><br /></p>
<p>A similar method can be used from any Tracker window:</p>
<img src="../images/tracker-images/window-drill-down.png" alt="window-drill-down.png" width="502" height="359" />
<p>Click on the area in the lower left, where the number of items are listed, and you'll get submenus for every level above you current folder. From there you can drill down through the folders as usual.</p>
<p>Click on the area in the lower left, where the number of items is listed, and you'll get submenus for every level above your current location. From there you can drill down through the folders as usual.</p>
<p>Note, that the Desktop is always the topmost level as that is where Tracker shows mounted volumes. So, if you want to go to another disk, you first have to navigate to the top (Desktop) and cross over to your other disk from there.</p><br />
<p>You'll get the same submenu-navigating when you drag a file over a folder. After a short while of hovering, a submenu pops up and you can drill down to your destination. If you initiated the drag with the right mousebutton, you can choose between copying, moving or linking the file when you release the mouse.</p><br />
<p>By default, when you double-click a folder, Tracker opens a new window while leaving the parent window open. This can quickly lead to an overcrowded desktop.<br />
You can prevent that by holding down the left <span class="key">WIN</span> key, which automatically closes the parent window.<br />
This is also true for keyboard navigation. For more on that, see topic <a href="keyboard-shortcuts">Shortcuts and key combinations</a>.</p>
<h2><a id="appearance" name="appearance">Appearance</a></h2>
<h1><a id="appearance" name="appearance">Appearance</a></h1>
<img src="../images/tracker-images/window-menu.png" alt="window-menu.png" width="382" height="259" />
<p>Tracker windows offer three different viewing modes from the <span class="menu">Window</span> menu:</p>
<ul>
@ -72,12 +72,12 @@ This is also true for keyboard navigation. For more on that, see topic <a href="
<ul>
<li><p><b>Resize Window</b> (<span class="key">ALT</span>&#160;<span class="key">Y</span>) - Resizes the window to its ideal size.</p></li>
<li><p><b>Clean Up</b> (<span class="key">ALT</span>&#160;<span class="key">K</span>) - Aligns all icons to an invisible grid. Hold down <span class="key">SHIFT</span> and the menu becomes <span class="menu">Clean Up All</span> which additionally sorts all icons alphabetically.</p></li>
<li><p><b>Select...</b> (<span class="key">SHIFT</span>&#160;<span class="key">ALT</span>&#160;<span class="key">A</span>) - Select files according to a regular expression.</p></li>
<li><p><b>Select...</b> (<span class="key">SHIFT</span>&#160;<span class="key">ALT</span>&#160;<span class="key">A</span>) - Select files according to a <a href="http://en.wikipedia.org/wiki/Regular_expression" class='external free' title="http://en.wikipedia.org/wiki/Regular expression">regular expression</a>.</p></li>
</ul>
<p>Sometimes you just want to rearrange a few icons without doing a complete <span class="menu">Clean Up</span> (<span class="key">ALT</span>&#160;<span class="key">K</span>). In that case, you select these icons and start to drag them to their new location. Before you drop them there, keep <span class="key">ALT</span> pressed until you've released the mouse button. This will align the icons to the invisible grid.</p>
<p>Sometimes you just want to rearrange a few icons without doing a complete <span class="menu">Clean Up</span> (<span class="key">ALT</span>&#160;<span class="key">K</span>). In that case, you select these icons and start to drag them to their new location. Before you drop them there, keep <span class="key">ALT</span> pressed. This will align the icons to the invisible grid.</p>
<p>The rest of the functions are pretty self-explanatory, leaving the Tracker preferences.</p>
<h3><a id="tracker-preferences" name="tracker-preferences">Tracker preferences</a></h3>
<h2><a id="tracker-preferences" name="tracker-preferences">Tracker preferences</a></h2>
<p><span class="menu">Window | Preferences...</span> opens a panel that offers a number of settings that, where not obvious, should become clear once tried out. Since all settings are applied live, you'll immediately see the changes.
<br />So, in short, the not so obvious settings:</p>
<ul>
@ -88,21 +88,21 @@ This is also true for keyboard navigation. For more on that, see topic <a href="
<br />
<p>Before you switch Tracker to Single Window Navigation mode, because that may feel more familiar to you, we recommend giving the menu based browsing a try first, as that may actually work much faster for you after getting used to. On the other hand, single window browsing offers a <i>Navigator</i> where you can enter or copy&amp;paste a path name and use back, forward and up buttons.</p></li>
<li><p><b>Date and Time</b> - Set date and time formats.</p></li>
<li><p><b>Trash</b> - Set the behaviour when deleting a file.</p></li>
<li><p><b>Volume Icons</b> - Set the colour of an optional indicator of free space that's shown besides a disk's icon.</p></li>
<li><p><b>Trash</b> - Set the behavior when deleting a file.</p></li>
<li><p><b>Volume Icons</b> - Set the color of an optional indicator of free space that's shown besides a disk's icon.</p></li>
</ul>
<p>This panel, by the way, is also available as <span class="app">Tracker</span> from Deskbar's <span class="menu">Preferences</span>.</p>
<h2><a id="working-with-files" name="working-with-files">Working with files</a></h2>
<h1><a id="working-with-files" name="working-with-files">Working with files</a></h1>
<p>When invoked on a selected file, most of the <span class="menu">File</span> menu commands are also offered in the context menu by right-clicking that file.</p>
<p>As usual the commands are pretty clear.</p>
<ul>
<li><p><b>Find...</b> - Find a file or folder. See topic <a href="Query.html">Query</a> for more info.</p></li>
<li><p><b>New...</b> - Create a new folder or any other file based on a <i>template</i>.
<li><p><b>New</b> - Create a new folder or any other file based on a <i>template</i>.
<br /><br />
<img src="../images/tracker-images/new-menu.png" alt="new-menu.png" width="627" height="219" />
<br />
<p>Choosing <span class="menu">Edit Templates...</span> opens the folder <span class="path">/boot/home/config/settings/Tracker/Tracker New Templates</span>. Creating a file in that folder will offer its filetype with the file's name and other attributes as template in the <span class="menu">New...</span> menu. Here, there's a file "Text" with the filetype <tt>text/plain</tt>. See topic <a href="filetypes.html">Filetypes</a> for more info.</p></li>
<p>Choosing <span class="menu">Edit Templates...</span> opens the folder <span class="path">/boot/home/config/settings/Tracker/Tracker New Templates</span>. Creating a file in that folder will offer its filetype with the file's name and other attributes as template in the <span class="menu">New</span> menu. Here, there's a file "Text" with the filetype <tt>text/plain</tt>. See topic <a href="filetypes.html">Filetypes</a> for more info.</p></li>
<li><p><b>Open With...</b> - A submenu offers all applications that can handle this filetype.
<br /><br />
<img src="../images/tracker-images/open-with.png" alt="open-with.png" width="303" height="343" />
@ -122,7 +122,7 @@ This is also true for keyboard navigation. For more on that, see topic <a href="
<li><p><b>Add-Ons</b> - offers you every generic Tracker add-on and those that can handle the selected file(s). See topic <a href="tracker-add-ons.html">Tracker Add-ons</a> for more information.</p></li>
</ul>
<h2><a id="transaction-status" name="transaction-status">Transaction status</a></h2>
<h1><a id="transaction-status" name="transaction-status">Transaction status</a></h1>
<p>When you copy, move or delete files, Tracker shows its progress with a status window. If you initiate more than one transaction, each job gets its own status display.</p>
<img src="../images/tracker-images/transaction-status.png" alt="transaction-status.png" width="361" height="149" />
<p>To the right are two buttons to pause or stop a transaction entirely. Sometimes it can be useful to temporarily pause a large transaction. For example, you may need to quickly launch a large application. Copying large amounts of data chokes your harddisk's IO bandwidth and thus delays your workflow.</p>

32
userguide/en/workshop-filetypes+attributes.html
View File

@ -38,10 +38,10 @@
<p>This is a workshop to show the use of <a href="attributes.html">Attributes</a>, <a href="queries.html">Queries</a>, the <a href="index.html">Index</a> and custom <a href="filetypes.html">Filetypes</a>. As an example, we build a database to keep track of our DVD library.</p>
<h2><a id="preparations" name="preparations">Preparations</a></h2>
<h1><a id="preparations" name="preparations">Preparations</a></h1>
<p>Let's first decide what filetype and attributes would serve our needs. Originally, I wanted to use a Bookmark file with a link to the movie's IMdB page, but Haiku doesn't have a "bookmarkable" browser like BeOS' <span class="app">NetPositive</span> at the moment, so I came up with this: The file itself will be a JPEG image for the movie cover.<br />
To that we add a couple of attributes. Here we have to decide if we want to query it later (then we have to add it to the index) and if so, what type of attribute it should be. Numbers (int, float) can be evaluated differently than text (&lt;/=/&gt; vs. is/contains/starts with).</p>
<p>Here's are the attributes I'd like to see for my DVDs:</p>
<p>Here are the attributes I'd like to see for my DVDs:</p>
<ul>
<li>Movie title</li>
<li>Genre</li>
@ -53,32 +53,32 @@ To that we add a couple of attributes. Here we have to decide if we want to quer
<li>If so, who's borrowed the disk...</li>
</ul>
<h2><a id="custom-filetype" name="custom-filetype">Creating a custom filetype</a></h2>
<h1><a id="custom-filetype" name="custom-filetype">Creating a custom filetype</a></h1>
<p>Start the <span class="app">Filetypes</span> preferences, and click on the <span class="button">Add...</span> button below the hierarchical list on the left. A small dialog opens and you specify in which MIME Group your new filetype will reside. You can also create a completely new group. Let's put it into "<i>applications</i>" and set the "Internal Name" to <i>DVDdb</i>.</p>
<img src="../images/workshop-filetypes+attributes-images/filetypes-new-file-type.png" alt="filetypes-new-file-type.png" width="559" height="432" />
<p>Now, a panel for your new DVDdb filetype opens:</p>
<img src="../images/workshop-filetypes+attributes-images/filetypes-dvddb.png" alt="filetypes-dvddb.png" width="559" height="432" />
<h3><a id="icon" name="icon">Icon</a></h3>
<h2><a id="icon" name="icon">Icon</a></h2>
<p>Double-click the icon well to open <span class="app">Icon-O-Matic</span> to design an icon for your filetype. You can also drag&amp;drop an icon from the icon well of another type, maybe as starting point for a modified version.</p>
<h3><a id="file-recognition" name="file-recognition">File Recognition</a></h3>
<h2><a id="file-recognition" name="file-recognition">File Recognition</a></h2>
<p>You can add suffixes like .txt, .jpg, .mp3 to recognize files by their extention. Useful when working with files from systems without MIME typing. We don't need that for our example.</p>
<h3><a id="decription" name="decription">Description</a></h3>
<h2><a id="decription" name="decription">Description</a></h2>
<ul>
<li><i>Type Name</i> - Appears e.g. in the Attribute menu of Tracker windows and the "Kind" attribute of a file.</li>
<li><i>Description</i> - A bit more detailed description.</li>
</ul>
<h3><a id="pref_app" name="pref_app">Preferred Application</a></h3>
<h2><a id="pref_app" name="pref_app">Preferred Application</a></h2>
<p>This drop-down menu shows a list of all applications that can handle this particular filetype. From here you can choose which program should open this specific file when it's double-clicked.</p>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
<tr><td><span class="button">Select...</span></td><td>&#160;</td><td>opens a file dialog where you choose the application to open with this filetype. Here, we set <span class="app">ShowImage</span> to display the DVD's cover.</td></tr>
<tr><td class="onelinetop"><span class="button">Same as...</span></td><td>&#160;</td><td>opens a file dialog where you choose any file that already has the preferred application set that you're looking for.</td></tr>
</table>
<h3><a id="extra_attribute" name="extra_attribute">Extra Attributes</a></h3>
<h2><a id="extra_attribute" name="extra_attribute">Extra Attributes</a></h2>
<p>Here we enter all the custom attributes we decided on in our preparations. Clicking the <span class="button">Add...</span> button opens a panel:</p>
<img src="../images/workshop-filetypes+attributes-images/filetype-extra-attribute.png" alt="filetype-extra-attribute.png" width="614" height="447" />
<ul>
@ -88,10 +88,10 @@ To that we add a couple of attributes. Here we have to decide if we want to quer
<li><span class="menu">String</span> for normal text</li>
<li><span class="menu">Boolean</span> for binary data: 0 or 1</li>
<li><span class="menu">Integer</span> for integer numbers with different ranges:<ul>
<li><span class="menu">8 bit</span>: +- 255</li>
<li><span class="menu">16 bit</span>: +- 65,535</li>
<li><span class="menu">32 bit</span>: +- 4,294,967,295</li>
<li><span class="menu">64 bit</span>: +- 18,446,744,073,709,551,615</li></ul></li>
<li><span class="menu">8 bit</span>: &plusmn; 255</li>
<li><span class="menu">16 bit</span>: &plusmn; 65,535</li>
<li><span class="menu">32 bit</span>: &plusmn; 4,294,967,295</li>
<li><span class="menu">64 bit</span>: &plusmn; 18,446,744,073,709,551,615</li></ul></li>
<li><span class="menu">Float</span> for floatingpoint numbers, single precision</li>
<li><span class="menu">Double</span> for floatingpoint numbers, double precision</li>
<li><span class="menu">Time</span> for time and date format</li>
@ -117,8 +117,8 @@ To that we add a couple of attributes. Here we have to decide if we want to quer
<tr><td>DVDdb:lent</td> <td>text</td> <td>yes</td> <td>Lent to</td></tr>
</table>
<h2><a id="indexing" name="indexing">Indexing</a></h2>
<p>Before we start entering data in our little DVD database, we should add certain attributes to the <a href="index.html">Index</a>. Only indexed attributes can use Haikus fast <a href="queries.html">Queries</a>.<br />
<h1><a id="indexing" name="indexing">Indexing</a></h1>
<p>Before we start entering data in our little DVD database, we should add certain attributes to the <a href="index.html">Index</a>. Only indexed attributes can use Haiku's fast <a href="queries.html">Queries</a>.<br />
So, what will we be searching in the future? We probably won't ask "What's in the B4 coordinate in my shelf?" or "Does the IMdB URL or the plot of the movie contain the word 'pope-shenooda'?".</p>
<p>This leaves these attributes:</p>
<table summary="Attribute Type" cellpadding="10" border="1">
@ -136,7 +136,7 @@ mkindex -t string DVDdb:cast
mkindex -t int DVDdb:rating</pre>
<p>The <span class="cli">-t</span> option defines the type of attribute, which is "string" for all but the rating, which is an integer number.</p>
<h2><a id="filling-data" name="filling-data">Filling in the data</a></h2>
<h1><a id="filling-data" name="filling-data">Filling in the data</a></h1>
<p>Now, everything's set and we can begin putting some data into our base.<br />
Since our basic file is a cover image, we go to some online resource like IMdB, look for our first movie and save the cover or movie poster in a new folder where we want to keep our DVDdb files.</p>
<p>Opening that folder we see a typical Tracker window with one JPEG in it. Right-clicking it, we change its filetype to <tt>application/DVDdb</tt> with the <span class="app">Filetype Addon</span>. There's more info on this in the <a href="filetypes.html">Filetypes</a> document.</p>
@ -146,7 +146,7 @@ Since our basic file is a cover image, we go to some online resource like IMdB,
<p>In our example, we usually start with a downloaded JPG cover and change its type to applications/DVDdb. There's another elegant way to produce a file to work with. Just copy an empty file of our filetype to <span class="path">/boot/home/config/settings/Tracker/Tracker New Templates</span> and rename it to DVDdb.</p>
<p>Right-clicking into a Tracker window, you'll find a new entry under <span class="menu">New...</span> besides the default "New folder".</p>
<h2><a id="query-db" name="query-db">Querying the database</a></h2>
<h1><a id="query-db" name="query-db">Querying the database</a></h1>
<p>Several hours of grunt work later, we have a nice little database that you can query to find all your Christina Ricci movies that have a 7+ rating... :)</p>
<p>You can assign a sensible attribute layout for query results of a specific filetype.<br />
Open the folder containing your DVDdb files and arrange the attributes how you'd like to have query results presented. Copy this layout with <span class="menu">Attributes | Copy Attributes</span>.</p>

2
userguide/en/workspaces.html
View File

@ -38,7 +38,7 @@
<p>Workspaces are virtual desktops, complete with their own resolution, color depth and background. Up to 32 of these workspaces can be set from the <a href="prefs-screen.html">Screen</a> preferences.</p>
<h2><img src="../images/desktop-applets-images/workspaces-icon_64.png" alt="workspaces-icon_64.png" width="64" height="64" /><a name="applet">The Workspaces Applet</a></h2>
<h1><img src="../images/desktop-applets-images/workspaces-icon_64.png" alt="workspaces-icon_64.png" width="64" height="64" /><a name="applet">The Workspaces Applet</a></h1>
<table summary="quickinfo" border="0" cellspacing="0" cellpadding="2">
<tr><td>Deskbar:</td><td style="width:15px;"></td><td><span class="menu">Desktop Applets</span></td></tr>
<tr><td>Location:</td><td></td><td><span class="path">/boot/beos/apps/Workspaces</span></td></tr>

BIN
userguide/images/apps-images/expander-preferences.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 16 KiB

BIN
userguide/images/apps-images/expander.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 18 KiB

4
welcome/en/bugreports.html
View File

@ -5,7 +5,7 @@
<head>
<!--
*
* Copyright 2008, Haiku. All rights reserved.
* Copyright 2008-2009, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -30,7 +30,7 @@
<div class="content">
<h2>Reporting bugs</h2>
<h1>Reporting bugs</h1>
<p>Since our developers are unable to test every hardware combination, nor every different way of interacting with the operating system, we are relying on you to give us some input on how things work at your end. Since this is a very early product, it is very likely that you will encounter bugs. We thank you for taking the time to report these.<br /><br />
Please follow these guidelines to create helpful bug reports:</p>
<ol>

12
welcome/welcome.html
View File

@ -30,10 +30,10 @@
<div class="content">
<h2><a id="welcome" name="welcome">Welcome to Haiku!</a></h2>
<h1><a id="welcome" name="welcome">Welcome to Haiku!</a></h1>
<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 hope that this release lets you discover Haiku's great potential and that you share our excitement.</p>
<h2><a id="bugreport" name="bugreport">Beware of Bugs</a></h2>
<h1><a id="bugreport" name="bugreport">Beware of Bugs</a></h1>
<p>We were working very hard to fix all possibly show stopping bugs, however, being an alpha release, there are bound to be plenty left undiscovered. <b>We discourage using alpha versions as a production system. Your data could very well be altered, mangled or downright destroyed.</b></p>
<p>One of the main reasons for releasing an alpha version is to attract more people to test the system and discover bugs or provide suggestions for future enhancements. Please file bugs and enhancements in our bug tracker after using its search function to avoid duplicates.</p>
@ -42,14 +42,14 @@
<li><a href="en/bugreports.html">Tips for a helpful bug report</a></li>
</ul>
<h2><a id="system" name="system">Getting to know the system</a></h2>
<h1><a id="system" name="system">Getting to know the system</a></h1>
<p>The first release(s) of Haiku will be very much like the BeOS R5, the operating system it is reimplementing. If you never experienced it, have a look at these links:</p>
<ul>
<li><a href="../userguide/en/contents.html">Haiku User Guide</a></li>
<li><a href="http://www.haiku-os.org/community/">List of BeOS/Haiku websites</a></li>
</ul>
<h2><a id="software" name="software">Installing more software</a></h2>
<h1><a id="software" name="software">Installing more software</a></h1>
<p>Because of our binary and source compatibility, many BeOS applications run on Haiku. After downloading a package, simply unzip it (double clicking should open <span class="app">Expander</span>) to a folder in <span class="path">/boot/apps/</span> and start the application from there.</p>
<p>Popular software repositories are:</p>
@ -60,7 +60,7 @@
<li><a href="http://www.osdrawer.net/">OsDrawer</a> hosts native BeOS and Haiku open source software projects</li>
</ul>
<h2><a id="api" name="api">Getting to know the API</a></h2>
<h1><a id="api" name="api">Getting to know the API</a></h1>
<p>Since Haiku is a reimplementation, the API is still the same as for BeOS R5 (with some additions). Therefore the documentation in the BeBook is still a valid resource. Thanks to ACCESS, who own the rights to former Be Inc. property, we are allowed to provide a copy of the BeBook.</p>
<p>There are additional resources that should help you getting started:</p>
@ -71,7 +71,7 @@
<li><a href="http://www.haiku-os.org/legacy-docs/benewsletter/">BeNewsletter Archive</a></li>
</ul>
<h2><a id="contact" name="contact">Getting in contact</a></h2>
<h1><a id="contact" name="contact">Getting in contact</a></h1>
<p>Get in contact with other developers and users and join the discussions in our forums or mailing lists.</p>
<ul>
<li><a href="http://www.haiku-os.org/forum">Haiku Forums</a></li>