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

Synchronize.

Browse Source
This commit is contained in:
waddlesplash 2023-07-24 19:01:02 +00:00
parent 39d8b33bfc
commit d7addc6c47
517 changed files with 2096 additions and 2106 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

0
userguide/Haiku-doc.css Normal file → Executable file
View File

2
userguide/ca/applications/bepdf.html
View File

@ -74,7 +74,7 @@
</table>
<p><br /></p>
<p>BePDF és un visualitzador de PDF que arrenca ràpidament. A més de visualitzar, permet fer anotacions, i afegir punts de llibre als PDFs no encriptats. Actualment està totalment localitzat en 20 llengües i és fàcil afegir més llengües fent servir fitxers de text.</p>
<p>Documentation is available as <a href="file:///boot/system/apps/BePDF/docs/English/table_of_contents.html">HTML</a> or <a href="file:///boot/system/apps/BePDF/docs/English.pdf">PDF</a>. The latter will also open from the menu <span class="menu">Help | Show Help...</span>.</p>
<p>Documentation is available as <a href="file:///boot/system/apps/BePDF/docs/English/table_of_contents.html">HTML</a> or <a href="file:///boot/system/apps/BePDF/docs/English.pdf">PDF</a>. The latter will also open from the menu <span class="menu">Help | Show Help…</span></p>
</div>
</div>

2
userguide/ca/applications/cli-apps.html
View File

@ -102,7 +102,7 @@ Would you like a link to it?" "On Desktop" "In Deskbar" "No thanks"</pre>
<p><img src="../images/apps-images/cli-filepanel.png" alt="cli-filepanel.png" /></p>
</td></tr>
<tr><td><p><span class="cli">hey</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">hey</span> is a littler helper tool that sends BMessages to applications and prints out their answer. It can be used for application scripting, i.e. "remote controlling" a program from a script or the command line. Its usage is a bit complex... <a href="https://www.haiku-os.org/blog/humdinger/2017-11-05_scripting_the_gui_with_hey/">Humdinger's blog post</a> serves as a good introduction, and thanks to Scot Hacker's BeOS Bible, there is a much more comprehensive <a href="http://www.birdhouse.org/beos/bible/bos/ch_scripting6.html">hey tutorial</a> by Chris Herborth.</p>
<td valign="top"><p><span class="cli">hey</span> is a littler helper tool that sends BMessages to applications and prints out their answer. It can be used for application scripting, i.e. "remote controlling" a program from a script or the command line. Its usage is a bit complex… <a href="https://www.haiku-os.org/blog/humdinger/2017-11-05_scripting_the_gui_with_hey/">Humdinger's blog post</a> serves as a good introduction, and thanks to Scot Hacker's BeOS Bible, there is a much more comprehensive <a href="http://www.birdhouse.org/beos/bible/bos/ch_scripting6.html">hey tutorial</a> by Chris Herborth.</p>
</td></tr>
<tr><td><p><span class="cli">notify</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">notify</span> shows a notification panel with a message. There are various parameters that are described when you call <span class="cli">notify --help</span>. A notification can also be used to show the progress of some action. When doing that, it's important to set a <i>messageID</i> and always use it when you update the progress (a float between 0.0 and 1.0 that's printed as percent). Otherwise you'll see several notification panels if you update quicker then the set timeout.<br />

2
userguide/ca/applications/diskusage.html
View File

@ -70,7 +70,7 @@
<p><br /></p>
<p>DiskUsage shows graphically how the space on your volumes is utilized.<br />
A useful tool to answer the question, "<i>Where has all my disk space gone?</i>".</p>
<p>After launching, DiskUsage shows only an empty window with all mounted volumes as tabs at the top. You'll have to choose the one you're interested in and click <span class="button">Scan</span> to start chugging through the disk. For larger disks this can take some time... While you wait, you may switch to a different tab and start exploring that volume or begin the scan process there as well.<br />
<p>After launching, DiskUsage shows only an empty window with all mounted volumes as tabs at the top. You'll have to choose the one you're interested in and click <span class="button">Scan</span> to start chugging through the disk. For larger disks this can take some time… While you wait, you may switch to a different tab and start exploring that volume or begin the scan process there as well.<br />
It's not recommended to start several concurrent scan processes on the same physical disk, as the constant repositioning of the heads of the drive will only extend the wait.</p>
<p><img id="diskusage" src="../images/apps-images/diskusage.png" alt="diskusage.png" /></p>
<p>The concentric circles represent different levels in the file system hierarchy. Above, the circle in the center represents the <span class="path">/boot/home/</span> folder. Each segment of the ring immediately outside that circle is a file or folder under <span class="path">/boot/home/</span>. Every segment farther outside brings you one level deeper in the file hierarchy. You may have to resize the window to accommodate very deep folders.</p>

2
userguide/ca/applications/drivesetup.html
View File

@ -106,7 +106,7 @@ Besides the familiar icons for harddisks, CD drives and USB sticks etc., there a
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="creating" name="creating">Creating a new partition</a></h2>
<p>When you found unformatted space on a drive, like the above <tt>&lt;empty&gt;</tt>, you can create a new partition in this space with <span class="menu">Partition | Create...</span>(<span class="key">ALT</span> <span class="key">C</span>).</p>
<p>When you found unformatted space on a drive, like the above <tt>&lt;empty&gt;</tt>, you can create a new partition in this space with <span class="menu">Partition | Create…</span>(<span class="key">ALT</span> <span class="key">C</span>).</p>
<img src="../images/apps-images/drivesetup-create.png" alt="drivesetup-create.png" />
<p>You're prompted with this dialog that lets you adjust the partition size and type. Choose <span class="menu">Be File System</span> if you want to use the partition for an Haiku installation or if you want to use all the interesting Haiku features with it, like attributes and queries. Note, that other operating systems might not be able to access such a partition.</p>
<p>The <span class="menu">Active partition</span> checkbox is only available if you have created a primary partition instead of just another logical partition within an extended one. You'll have to tick that checkbox if you plan to use that partition to boot a Haiku installation.</p>

2
userguide/ca/applications/expander.html
View File

@ -81,7 +81,7 @@ Just double-click an archive to see this simple interface:</p>
<p>You can toggle the display of the file listing by un/checking <span class="menu">Show contents</span> or pressing <span class="key">ALT</span> <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">Settings | Settings...</span> or <span class="key">ALT</span> <span class="key">S</span> opens a preference panel that offers some useful settings to adjust Expander's behavior.<br />
<p><span class="menu">Settings | Settings…</span> or <span class="key">ALT</span> <span class="key">S</span> opens a preference panel that offers some useful settings to adjust Expander's behavior.<br />
The options are all self-explanatory:</p>
<p><img id="preferences" src="../images/apps-images/expander-preferences.png" alt="expander-preferences.png" /></p>

12
userguide/ca/applications/haikudepot.html
View File

@ -135,15 +135,15 @@ In the middle are user comments with their nickname, the number of stars they ga
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="menu" name="menu">HaikuDepot and Show menu</a></h2>
<p>In the <span class="menu">HaikuDepot</span> menu at the top of the window, you'll find an item to <span class="menu">Refresh repositories</span>. This will request an up-to-date list of all available packages from the repositories.<br />
The second item is to <span class="menu">Manage repositories...</span>. It opens the <a href="../preferences/repositories.html">Repositories</a> preferences, to add/remove or disable and enable repositories.<br />
<span class="menu">Check for updates...</span> opens the <a href="../apps/softwareupdater.html">SoftwareUpdater</a> to search and install updated packages.<br />
<span class="menu">Settings...</span> opens a window with the currently only option: <span class="menu">Share anonymous usage data with HaikuDepotServer</span>. The data is used to, for example, increase a counter on how often a package is viewed and installed, which then can determine if a package is promoted to the "Featured packages" list.</p>
The second item is to <span class="menu">Manage repositories…</span>. It opens the <a href="../preferences/repositories.html">Repositories</a> preferences, to add/remove or disable and enable repositories.<br />
<span class="menu">Check for updates…</span> opens the <a href="../apps/softwareupdater.html">SoftwareUpdater</a> to search and install updated packages.<br />
<span class="menu">Settings…</span> opens a window with the currently only option: <span class="menu">Share anonymous usage data with HaikuDepotServer</span>. The data is used to, for example, increase a counter on how often a package is viewed and installed, which then can determine if a package is promoted to the "Featured packages" list.</p>
<p>Under <span class="menu">Show</span> you can choose to also display <span class="menu">Develop packages</span> and <span class="menu">Source packages</span> in the packages list. For the normal user those are of no interest and would only clutter the list. They are important, however, for people who need the libraries, headers etc. of a package to develop and compile programs depending on them.</p>
<p>Of more interest are the options to only show <span class="menu">Available packages</span> and <span class="menu">Installed packages</span>.</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="account" name="account">Creating a User Account</a></h2>
<p>To be able to rate a package, you need a user account at the <a href="http://depot.haiku-os.org">Haiku Depot Server</a> that serves all the packages and keeps track of ratings and user comments. You can create an account within the HaikuDepot application by clicking on the menu in the far right of the menu bar that shows your current status: <span class="menu">Not logged in</span>. Choosing <span class="menu">Log in...</span> opens a window with two tabs; one to enter your user name and password (once you have those) to log in, and the other to create a new account:</p>
<p>To be able to rate a package, you need a user account at the <a href="http://depot.haiku-os.org">Haiku Depot Server</a> that serves all the packages and keeps track of ratings and user comments. You can create an account within the HaikuDepot application by clicking on the menu in the far right of the menu bar that shows your current status: <span class="menu">Not logged in</span>. Choosing <span class="menu">Log in…</span> opens a window with two tabs; one to enter your user name and password (once you have those) to log in, and the other to create a new account:</p>
<img src="../images/apps-images/haikudepot-login-tab.png" alt="haikudepot-login-tab.png" />
<p>To create an account you need to:</p>
<ul><li>use an all lower-case user name without special characters</li>
@ -151,8 +151,8 @@ The second item is to <span class="menu">Manage repositories...</span>. It opens
<li>provide a valid email address (if you want a new password sent to you in case you forgot it)</li>
<li>solve the captcha</li>
<li>tick the checkboxes to confirm you're over 16 and have read the usage conditions linked below them.</li></ul>
<p>After logging in, the top-right menu of the HaikuDepot window will now say <span class="menu">Logged in as (...)</span>, showing your user name. The menu now offers you to <span class="menu">Switch account...</span> or <span class="menu">Log out</span>.</p>
<p>As a reminder of what you actually agreed to when you ticked the above mentioned checkbox, there are menu items to <span class="menu">View latest/agreed usage conditions...</span></p>
<p>After logging in, the top-right menu of the HaikuDepot window will now say <span class="menu">Logged in as (…)</span>, showing your user name. The menu now offers you to <span class="menu">Switch account...</span> or <span class="menu">Log out</span>.</p>
<p>As a reminder of what you actually agreed to when you ticked the above mentioned checkbox, there are menu items to <span class="menu">View latest/agreed usage conditions…</span></p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="rating" name="rating">Rating and Commenting</a></h2>

8
userguide/ca/applications/icon-o-matic.html
View File

@ -244,7 +244,7 @@ If not, "Freeze transformation" will apply the current shape transformation to t
With the LOD you control the visibility of a shape depending on its size. That way, you can leave away details of an icon that look good on a bigger icon, but maybe not so much on its smaller version.</p>
<p>This is how it works: A LOD of 1.0 is defined as a 64px icon size. To get the LOD of a particular icon size you simply divide it by 64, e.g. a 16px icon has a LOD of 16/64 = 0.25. A shape won't be visible below its <span class="menu">Min LOD</span> and above its <span class="menu">Max LOD</span>.</p>
<p>So, if you set a shape's <span class="menu">Min LOD</span> to 0.0 and the <span class="menu">Max LOD</span> to 0.5, this means that the shape will only be visible for icon sizes smaller or <i>equal</i> to 32px. If you wanted to exclude the 32px icon size, you'd have to stay below 0.5, say 0.49.</p>
<p>The LOD is not only for leaving out detailing shapes, but also to e.g. change the stroke width at different sizes, if you feel that's needed. Simply duplicate a shape, make your changes and set both of their LOD settings to show either one or the other. Here lies the only source of potential confusion, when you unwittingly overlap LODs of shapes, and wonder why at some size both are visible...<br />
<p>The LOD is not only for leaving out detailing shapes, but also to e.g. change the stroke width at different sizes, if you feel that's needed. Simply duplicate a shape, make your changes and set both of their LOD settings to show either one or the other. Here lies the only source of potential confusion, when you unwittingly overlap LODs of shapes, and wonder why at some size both are visible…<br />
For example, if Shape 1 were to be shown below 48px and Shape 2 from 48px upward (LOD: 48/64 = 0.75):</p>
<table summary="LOD values example" border="0" cellpadding="5">
@ -278,7 +278,7 @@ Of course you can move these indicators to change the gradient to your liking. Y
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="i-o-m-transformer" name="i-o-m-transformer">Transformer</a></h3>
<p>A shape can have Transformers which change its appearance. The effects, however, are more subtle than a truck turning into a battle robot...</p>
<p>A shape can have Transformers which change its appearance. The effects, however, are more subtle than a truck turning into a battle robot…</p>
<h4><a id="i-o-m-transformer-menu" name="i-o-m-transformer-menu">Transformer Add Menu</a></h4>
<table summary=" Transformer Add menu" border="0" cellspacing="0" cellpadding="2">
@ -302,9 +302,9 @@ Of course you can move these indicators to change the gradient to your liking. Y
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="i-o-m-save" name="i-o-m-save">Saving an icon</a></h3>
<p>There's your usual menu bar at the top, <span class="menu">File</span>, <span class="menu">Edit</span>, <span class="menu">Options</span>. The usage is pretty much self-explaining, so we'll only look at how to save your work.</p>
<p><span class="menu">File | Save as...</span> will save in a special Icon-O-Matic format that retains additional information like the names of paths, shapes and styles. These will be stripped from the actual icon once you export it to save space. It's a good idea to back-up your work like this, because without named objects everything's named "&lt;path&gt;/&lt;shape&gt;/&lt;style&gt;" which makes specific changes tedious.</p>
<p><span class="menu">File | Save as…</span> will save in a special Icon-O-Matic format that retains additional information like the names of paths, shapes and styles. These will be stripped from the actual icon once you export it to save space. It's a good idea to back-up your work like this, because without named objects everything's named "&lt;path&gt;/&lt;shape&gt;/&lt;style&gt;" which makes specific changes tedious.</p>
<p><span class="menu">File | Export as...</span> opens a familiar save panel with a file format pop-up menu at the bottom, offering these choices:</p>
<p><span class="menu">File | Export as…</span> opens a familiar save panel with a file format pop-up menu at the bottom, offering these choices:</p>
<table summary="file formats" border="0" cellspacing="0" cellpadding="2">
<tr><td>HVIF</td><td style="width:15px;"></td><td>Haiku Vector Icon Format</td></tr>
<tr><td>HVIF RDef</td><td></td><td>Saves as resource used by programmers</td></tr>

2
userguide/ca/applications/installer.html
View File

@ -81,7 +81,7 @@
<p>In the first pop-up menu you choose the source for the installation. It can be a currently installed Haiku or can come from an install CD or USB drive, etc.<br />
The second pop-up menu specifies the target for the installation. This target partition/volume will be completely overwritten and has to be set aside beforehand by a partitioning tool like GParted.</p>
<p>Clicking the little expander widget will <i>Show optional packages</i>, if available, that you can choose to install in addition to the basic Haiku.</p>
<p>You should do a last check if you really picked the right target before starting the installation process. Click on <span class="button">Setup partitions...</span> to open <a href="drivesetup.html">DriveSetup</a> and have a look at the naming and layout of the available volumes and partitions.</p>
<p>You should do a last check if you really picked the right target before starting the installation process. Click on <span class="button">Setup partitions…</span> to open <a href="drivesetup.html">DriveSetup</a> and have a look at the naming and layout of the available volumes and partitions.</p>
<p><span class="button">Begin</span> starts the installation procedure, which basically copies the <span class="path">/home/</span> and <span class="path">/system/</span> folder onto the target volume and makes it bootable.</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>

11
userguide/ca/applications/list-cli-apps.html
View File

@ -78,7 +78,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>CortexAddOnHost</tt></td><td style="width:10px;"> </td><td>Starts service to monitor audio and video media add-ons in use. </td></tr>
<tr><td><tt>FirstBootPrompt</tt></td><td> </td><td>Language and keymap setup. </td></tr>
<tr><td><tt>[</tt></td><td> </td><td>Returns true/false after comparing items.</td></tr>
<tr><td colspan="3"><a id="A" name="A"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>A</h2></a></td></tr>
<tr><td colspan="3"><a id="A" name="A"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>A - E</h2></a></td></tr>
<tr><td><tt>addattr</tt></td><td> </td><td>Writes an attribute to a file, taking the type into account and converting the values accordingly. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td><tt>alert</tt></td><td> </td><td>Shows a message box. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td><tt>arp</tt></td><td> </td><td>Manipulates the system ARP cache. </td></tr>
@ -136,7 +136,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>error</tt></td><td> </td><td>Prints clear text error messages for given error numbers. </td></tr>
<tr><td><tt>expand</tt></td><td> </td><td>Converts tabs to spaces.</td></tr>
<tr><td><tt>expr</tt></td><td> </td><td>Prints the value of an expression.</td></tr>
<tr><td colspan="3"><a id="F" name="F"><h2>F</h2></a></td></tr>
<tr><td colspan="3"><a id="F" name="F"><h2>F - J</h2></a></td></tr>
<tr><td><tt>factor</tt></td><td> </td><td>Prints the prime factors of integer numbers.</td></tr>
<tr><td><tt>false</tt></td><td> </td><td>Does nothing, indicates "unsuccessful" and returns the value "1".</td></tr>
<tr><td><tt>fdinfo</tt></td><td> </td><td>Shows info about the used file descriptors in the system. </td></tr>
@ -172,7 +172,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>iroster</tt></td><td> </td><td>Lists input devices. </td></tr>
<tr><td><tt>isvolume</tt></td><td> </td><td>Gets information about a mounted volume.</td></tr>
<tr><td><tt>join</tt></td><td> </td><td>For each pair of input lines with identical join fields, write a line to standard output. </td></tr>
<tr><td colspan="3"><a id="K" name="K"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>K</h2></a></td></tr>
<tr><td colspan="3"><a id="K" name="K"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>K - O</h2></a></td></tr>
<tr><td><tt>kernel_debugger</tt></td><td> </td><td>Enters the kernel debugger.</td></tr>
<tr><td><tt>keymap</tt></td><td> </td><td>Loads or saves a keymap.</td></tr>
<tr><td><tt>kill</tt></td><td> </td><td>Sends a signal to quit a process. </td></tr>
@ -226,7 +226,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>nproc</tt></td><td> </td><td>Prints the number of available processing units.</td></tr>
<tr><td><tt>od</tt></td><td> </td><td>Writes an unambiguous representation of a file.</td></tr>
<tr><td><tt>open</tt></td><td> </td><td>Launches an application/document from the shell. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td colspan="3"><a id="P" name="P"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>P</h2></a></td></tr>
<tr><td colspan="3"><a id="P" name="P"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>P - S</h2></a></td></tr>
<tr><td><tt>package</tt></td><td> </td><td>Creates, inspects, or extracts a Haiku package.</td></tr>
<tr><td><tt>package_repo</tt></td><td> </td><td>Creates or inspects a Haiku package repository file.</td></tr>
<tr><td><tt>passwd</tt></td><td> </td><td>Changes the user password. </td></tr>
@ -249,6 +249,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>ramdisk</tt></td><td> </td><td>Creates a ramdisk. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td><tt>rc</tt></td><td> </td><td>Resource compiler.</td></tr>
<tr><td><tt>readlink</tt></td><td> </td><td>Prints the path to the destination of a symbolic link.</td></tr>
<tr><td><tt>recover</tt></td><td> </td><td>A tool that tries to recover files from a corrupted BFS volume (see its <a href="https://www.pinc-software.de/docs/BFS-tools.html#recover">documentation</a> for a bit more info).</td></tr>
<tr><td><tt>reindex</tt></td><td> </td><td>Puts attributes of existing files into newly created indexes. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td><tt>release</tt></td><td> </td><td>Releases a semaphore. </td></tr>
<tr><td><tt>renice</tt></td><td> </td><td>Alters the priority of a running process. </td></tr>
@ -286,7 +287,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>sum</tt></td><td> </td><td>Prints checksum and block counts for each file. </td></tr>
<tr><td><tt>sync</tt></td><td> </td><td>Forces changed blocks to disk, updates the superblock. </td></tr>
<tr><td><tt>sysinfo</tt></td><td> </td><td>Shows system info. </td></tr>
<tr><td colspan="3"><a id="T" name="T"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>T</h2></a></td></tr>
<tr><td colspan="3"><a id="T" name="T"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>T - Z</h2></a></td></tr>
<tr><td><tt>tac</tt></td><td> </td><td>Concatenates and prints files, last line first. </td></tr>
<tr><td><tt>tail</tt></td><td> </td><td>Prints the last ten lines of a file.</td></tr>
<tr><td><tt>tcpdump</tt></td><td> </td><td>Dumps traffic of a network. </td></tr>

22
userguide/ca/applications/mail.html
View File

@ -67,7 +67,7 @@
<tr class="heading"><td>Índex</td></tr>
<tr class="index"><td><a href="#reading">Reading messages</a><br />
<a href="#creating">Creating new messages</a><br />
<a href="#preferences">Preferences</a></td></tr>
<a href="#preferences">Settings</a></td></tr>
</table>
<h2><img src="../../images/apps-images/mail-icon_64.png" alt="mail-icon_64.png" width="64" height="64" />Mail</h2>
@ -88,14 +88,14 @@
<p>You double-click an email file to open it in Mail. The interface is quite simple:</p>
<img src="../images/apps-images/mail-read.png" alt="email-read.png" />
<p>A menu and optional tool bar on top, with an area of the interesting attributes of a mail (to, from, subject, date) below that, and then the actual body of the mail. If the mail appears with strange characters or empty, try to change the <span class="menu">Encoding</span> in the <span class="menu">Message</span> menu.</p>
<p>If there are files attached to an email, they are listed at the end of the message. A right-click on one opens a context menu to <span class="menu">Save attachment...</span> or <span class="menu">Open attachment</span>. You can also drag &amp; drop directly to the Desktop or another Tracker window.</p>
<p>If there are files attached to an email, they are listed at the end of the message. A right-click on one opens a context menu to <span class="menu">Save attachment…</span> or <span class="menu">Open attachment</span>. You can also drag &amp; drop directly to the Desktop or another Tracker window.</p>
<p>Most of the menu and tool bar items are pretty self-explaining, so we'll concentrate just on the highlights.</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Fitxer</h3>
<p>When you close the window of a new mail, its status is normally switched from "New" to "Read". But you can set other statuses as well, by choosing from the <span class="menu">Close and</span> submenu. There you'll also find the option <span class="menu">Set to...</span> to create your own custom statuses, which are saved under <span class="path">~/config/settings/Mail/status/</span>.</p>
<p>When you close the window of a new mail, its status is normally switched from "New" to "Read". But you can set other statuses as well, by choosing from the <span class="menu">Close and</span> submenu. There you'll also find the option <span class="menu">Set to…</span> to create your own custom statuses, which are saved under <span class="path">~/config/settings/Mail/status/</span>.</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Edita</h3>
<p>Here you'll find an item to open Mail's <span class="menu">Preferences...</span> (<a href="#preferences">see below</a>) and a shortcut to manage your <span class="menu">Accounts...</span>, which will open the <a href="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<p>Here you'll find an item to open Mail's <span class="menu">Settings…</span> (<a href="#preferences">see below</a>) and a shortcut to manage your <span class="menu">Accounts…</span>, which will open the <a href="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Visualitza</h3>
<p>You'll only seldomly need these two items, if at all:</p>
@ -111,7 +111,7 @@
<tr><td class="onelinetop"><span class="menu">Contesta al remitent</span></td><td><span class="key">OPT</span> <span class="key">ALT</span> <span class="key">R</span></td><td></td><td>This on the other hand, sends directly and only to the person listed in the "From" attribute.</td></tr>
<tr><td><span class="menu">Contesta a tothom</span></td><td class="onelinetop"><span class="key">SHIFT</span> <span class="key">ALT</span> <span class="key">R</span></td><td></td><td>Replies to the original sender plus all other (cc'ed) recipients of the original mail.</td></tr>
</table>
<div class="box-info">If you mark a passage in the email before replying to it, only the marked text will be quoted in your answering mail. A nice way to cut down on excessive quoting, which is frowned upon by pretty much everybody...</div>
<div class="box-info">If you mark a passage in the email before replying to it, only the marked text will be quoted in your answering mail. A nice way to cut down on excessive quoting, which is frowned upon by pretty much everybody…</div>
<p>The items to <span class="menu">Forward</span>, <span class="menu">Resend</span> and <span class="menu">Copy to new</span> are again pretty self-explaining.</p>
<p>When you've opened an email from a Tracker or query result window, <span class="menu">Previous message</span> and <span class="menu">Next message</span> will move to the previous/next email in the list.</p>
<p><span class="menu">Save address</span> collects all email addresses from the header and the actual email body in a submenu. Choosing an address will open the <a href="people.html">People</a> application in order to complete and save the contact information.</p>
@ -123,7 +123,7 @@
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="creating" name="creating">Nous missatges</a></h2>
<p>A new email is created by invoking <span class="menu">New mail message</span> of the <span class="menu">File</span> menu or the corresponding icon from the tool bar of an open email. Or you just start the Mail application or choose <span class="menu">Create new message...</span> from the context menu of the mailbox icon in the Deskbar.</p>
<p>A new email is created by invoking <span class="menu">New mail message</span> of the <span class="menu">File</span> menu or the corresponding icon from the tool bar of an open email. Or you just start the Mail application or choose <span class="menu">Create new message…</span> from the context menu of the mailbox icon in the Deskbar.</p>
<img src="../images/apps-images/mail-write.png" alt="email-write.png" />
<p>The window is pretty similar to the one when reading mails. The menu and tool bar items are slightly different and the text boxes have to be filled with the recipient's email address, subject and so on, of course.</p>
<p><span class="menu">Cc</span> is short for the anachronistic term "<i>carbon copy</i>" and results in copies of your mail being sent to the listed people. The difference to just listing a buch of addresses in the "To" field is, that you don't directly address the cc'ed people, thereby signaling that you probably don't expect an answer of them.<br />
@ -142,15 +142,15 @@
<p><span class="menu">Check spelling</span> currently only offers corrections of English texts by marking wrong or unknown words red and showing them in italic.
Right-clicking such a word opens a context menu offering suggestions to correct the word or to <span class="menu">Add</span> it to the accepted vocabulary.</p>
<p>Then, there are again the items to open Mail's <span class="menu">Preferences...</span> (<a href="#preferences">see below</a>) and a shortcut to managing your <span class="menu">Accounts...</span>, which will open the <a href="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<p>Then, there are again the items to open Mail's <span class="menu">Settings…</span> (<a href="#preferences">see below</a>) and a shortcut to managing your <span class="menu">Accounts…</span>, which will open the <a href="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Missatge</h3>
<p>With <span class="menu">Add signature</span> you can add predefined texts to the end of your mail. From its submenu you can choose a specific or <span class="menu">Random</span> one.</p>
<img src="../images/apps-images/mail-signature.png" alt="email-signature.png" />
<p>You create new or edit existing signatures with <span class="menu">Edit signatures...</span>, which will open a window where you enter the text itself and the title of your new sig. There, in the <span class="menu">Signature</span> menu, you find items to <span class="menu">Open</span> a specific signature or <span class="menu">Save</span> or <span class="menu">Delete</span> the currently loaded one, Signatures should be saved in <span class="path">~/config/settings/Mail/signatures</span>.</p>
<p>Use <span class="menu">Add enclosure...</span> and <span class="menu">Remove enclosure</span> to add/remove files as attachments. You can also drag &amp; drop files from a Tracker window. Be careful though to drop those in the header section (To/From/Subject area at the top) or they'll get pasted into the email body if they are text files.</p>
<p>You create new or edit existing signatures with <span class="menu">Edit signatures…</span>, which will open a window where you enter the text itself and the title of your new sig. There, in the <span class="menu">Signature</span> menu, you find items to <span class="menu">Open</span> a specific signature or <span class="menu">Save</span> or <span class="menu">Delete</span> the currently loaded one, Signatures should be saved in <span class="path">~/config/settings/Mail/signatures</span>.</p>
<p>Use <span class="menu">Add enclosure…</span> and <span class="menu">Remove enclosure</span> to add/remove files as attachments. You can also drag &amp; drop files from a Tracker window. Be careful though to drop those in the header section (To/From/Subject area at the top) or they'll get pasted into the email body if they are text files.</p>
<img src="../images/apps-images/mail-attachments.png" alt="email-attachments.png" />
@ -164,7 +164,7 @@ Right-clicking such a word opens a context menu offering suggestions to correct
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="preferences" name="preferences">Preferències</a></h2>
<img src="../images/apps-images/mail-preferences.png" alt="email-preferences.png" />
<p>Mail's preferences come in two parts:</p>
<p>Mail's settings come in two parts:</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>User interface</h3>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
@ -191,7 +191,7 @@ On Mon, 18 Jan 1998 02:55:16 +0800 you wrote:
<tr><td><span class="menu">Encoding</span></td><td></td><td>Sets the default encoding.</td></tr>
<tr><td class="onelinetop"><span class="menu">Warn unencodable</span></td><td></td><td>If your mail contains characters that can't be encoded with the currently set encoding method, you can turn on being warned about that. That gives you the opportunity to change the encoding before sending. Otherwise unencodable characters are replaced by rectangle symbols.</td></tr>
<tr><td><span class="menu">Text wrapping</span></td><td></td><td>Inserts line-breaks every 76 characters which makes mails easier to read.</td></tr>
<tr><td><span class="menu">Attach attributes</span></td><td></td><td>You can choose to send BFS' attributes of a file alongside the attachments. This is nice for other Haiku users, as they'll get a "complete" file (think artist, album, title attributes of MP3 files), but may cause confusion (or even suspicion) with others, who will wonder what the additional "BeOS Attributes" attachment might be...<br />
<tr><td><span class="menu">Attach attributes</span></td><td></td><td>You can choose to send BFS' attributes of a file alongside the attachments. This is nice for other Haiku users, as they'll get a "complete" file (think artist, album, title attributes of MP3 files), but may cause confusion (or even suspicion) with others, who will wonder what the additional "BeOS Attributes" attachment might be…<br />
Should you opt not to send attributes with your attachments, remember zip up your files before you send them or you'll strip away BFS attributes.</td></tr>
</table>

4
userguide/ca/applications/mediaplayer.html
View File

@ -77,7 +77,7 @@ Below that you find the usual controls to skip to the previous track, play/pause
<h2>Audio and video playback</h2>
<p>Since there aren't any specific features for audio playback, we'll go straight to video or general features.</p>
<img src="../images/apps-images/mediaplayer-info.png" alt="mediaplayer-info.png" />
<p>Available to all media is the <span class="menu">File info...</span> (<span class="key">ALT</span> <span class="key">I</span>). It shows information about the currently loaded file, like playing time or details of the audio/video track and its codec.</p>
<p>Available to all media is the <span class="menu">File info…</span> (<span class="key">ALT</span> <span class="key">I</span>). It shows information about the currently loaded file, like playing time or details of the audio/video track and its codec.</p>
<p>Most of the often used commands from the menus are also available from a right-click context menu on the video area. Convenient when in full-screen mode.<br />
Under <span class="menu">Video</span> you'll find options to zoom the window to various levels or force the aspect ratio to some standard values. Leaving the aspect ration to the default <span class="menu">Stream settings</span> should work best for correctly encoded files.</p>
<p>MediaPlayer supports subtitles in <a href="http://en.wikipedia.org/wiki/SubRip">SRT</a> format. To have them show up under <span class="menu">Subtitles</span>, their filenames have to be identical to their video file, with a suffixed language name and ".srt" instead of the video's extension. For example:</p>
@ -89,7 +89,7 @@ MyMovie.Français.srt</pre>
<p>You can toggle the <span class="menu">Full screen</span> mode (<span class="key">ALT</span> <span class="key">ENTER</span> or <span class="key">F</span> or a double left-click), hide MediaPlayer's window borders and controls with <span class="menu">Hide interface</span> (<span class="key">ALT</span> <span class="key">H</span> or a double right-click) or have its window <span class="menu">Always on top</span> (<span class="key">ALT</span> <span class="key">A</span>).</p>
<h2>Playlists</h2>
<p><span class="menu">MediaPlayer | Playlist...</span> (<span class="key">ALT</span> <span class="key">P</span>) opens a window with the files currently queued up for playback. Double-clicking an entry starts playing it.</p>
<p><span class="menu">MediaPlayer | Playlist…</span> (<span class="key">ALT</span> <span class="key">P</span>) opens a window with the files currently queued up for playback. Double-clicking an entry starts playing it.</p>
<img src="../images/apps-images/mediaplayer-playlist.png" alt="mediaplayer-playlist.png" />
<p>You can add more files by dropping them into the list and rearrange their position via drag &amp; drop. New files are added in the order they were selected from a Tracker window. Drag &amp; dropping them with the right mouse button shows a context menu to insert them <span class="menu">sorted</span> (alphabetically).<br />
From the <span class="menu">Edit</span> menu you can <span class="menu">Randomize</span> or <span class="menu">Remove</span> (<span class="key">DEL</span>) an entry from the list or delete the actual file with <span class="menu">Move to Trash</span> (<span class="key">ALT</span> <span class="key">T</span>).</p>

2
userguide/ca/applications/poorman.html
View File

@ -70,7 +70,7 @@
<p><br /></p>
<p>PoorMan is a nice little webserver that's extremely easy to set up. Naturally it doesn't offer any advanced features like other heavy duty server software, it's after all only a poor man's webserver.</p>
<p>Upon its first launch, PoorMan asks for the folder that is about to be served to the web. If you go with the <span class="button">Default</span>, a new folder <span class="path">/boot/home/public_html</span> is created for you. As a start page a HTML file named by default <span class="cli">index.html</span> has to be present there.</p>
<p>PoorMan presents itself with a simple console that logs its activity. Then, there's status information if the server is running, which folder is being served, and a hit counter. Settings are changed with <span class="menu">Edit | Settings...</span>:
<p>PoorMan presents itself with a simple console that logs its activity. Then, there's status information if the server is running, which folder is being served, and a hit counter. Settings are changed with <span class="menu">Edit | Settings…</span>:
</p>
<p><img id="poorman" src="../images/apps-images/poorman.png" alt="poorman.png" /></p>
<p>The settings panel is divided into three tabs:</p>

4
userguide/ca/applications/showimage.html
View File

@ -94,12 +94,12 @@ ShowImage provides minimal editing features to crop, rotate and flip images and
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Editing</h2>
<img src="../images/apps-images/showimage-edit.jpg" alt="showimage-edit.jpg" />
<p>The <span class="menu">Image</span> menu offers the few image manipulations necessary for an image viewer: rotating and flipping the image. Note however, that the actual image data won't be changed. Only an attribute is added to the file so it'll be shown rotated or flipped the next time you open it.</p>
<p><span class="menu">Use as backgroud...</span> will open the <a href="../preferences/backgrounds.html">Backgrounds</a> preferences to set the current picture as image for your workspaces.</p>
<p><span class="menu">Use as background…</span> will open the <a href="../preferences/backgrounds.html">Backgrounds</a> preferences to set the current picture as image for your workspaces.</p>
<p>Cropping is another feature that's needed sometimes. To define the frame to cut to, you can switch to <span class="menu">Selection mode</span> from the <span class="menu">Edit</span> menu and drag out a box with your left mouse button. If you don't want to change modes first, you can create this box in "normal mode" by simply holding <span class="key">CTRL</span> while left-click-dragging, which otherwise would just pan the image around.<br />
<span class="menu">Clear selection</span> or <span class="key">ESC</span> will remove the selection box.</p>
<p>The following chapter shows how to actually save the cropped area.</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Saving and converting</h2>
<p>To save or convert an image into any available format, you can invoke the normal <span class="menu">Save as...</span> item from the <span class="menu">File</span> menu, select the format and choose a file name.<br />
<p>To save or convert an image into any available format, you can invoke the normal <span class="menu">Save as…</span> item from the <span class="menu">File</span> menu, select the format and choose a file name.<br />
Often quicker, especially when the Tracker window with the destination folder is already open, is using drag &amp; drop.</p>
<img src="../images/apps-images/showimage-dnd.jpg" alt="showimage-dnd.jpg" />
<p>This is also how the above mentioned cropping is finalized. Either select a frame as described above, or choose <span class="menu">Edit | Select all</span> for the whole image. Then drag &amp; drop the selection onto the Desktop or any Tracker window to create a new image clipping in the same format of the original image.</p>

10
userguide/ca/applications/terminal.html
View File

@ -83,14 +83,14 @@
<br />
<p>Double-clicking into the emtpy part of the tab bar opens a new tab; onto a tab opens a dialog to rename its title. There are several %-designated variables that are explained with a tooltip when you hover the mouse over the text field.<br />
By default, <tt>%1d: %p</tt>, a tab shows the current directory and, separated by a <tt>:</tt>, the name of the currently running process (or <tt>--</tt> if it's just bash running, probably idling). The screenshot above shows the first tab with a FTP session in the <span class="path">Desktop</span> folder and a second tab idling at <span class="path">home</span>.<br />
Via <span class="menu">Settings | Window title...</span> the Terminal window's title can be edited in a similar way.</p>
<p>Right-clicking a tab shows a context menu to <span class="menu">Close tab</span>, <span class="menu">Close other tabs</span> or, like double-clicking, <span class="menu">Edit tab title...</span>.</p>
Via <span class="menu">Settings | Window title…</span> the Terminal window's title can be edited in a similar way.</p>
<p>Right-clicking a tab shows a context menu to <span class="menu">Close tab</span>, <span class="menu">Close other tabs</span> or, like double-clicking, <span class="menu">Edit tab title…</span></p>
<p>A Terminal window can be resized like any other window or you use the presets from the <span class="menu">Settings | Window size</span> menu. <span class="key">ALT</span> <span class="key">ENTER</span> toggles fullscreen mode.</p>
<p>All the settings you change directly through the <span class="menu">Settings</span> menu, like <span class="menu">Window title</span>, <span class="menu">Window size</span>, <span class="menu">Text encoding</span> or <span class="menu">Font size</span> are only kept for the current session. If you want to make permanent changes, you have to apply them in the <span class="menu">Settings...</span> panel.</p>
<p>All the settings you change directly through the <span class="menu">Settings</span> menu, like <span class="menu">Window title</span>, <span class="menu">Window size</span>, <span class="menu">Text encoding</span> or <span class="menu">Font size</span> are only kept for the current session. If you want to make permanent changes, you have to apply them in the <span class="menu">Settings…</span> panel.</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="settings" name="settings">Preferències</a></h2>
<p><span class="menu">Settings | Settings...</span> opens a panel to configure the standard settings of a Terminal.</p>
<p><span class="menu">Settings | Settings…</span> opens a panel to configure the standard settings of a Terminal.</p>
<img src="../images/apps-images/terminal-settings.png" alt="terminal-settings.png" />
<br />
<p>Most of the offered settings speak for themselves. Not entirely obvious though, the font size is set in the submenu of the <span class="menu">Font</span> popup menu.<br />
@ -101,7 +101,7 @@ You can choose pre-defined color schema like <span class="menu">Midnight</span>
<span class="menu">Use left Option as Meta key</span> if you work with certain UNIX software that relies on accessing an extended portion of the ASCII character set, like e.g. GNU Emacs and the GNU readline library.<br />
Activate the checkbox to <span class="menu">Confirm exit if active programs exist</span> and you'll be warned when trying to close a Terminal window while an app is still being executed.</p>
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
<tr><td class="onelinetop"><span class="button">Save to file...</span></td><td width="10"> </td><td>let's you save different settings as separate profiles, which on double-click open an accordingly configured Terminal.</td></tr>
<tr><td class="onelinetop"><span class="button">Save to file…</span></td><td width="10"> </td><td>let's you save different settings as separate profiles, which on double-click open an accordingly configured Terminal.</td></tr>
<tr><td><span class="button">Revert</span></td><td> </td><td>brings back the settings that were active when you opened the settings panel.</td></tr>
<tr><td><span class="button">Defaults</span></td><td> </td><td>resets everything to default values.</td></tr>
</table>

2
userguide/ca/applications/textsearch.html
View File

@ -81,7 +81,7 @@
<tr><td colspan="5"><h3>Menú de Fitxer</h3></td></tr>
<tr><td class="onelinetop"><span class="menu">New window</span></td><td></td><td><span class="key">ALT</span> <span class="key">N</span></td><td> </td><td>Opens a new window where you can enter another string and search through the same files/folders.
</td></tr>
<tr><td><span class="menu">Set target...</span></td><td></td><td><span class="key">ALT</span> <span class="key">F</span></td><td></td><td>Lets you choose a new set of files and folders to search through. Alternatively you can drag and drop files/folders into the window.</td></tr>
<tr><td><span class="menu">Set target…</span></td><td></td><td><span class="key">ALT</span> <span class="key">F</span></td><td></td><td>Lets you choose a new set of files and folders to search through. Alternatively you can drag and drop files/folders into the window.</td></tr>
<tr><td colspan="5"><h3>Menú d'accions</h3></td></tr>
<tr><td><span class="menu">Trim selection</span></td><td></td><td><span class="key">ALT</span> <span class="key">T</span></td><td> </td><td>Removes all entries from the list that are not currently selected.</td></tr>
<tr><td><span class="menu">Open selection</span></td><td></td><td><span class="key">ALT</span> <span class="key">O</span></td><td></td><td>Opens the currently selected files with their preferred application (same as a double-click). If it's a text editor supporting it (like Pe), you can jump to the exact line the search string was found.</td></tr>

5
userguide/ca/applications/webpositive.html
View File

@ -108,12 +108,13 @@ Strings not recognized as URLs will get looked up with the search engine set in
<li><p><span class="menu">Edit | Find</span> shows a find bar at the bottom to start an in-page search. Matches are highlighted in the page.</p></li>
</ul>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Bookmarks</h2>
<p>WebPositive's bookmarks are managed as files and folders in <tt>~/config/settings/WebPositive/Bookmarks/</tt>. Adding a bookmark will create a new file there. You can quickly open the folder with <span class="menu">Manage Bookmarks...</span>.</p>
<p>WebPositive's bookmarks are managed as files and folders in <tt>~/config/settings/WebPositive/Bookmarks/</tt>. Adding a bookmark will create a new file there. Alternatively, you can drag and drop the site's 'favicon' in front of the URL to any open Tracker window or the Desktop, or even into the Bookmark bar (activated with <span class="menu">View | Show bookmark bar</span>).<br />
You quickly open the <tt>Bookmarks</tt> folder with <span class="menu">Manage Bookmarks…</span></p>
<img src="../images/apps-images/webpositive-bookmarks.png" alt="webpositive-bookmarks" />
<p>You can change a bookmark's URL, name, title and enter keywords just like with any other file with attributes. Just make sure you have all their columns displayed via Tracker's <span class="menu">Attributes</span> menu, then select a file, press <span class="key">ALT</span> <span class="key">E</span> and start editing the attribute; change attribute columns with <span class="key">TAB</span>.<br />You can sort bookmarks into different folders you create yourself.</p>
<p>By using Tracker to manage and navigate bookmarks you can lift its unique features to quickly find what you're looking for.<br />
Activating <span class="menu">Type-ahead filtering</span> in <a href="../tracker.html#tracker-preferences">Tracker's preferences</a>, you can instantly trim down your list of bookmarks to matches of your filter-string. A few more <span class="key">↑</span> or <span class="key">↓</span> to move the selection and pressing <span class="key">ENTER</span> opens the site. Make sure to display all attribute columns to have the filter applied to name, title, URL and keywords.</p>
<p>For this to work, all bookmarks should be kept in the <tt>~/config/settings/WebPositive/Bookmarks/</tt> folder and only copies should be sorted into custom subfolders for usage in WebPositive's <span class="menu">Bookmarks</span> menu (if at all). Also, actually filling the keywords attribute helps...</p>
<p>For this to work, all bookmarks should be kept in the <tt>~/config/settings/WebPositive/Bookmarks/</tt> folder and only copies should be sorted into custom subfolders for usage in WebPositive's <span class="menu">Bookmarks</span> menu (if at all). Also, actually filling the keywords attribute helps…</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Downloads</h2>
<p><span class="menu">Window | Downloads</span> opens a window listing all past and ongoing downloads:</p>
<img src="../images/apps-images/webpositive-downloads.png" alt="webpositive-downloads.png" />

8
userguide/ca/deskbar.html
View File

@ -86,12 +86,12 @@ You can also fold it into a more compact layout by drag &amp; dropping the knobb
<p>A menu opens when you click on the Deskbar's top:</p>
<img src="images/deskbar-images/deskbar.png" alt="deskbar.png" />
<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>About Haiku…</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 <a href="queries.html">Query</a> 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 <a href="gui.html#replicants">Replicant</a> widget you use to drag it around, remove or access its context menu.</p></li>
<li><p><b>Mount</b> - Offers the same options as when invoked by right-clicking the Desktop (see <a href="tracker.html#mounting-volumes">Mounting Volumes</a>).</p></li>
<li><p><b>Deskbar preferences...</b> - Opens a panel to configure the Deskbar (see below).</p></li>
<li><p><b>Deskbar preferences…</b> - Opens a panel to configure the Deskbar (see below).</p></li>
<li><p><b>Shutdown</b> - Offers options to either <span class="menu">Restart system</span> or <span class="menu">Power off</span>.</p></li>
<li><p><b>Recent documents, folders, applications</b> - List of the last recently opened documents, folders and applications (see <span class="menu">Deskbar preferences</span> below).</p></li>
<li><p><b>Applications, Demos, Deskbar applets, Preferences</b> - List of installed applications, demos, applets and preferences.<br />You can add links to other programs (or any folder, document, query etc.) by putting them into <span class="path">~/config/settings/deskbar/menu/</span>.</p></li>
@ -114,7 +114,7 @@ You can also fold it into a more compact layout by drag &amp; dropping the knobb
</table>
<h4>Menu</h4>
<p>While the first couple of menu items of the Deskbar are fixed, you can customized the ones below <span class="menu">Shutdown...</span>.<br />
<p>While the first couple of menu items of the Deskbar are fixed, you can customized the ones below <span class="menu">Shutdown…</span>.<br />
Here you can set the number of recent documents, folders and applications that are shown in their menu in the Deskbar, or if you want to see them at all.<br />
The button <span class="button">Edit in Tracker...</span> opens the folder <span class="path">~/config/settings/deskbar/menu/</span>. In it you'll find the files and folders that appear in the Deskbar, by default these are <span class="menu">Applications</span>, <span class="menu">Demos</span>, <span class="menu">Deskbar applets</span>, and <span class="menu">Preferences</span>.<br />
You can delete or add entries like links to applications, documents or even queries by simply copying/deleting them to/from this folder.</p>

2
userguide/ca/desktop-applets/launchbox.html
View File

@ -73,7 +73,7 @@
<tr><td><span class="menu">Add button here</span></td><td style="width:10px;"> </td><td>Adds an empty button.</td></tr>
<tr><td><span class="menu">Clear button</span></td><td> </td><td>Empties a button.</td></tr>
<tr><td><span class="menu">Remove button</span></td><td> </td><td>Removes a button.</td></tr>
<tr><td><span class="menu">Set description...</span></td><td> </td><td>Hovering the mouse over an icon shows a tooltip with the file's name and, in case of an application, its short description if it differs from its name (see topic <a href="../filetypes.html#settings-apps">FileTypes</a>). With this menu item you can customize the description for this tooltip.</td></tr>
<tr><td><span class="menu">Set description…</span></td><td> </td><td>Hovering the mouse over an icon shows a tooltip with the file's name and, in case of an application, its short description if it differs from its name (see topic <a href="../filetypes.html#settings-apps">FileTypes</a>). With this menu item you can customize the description for this tooltip.</td></tr>
<tr><td class="onelinetop"><span class="menu">Settings</span><br />
<span class="menu">- Horizontal layout</span><br />
<span class="menu">- Icon size</span><br />

2
userguide/ca/desktop-applets/networkstatus.html
View File

@ -73,7 +73,7 @@ Wherever installed, it's operated via a right-click context menu.</p>
<img src="../images/networkstatus-images/applet.png" alt="NetworkStatus applet" />
<p>The first section contains all network devices' names and their state. Clicking on such an entry brings up a window showing its IP, broadcast and netmask address.<br />
Below is a list of all wireless networks found by the first wireless adapter and an indicator of their signal strength. Have a look at the <a href="..\workshop-wlan.html">Workshop: Wireless networking</a> for more information on how to set up a connection.<br />
Lastly, you can <span class="menu">Open network preferences...</span> to change your <a href="../preferences/network.html">network configuration</a> or <span class="menu">Quit</span> the applet.</p>
Lastly, you can <span class="menu">Open network preferences…</span> to change your <a href="../preferences/network.html">network configuration</a> or <span class="menu">Quit</span> the applet.</p>
<h2>Status icons</h2>
<table summary="status icons" border="0" cellspacing="0" cellpadding="2">

4
userguide/ca/desktop-applets/powerstatus.html
View File

@ -78,8 +78,8 @@ Wherever installed, it's operated via a right-click context menu.</p>
<tr><td><span class="menu">Show text label</span></td><td style="width:10px"></td><td>Shows battery level in percent or remaining time.</td></tr>
<tr><td><span class="menu">Show status icon</span></td><td></td><td>Shows icon of the applet.</td></tr>
<tr><td class="onelinetop"><span class="menu">Show percent / time</span></td><td></td><td>Switch between showing battery level in percent or remaining time (<span class="menu">Show text label</span> has to be active).</td></tr>
<tr><td><span class="menu">Battery info...</span></td><td></td><td>Shows the extended battery info window.</td></tr>
<tr><td><span class="menu">About...</span></td><td></td><td>Shows the About window.</td></tr>
<tr><td><span class="menu">Battery info…</span></td><td></td><td>Shows the extended battery info window.</td></tr>
<tr><td><span class="menu">About…</span></td><td></td><td>Shows the About window.</td></tr>
<tr><td><span class="menu">Quit</span></td><td></td><td>Quits the PowerStatus applet.</td></tr>
</table>

2
userguide/ca/desktop-applets/processcontroller.html
View File

@ -82,7 +82,7 @@ To remove the applet again from the Deskbar, uncheck <span class="menu">Live in
<img src="../images/processcontroller-images/memory.png" alt="ProcessController - Memory usage" />
<p>Monitoring memory usage can be rather inaccurate.</p>
<p>This menu allows you to monitor memory usage of different teams in your system. Next to the team's name there are two columns: first with the amount reserved for writable memory, while the second shows all memory including read-only space (shared libraries for example).</p>
<p>The first row <i>System resources &amp; caches...</i> shows the total amount of memory used by the system and all applications. The length of the blue bar is based on the total physical memory in your computer. The next rows show memory used by each process. Note that the length of the bar is based only on the actually used part of the memory.</p>
<p>The first row <i>System resources &amp; caches…</i> shows the total amount of memory used by the system and all applications. The length of the blue bar is based on the total physical memory in your computer. The next rows show memory used by each process. Note that the length of the bar is based only on the actually used part of the memory.</p>
<table>
<tr><td style="width:20px;height:20px;background:#1414E7"></td><td style="width:10px"></td><td>Memory used only by given application (with write access)</td></tr>
<tr><td style="height:20px;background:#A4A4F5"></td><td></td><td>Memory including read-only space (can be shared with other applications)</td></tr>

2
userguide/ca/desktop-applets/workspaces.html
View File

@ -71,7 +71,7 @@
<p><br /></p>
<img src="../images/workspaces-images/workspaces.png" alt="workspaces.png" />
<p>You find the Workspaces applet with the other <span class="menu">Desktop applets</span> in the Deskbar. It shows a miniature version of all workspaces. There are several options available from the context menu of the applet's window, which are all pretty self-explaining.<br />
<span class="menu">Change workspace count...</span> will open the <a href="../preferences/screen.html">Screen</a> preferences where you set the number of workspaces and their arrangement (how many rows and columns).</p>
<span class="menu">Change workspace count…</span> will open the <a href="../preferences/screen.html">Screen</a> preferences where you set the number of workspaces and their arrangement (how many rows and columns).</p>
<p>Since the applet is a <a href="../gui.html#replicants">Replicant</a>, you can resize the window as desired and then drag &amp; drop it by its handle onto the desktop (make sure <span class="menu">Show replicants</span> is activated in the Deskbar menu). Hold <span class="key">SHIFT</span> while resizing to keep your screen's aspect ratio.</p>
<h2>

2
userguide/ca/filesystem-layout.html
View File

@ -148,7 +148,7 @@ Files that you'd like to share with other users in a future multi-user environme
<tr><td align="right"><span class="path">Go/</span></td><td></td><td>Put links to your favorite locations in here to make them available e.g. in open and save panels. See topic <a href="gui.html#favorites-recent">Haiku's GUI: Favorites and recent folders</a>.</td></tr>
<tr><td align="right"><span class="path">Tracker New Template/</span></td><td></td><td>Add a template for any filetype that's then available from Tracker's <span class="menu">File | New...</span> menu. See topic <a href="tracker.html#working-with-files">Tracker: Working with files</a>.</td></tr>
<tr><td align="right"><span class="path">Tracker New Template/</span></td><td></td><td>Add a template for any filetype that's then available from Tracker's <span class="menu">File | New…</span> menu. See topic <a href="tracker.html#working-with-files">Tracker: Working with files</a>.</td></tr>
</table>
</div>

4
userguide/ca/filetypes.html
View File

@ -87,7 +87,7 @@
<a id="preferred-app" name="preferred-app">Aplicació Preferida</a></h3>
<p>This pop-up 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 pop-up 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>
<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 pop-up 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 href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
@ -108,7 +108,7 @@
<tr><td><span class="menu">Només arguments</span></td><td> </td><td>Indicates the app doesn't respond to messages.</td></tr>
<tr><td><span class="menu">En segón pla</span></td><td> </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>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>
<h2>

2
userguide/ca/gui.html
View File

@ -147,7 +147,7 @@ You can enter parent folders with the pop-up menu above the file listing.</p>
<a id="favorites-recent" name="favorites-recent">Preferits i carpetes recents</a></h3>
<p>The <span class="menu">Favorites</span> menu in open and save panels 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" />
<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 | Edit favorites...</span> and delete its entry.<br />
<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 | Edit favorites…</span> and delete its entry.<br />
All Favorites are kept in <span class="path">/boot/home/config/settings/Tracker/Go/</span>. So you might as well add and remove links to files and folders there directly.</p>
<h2>

BIN
userguide/ca/images/tracker-images/get-info.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 16 KiB

After

Width:  |  Height:  |  Size: 62 KiB

2
userguide/ca/keyboard-shortcuts.html
View File

@ -137,7 +137,7 @@
<tr><td><span class="key">ALT</span> + left click</td><td style="width:15px;"></td><td>Left-clicking on a path or URL while holding <span class="key">ALT</span> opens it in the preferred application, e.g. folders in Tracker, pictures in ShowImage. You can limit the selected path by additionally holding <span class="key">SHIFT</span>.</td></tr>
<tr><td><span class="key">ALT</span> <span class="key">N</span></td><td></td><td>Opens another Terminal session in a new window.</td></tr>
<tr><td><span class="key">ALT</span> <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> <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> <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> <span class="key">TAB</span></td><td></td><td>Switches to the next Terminal window.</td></tr>
<tr><td><span class="key">SHIFT</span> <span class="key">←</span> / <span class="key">→</span></td><td></td><td>Switches to the tab to the left/right.</td></tr>
<tr><td><span class="key">ALT</span> <span class="key">SHIFT</span> <span class="key">←</span> / <span class="key">→</span></td><td></td><td>Moves the current tab left/right.</td></tr>

2
userguide/ca/preferences/appearance.html
View File

@ -98,7 +98,7 @@
<a id="decorators" name="decorators">Decoració de les finestres</a></h2>
<img src="../images/prefs-images/appearance-decorators.png" alt="appearance-decorators.png" />
<p>La decoració determina l'aspecte de les finestres i tots els elements de la interfície. Ara per ara Haiku vé amb només una decoració. Si trobeu i instal·leu altres decoracions, podeu triar-ne altres des del menú desplegable.</p>
<p>Haiku's default decorator lets you set the arrow style of the scroll bar: either single arrows at the end of scrollbars to conserve a bit of space, or double arrows — the traditional BeOS way — potentially saving some mouse moving when scrolling up and down or left and right...</p>
<p>Haiku's default decorator lets you set the arrow style of the scroll bar: either single arrows at the end of scrollbars to conserve a bit of space, or double arrows — the traditional BeOS way — potentially saving some mouse moving when scrolling up and down or left and right…</p>
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>

2
userguide/ca/preferences/datatranslations.html
View File

@ -73,7 +73,7 @@
<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>
<p><br /></p>
<img src="../images/prefs-images/datatranslations.png" alt="datatranslations.png" />
<p>Depending on its capabilities, each Translator offers different settings. At least you'll get an <span class="button">Info...</span> button that opens a window with the credits and the installation path.<br />
<p>Depending on its capabilities, each Translator offers different settings. At least you'll get an <span class="button">Info…</span> button that opens a window with the credits and the installation path.<br />
The following table gives an overview of the default Translators and their most useful options.</p>
<table summary="translators" border="0" cellpadding="2" cellspacing="0">
<tr><td><span class="menu">Apple icons</span></td><td>Valid image sizes are 16, 32, 48, 128, 256, 512, 1024 (RGB32 and RGBA32)</td></tr>

21
userguide/ca/preferences/e-mail.html
View File

@ -4,7 +4,7 @@
<head>
<!--
*
* Copyright 2008-2011, Haiku. All rights reserved.
* Copyright 2008-2023, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -94,8 +94,7 @@ You start by clicking the <span class="button">Add</span> button to create a new
<p>Now you enter your <i>E-mail address</i>, <i>Login name</i> and <i>Password</i>, give an <i>Account name</i> under which it will be known under Haiku and your <i>Real name</i>.</p>
<p>If your account is from a major e-mail provider, Haiku already knows all technical details like server IP addresses. If that is not the case, clicking <span class="button">Next</span> will open another window to enter this information by hand:</p>
<img src="../images/prefs-images/e-mail-new-account-2.png" alt="e-mail-new-account-2.png" />
<p>You first set the <i>Server name</i>, <i>Login type</i> and <i>Connection type</i> for the incoming mail, below that for the outgoing mail. You should find the necessary information on your email provider's website.<br />
See below for more info about the various settings and additional options.</p>
<div class="box-info">If you use GMail as your e-mail provider, you'll have to create a special app password.<br />See Google's support page on how to <a href="https://support.google.com/mail/answer/185833">Sign in with app passwords</a>.</div>
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
@ -111,7 +110,7 @@ See below for more info about the various settings and additional options.</p>
<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" />
<p>First is the <span class="menu">Mail server</span> address for incoming mails. If your provider needs you to log into a specific port, you add that to the address, separated by a colon. For example, <tt>pop.your-provider.org:1400</tt>.</p>
<p>Then you enter your login information, <i>Login name</i> and <i>Password</i>, and if necessary change the <i>Login type</i> from the default <span class="menu">Plain text</span> to <span class="menu">APOP</span> for authentication.</p>
<p>Then you enter your login information, <i>Username</i> and <i>Password</i>, and if necessary change <i>Connection type</i> from <span class="menu">No encryption</span> to <span class="menu">SSL</span> and the <i>Login type</i> from the default <span class="menu">Plain text</span> to <span class="menu">APOP</span> for authentication.</p>
<p>If you use <i>POP3</i> and retrieve mails of this account from different computers, you may want to activate the option to <span class="menu">Leave mail on server</span> and only <span class="menu">Remove mail from server when deleted</span> locally.</p>
<p>If you use <i>IMAP</i> instead, you have the option to <span class="menu">Remove mail from server when deleted</span> locally. You can specify <span class="menu">IMAP folders</span> to only synchronize with a specific folder and its subfolders.</p>
<p>Also, you can opt to only <span class="menu">Partially download messages larger than</span> 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>
@ -123,7 +122,7 @@ See below for more info about the various settings and additional options.</p>
<a id="outgoing" name="outgoing">Més preferències del correu sortint</a></h2>
<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" />
<p>First 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>First 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> and change <i>Username</i>, <i>Password</i> and <i>Connection type</i>.</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>
<p>As with incoming mail, you can also change the <i>Destination</i> of your outbox (default: <span class="path">/boot/home/mail/out/</span>).</p>
@ -210,15 +209,13 @@ Filtres de correu sortint</h3>
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="settings" name="settings">Preferències del compte de correu</a></h2>
<p>Now that your incoming and outgoing mail servers (and maybe some filters, too), are configured, you have to tell the Mail Service that does all the actual checking and fetching how to do its job.</p>
<p>Now that your incoming and outgoing mail servers (and maybe some filters, too), are configured, the Mail Service that does all the actual checking and fetching needs to know how to do its job.</p>
<img src="../images/prefs-images/e-mail-settings.png" alt="e-mail-settings.png" />
<p>Under <i>Mail checking</i> you configure the interval at which the account's mail server is probed for new mail.<br />
If you're on a dial-up connection, you may want to do that <span class="menu">Only when dial-up is connected</span> and also <span class="menu">Schedule outgoing mail when dial-up is disconnected</span> to avoid dialing automatically in regularly only to check for mail.</p>
<p>The Mail Service has a status window which you can set to show up <span class="menu">Never</span>, <span class="menu">While sending</span>, <span class="menu">While sending and receiving</span> or <span class="menu">Always</span>.</p>
<p>Make sure to <span class="menu">Start mail services on startup</span> or there will be no mail_daemon running to do your bidding...</p>
<p>After ticking the checkmark, you can configure the interval at which the account's mail server is probed for new mail.</p>
<p>The Mail Service can trigger notifications that can be set to show up <span class="menu">Never</span>, <span class="menu">While sending</span> or <span class="menu">While sending and receiving</span>.</p>
<p><span class="menu">Edit mailbox menu…</span> will open the folder <span class="path">/boot/home/config/Mail/Menu Links/</span>. All folders or queries (!) or their links put into this folder will appear in the context menu of the mailbox icon of the Mail Services in the Deskbar tray.</p>
<p>From that context menu, you can also <span class="menu">Create new message…</span>, <span class="menu">Check for mail now</span> or edit <span class="menu">Settings…</span>:</p>
<img src="../images/prefs-images/e-mail-mailbox.png" alt="e-mail-mailbox.png" />
<p><span class="menu">Edit mailbox menu...</span> will open the folder <span class="path">/boot/home/config/Mail/Menu Links/</span>. All folders or queries (!) or their links put into this folder will appear in the context menu of the mailbox icon of the Mail Services in the Deskbar tray.</p>
<p>From that menu, you can also <span class="menu">Create new message...</span>, <span class="menu">Check for mail now</span> or edit <span class="menu">Preferences...</span>.</p>
<p>If you hold down <span class="key">SHIFT</span> when invoking the context menu, you'll get additional commands:</p>
<table summary="notofications" border="0" cellpadding="2" cellspacing="0">
<tr><td><span class="menu">Comprova només el correu de</span></td><td style="width:5px;"> </td>

2
userguide/ca/preferences/input.html
View File

@ -96,7 +96,7 @@
<img src="../images/prefs-images/mouse.png" alt="mouse.png" />
<p>First you set your type of mouse: 1, 2 or 3 button mouse. You can simulate the 2nd (=right) mouse button by holding down <span class="key">CTRL</span> while left-clicking. For the 3rd (=middle) mouse button, it's <span class="key">CTRL</span> <span class="key">ALT</span> and a left-click.</p>
<p>You can rearrange the mouse buttons by clicking on them and choosing their new meaning from the pop-up menu.</p>
<p>With the sliders to the right, you adjust double-click speed, mouse speed and acceleration. The test area below the mouse graphics can be used to check if the double-click speed meets your taste: if double-clicking a word doesn't select it, it's set too fast (or you'll have to get used to clicking quicker...).</p>
<p>With the sliders to the right, you adjust double-click speed, mouse speed and acceleration. The test area below the mouse graphics can be used to check if the double-click speed meets your taste: if double-clicking a word doesn't select it, it's set too fast (or you'll have to get used to clicking quicker…).</p>
<p>There are three <span class="menu">Focus modes</span> that determine how windows react to clicks:</p>
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
<tr><td class="onelinetop"><span class="menu">Click to focus and raise</span></td><td width="15px"> </td><td>This is the default setting: you click a window and it gets focus and is raised to the top.</td></tr>

12
userguide/ca/preferences/keymap.html
View File

@ -71,24 +71,24 @@
<p><br /></p>
<img src="../images/prefs-images/keymap.png" alt="keymap.png" />
<p>To the right, the Keymap window shows a representation of your keyboard. When you press a key, the corresponding key is darkened and the assigned symbol is entered into the <i>Sample and Clipboard</i> text field at the bottom. From there you can also copy and paste it into a document.<br />
Thus, the Keymap preferences are not only for configuring your local keymap, but are also useful when looking for a special symbol used in other languages. For example, you can switch the keymap to "French", find the "ç" and copy it into your mail to François. (Though you'll find the "cedil" also in other keymaps...)</p>
Thus, the Keymap preferences are not only for configuring your local keymap, but are also useful when looking for a special symbol used in other languages. For example, you can switch the keymap to "French", find the "ç" and copy it into your mail to François. (Though you'll find the "cedil" also in other keymaps…)</p>
<p>Pressing modifier keys like <span class="key">SHIFT</span>, <span class="key">CONTROL</span> or <span class="key">OPTION</span> changes the displayed keyboard accordingly.</p>
<p>Then there are the keys that are marked with a blue background. These keys are called <i>Dead Keys</i> that can change the key you press after that. If you click on such a blue key with your mouse, those changeable keys light up yellow. Click again and everything's back to normal. Examples are é, ñ, ó or ë.</p>
<p>Below the keyboard representation are two more options:</p>
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
<tr><td><span class="menu">Select dead keys</span></td><td> </td><td>for setting the above mentioned blue keys.</td></tr>
<tr><td class="onelinetop"><span class="menu">Switch shortcut key...</span></td><td> </td><td>for using the shortcut key in Windows/Linux mode, i.e. <span class="key">CONTROL</span> (normally <span class="key">CTRL</span>) or Haiku mode, i.e. <span class="key">COMMAND</span> (normally <span class="key">ALT</span>).</td></tr>
<tr><td class="onelinetop"><span class="menu">Switch shortcut key…</span></td><td> </td><td>for using the shortcut key in Windows/Linux mode, i.e. <span class="key">CONTROL</span> (normally <span class="key">CTRL</span>) or Haiku mode, i.e. <span class="key">COMMAND</span> (normally <span class="key">ALT</span>).</td></tr>
</table>
<p>The lists on the left offer the available pre-configured keymaps of the system, and below that, if available, user-defined maps. You can change a keymap in the keyboard representation: drag &amp; drop one key on another and they switch places.</p>
<p>You can also create an individual mapping by drag &amp; dropping a character from another app onto the key. For example, you could extend your regular keymap with often used currency symbols. Just click on the <span class="key">CONTROL</span> key and drag &amp; drop the pound symbol from CharacterMap onto the 'P' key to get a ₤ when you press <span class="key">CTRL</span> <span class="key">P</span>.
<br />
By right-clicking a normal key, the context menu offers to <span class="menu">Remove</span> its mapping. Modifier keys can have alternative mappings, like using <span class="key">CAPS LOCK</span> as <span class="key">CTRL</span> key:</p>
<img src="../images/prefs-images/keymap-context.png" alt="keymap-context.png" />
<p>Alternatively to this or drag &amp; dropping of keys, there's the menu <span class="menu">File | Set modifier keys...</span> that opens this window:</p>
<p>Alternatively to this or drag &amp; dropping of keys, there's the menu <span class="menu">File | Set modifier keys…</span> that opens this window:</p>
<img src="../images/prefs-images/keymap-modifiers.png" alt="keymap-modifiers.png" />
<p>Here, you can assign keys to their respective roles or even completely disable the role of a key. You can even assign the same key to different roles, though that's not a good idea most of the time and you'll be warned by a small exclamation mark beside the pop-up menus if you do that.<br />
Pressing <span class="button">Set modifier keys</span> applies your changes and closes the window.</p>
<p>When you're done you can save the result from the menu <span class="menu">File | Save...</span>. Your modified map will only appear in the user-defined list if it's stored in <span class="path">~/config/settings/Keymap/</span>. Otherwise you'll have to manually load it via <span class="menu">File | Open...</span>.</p>
<p>When you're done you can save the result from the menu <span class="menu">File | Save…</span>. Your modified map will only appear in the user-defined list if it's stored in <span class="path">~/config/settings/Keymap/</span>. Otherwise you'll have to manually load it via <span class="menu">File | Open…</span></p>
<p>To better match the Keymap panel to your physical keyboard, there are several different settings available from the <span class="menu">Layout</span> menu.</p>
<p>The font used in the keyboard representation is set from the <span class="menu">Font</span> menu. Note, that it may or may not contain all symbols for a specific keymap.</p>
<p>Finally, there's a <span class="button">Revert</span> button to bring back the settings that were active when you started the Keymap preferences.</p>
@ -100,13 +100,13 @@ Pressing <span class="button">Set modifier keys</span> applies your changes and
<p>There's another method to customize your keymap besides the Keymap preference panel. It involves editing a text file containing loads of hex values, which may appear daunting on first sight, but isn't really that impossible to grasp.</p>
<p>You can dump the current keymap with a command in Terminal:</p>
<pre class="terminal">keymap -d &gt; MyKeymap</pre>
<p>The generated text file can then be opened in a text editor. Make sure to use a fixed font in that editor or you'll never grok that file...<br />
<p>The generated text file can then be opened in a text editor. Make sure to use a fixed font in that editor or you'll never grok that file…<br />
At the beginning of that file, you'll find a legend of a stylized keyboard with the hex value corresponding to each key. Below that are the actual assignments of every value. You can do all the customizing that's also available from the Keymap preference panel, and then some. If you happen to have some special keys on your keyboard, you may be able to activate them. That is, use them as ordinary keys or like an option or control key. You won't be able to, for example, have your multimedia keys de/increase the volume or start some application. For this you can use the <a href="shortcuts.html">Shortcuts</a> preferences.</p>
<p>When you're finished, you'll save the file and have your system load the modified keymap with this command:</p>
<pre class="terminal">keymap -s &lt; MyKeymap</pre>
<p>If you'd like to import this keymap into the Keymap panel, you have to compile it first to a binary format:</p>
<pre class="terminal">keymap -c &lt; MyKeymap</pre>
<p>This will produce a file <span class="cli">keymap.out</span> which you can load into Keymap via its <span class="menu">Open...</span> menu. By the way, the keymap command is able to load this binary format as well: <span class="cli">keymap -l &lt; keymap.out</span></p>
<p>This will produce a file <span class="cli">keymap.out</span> which you can load into Keymap via its <span class="menu">Open…</span> menu. By the way, the keymap command is able to load this binary format as well: <span class="cli">keymap -l &lt; keymap.out</span></p>
<p>This is the dumped file (the rightmost keys of the stylized keyboard are cut-off for a nicer display on this page):</p>
<pre>#!/bin/keymap -s

2
userguide/ca/preferences/media.html
View File

@ -141,7 +141,7 @@ Use the checkmark to <span class="menu">Mute</span> a stream.</p>
<tr><td><span class="menu">Input</span></td><td> </td><td>sets the input levels for line-in and microphone.</td></tr>
</table>
<p>It has to be said that these hardware level settings can appear a bit haphazard...<br />
<p>It has to be said that these hardware level settings can appear a bit haphazard…<br />
Haiku probes the hardware and tries to make sense of what it gets back. You may see various duplicate sliders with the same label etc. You'll have to experiment a bit to find the one you're looking for.</p>
<h2>

2
userguide/ca/preferences/network.html
View File

@ -103,7 +103,7 @@ Once a WLAN is selected, Haiku will try to connect to it automatically on every
<h2>Settings files</h2>
<p>The network settings are found in the folder <span class="path">/system/settings/network/</span>. Normally you don't have to care about those, other than maybe having to delete them to begin with a clean slate after things have gone terribly wrong...</p>
<p>The network settings are found in the folder <span class="path">/system/settings/network/</span>. Normally you don't have to care about those, other than maybe having to delete them to begin with a clean slate after things have gone terribly wrong…</p>
<p>One file however can be really useful, especially when working from the Terminal. The <tt>hosts</tt> file lets you define aliases to specific IP addresses in the network. For example:</p>
<pre>127.0.0.1 localhost #loopback
192.168.178.3 NAS #Synology

2
userguide/ca/preferences/sounds.html
View File

@ -72,7 +72,7 @@
<p>You can assign sounds to certain events in the system. Just select the event from the list and choose a sound from the pop-up menu below.</p>
<table summary="quickinfo" border="0" cellspacing="0" cellpadding="2">
<tr><td><span class="menu">None</span></td><td> </td><td>will silence an event.</td></tr>
<tr><td><span class="menu">Other...</span></td><td> </td><td>will open a file panel to find a new sound that isn't yet in the menu.</td></tr></table>
<tr><td><span class="menu">Other…</span></td><td> </td><td>will open a file panel to find a new sound that isn't yet in the menu.</td></tr></table>
<p>You can use any format that's supported by the system. If <a href="../applications/mediaplayer.html">MediaPlayer</a> can deal with it, so can any other program.<br />
You can "pre-hear" an event's sound by selecting it and using the <span class="button">Play</span> and <span class="button">Stop</span> buttons.</p>

2
userguide/ca/preferences/virtualmemory.html
View File

@ -72,7 +72,7 @@
<p>Virtual memory lets the system swap out memory to the harddisk, if the RAM can be used more sensibly for other things. So, even if you have lots of RAM, providing virtual memory is never a bad idea.</p>
<img src="../images/prefs-images/virtualmemory.png" alt="virtualmemory.png" />
<p>Normally, the swap file is written to the boot partition. If you're running low on free memory there, you can deactivate the <span class="menu">Automatic swap management</span> and choose another mounted partition from the popup menu. The swap file size is set with the slider below.<br />
If you often run into disk thrashing due to the virtual memory system swapping memory in and out, you can try to use a separate harddisk for you swap file to avoid I/O congestion. Simply another partition on the same harddisk with your system/data won't help. Upgrading your RAM is of course the most effective way to go...</p>
If you often run into disk thrashing due to the virtual memory system swapping memory in and out, you can try to use a separate harddisk for you swap file to avoid I/O congestion. Simply another partition on the same harddisk with your system/data won't help. Upgrading your RAM is of course the most effective way to go…</p>
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
<tr><td><span class="button">Opcions per Omissió</span></td><td> </td><td>Reinicia tot als valors per omissió.</td></tr>
<tr><td><span class="button">Desfés</span></td><td> </td><td>brings back the settings that were active when you started the VirtualMemory preferences.</td></tr>

2
userguide/ca/queries.html
View File

@ -82,7 +82,7 @@ Even better, you don't have to double-click to re-do a query. You can <a href="t
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="find-window" name="find-window">The Find window</a></h2>
<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> <span class="key">F</span>. You're presented with the Find window:</p>
<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> <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" />
<ol>
<li><p>Select recent or saved queries or save the current search parameters as <a href="#query-template">Query Template</a>.</p></li>

14
userguide/ca/tracker.html
View File

@ -138,13 +138,13 @@ This type-ahead filtering is set in the <a href="#tracker-preferences.html">Trac
<p>The <span class="menu">Window</span> menu offers a number of other functions:</p>
<ul>
<li><p><span class="menu">Resize to fit</span> (<span class="key">ALT</span> <span class="key">Y</span>) - Resizes the window to its ideal size.</p></li>
<li><p><span class="menu">Arrange by...</span> - Only available in Icon or Mini icon view, a submenu allows to set the sorting order to various properties:</p>
<li><p><span class="menu">Arrange by…</span> - Only available in Icon or Mini icon view, a submenu allows to set the sorting order to various properties:</p>
<ul>
<li><p><span class="menu">Name</span>, <span class="menu">Real name</span>, <span class="menu">Size</span>, <span class="menu">Modified</span>, <span class="menu">Created</span>, <span class="menu">Kind</span>, <span class="menu">Location</span>, <span class="menu">Permissions</span></p></li>
<li><p><span class="menu">Reverse order</span> - Inverts the sorting order</p></li>
<li _translation_id="4339"><p><span class="menu">Clean up</span> (<span class="key">ALT</span> <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 according to the above selected criterium.</p></li>
</ul></li>
<li><p><span class="menu">Select...</span> (<span class="key">SHIFT</span> <span class="key">ALT</span> <span class="key">A</span>) - Select files according to a <a href="http://en.wikipedia.org/wiki/Regular_expression" class="external free" title="Wikipedia: Regular expression">regular expression</a>.</p></li>
<li><p><span class="menu">Select…</span> (<span class="key">SHIFT</span> <span class="key">ALT</span> <span class="key">A</span>) - Select files according to a <a href="http://en.wikipedia.org/wiki/Regular_expression" class="external free" title="Wikipedia: Regular expression">regular expression</a>.</p></li>
<li><p><span class="menu">Close</span> (<span class="key">ALT</span> <span class="key">W</span>) - Closes the window. Hold down <span class="key">SHIFT</span> and the menu becomes <span class="menu">Close all</span> which closes every Tracker window.</p></li>
<li><p><span class="menu">Close all in workspace</span> (<span class="key">ALT</span> <span class="key">Q</span>) - Closes every Tracker window in the current workspace. A useful shortcut if you forgot to hold the <span class="key">OPT</span> key while clicking through folders and all those still open Tracker windows clutter your workspace.</p></li>
</ul>
@ -157,7 +157,7 @@ This type-ahead filtering is set in the <a href="#tracker-preferences.html">Trac
<h3>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="tracker-preferences" name="tracker-preferences">Tracker preferences</a></h3>
<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.
<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>
<li><p><span class="menu">Desktop</span> - Decide if all mounted disks appear directly on the Desktop or in a window after clicking a single Disk icon sitting on the Desktop.</p></li>
@ -179,16 +179,16 @@ This type-ahead filtering is set in the <a href="#tracker-preferences.html">Trac
<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><span class="menu">Find...</span> - Find a file or folder. See topic <a href="queries.html">Query</a> for more info.</p></li>
<li><p><span class="menu">Find…</span> - Find a file or folder. See topic <a href="queries.html">Query</a> for more info.</p></li>
<li><p><span class="menu">New</span> - Create a new folder or any other file based on a <i>template</i>.
</p>
<img src="images/tracker-images/new-menu.png" alt="new-menu.png" />
<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><span class="menu">Open with...</span> - A submenu offers all applications that can handle this filetype.
<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><span class="menu">Open with…</span> - A submenu offers all applications that can handle this filetype.
</p>
<img src="images/tracker-images/open-with.png" alt="open-with.png" />
<p>The preferred application that would open the file when double-clicked, is checkmarked. This submenu lists first those applications that can handle the exact filetype, in this case it's a text file, the type <tt>text/plain</tt>. Next come all applications that can handle that supertype in general, here <tt>text/*</tt>. Last in the list are those that can deal with any file. If you don't click on an app in the submenu, but on the <span class="menu">Open with...</span> entry instead, a panel opens:</p>
<p>The preferred application that would open the file when double-clicked, is checkmarked. This submenu lists first those applications that can handle the exact filetype, in this case it's a text file, the type <tt>text/plain</tt>. Next come all applications that can handle that supertype in general, here <tt>text/*</tt>. Last in the list are those that can deal with any file. If you don't click on an app in the submenu, but on the <span class="menu">Open with…</span> entry instead, a panel opens:</p>
<img src="images/tracker-images/open-with-preferred.png" alt="open-with-preferred" />
<p>Here you'll again find the programs that were listed in the submenu. By selecting one and clicking the <span class="button">Open and make preferred</span> button, you changed the preferred application for every file of that filetype, here <tt>text/plain</tt>.</p></li>

8
userguide/ca/workshop-email.html
View File

@ -103,18 +103,18 @@ Also, improvements in any of these system areas benefit not just emailing, but a
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="status" name="status">Com fer servir els estats a mida</a></h2>
<p>When you browse through your newly arrived email, you may want to come back to some of them later to think about it in more depth. While you could use Mail's menu <span class="menu">Close and | Leave as New</span> to keep them in your "<i>New messages</i>" query, things tend to pile up that way...</p>
<p>When you browse through your newly arrived email, you may want to come back to some of them later to think about it in more depth. While you could use Mail's menu <span class="menu">Close and | Leave as New</span> to keep them in your "<i>New messages</i>" query, things tend to pile up that way…</p>
<p>One solution is of course to just start a reply and save it as draft. But if you don't expect to write a reply and just want to re-read the mail later, that isn't ideal.</p>
<img src="images/workshop-email-images/status.png" alt="status.png" />
<p>Better use <span class="menu">Close and | Set to...</span> to create a new status and use that to categorize your mail. For example, you could call the status "<i>Later</i>", and then query for that when you find more time.<br />
<p>Better use <span class="menu">Close and | Set to…</span> to create a new status and use that to categorize your mail. For example, you could call the status "<i>Later</i>", and then query for that when you find more time.<br />
Or you use different statuses for specific projects. For example, I created a status "<i>HUG</i>" (for "Haiku user guide") under which I collect every mail that may influence the contents of the user guide, like commit messages about code changes that alter or introduce some feature or anything else I feel could improve the user guide.<br />
In any case, try to keep the status name short. That way it always fits in a normally wide "Status" column in Tracker.</p>
<p>You don't have to open an email with the <span class="app">Mail</span> application to set its status. With the Tracker add-ons <span class="app">Mark as Read </span> and <span class="app">Mark as...</span> you can select some email files and set their status in one go.</p>
<p>You don't have to open an email with the <span class="app">Mail</span> application to set its status. With the Tracker add-ons <span class="app">Mark as Read </span> and <span class="app">Mark as…</span> you can select some email files and set their status in one go.</p>
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="queries" name="queries">Com fer servir les consultes</a></h2>
<p>Sure, you specify a folder to store all your email, you can open it et voilà, there's all you mail. But over time the folder becomes crowded and showing all will take longer and longer as thousands of files and their attributes have to be parsed and sorted. Also, most of the time you don't really care about two year old emails of Nigerian princes and their inheritory trouble ...</p>
<p>Sure, you specify a folder to store all your email, you can open it et voilà, there's all you mail. But over time the folder becomes crowded and showing all will take longer and longer as thousands of files and their attributes have to be parsed and sorted. Also, most of the time you don't really care about two year old emails of Nigerian princes and their inheritory trouble…</p>
<div class="box-info">A lot of time when populating a folder is spent on putting files read from disk into the correct sorting order and displaying that in the window. If you do have to open a folder with a huge number of files, you can shorten the wait by making the Tracker window "invisible", i.e. either minimize it or change to another workspace. Watch <a href="desktop-applets/processcontroller.html">ProcessController</a> to see how it affects CPU usage.</div>
<p><a href="queries.html">Queries</a>, to the rescue!</p>
<p>By using queries, you can narrow down the view of your mails. Actually, the mailbox icon in the Deskbar uses queries.</p>

10
userguide/ca/workshop-filetypes+attributes.html
View File

@ -99,13 +99,13 @@ In any case, to these files we add a couple of attributes. Here we have to decid
<li>Plot</li>
<li>La meva valoració de 1 a 10</li>
<li>Coordinates in my shelf, e.g. A2, B3, so I find the DVD also in Real Life :)</li>
<li>If so, who's borrowed the disk...</li>
<li>If so, who's borrowed the disk…</li>
</ul>
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="custom-filetype" name="custom-filetype">Generar un nou tipus de fitxer</a></h2>
<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>
<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" />
<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" />
@ -140,7 +140,7 @@ In any case, to these files we add a couple of attributes. Here we have to decid
<h3>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="extra_attribute" name="extra_attribute">Altres Atributs</a></h3>
<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 to enter all the data for the new attribute. You can edit an existing attribute with a double-click.</p>
<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 to enter all the data for the new attribute. You can edit an existing attribute with a double-click.</p>
<img src="images/workshop-filetypes+attributes-images/filetype-extra-attribute.png" alt="filetype-extra-attribute.png" />
<ul>
<li><p><i>Attribute name</i> - Appears e.g. as the column heading in Tracker windows.</p></li>
@ -221,12 +221,12 @@ Since our basic file is a cover image, we go to some online resource like IMdB,
<img src="images/workshop-filetypes+attributes-images/filetypes-dvddb-empty.png" alt="filetypes-dvddb-empty.png" />
<p>By clicking on a yet empty attribute (or pressing <span class="key">ALT</span> <span class="key">E</span>) we enter editing mode and fill each attribute. With <span class="key">TAB</span> and <span class="key">SHIFT</span> <span class="key">TAB</span> you can navigate between attributes.</p>
<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>
<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 href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="query-db" name="query-db">Consultar la base de dades</a></h2>
<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>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 layout</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; in our case "application_DVDdb".</p>

2
userguide/ca/workshop-wlan.html
View File

@ -102,7 +102,7 @@ ArcorInternet123 00:20:12:a4:29:e1 15 WPA</pre>
The output shows the public name (SSID), MAC address, signal strength and authentication method of all found networks.</p>
<p>To join a network, use this line and insert the respective public name (SSID) and password:</p>
<pre class="terminal">ifconfig /dev/net/iprowifi3945/0 join {SSID} {password}</pre>
<p>Make sure the initial configuration of the wireless network adapter after booting up has finished, before issuing <tt>ifconfig</tt> commands or they might be ignored. Depending on your hardware and network configuration that may take a while. Watch those notifications...</p>
<p>Make sure the initial configuration of the wireless network adapter after booting up has finished, before issuing <tt>ifconfig</tt> commands or they might be ignored. Depending on your hardware and network configuration that may take a while. Watch those notifications…</p>
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>

2
userguide/de/applications/activitymonitor.html
View File

@ -71,7 +71,7 @@
<tr><td>Einstellungen:</td><td></td><td><span class="path">~/config/settings/ActivityMonitor settings</span></td></tr>
</table>
<p><br /></p>
<p>Um die Systemressourcen im Auge zu behalten, kann der ActivityMonitor gestartet werden. Dort lassen sich verschiedene Einträge auswählen, die von Interesse sind.</p>
<p>Um die Systemressourcen im Auge zu behalten, kann der ActivityMonitor gestartet werden. Dort lassen sich verschiedene Messgrößen auswählen.</p>
<img src="../images/apps-images/activitymonitor.png" alt="activitymonitor.png" />
<p>Durch einen Rechtsklick ins Fenster kann die Anzeige verschiedener Ressourcen ein- und ausgeschaltet werden:<br />
<span class="menu">Benutzter/Gecachter Speicher</span>, <span class="menu">Auslagerungsspeicher</span>, <span class="menu">CPU-Takt/Auslastung</span>, <span class="menu">Netzwerk empfangen/senden</span> und noch technischerer Ressourcen unter <span class="menu">Zusätzliche Elemente</span>.</p>

12
userguide/de/applications/list-cli-apps.html
View File

@ -64,6 +64,7 @@
<div id="content">
<div>
<div class="box-info">Solange die Übersetzung dieser Seite noch nicht ganz fertig ist, erscheint für die noch fehlenden Teile die englische Version.</div>
<h2><img src="../../images/apps-images/cli-app-icon_64.png" alt="cli-app-icon_64.png" width="64" height="64" />Liste aller Konsolenprogramme</h2>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
@ -79,7 +80,7 @@ Nachfolgend eine Liste aller in Haiku enthaltenen Konsolenprogramme mit einer ku
<tr><td><tt>CortexAddOnHost</tt></td><td style="width:10px;"> </td><td>Startet einen Dienst zum Überwachen von gerade benutzten Audio- und Video-Add-ons.</td></tr>
<tr><td><tt>FirstBootPrompt</tt></td><td> </td><td>Einstellungen zu Sprache und Tastaturlayout.</td></tr>
<tr><td><tt>[</tt></td><td> </td><td>Vergleicht Werte und Dateien.</td></tr>
<tr><td colspan="3"><a id="A" name="A"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>A</h2></a></td></tr>
<tr><td colspan="3"><a id="A" name="A"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>A - E</h2></a></td></tr>
<tr><td><tt>addattr</tt></td><td> </td><td>Hängt ein Attribut an eine Datei, achtet dabei auf den Typ und konvertiert Werte entsprechend. <a href="cli-apps.html">(Haiku spezifisch)</a></td></tr>
<tr><td><tt>alert</tt></td><td> </td><td>Zeigt ein Mitteilungfenster. <a href="cli-apps.html">(Haiku spezifisch)</a></td></tr>
<tr><td><tt>arp</tt></td><td> </td><td>Änderungen am ARP Cache. </td></tr>
@ -137,7 +138,7 @@ Nachfolgend eine Liste aller in Haiku enthaltenen Konsolenprogramme mit einer ku
<tr><td><tt>error</tt></td><td> </td><td>Zeigt die textliche Fehlermeldung für eine Fehlernummer.</td></tr>
<tr><td><tt>expand</tt></td><td> </td><td>Konvertiert Tabulatoren zu Leerzeichen.</td></tr>
<tr><td><tt>expr</tt></td><td> </td><td>Gibt den Wert eines Ausdrucks aus.</td></tr>
<tr><td colspan="3"><a id="F" name="F"><h2>F</h2></a></td></tr>
<tr><td colspan="3"><a id="F" name="F"><h2>F - J</h2></a></td></tr>
<tr><td><tt>factor</tt></td><td> </td><td>Gibt die Primzahlfaktoren ganzer Zahlen aus.</td></tr>
<tr><td><tt>false</tt></td><td> </td><td>Tut nichts, signalisiert "falsch" und gibt den Wert "1" zurück.</td></tr>
<tr><td><tt>fdinfo</tt></td><td> </td><td>Zeigt Informationen zu den vom System benutzten "File Descriptors" an.</td></tr>
@ -173,7 +174,7 @@ Nachfolgend eine Liste aller in Haiku enthaltenen Konsolenprogramme mit einer ku
<tr><td><tt>iroster</tt></td><td> </td><td>Zeigt alle Eingabegeräte.</td></tr>
<tr><td><tt>isvolume</tt></td><td> </td><td>Zeigt Informationen einer eingehängten Partition.</td></tr>
<tr><td><tt>join</tt></td><td> </td><td>Kombiniert jeweils ein Zeilenpaar mit identischen Join-Feldern zu einer Zeile und gibt sie aus.</td></tr>
<tr><td colspan="3"><a id="K" name="K"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>K</h2></a></td></tr>
<tr><td colspan="3"><a id="K" name="K"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>K - O</h2></a></td></tr>
<tr><td><tt>kernel_debugger</tt></td><td> </td><td>Wechselt in den Kernel Debugger.</td></tr>
<tr><td><tt>keymap</tt></td><td> </td><td>Lädt oder speichert eine Tastaturbelegungs-Datei.</td></tr>
<tr><td><tt>kill</tt></td><td> </td><td>Sendet ein Signal, um einen Prozess zu beenden.</td></tr>
@ -227,7 +228,7 @@ Nachfolgend eine Liste aller in Haiku enthaltenen Konsolenprogramme mit einer ku
<tr><td><tt>nproc</tt></td><td> </td><td>Gibt die Zahl der verfügbaren Recheneinheiten aus.</td></tr>
<tr><td><tt>od</tt></td><td> </td><td>Gibt eine eindeutige Darstellung einer Datei aus.</td></tr>
<tr><td><tt>open</tt></td><td> </td><td>Öffnet eine Anwendung oder ein Dokument von der Konsole aus. <a href="cli-apps.html">(Haiku spezifisch)</a></td></tr>
<tr><td colspan="3"><a id="P" name="P"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>P</h2></a></td></tr>
<tr><td colspan="3"><a id="P" name="P"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>P - S</h2></a></td></tr>
<tr><td><tt>package</tt></td><td> </td><td>Erzeugt, untersucht oder entpackt ein Haiku-Paket.</td></tr>
<tr><td><tt>package_repo</tt></td><td> </td><td>Erzeugt oder untersucht eine Haiku Repository-Datei.</td></tr>
<tr><td><tt>passwd</tt></td><td> </td><td>Ändert das Passwort des Benutzers.</td></tr>
@ -250,6 +251,7 @@ Nachfolgend eine Liste aller in Haiku enthaltenen Konsolenprogramme mit einer ku
<tr><td><tt>ramdisk</tt></td><td> </td><td>Erstellt eine Ramdisk. <a href="cli-apps.html">(Haiku spezifisch)</a></td></tr>
<tr><td><tt>rc</tt></td><td> </td><td>Ressource Kompiler.</td></tr>
<tr><td><tt>readlink</tt></td><td> </td><td>Gibt den Pfad zum Ziel einer symbolischen Verknüpfung aus.</td></tr>
<tr><td><tt>recover</tt></td><td> </td><td>Ein Tool um Dateien von beschädigten BFS-Partitionen zu retten (siehe dessen <a href="https://www.pinc-software.de/docs/BFS-tools.html#recover">Dokumentation</a> (Englisch)).</td></tr>
<tr><td><tt>reindex</tt></td><td> </td><td>Nimmt Attribute bestehender Dateien in einen neu angelegten index auf. <a href="cli-apps.html">(Haiku spezifisch)</a></td></tr>
<tr><td><tt>release</tt></td><td> </td><td>Gibt eine Semaphore frei.</td></tr>
<tr><td><tt>renice</tt></td><td> </td><td>Ändert die Priorität eines laufenden Prozesses.</td></tr>
@ -287,7 +289,7 @@ Nachfolgend eine Liste aller in Haiku enthaltenen Konsolenprogramme mit einer ku
<tr><td><tt>sum</tt></td><td> </td><td>Gibt Checksumme und Blockanzahl von Dateien aus.</td></tr>
<tr><td><tt>sync</tt></td><td> </td><td>Erzwingt das Schreiben geänderter Blöcke auf Speichermedien und aktualisiert den Superblock.</td></tr>
<tr><td><tt>sysinfo</tt></td><td> </td><td>Zeigt Informationen zum System.</td></tr>
<tr><td colspan="3"><a id="T" name="T"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>T</h2></a></td></tr>
<tr><td colspan="3"><a id="T" name="T"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>T - Z</h2></a></td></tr>
<tr><td><tt>tac</tt></td><td> </td><td>Hängt Dateien aneinander, beginnend mit der letzten Zeile, und gibt sie aus.</td></tr>
<tr><td><tt>tail</tt></td><td> </td><td>Gibt die letzten zehn Zeilen einer Datei aus.</td></tr>
<tr><td><tt>tcpdump</tt></td><td> </td><td>Zeigt den Datenverkehr im Netzwerk.</td></tr>

3
userguide/de/applications/webpositive.html
View File

@ -112,7 +112,8 @@ Eingaben, die nicht als URL erkannt werden, dienen als Suchbegriff für die in d
<li><p><span class="menu">Bearbeiten | Suchen</span> öffnet eine Suchleiste unten im Fenster, um Begriffe auf der aktuellen Seite zu suchen. Die Fundstellen werden farbig hinterlegt.</p></li>
</ul>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Lesezeichen</h2>
<p>WebPositives Lesezeichen werden als einzelne Dateien und Ordner in <span class="path">~/config/settings/WebPositive/Bookmarks/</span> verwaltet. Fügt man ein neues Lesezeichen hinzu, wird dort eine neue Datei erstellt. Dieser Ordner lässt sich bequem mit <span class="menu">Lesezeichen verwalten...</span> öffnen.</p>
<p>WebPositives Lesezeichen werden als einzelne Dateien und Ordner in <span class="path">~/config/settings/WebPositive/Bookmarks/</span> verwaltet. Fügt man ein neues Lesezeichen hinzu, wird dort eine neue Datei erstellt. Alternativ lässt sich auch das 'favicon' links der URL in ein offenes Tracker-Fenster oder auf den Desktop, und sogar in die Lesezeichenleiste ziehen (aktivierbar mittels <span class="menu">Ansicht | Lesezeichenleiste einblenden</span>).<br />
Der Bookmarks Ordner lässt sich bequem mit <span class="menu">Lesezeichen verwalten...</span> öffnen.</p>
<img src="../images/apps-images/webpositive-bookmarks.png" alt="webpositive-bookmarks" />
<p>Man kann URL, Name und Titel eines Lesezeichens ändern und Begriffe als "Keywords" eingeben, wie bei jeder Datei mit Attributen. Dazu müssen in Tracker-Menü<span class="menu">Attribute</span> nur all diese Spalten angezeigt werden. Dann markiert man eine Datei, drückt <span class="key">ALT</span> <span class="key">E</span> und editiert das Attribut. Spalten werden mittels <span class="key">TAB</span> gewechselt.<br />
Lesezeichen lassen sich in selbst angelegte Ordner einsortieren.</p>

2
userguide/de/bootloader.html
View File

@ -70,7 +70,7 @@
<p>Mit den "Haiku Boot Loader Optionen" kann man zum einen unterschiedliche Haiku-Installationen starten, zum anderen hardware-spezifische Probleme umgehen. Die Boot Loader Optionen sind auch nützlich, wenn etwas installiert wurde, dass das Booten von Haiku verhindert (siehe <a href="#troubleshooting">Fehlersuche</a> weiter unten).</p>
<p>Um zu den Boot Loader Optionen zu gelangen, muss man noch vor Beginn des Boot-Prozesses <span class="key">SHIFT</span> gedrückt halten. Ist ein Bootmanager installiert, kann man das bereits tun, bevor man dort den Haiku-Eintrag auswählt. Ist Haiku das einzige Betriebssystem auf dem Rechner, kann die Taste schon gehalten werden, während noch die Meldungen des BIOS zu sehen sind.</p>
<div class="box-info">Bei mancher Hardware muss im BIOS erst die Unterstützung von USB-Tastaturen aktiviert werden, um sie beim Hochfahren benutzen zu können. <br />
Wird per UEFI statt dem klassischen BIOS gebootet, muss anstelle von <span class="key">SHIFT</span> die <span class="key">LEERTASTE</span> gedrückt werden.</div>
Wird per UEFI statt dem klassischen BIOS gebootet, muss anstelle von <span class="key">SHIFT</span> die <span class="key">LEERTASTE</span> gehalten werden.</div>
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="options" name="options">Boot Loader Optionen</a></h2>

23
userguide/de/preferences/e-mail.html
View File

@ -4,7 +4,7 @@
<head>
<!--
*
* Copyright 2008-2011, Haiku. All rights reserved.
* Copyright 2008-2023, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -73,7 +73,7 @@
<a href="#incoming">Einstellungen für eingehende Mails</a><br />
<a href="#outgoing">Einstellungen für ausgehende Mails</a><br />
<a href="#filters">Einstellungen für E-Mail Filter</a><br />
<a href="#settings">Der Mail Service</a>
<a href="#settings">Der E-Mail Dienst</a>
</td></tr>
</table>
@ -96,8 +96,7 @@ Im Programmfenster der E-Mail-Eigenschaften als erstes unten auf <span class="bu
<p>Dann ist die verwendete <i>E-Mail-Adresse</i> einzugeben, sowie der <i>Login</i>-Name und das <i>Passwort</i> für das Mail-Konto. Der <i>Kontoname</i> bezeichnet das E-Mail-Konto in der Liste aller Konten, der <i>Benutzername</i> wird als Absender einer E-Mail angegeben.</p>
<p>Haiku kennt einige der großen E-Mail-Provider, so dass die notwendigen technischen Einstellungen wie IP-Adresse und Servername bereits automatisch ausgefüllt werden. Wenn das nicht möglich ist, oder die Daten angepasst werden müssen, kann man dazu nach Klicken auf <span class="button">Weiter</span> wie nachfolgend beschrieben vorgehen.</p>
<img src="../images/prefs-images/e-mail-new-account-2.png" alt="e-mail-new-account-2.png" />
<p>Zunächst werden <i>Servername</i>, <i>Anmeldemethode</i> und <i>Verbindungsart</i> für eingehende E-Mail, darunter für ausgehende E-Mail angegeben. Die dazu nötigen Informationen sollten sich auf der Webseite des E-Mail-Providers finden lassen.<br />
Mehr Informationen zu den verschiedenen Einstellungen und weiteren Optionen im Folgenden.</p>
<div class="box-info">Nutzt man GMail als E-mail Provider, muss ein sog. "App-Passwort" erzeugt werden.<br />Siehe dazu Google's Hilfsseite "<a href="https://support.google.com/accounts/answer/185833?hl=de">Mit App-Passwörtern anmelden</a>".</div>
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
@ -113,7 +112,7 @@ Mehr Informationen zu den verschiedenen Einstellungen und weiteren Optionen im F
<p>Mit einem Klick auf <span class="menu">Eingang</span> unter dem Kontonamen, lassen sich Einstellungen zum E-Mail Empfang vornehmen.</p>
<img src="../images/prefs-images/e-mail-in.png" alt="e-mail-in.png" />
<p>Der erste Eintrag ist die <span class="menu">Mail-Server</span>-Adresse für eingehende E-Mails. Falls ein Provider einen bestimmten Port beim Anmelden verlangt, wird dieser mit einem vorangestellten Doppelpunkt an die Adresse angehängt, wie zum Beispiel <tt>pop.dein-provider.org:1400</tt>.</p>
<p>Anschließend werden die benötigten Anmeldeinformationen eingetragen: <i>Benutzername</i> und <i>Passwort</i> - falls nötig muss die <i>Anmeldemethode</i> von der Standardeinstellung <span class="menu">Klartext</span> auf <span class="menu">APOP</span> für die Authentifizierung umgestellt werden.</p>
<p>Anschließend werden die benötigten Anmeldeinformationen eingetragen: <i>Benutzername</i> und <i>Passwort</i> - falls nötig muss die <i>Verbindungsart</i> von <span class="menu">Keine Verschlüsselung</span> zu <span class="menu">SSL</span>, und die <i>Anmeldemethode</i> von der Standardeinstellung <span class="menu">Klartext</span> auf <span class="menu">APOP</span> für die Authentifizierung umgestellt werden.</p>
<p>Bei Verwendung des <i>POP3</i>-Protokolls für eingehende E-Mails kann die Option <span class="menu">E-Mails auf dem Server belassen</span> eingeschaltet werden. So kann auch von einem anderen Computer aus auf die Mails zugegriffen werden. Mit <span class="menu">Gelöschte E-Mails auch vom Server löschen</span> werden die E-Mails erst dann auf dem Server gelöscht, wenn sie auch auf dem Rechner entfernt werden.</p>
<p>Sollte stattdessen <i>IMAP</i> als Übertragungsprotokoll verwendet werden, steht nur die Option <span class="menu">Gelöschte E-Mails auch vom Server löschen</span> zur Verfügung. Zusätzlich kann man noch <span class="menu">IMAP-Ordner</span> angeben, um nur von einem bestimmten Postfach und dessen Unterverzeichnissen die E-Mails zu synchronisieren.</p>
<p>Außerdem kann man durch Aktivieren der Option <span class="menu">Nur Kopfzeilen herunterladen bei E-Mails über ... KB</span> bestimmen, dass E-Mails lediglich teilweise (bis zu einer bestimten Größe) heruntergeladen werden. Dadurch werden von Mails, die größer als der eingestellte Wert sind, nur die Kopfzeilen heruntergeladen. So kann man erstmal die Betreffzeile und Absender prüfen, bevor man den Rest der Nachricht plus eventuelle Anhänge runterlädt. Die Einstellung ist vor allem bei langsamen Netzwerkverbindungen sinnvoll.</p>
@ -125,7 +124,7 @@ Mehr Informationen zu den verschiedenen Einstellungen und weiteren Optionen im F
<a id="outgoing" name="outgoing">Einstellungen für ausgehende E-Mails</a></h2>
<p>Unter <span class="menu">Ausgang</span> lassen sich für jedes Konto Einstellungen zum E-Mail-Versand vornehmen.</p>
<img src="../images/prefs-images/e-mail-out.png" alt="e-mail-out.png" />
<p>Als erstes ist die <i>SMTP-Server</i>-Adresse anzugeben. Wie beim Mail-Server für eingehende E-Mails beschrieben, kann hier wenn nötig ein spezieller Port angegeben werden: <tt>mail.dein-provider.org:1200</tt>.</p>
<p>Als erstes ist die <i>SMTP-Server</i>-Adresse anzugeben. Wie beim Mail-Server für eingehende E-Mails beschrieben, kann hier wenn nötig ein spezieller Port angegeben werden, z. B. <tt>mail.dein-provider.org:1200</tt>, und ggf. <i>Benutzername</i>, <i>Passwort</i> and <i>Verbindungsart</i>.</p>
<p>Falls man sich am SMTP-Server mit Benutzernamen und Passwort anmelden muss, muss man die <i>Anmeldemethode</i> auf <span class="menu">ESMTP</span> stellen. Die andere Möglichkeit <span class="menu">POP3 vor SMTP</span> ist für Provider, die festgelegt haben, dass man nur unmittelbar nach einem Post-Abholen auch Versenden kann.</p>
<p>Genauso wie bei eingehenden Mails kann der Speicherpfad für ausgehende E-Mails unter <i>Zielverzeichnis</i> vom Standard <span class="path">/boot/home/mail/out</span> in einen anderen geändert werden.</p>
@ -210,15 +209,13 @@ Dieser Filter hängt an den E-Mail-Text ein zufällig ausgesuchtes Zitat oder ei
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="settings" name="settings">Der E-Mail-Dienst</a></h2>
<p>Nach der Konfiguration der E-Mail-Konten und Filter muss der E-Mail-Dienst noch konfiguriert werden, wann er E-Mails abrufen und versenden soll.</p>
<p>Nach der Konfiguration der E-Mail-Konten und Filter kann der E-Mail-Dienst noch konfiguriert werden, wann E-Mails abgerufen und versandt werden sollen.</p>
<img src="../images/prefs-images/e-mail-settings.png" alt="e-mail-settings.png" />
<p>Unter <i>E-Mail abfragen</i> legt man fest, in welchen Zeitabständen der Mailserver kontaktiert werden soll.<br />
Wenn man seine Netzwerkverbindung über eine Wählverbindung aufbaut, ist es ratsam <span class="menu">Nur bei aktiver Einwahlverbindung</span> und <span class="menu">Versand aufschieben falls Einwahlverbindung nicht aktiv</span> auszuwählen. Dann werden E-Mails nur abgefragt oder versendet, wenn bereits eine Netzwerkverbindung besteht. Ausgehende E-Mails werden zurück gehalten, um keine unnötigen Einwahl-Entgelte zu verursachen.</p>
<p>Der E-Mail-Dienst kann entweder <span class="menu">Nie</span>, <span class="menu">Beim Senden</span>, <span class="menu">Beim Senden und Empfangen</span> oder <span class="menu">Immer</span> ein Statusfenster anzeigen.</p>
<p>Nur wenn der mail_daemon schon während dem Hochfahren gestartet wird (<span class="menu">Starte E-Mail-Dienst beim Systemstart</span>), werden E-Mails automatisch empfangen und versendet.</p>
<p>Nachdem man die Checkbox aktiviert hat, lässt sich festlegen in welchen Zeitabständen der Mailserver kontaktiert werden soll.</p>
<p>Der E-Mail-Dienst kann entweder <span class="menu">Nie</span>, <span class="menu">Beim Senden</span> oder <span class="menu">Beim Senden und Empfangen</span> eine Benachrichtigung anzeigen.</p>
<p><span class="menu">Mailbox-Menü bearbeiten…</span> öffnet das Verzeichnis <span class="path">/boot/home/config/Mail/Menu Links/</span>. Alle Ordner oder auch Queries(!) - beziehungsweise Verknüpfungen hierzu - erscheinen im Kontextmenü des E-Mail-Dienst Icons in der Deskbar.</p>
<p>Über dieses Kontextmenü kann man auch eine neue <span class="menu">Nachricht verfassen…</span>, sofort nach neuen E-Mails schauen (<span class="menu">E-Mails jetzt abrufen</span>), oder die E-Mail-Dienst <span class="menu">Einstellungen…</span> aufrufen.</p>
<img src="../images/prefs-images/e-mail-mailbox.png" alt="e-mail-mailbox.png" />
<p><span class="menu">Mailbox-Menü bearbeiten...</span> öffnet das Verzeichnis <span class="path">/boot/home/config/Mail/Menu Links/</span>. Alle Ordner oder auch Queries(!) - beziehungsweise Verknüpfungen hierzu - erscheinen im Kontextmenü des E-Mail-Dienst Icons in der Deskbar.</p>
<p>Über dieses Kontextmenü kann man auch eine neue <span class="menu">Nachricht verfassen...</span>, sofort nach neuen E-Mails schauen (<span class="menu">E-Mails jetzt abrufen</span>), oder die E-Mail-Dienst <span class="menu">Einstellungen...</span> aufrufen.</p>
<p>Hält man beim Aufrufen des Kontextmenüs <span class="key">SHIFT</span> gedrückt, erhält man Zugriff auf weitere Befehle:</p>
<table summary="notofications" border="0" cellpadding="2" cellspacing="0">
<tr><td><span class="menu">E-Mails nur abrufen für</span></td><td style="width:5px;"> </td>

2
userguide/en/applications/bepdf.html
View File

@ -71,7 +71,7 @@
</table>
<p><br /></p>
<p>BePDF is a fast launching PDF viewer. Besides viewing, it supports annotating and user-defined bookmarking for unencrypted PDFs. It's fully localized for 20 languages at the moment with additional languages being easily added via text files.</p>
<p>Documentation is available as <a href="file:///boot/system/apps/BePDF/docs/English/table_of_contents.html">HTML</a> or <a href="file:///boot/system/apps/BePDF/docs/English.pdf">PDF</a>. The latter will also open from the menu <span class="menu">Help | Show Help...</span>.</p>
<p>Documentation is available as <a href="file:///boot/system/apps/BePDF/docs/English/table_of_contents.html">HTML</a> or <a href="file:///boot/system/apps/BePDF/docs/English.pdf">PDF</a>. The latter will also open from the menu <span class="menu">Help | Show Help…</span></p>
</div>
</div>

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

@ -101,7 +101,7 @@ Would you like a link to it?" "On Desktop" "In Deskbar" "No thanks"</pre>
<p><img src="../images/apps-images/cli-filepanel.png" alt="cli-filepanel.png" /></p>
</td></tr>
<tr><td><p><span class="cli">hey</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">hey</span> is a littler helper tool that sends BMessages to applications and prints out their answer. It can be used for application scripting, i.e. "remote controlling" a program from a script or the command line. Its usage is a bit complex... <a href="https://www.haiku-os.org/blog/humdinger/2017-11-05_scripting_the_gui_with_hey/">Humdinger's blog post</a> serves as a good introduction, and thanks to Scot Hacker's BeOS Bible, there is a much more comprehensive <a href="http://www.birdhouse.org/beos/bible/bos/ch_scripting6.html">hey tutorial</a> by Chris Herborth.</p>
<td valign="top"><p><span class="cli">hey</span> is a littler helper tool that sends BMessages to applications and prints out their answer. It can be used for application scripting, i.e. "remote controlling" a program from a script or the command line. Its usage is a bit complex… <a href="https://www.haiku-os.org/blog/humdinger/2017-11-05_scripting_the_gui_with_hey/">Humdinger's blog post</a> serves as a good introduction, and thanks to Scot Hacker's BeOS Bible, there is a much more comprehensive <a href="http://www.birdhouse.org/beos/bible/bos/ch_scripting6.html">hey tutorial</a> by Chris Herborth.</p>
</td></tr>
<tr><td><p><span class="cli">notify</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">notify</span> shows a notification panel with a message. There are various parameters that are described when you call <span class="cli">notify --help</span>. A notification can also be used to show the progress of some action. When doing that, it's important to set a <i>messageID</i> and always use it when you update the progress (a float between 0.0 and 1.0 that's printed as percent). Otherwise you'll see several notification panels if you update quicker then the set timeout.<br />

2
userguide/en/applications/diskusage.html
View File

@ -69,7 +69,7 @@
<p><br /></p>
<p>DiskUsage shows graphically how the space on your volumes is utilized.<br />
A useful tool to answer the question, "<i>Where has all my disk space gone?</i>".</p>
<p>After launching, DiskUsage shows only an empty window with all mounted volumes as tabs at the top. You'll have to choose the one you're interested in and click <span class="button">Scan</span> to start chugging through the disk. For larger disks this can take some time... While you wait, you may switch to a different tab and start exploring that volume or begin the scan process there as well.<br />
<p>After launching, DiskUsage shows only an empty window with all mounted volumes as tabs at the top. You'll have to choose the one you're interested in and click <span class="button">Scan</span> to start chugging through the disk. For larger disks this can take some time… While you wait, you may switch to a different tab and start exploring that volume or begin the scan process there as well.<br />
It's not recommended to start several concurrent scan processes on the same physical disk, as the constant repositioning of the heads of the drive will only extend the wait.</p>
<p><img id="diskusage" src="../images/apps-images/diskusage.png" alt="diskusage.png" /></p>
<p>The concentric circles represent different levels in the file system hierarchy. Above, the circle in the center represents the <span class="path">/boot/home/</span> folder. Each segment of the ring immediately outside that circle is a file or folder under <span class="path">/boot/home/</span>. Every segment farther outside brings you one level deeper in the file hierarchy. You may have to resize the window to accommodate very deep folders.</p>

2
userguide/en/applications/drivesetup.html
View File

@ -105,7 +105,7 @@ Besides the familiar icons for harddisks, CD drives and USB sticks etc., there a
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="creating" name="creating">Creating a new partition</a></h2>
<p>When you found unformatted space on a drive, like the above <tt>&lt;empty&gt;</tt>, you can create a new partition in this space with <span class="menu">Partition | Create...</span>(<span class="key">ALT</span> <span class="key">C</span>).</p>
<p>When you found unformatted space on a drive, like the above <tt>&lt;empty&gt;</tt>, you can create a new partition in this space with <span class="menu">Partition | Create…</span>(<span class="key">ALT</span> <span class="key">C</span>).</p>
<img src="../images/apps-images/drivesetup-create.png" alt="drivesetup-create.png" />
<p>You're prompted with this dialog that lets you adjust the partition size and type. Choose <span class="menu">Be File System</span> if you want to use the partition for an Haiku installation or if you want to use all the interesting Haiku features with it, like attributes and queries. Note, that other operating systems might not be able to access such a partition.</p>
<p>The <span class="menu">Active partition</span> checkbox is only available if you have created a primary partition instead of just another logical partition within an extended one. You'll have to tick that checkbox if you plan to use that partition to boot a Haiku installation.</p>

2
userguide/en/applications/expander.html
View File

@ -78,7 +78,7 @@ Just double-click an archive to see this simple interface:</p>
<p>You can toggle the display of the file listing by un/checking <span class="menu">Show contents</span> or pressing <span class="key">ALT</span> <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">Settings | Settings...</span> or <span class="key">ALT</span> <span class="key">S</span> opens a preference panel that offers some useful settings to adjust Expander's behavior.<br />
<p><span class="menu">Settings | Settings…</span> or <span class="key">ALT</span> <span class="key">S</span> opens a preference panel that offers some useful settings to adjust Expander's behavior.<br />
The options are all self-explanatory:</p>
<p><img id="preferences" src="../images/apps-images/expander-preferences.png" alt="expander-preferences.png" /></p>

12
userguide/en/applications/haikudepot.html
View File

@ -134,15 +134,15 @@ In the middle are user comments with their nickname, the number of stars they ga
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="menu" name="menu">HaikuDepot and Show menu</a></h2>
<p>In the <span class="menu">HaikuDepot</span> menu at the top of the window, you'll find an item to <span class="menu">Refresh repositories</span>. This will request an up-to-date list of all available packages from the repositories.<br />
The second item is to <span class="menu">Manage repositories...</span>. It opens the <a href="../preferences/repositories.html">Repositories</a> preferences, to add/remove or disable and enable repositories.<br />
<span class="menu">Check for updates...</span> opens the <a href="../apps/softwareupdater.html">SoftwareUpdater</a> to search and install updated packages.<br />
<span class="menu">Settings...</span> opens a window with the currently only option: <span class="menu">Share anonymous usage data with HaikuDepotServer</span>. The data is used to, for example, increase a counter on how often a package is viewed and installed, which then can determine if a package is promoted to the "Featured packages" list.</p>
The second item is to <span class="menu">Manage repositories…</span>. It opens the <a href="../preferences/repositories.html">Repositories</a> preferences, to add/remove or disable and enable repositories.<br />
<span class="menu">Check for updates…</span> opens the <a href="../apps/softwareupdater.html">SoftwareUpdater</a> to search and install updated packages.<br />
<span class="menu">Settings…</span> opens a window with the currently only option: <span class="menu">Share anonymous usage data with HaikuDepotServer</span>. The data is used to, for example, increase a counter on how often a package is viewed and installed, which then can determine if a package is promoted to the "Featured packages" list.</p>
<p>Under <span class="menu">Show</span> you can choose to also display <span class="menu">Develop packages</span> and <span class="menu">Source packages</span> in the packages list. For the normal user those are of no interest and would only clutter the list. They are important, however, for people who need the libraries, headers etc. of a package to develop and compile programs depending on them.</p>
<p>Of more interest are the options to only show <span class="menu">Available packages</span> and <span class="menu">Installed packages</span>.</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="account" name="account">Creating a User Account</a></h2>
<p>To be able to rate a package, you need a user account at the <a href="http://depot.haiku-os.org">Haiku Depot Server</a> that serves all the packages and keeps track of ratings and user comments. You can create an account within the HaikuDepot application by clicking on the menu in the far right of the menu bar that shows your current status: <span class="menu">Not logged in</span>. Choosing <span class="menu">Log in...</span> opens a window with two tabs; one to enter your user name and password (once you have those) to log in, and the other to create a new account:</p>
<p>To be able to rate a package, you need a user account at the <a href="http://depot.haiku-os.org">Haiku Depot Server</a> that serves all the packages and keeps track of ratings and user comments. You can create an account within the HaikuDepot application by clicking on the menu in the far right of the menu bar that shows your current status: <span class="menu">Not logged in</span>. Choosing <span class="menu">Log in…</span> opens a window with two tabs; one to enter your user name and password (once you have those) to log in, and the other to create a new account:</p>
<img src="../images/apps-images/haikudepot-login-tab.png" alt="haikudepot-login-tab.png" />
<p>To create an account you need to:</p>
<ul><li>use an all lower-case user name without special characters</li>
@ -150,8 +150,8 @@ The second item is to <span class="menu">Manage repositories...</span>. It opens
<li>provide a valid email address (if you want a new password sent to you in case you forgot it)</li>
<li>solve the captcha</li>
<li>tick the checkboxes to confirm you're over 16 and have read the usage conditions linked below them.</li></ul>
<p>After logging in, the top-right menu of the HaikuDepot window will now say <span class="menu">Logged in as (...)</span>, showing your user name. The menu now offers you to <span class="menu">Switch account...</span> or <span class="menu">Log out</span>.</p>
<p>As a reminder of what you actually agreed to when you ticked the above mentioned checkbox, there are menu items to <span class="menu">View latest/agreed usage conditions...</span></p>
<p>After logging in, the top-right menu of the HaikuDepot window will now say <span class="menu">Logged in as (…)</span>, showing your user name. The menu now offers you to <span class="menu">Switch account...</span> or <span class="menu">Log out</span>.</p>
<p>As a reminder of what you actually agreed to when you ticked the above mentioned checkbox, there are menu items to <span class="menu">View latest/agreed usage conditions…</span></p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="rating" name="rating">Rating and Commenting</a></h2>

8
userguide/en/applications/icon-o-matic.html
View File

@ -243,7 +243,7 @@ If not, "Freeze transformation" will apply the current shape transformation to t
With the LOD you control the visibility of a shape depending on its size. That way, you can leave away details of an icon that look good on a bigger icon, but maybe not so much on its smaller version.</p>
<p>This is how it works: A LOD of 1.0 is defined as a 64px icon size. To get the LOD of a particular icon size you simply divide it by 64, e.g. a 16px icon has a LOD of 16/64 = 0.25. A shape won't be visible below its <span class="menu">Min LOD</span> and above its <span class="menu">Max LOD</span>.</p>
<p>So, if you set a shape's <span class="menu">Min LOD</span> to 0.0 and the <span class="menu">Max LOD</span> to 0.5, this means that the shape will only be visible for icon sizes smaller or <i>equal</i> to 32px. If you wanted to exclude the 32px icon size, you'd have to stay below 0.5, say 0.49.</p>
<p>The LOD is not only for leaving out detailing shapes, but also to e.g. change the stroke width at different sizes, if you feel that's needed. Simply duplicate a shape, make your changes and set both of their LOD settings to show either one or the other. Here lies the only source of potential confusion, when you unwittingly overlap LODs of shapes, and wonder why at some size both are visible...<br />
<p>The LOD is not only for leaving out detailing shapes, but also to e.g. change the stroke width at different sizes, if you feel that's needed. Simply duplicate a shape, make your changes and set both of their LOD settings to show either one or the other. Here lies the only source of potential confusion, when you unwittingly overlap LODs of shapes, and wonder why at some size both are visible…<br />
For example, if Shape 1 were to be shown below 48px and Shape 2 from 48px upward (LOD: 48/64 = 0.75):</p>
<table summary="LOD values example" border="0" cellpadding="5">
@ -277,7 +277,7 @@ Of course you can move these indicators to change the gradient to your liking. Y
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="i-o-m-transformer" name="i-o-m-transformer">Transformer</a></h3>
<p>A shape can have Transformers which change its appearance. The effects, however, are more subtle than a truck turning into a battle robot...</p>
<p>A shape can have Transformers which change its appearance. The effects, however, are more subtle than a truck turning into a battle robot…</p>
<h4><a id="i-o-m-transformer-menu" name="i-o-m-transformer-menu">Transformer Add Menu</a></h4>
<table summary=" Transformer Add menu" border="0" cellspacing="0" cellpadding="2">
@ -301,9 +301,9 @@ Of course you can move these indicators to change the gradient to your liking. Y
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="i-o-m-save" name="i-o-m-save">Saving an icon</a></h3>
<p>There's your usual menu bar at the top, <span class="menu">File</span>, <span class="menu">Edit</span>, <span class="menu">Options</span>. The usage is pretty much self-explaining, so we'll only look at how to save your work.</p>
<p><span class="menu">File | Save as...</span> will save in a special Icon-O-Matic format that retains additional information like the names of paths, shapes and styles. These will be stripped from the actual icon once you export it to save space. It's a good idea to back-up your work like this, because without named objects everything's named "&lt;path&gt;/&lt;shape&gt;/&lt;style&gt;" which makes specific changes tedious.</p>
<p><span class="menu">File | Save as…</span> will save in a special Icon-O-Matic format that retains additional information like the names of paths, shapes and styles. These will be stripped from the actual icon once you export it to save space. It's a good idea to back-up your work like this, because without named objects everything's named "&lt;path&gt;/&lt;shape&gt;/&lt;style&gt;" which makes specific changes tedious.</p>
<p><span class="menu">File | Export as...</span> opens a familiar save panel with a file format pop-up menu at the bottom, offering these choices:</p>
<p><span class="menu">File | Export as…</span> opens a familiar save panel with a file format pop-up menu at the bottom, offering these choices:</p>
<table summary="file formats" border="0" cellspacing="0" cellpadding="2">
<tr><td>HVIF</td><td style="width:15px;"></td><td>Haiku Vector Icon Format</td></tr>
<tr><td>HVIF RDef</td><td></td><td>Saves as resource used by programmers</td></tr>

2
userguide/en/applications/installer.html
View File

@ -80,7 +80,7 @@
<p>In the first pop-up menu you choose the source for the installation. It can be a currently installed Haiku or can come from an install CD or USB drive, etc.<br />
The second pop-up menu specifies the target for the installation. This target partition/volume will be completely overwritten and has to be set aside beforehand by a partitioning tool like GParted.</p>
<p>Clicking the little expander widget will <i>Show optional packages</i>, if available, that you can choose to install in addition to the basic Haiku.</p>
<p>You should do a last check if you really picked the right target before starting the installation process. Click on <span class="button">Setup partitions...</span> to open <a href="drivesetup.html">DriveSetup</a> and have a look at the naming and layout of the available volumes and partitions.</p>
<p>You should do a last check if you really picked the right target before starting the installation process. Click on <span class="button">Setup partitions…</span> to open <a href="drivesetup.html">DriveSetup</a> and have a look at the naming and layout of the available volumes and partitions.</p>
<p><span class="button">Begin</span> starts the installation procedure, which basically copies the <span class="path">/home/</span> and <span class="path">/system/</span> folder onto the target volume and makes it bootable.</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>

11
userguide/en/applications/list-cli-apps.html
View File

@ -75,7 +75,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>CortexAddOnHost</tt></td><td style="width:10px;"> </td><td>Starts service to monitor audio and video media add-ons in use. </td></tr>
<tr><td><tt>FirstBootPrompt</tt></td><td> </td><td>Language and keymap setup. </td></tr>
<tr><td><tt>[</tt></td><td> </td><td>Returns true/false after comparing items.</td></tr>
<tr><td colspan="3"><a id="A" name="A"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>A</h2></a></td></tr>
<tr><td colspan="3"><a id="A" name="A"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>A - E</h2></a></td></tr>
<tr><td><tt>addattr</tt></td><td> </td><td>Writes an attribute to a file, taking the type into account and converting the values accordingly. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td><tt>alert</tt></td><td> </td><td>Shows a message box. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td><tt>arp</tt></td><td> </td><td>Manipulates the system ARP cache. </td></tr>
@ -133,7 +133,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>error</tt></td><td> </td><td>Prints clear text error messages for given error numbers. </td></tr>
<tr><td><tt>expand</tt></td><td> </td><td>Converts tabs to spaces.</td></tr>
<tr><td><tt>expr</tt></td><td> </td><td>Prints the value of an expression.</td></tr>
<tr><td colspan="3"><a id="F" name="F"><h2>F</h2></a></td></tr>
<tr><td colspan="3"><a id="F" name="F"><h2>F - J</h2></a></td></tr>
<tr><td><tt>factor</tt></td><td> </td><td>Prints the prime factors of integer numbers.</td></tr>
<tr><td><tt>false</tt></td><td> </td><td>Does nothing, indicates "unsuccessful" and returns the value "1".</td></tr>
<tr><td><tt>fdinfo</tt></td><td> </td><td>Shows info about the used file descriptors in the system. </td></tr>
@ -169,7 +169,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>iroster</tt></td><td> </td><td>Lists input devices. </td></tr>
<tr><td><tt>isvolume</tt></td><td> </td><td>Gets information about a mounted volume.</td></tr>
<tr><td><tt>join</tt></td><td> </td><td>For each pair of input lines with identical join fields, write a line to standard output. </td></tr>
<tr><td colspan="3"><a id="K" name="K"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>K</h2></a></td></tr>
<tr><td colspan="3"><a id="K" name="K"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>K - O</h2></a></td></tr>
<tr><td><tt>kernel_debugger</tt></td><td> </td><td>Enters the kernel debugger.</td></tr>
<tr><td><tt>keymap</tt></td><td> </td><td>Loads or saves a keymap.</td></tr>
<tr><td><tt>kill</tt></td><td> </td><td>Sends a signal to quit a process. </td></tr>
@ -223,7 +223,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>nproc</tt></td><td> </td><td>Prints the number of available processing units.</td></tr>
<tr><td><tt>od</tt></td><td> </td><td>Writes an unambiguous representation of a file.</td></tr>
<tr><td><tt>open</tt></td><td> </td><td>Launches an application/document from the shell. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td colspan="3"><a id="P" name="P"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>P</h2></a></td></tr>
<tr><td colspan="3"><a id="P" name="P"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>P - S</h2></a></td></tr>
<tr><td><tt>package</tt></td><td> </td><td>Creates, inspects, or extracts a Haiku package.</td></tr>
<tr><td><tt>package_repo</tt></td><td> </td><td>Creates or inspects a Haiku package repository file.</td></tr>
<tr><td><tt>passwd</tt></td><td> </td><td>Changes the user password. </td></tr>
@ -246,6 +246,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>ramdisk</tt></td><td> </td><td>Creates a ramdisk. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td><tt>rc</tt></td><td> </td><td>Resource compiler.</td></tr>
<tr><td><tt>readlink</tt></td><td> </td><td>Prints the path to the destination of a symbolic link.</td></tr>
<tr><td><tt>recover</tt></td><td> </td><td>A tool that tries to recover files from a corrupted BFS volume (see its <a href="https://www.pinc-software.de/docs/BFS-tools.html#recover">documentation</a> for a bit more info).</td></tr>
<tr><td><tt>reindex</tt></td><td> </td><td>Puts attributes of existing files into newly created indexes. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td><tt>release</tt></td><td> </td><td>Releases a semaphore. </td></tr>
<tr><td><tt>renice</tt></td><td> </td><td>Alters the priority of a running process. </td></tr>
@ -283,7 +284,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>sum</tt></td><td> </td><td>Prints checksum and block counts for each file. </td></tr>
<tr><td><tt>sync</tt></td><td> </td><td>Forces changed blocks to disk, updates the superblock. </td></tr>
<tr><td><tt>sysinfo</tt></td><td> </td><td>Shows system info. </td></tr>
<tr><td colspan="3"><a id="T" name="T"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>T</h2></a></td></tr>
<tr><td colspan="3"><a id="T" name="T"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>T - Z</h2></a></td></tr>
<tr><td><tt>tac</tt></td><td> </td><td>Concatenates and prints files, last line first. </td></tr>
<tr><td><tt>tail</tt></td><td> </td><td>Prints the last ten lines of a file.</td></tr>
<tr><td><tt>tcpdump</tt></td><td> </td><td>Dumps traffic of a network. </td></tr>

24
userguide/en/applications/mail.html
View File

@ -64,7 +64,7 @@
<tr class="heading"><td>Index</td></tr>
<tr class="index"><td><a href="#reading">Reading messages</a><br />
<a href="#creating">Creating new messages</a><br />
<a href="#preferences">Preferences</a></td></tr>
<a href="#preferences">Settings</a></td></tr>
</table>
<h2><img src="../../images/apps-images/mail-icon_64.png" alt="mail-icon_64.png" width="64" height="64" />Mail</h2>
@ -85,14 +85,14 @@
<p>You double-click an email file to open it in Mail. The interface is quite simple:</p>
<img src="../images/apps-images/mail-read.png" alt="email-read.png" />
<p>A menu and optional tool bar on top, with an area of the interesting attributes of a mail (to, from, subject, date) below that, and then the actual body of the mail. If the mail appears with strange characters or empty, try to change the <span class="menu">Encoding</span> in the <span class="menu">Message</span> menu.</p>
<p>If there are files attached to an email, they are listed at the end of the message. A right-click on one opens a context menu to <span class="menu">Save attachment...</span> or <span class="menu">Open attachment</span>. You can also drag &amp; drop directly to the Desktop or another Tracker window.</p>
<p>If there are files attached to an email, they are listed at the end of the message. A right-click on one opens a context menu to <span class="menu">Save attachment…</span> or <span class="menu">Open attachment</span>. You can also drag &amp; drop directly to the Desktop or another Tracker window.</p>
<p>Most of the menu and tool bar items are pretty self-explaining, so we'll concentrate just on the highlights.</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>File</h3>
<p>When you close the window of a new mail, its status is normally switched from "New" to "Read". But you can set other statuses as well, by choosing from the <span class="menu">Close and</span> submenu. There you'll also find the option <span class="menu">Set to...</span> to create your own custom statuses, which are saved under <span class="path">~/config/settings/Mail/status/</span>.</p>
<p>When you close the window of a new mail, its status is normally switched from "New" to "Read". But you can set other statuses as well, by choosing from the <span class="menu">Close and</span> submenu. There you'll also find the option <span class="menu">Set to…</span> to create your own custom statuses, which are saved under <span class="path">~/config/settings/Mail/status/</span>.</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Edit</h3>
<p>Here you'll find an item to open Mail's <span class="menu">Preferences...</span> (<a href="#preferences">see below</a>) and a shortcut to manage your <span class="menu">Accounts...</span>, which will open the <a href="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<p>Here you'll find an item to open Mail's <span class="menu">Settings…</span> (<a href="#preferences">see below</a>) and a shortcut to manage your <span class="menu">Accounts…</span>, which will open the <a href="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>View</h3>
<p>You'll only seldomly need these two items, if at all:</p>
@ -108,7 +108,7 @@
<tr><td class="onelinetop"><span class="menu">Reply to sender</span></td><td><span class="key">OPT</span> <span class="key">ALT</span> <span class="key">R</span></td><td></td><td>This on the other hand, sends directly and only to the person listed in the "From" attribute.</td></tr>
<tr><td><span class="menu">Reply to all</span></td><td class="onelinetop"><span class="key">SHIFT</span> <span class="key">ALT</span> <span class="key">R</span></td><td></td><td>Replies to the original sender plus all other (cc'ed) recipients of the original mail.</td></tr>
</table>
<div class="box-info">If you mark a passage in the email before replying to it, only the marked text will be quoted in your answering mail. A nice way to cut down on excessive quoting, which is frowned upon by pretty much everybody...</div>
<div class="box-info">If you mark a passage in the email before replying to it, only the marked text will be quoted in your answering mail. A nice way to cut down on excessive quoting, which is frowned upon by pretty much everybody…</div>
<p>The items to <span class="menu">Forward</span>, <span class="menu">Resend</span> and <span class="menu">Copy to new</span> are again pretty self-explaining.</p>
<p>When you've opened an email from a Tracker or query result window, <span class="menu">Previous message</span> and <span class="menu">Next message</span> will move to the previous/next email in the list.</p>
<p><span class="menu">Save address</span> collects all email addresses from the header and the actual email body in a submenu. Choosing an address will open the <a href="people.html">People</a> application in order to complete and save the contact information.</p>
@ -120,7 +120,7 @@
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="creating" name="creating">Creating new messages</a></h2>
<p>A new email is created by invoking <span class="menu">New mail message</span> of the <span class="menu">File</span> menu or the corresponding icon from the tool bar of an open email. Or you just start the Mail application or choose <span class="menu">Create new message...</span> from the context menu of the mailbox icon in the Deskbar.</p>
<p>A new email is created by invoking <span class="menu">New mail message</span> of the <span class="menu">File</span> menu or the corresponding icon from the tool bar of an open email. Or you just start the Mail application or choose <span class="menu">Create new message…</span> from the context menu of the mailbox icon in the Deskbar.</p>
<img src="../images/apps-images/mail-write.png" alt="email-write.png" />
<p>The window is pretty similar to the one when reading mails. The menu and tool bar items are slightly different and the text boxes have to be filled with the recipient's email address, subject and so on, of course.</p>
<p><span class="menu">Cc</span> is short for the anachronistic term "<i>carbon copy</i>" and results in copies of your mail being sent to the listed people. The difference to just listing a buch of addresses in the "To" field is, that you don't directly address the cc'ed people, thereby signaling that you probably don't expect an answer of them.<br />
@ -139,15 +139,15 @@
<p><span class="menu">Check spelling</span> currently only offers corrections of English texts by marking wrong or unknown words red and showing them in italic.
Right-clicking such a word opens a context menu offering suggestions to correct the word or to <span class="menu">Add</span> it to the accepted vocabulary.</p>
<p>Then, there are again the items to open Mail's <span class="menu">Preferences...</span> (<a href="#preferences">see below</a>) and a shortcut to managing your <span class="menu">Accounts...</span>, which will open the <a href="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<p>Then, there are again the items to open Mail's <span class="menu">Settings…</span> (<a href="#preferences">see below</a>) and a shortcut to managing your <span class="menu">Accounts…</span>, which will open the <a href="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Message</h3>
<p>With <span class="menu">Add signature</span> you can add predefined texts to the end of your mail. From its submenu you can choose a specific or <span class="menu">Random</span> one.</p>
<img src="../images/apps-images/mail-signature.png" alt="email-signature.png" />
<p>You create new or edit existing signatures with <span class="menu">Edit signatures...</span>, which will open a window where you enter the text itself and the title of your new sig. There, in the <span class="menu">Signature</span> menu, you find items to <span class="menu">Open</span> a specific signature or <span class="menu">Save</span> or <span class="menu">Delete</span> the currently loaded one, Signatures should be saved in <span class="path">~/config/settings/Mail/signatures</span>.</p>
<p>Use <span class="menu">Add enclosure...</span> and <span class="menu">Remove enclosure</span> to add/remove files as attachments. You can also drag &amp; drop files from a Tracker window. Be careful though to drop those in the header section (To/From/Subject area at the top) or they'll get pasted into the email body if they are text files.</p>
<p>You create new or edit existing signatures with <span class="menu">Edit signatures…</span>, which will open a window where you enter the text itself and the title of your new sig. There, in the <span class="menu">Signature</span> menu, you find items to <span class="menu">Open</span> a specific signature or <span class="menu">Save</span> or <span class="menu">Delete</span> the currently loaded one, Signatures should be saved in <span class="path">~/config/settings/Mail/signatures</span>.</p>
<p>Use <span class="menu">Add enclosure…</span> and <span class="menu">Remove enclosure</span> to add/remove files as attachments. You can also drag &amp; drop files from a Tracker window. Be careful though to drop those in the header section (To/From/Subject area at the top) or they'll get pasted into the email body if they are text files.</p>
<img src="../images/apps-images/mail-attachments.png" alt="email-attachments.png" />
@ -159,9 +159,9 @@ Right-clicking such a word opens a context menu offering suggestions to correct
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="preferences" name="preferences">Preferences</a></h2>
<a id="preferences" name="preferences">Settings</a></h2>
<img src="../images/apps-images/mail-preferences.png" alt="email-preferences.png" />
<p>Mail's preferences come in two parts:</p>
<p>Mail's settings come in two parts:</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>User interface</h3>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
@ -188,7 +188,7 @@ On Mon, 18 Jan 1998 02:55:16 +0800 you wrote:
<tr><td><span class="menu">Encoding</span></td><td></td><td>Sets the default encoding.</td></tr>
<tr><td class="onelinetop"><span class="menu">Warn unencodable</span></td><td></td><td>If your mail contains characters that can't be encoded with the currently set encoding method, you can turn on being warned about that. That gives you the opportunity to change the encoding before sending. Otherwise unencodable characters are replaced by rectangle symbols.</td></tr>
<tr><td><span class="menu">Text wrapping</span></td><td></td><td>Inserts line-breaks every 76 characters which makes mails easier to read.</td></tr>
<tr><td><span class="menu">Attach attributes</span></td><td></td><td>You can choose to send BFS' attributes of a file alongside the attachments. This is nice for other Haiku users, as they'll get a "complete" file (think artist, album, title attributes of MP3 files), but may cause confusion (or even suspicion) with others, who will wonder what the additional "BeOS Attributes" attachment might be...<br />
<tr><td><span class="menu">Attach attributes</span></td><td></td><td>You can choose to send BFS' attributes of a file alongside the attachments. This is nice for other Haiku users, as they'll get a "complete" file (think artist, album, title attributes of MP3 files), but may cause confusion (or even suspicion) with others, who will wonder what the additional "BeOS Attributes" attachment might be…<br />
Should you opt not to send attributes with your attachments, remember zip up your files before you send them or you'll strip away BFS attributes.</td></tr>
</table>

4
userguide/en/applications/mediaplayer.html
View File

@ -76,7 +76,7 @@ Below that you find the usual controls to skip to the previous track, play/pause
<h2>Audio and video playback</h2>
<p>Since there aren't any specific features for audio playback, we'll go straight to video or general features.</p>
<img src="../images/apps-images/mediaplayer-info.png" alt="mediaplayer-info.png" />
<p>Available to all media is the <span class="menu">File info...</span> (<span class="key">ALT</span> <span class="key">I</span>). It shows information about the currently loaded file, like playing time or details of the audio/video track and its codec.</p>
<p>Available to all media is the <span class="menu">File info…</span> (<span class="key">ALT</span> <span class="key">I</span>). It shows information about the currently loaded file, like playing time or details of the audio/video track and its codec.</p>
<p>Most of the often used commands from the menus are also available from a right-click context menu on the video area. Convenient when in full-screen mode.<br />
Under <span class="menu">Video</span> you'll find options to zoom the window to various levels or force the aspect ratio to some standard values. Leaving the aspect ration to the default <span class="menu">Stream settings</span> should work best for correctly encoded files.</p>
<p>MediaPlayer supports subtitles in <a href="http://en.wikipedia.org/wiki/SubRip">SRT</a> format. To have them show up under <span class="menu">Subtitles</span>, their filenames have to be identical to their video file, with a suffixed language name and ".srt" instead of the video's extension. For example:</p>
@ -88,7 +88,7 @@ MyMovie.Français.srt</pre>
<p>You can toggle the <span class="menu">Full screen</span> mode (<span class="key">ALT</span> <span class="key">ENTER</span> or <span class="key">F</span> or a double left-click), hide MediaPlayer's window borders and controls with <span class="menu">Hide interface</span> (<span class="key">ALT</span> <span class="key">H</span> or a double right-click) or have its window <span class="menu">Always on top</span> (<span class="key">ALT</span> <span class="key">A</span>).</p>
<h2>Playlists</h2>
<p><span class="menu">MediaPlayer | Playlist...</span> (<span class="key">ALT</span> <span class="key">P</span>) opens a window with the files currently queued up for playback. Double-clicking an entry starts playing it.</p>
<p><span class="menu">MediaPlayer | Playlist…</span> (<span class="key">ALT</span> <span class="key">P</span>) opens a window with the files currently queued up for playback. Double-clicking an entry starts playing it.</p>
<img src="../images/apps-images/mediaplayer-playlist.png" alt="mediaplayer-playlist.png" />
<p>You can add more files by dropping them into the list and rearrange their position via drag &amp; drop. New files are added in the order they were selected from a Tracker window. Drag &amp; dropping them with the right mouse button shows a context menu to insert them <span class="menu">sorted</span> (alphabetically).<br />
From the <span class="menu">Edit</span> menu you can <span class="menu">Randomize</span> or <span class="menu">Remove</span> (<span class="key">DEL</span>) an entry from the list or delete the actual file with <span class="menu">Move to Trash</span> (<span class="key">ALT</span> <span class="key">T</span>).</p>

2
userguide/en/applications/poorman.html
View File

@ -69,7 +69,7 @@
<p><br /></p>
<p>PoorMan is a nice little webserver that's extremely easy to set up. Naturally it doesn't offer any advanced features like other heavy duty server software, it's after all only a poor man's webserver.</p>
<p>Upon its first launch, PoorMan asks for the folder that is about to be served to the web. If you go with the <span class="button">Default</span>, a new folder <span class="path">/boot/home/public_html</span> is created for you. As a start page a HTML file named by default <span class="cli">index.html</span> has to be present there.</p>
<p>PoorMan presents itself with a simple console that logs its activity. Then, there's status information if the server is running, which folder is being served, and a hit counter. Settings are changed with <span class="menu">Edit | Settings...</span>:
<p>PoorMan presents itself with a simple console that logs its activity. Then, there's status information if the server is running, which folder is being served, and a hit counter. Settings are changed with <span class="menu">Edit | Settings…</span>:
</p>
<p><img id="poorman" src="../images/apps-images/poorman.png" alt="poorman.png" /></p>
<p>The settings panel is divided into three tabs:</p>

4
userguide/en/applications/showimage.html
View File

@ -93,12 +93,12 @@ ShowImage provides minimal editing features to crop, rotate and flip images and
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Editing</h2>
<img src="../images/apps-images/showimage-edit.jpg" alt="showimage-edit.jpg" />
<p>The <span class="menu">Image</span> menu offers the few image manipulations necessary for an image viewer: rotating and flipping the image. Note however, that the actual image data won't be changed. Only an attribute is added to the file so it'll be shown rotated or flipped the next time you open it.</p>
<p><span class="menu">Use as backgroud...</span> will open the <a href="../preferences/backgrounds.html">Backgrounds</a> preferences to set the current picture as image for your workspaces.</p>
<p><span class="menu">Use as background…</span> will open the <a href="../preferences/backgrounds.html">Backgrounds</a> preferences to set the current picture as image for your workspaces.</p>
<p>Cropping is another feature that's needed sometimes. To define the frame to cut to, you can switch to <span class="menu">Selection mode</span> from the <span class="menu">Edit</span> menu and drag out a box with your left mouse button. If you don't want to change modes first, you can create this box in "normal mode" by simply holding <span class="key">CTRL</span> while left-click-dragging, which otherwise would just pan the image around.<br />
<span class="menu">Clear selection</span> or <span class="key">ESC</span> will remove the selection box.</p>
<p>The following chapter shows how to actually save the cropped area.</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Saving and converting</h2>
<p>To save or convert an image into any available format, you can invoke the normal <span class="menu">Save as...</span> item from the <span class="menu">File</span> menu, select the format and choose a file name.<br />
<p>To save or convert an image into any available format, you can invoke the normal <span class="menu">Save as…</span> item from the <span class="menu">File</span> menu, select the format and choose a file name.<br />
Often quicker, especially when the Tracker window with the destination folder is already open, is using drag &amp; drop.</p>
<img src="../images/apps-images/showimage-dnd.jpg" alt="showimage-dnd.jpg" />
<p>This is also how the above mentioned cropping is finalized. Either select a frame as described above, or choose <span class="menu">Edit | Select all</span> for the whole image. Then drag &amp; drop the selection onto the Desktop or any Tracker window to create a new image clipping in the same format of the original image.</p>

10
userguide/en/applications/terminal.html
View File

@ -80,14 +80,14 @@
<br />
<p>Double-clicking into the emtpy part of the tab bar opens a new tab; onto a tab opens a dialog to rename its title. There are several %-designated variables that are explained with a tooltip when you hover the mouse over the text field.<br />
By default, <tt>%1d: %p</tt>, a tab shows the current directory and, separated by a <tt>:</tt>, the name of the currently running process (or <tt>--</tt> if it's just bash running, probably idling). The screenshot above shows the first tab with a FTP session in the <span class="path">Desktop</span> folder and a second tab idling at <span class="path">home</span>.<br />
Via <span class="menu">Settings | Window title...</span> the Terminal window's title can be edited in a similar way.</p>
<p>Right-clicking a tab shows a context menu to <span class="menu">Close tab</span>, <span class="menu">Close other tabs</span> or, like double-clicking, <span class="menu">Edit tab title...</span>.</p>
Via <span class="menu">Settings | Window title…</span> the Terminal window's title can be edited in a similar way.</p>
<p>Right-clicking a tab shows a context menu to <span class="menu">Close tab</span>, <span class="menu">Close other tabs</span> or, like double-clicking, <span class="menu">Edit tab title…</span></p>
<p>A Terminal window can be resized like any other window or you use the presets from the <span class="menu">Settings | Window size</span> menu. <span class="key">ALT</span> <span class="key">ENTER</span> toggles fullscreen mode.</p>
<p>All the settings you change directly through the <span class="menu">Settings</span> menu, like <span class="menu">Window title</span>, <span class="menu">Window size</span>, <span class="menu">Text encoding</span> or <span class="menu">Font size</span> are only kept for the current session. If you want to make permanent changes, you have to apply them in the <span class="menu">Settings...</span> panel.</p>
<p>All the settings you change directly through the <span class="menu">Settings</span> menu, like <span class="menu">Window title</span>, <span class="menu">Window size</span>, <span class="menu">Text encoding</span> or <span class="menu">Font size</span> are only kept for the current session. If you want to make permanent changes, you have to apply them in the <span class="menu">Settings…</span> panel.</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="settings" name="settings">Settings</a></h2>
<p><span class="menu">Settings | Settings...</span> opens a panel to configure the standard settings of a Terminal.</p>
<p><span class="menu">Settings | Settings…</span> opens a panel to configure the standard settings of a Terminal.</p>
<img src="../images/apps-images/terminal-settings.png" alt="terminal-settings.png" />
<br />
<p>Most of the offered settings speak for themselves. Not entirely obvious though, the font size is set in the submenu of the <span class="menu">Font</span> popup menu.<br />
@ -98,7 +98,7 @@ You can choose pre-defined color schema like <span class="menu">Midnight</span>
<span class="menu">Use left Option as Meta key</span> if you work with certain UNIX software that relies on accessing an extended portion of the ASCII character set, like e.g. GNU Emacs and the GNU readline library.<br />
Activate the checkbox to <span class="menu">Confirm exit if active programs exist</span> and you'll be warned when trying to close a Terminal window while an app is still being executed.</p>
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
<tr><td class="onelinetop"><span class="button">Save to file...</span></td><td width="10"> </td><td>let's you save different settings as separate profiles, which on double-click open an accordingly configured Terminal.</td></tr>
<tr><td class="onelinetop"><span class="button">Save to file…</span></td><td width="10"> </td><td>let's you save different settings as separate profiles, which on double-click open an accordingly configured Terminal.</td></tr>
<tr><td><span class="button">Revert</span></td><td> </td><td>brings back the settings that were active when you opened the settings panel.</td></tr>
<tr><td><span class="button">Defaults</span></td><td> </td><td>resets everything to default values.</td></tr>
</table>

2
userguide/en/applications/textsearch.html
View File

@ -78,7 +78,7 @@
<tr><td colspan="5"><h3>File menu</h3></td></tr>
<tr><td class="onelinetop"><span class="menu">New window</span></td><td></td><td><span class="key">ALT</span> <span class="key">N</span></td><td> </td><td>Opens a new window where you can enter another string and search through the same files/folders.
</td></tr>
<tr><td><span class="menu">Set target...</span></td><td></td><td><span class="key">ALT</span> <span class="key">F</span></td><td></td><td>Lets you choose a new set of files and folders to search through. Alternatively you can drag and drop files/folders into the window.</td></tr>
<tr><td><span class="menu">Set target…</span></td><td></td><td><span class="key">ALT</span> <span class="key">F</span></td><td></td><td>Lets you choose a new set of files and folders to search through. Alternatively you can drag and drop files/folders into the window.</td></tr>
<tr><td colspan="5"><h3>Action menu</h3></td></tr>
<tr><td><span class="menu">Trim selection</span></td><td></td><td><span class="key">ALT</span> <span class="key">T</span></td><td> </td><td>Removes all entries from the list that are not currently selected.</td></tr>
<tr><td><span class="menu">Open selection</span></td><td></td><td><span class="key">ALT</span> <span class="key">O</span></td><td></td><td>Opens the currently selected files with their preferred application (same as a double-click). If it's a text editor supporting it (like Pe), you can jump to the exact line the search string was found.</td></tr>

5
userguide/en/applications/webpositive.html
View File

@ -107,12 +107,13 @@ Strings not recognized as URLs will get looked up with the search engine set in
<li><p><span class="menu">Edit | Find</span> shows a find bar at the bottom to start an in-page search. Matches are highlighted in the page.</p></li>
</ul>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Bookmarks</h2>
<p>WebPositive's bookmarks are managed as files and folders in <tt>~/config/settings/WebPositive/Bookmarks/</tt>. Adding a bookmark will create a new file there. You can quickly open the folder with <span class="menu">Manage Bookmarks...</span>.</p>
<p>WebPositive's bookmarks are managed as files and folders in <tt>~/config/settings/WebPositive/Bookmarks/</tt>. Adding a bookmark will create a new file there. Alternatively, you can drag and drop the site's 'favicon' in front of the URL to any open Tracker window or the Desktop, or even into the Bookmark bar (activated with <span class="menu">View | Show bookmark bar</span>).<br />
You quickly open the <tt>Bookmarks</tt> folder with <span class="menu">Manage Bookmarks…</span></p>
<img src="../images/apps-images/webpositive-bookmarks.png" alt="webpositive-bookmarks" />
<p>You can change a bookmark's URL, name, title and enter keywords just like with any other file with attributes. Just make sure you have all their columns displayed via Tracker's <span class="menu">Attributes</span> menu, then select a file, press <span class="key">ALT</span> <span class="key">E</span> and start editing the attribute; change attribute columns with <span class="key">TAB</span>.<br />You can sort bookmarks into different folders you create yourself.</p>
<p>By using Tracker to manage and navigate bookmarks you can lift its unique features to quickly find what you're looking for.<br />
Activating <span class="menu">Type-ahead filtering</span> in <a href="../tracker.html#tracker-preferences">Tracker's preferences</a>, you can instantly trim down your list of bookmarks to matches of your filter-string. A few more <span class="key">↑</span> or <span class="key">↓</span> to move the selection and pressing <span class="key">ENTER</span> opens the site. Make sure to display all attribute columns to have the filter applied to name, title, URL and keywords.</p>
<p>For this to work, all bookmarks should be kept in the <tt>~/config/settings/WebPositive/Bookmarks/</tt> folder and only copies should be sorted into custom subfolders for usage in WebPositive's <span class="menu">Bookmarks</span> menu (if at all). Also, actually filling the keywords attribute helps...</p>
<p>For this to work, all bookmarks should be kept in the <tt>~/config/settings/WebPositive/Bookmarks/</tt> folder and only copies should be sorted into custom subfolders for usage in WebPositive's <span class="menu">Bookmarks</span> menu (if at all). Also, actually filling the keywords attribute helps…</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Downloads</h2>
<p><span class="menu">Window | Downloads</span> opens a window listing all past and ongoing downloads:</p>
<img src="../images/apps-images/webpositive-downloads.png" alt="webpositive-downloads.png" />

8
userguide/en/deskbar.html
View File

@ -85,12 +85,12 @@ You can also fold it into a more compact layout by drag &amp; dropping the knobb
<p>A menu opens when you click on the Deskbar's top:</p>
<img src="images/deskbar-images/deskbar.png" alt="deskbar.png" />
<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>About Haiku…</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 <a href="queries.html">Query</a> 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 <a href="gui.html#replicants">Replicant</a> widget you use to drag it around, remove or access its context menu.</p></li>
<li><p><b>Mount</b> - Offers the same options as when invoked by right-clicking the Desktop (see <a href="tracker.html#mounting-volumes">Mounting Volumes</a>).</p></li>
<li><p><b>Deskbar preferences...</b> - Opens a panel to configure the Deskbar (see below).</p></li>
<li><p><b>Deskbar preferences…</b> - Opens a panel to configure the Deskbar (see below).</p></li>
<li><p><b>Shutdown</b> - Offers options to either <span class="menu">Restart system</span> or <span class="menu">Power off</span>.</p></li>
<li><p><b>Recent documents, folders, applications</b> - List of the last recently opened documents, folders and applications (see <span class="menu">Deskbar preferences</span> below).</p></li>
<li><p><b>Applications, Demos, Deskbar applets, Preferences</b> - List of installed applications, demos, applets and preferences.<br />You can add links to other programs (or any folder, document, query etc.) by putting them into <span class="path">~/config/settings/deskbar/menu/</span>.</p></li>
@ -113,7 +113,7 @@ You can also fold it into a more compact layout by drag &amp; dropping the knobb
</table>
<h4>Menu</h4>
<p>While the first couple of menu items of the Deskbar are fixed, you can customized the ones below <span class="menu">Shutdown...</span>.<br />
<p>While the first couple of menu items of the Deskbar are fixed, you can customized the ones below <span class="menu">Shutdown…</span>.<br />
Here you can set the number of recent documents, folders and applications that are shown in their menu in the Deskbar, or if you want to see them at all.<br />
The button <span class="button">Edit in Tracker...</span> opens the folder <span class="path">~/config/settings/deskbar/menu/</span>. In it you'll find the files and folders that appear in the Deskbar, by default these are <span class="menu">Applications</span>, <span class="menu">Demos</span>, <span class="menu">Deskbar applets</span>, and <span class="menu">Preferences</span>.<br />
You can delete or add entries like links to applications, documents or even queries by simply copying/deleting them to/from this folder.</p>

2
userguide/en/desktop-applets/launchbox.html
View File

@ -72,7 +72,7 @@
<tr><td><span class="menu">Add button here</span></td><td style="width:10px;"> </td><td>Adds an empty button.</td></tr>
<tr><td><span class="menu">Clear button</span></td><td> </td><td>Empties a button.</td></tr>
<tr><td><span class="menu">Remove button</span></td><td> </td><td>Removes a button.</td></tr>
<tr><td><span class="menu">Set description...</span></td><td> </td><td>Hovering the mouse over an icon shows a tooltip with the file's name and, in case of an application, its short description if it differs from its name (see topic <a href="../filetypes.html#settings-apps">FileTypes</a>). With this menu item you can customize the description for this tooltip.</td></tr>
<tr><td><span class="menu">Set description…</span></td><td> </td><td>Hovering the mouse over an icon shows a tooltip with the file's name and, in case of an application, its short description if it differs from its name (see topic <a href="../filetypes.html#settings-apps">FileTypes</a>). With this menu item you can customize the description for this tooltip.</td></tr>
<tr><td class="onelinetop"><span class="menu">Settings</span><br />
<span class="menu">- Horizontal layout</span><br />
<span class="menu">- Icon size</span><br />

2
userguide/en/desktop-applets/networkstatus.html
View File

@ -72,7 +72,7 @@ Wherever installed, it's operated via a right-click context menu.</p>
<img src="../images/networkstatus-images/applet.png" alt="NetworkStatus applet" />
<p>The first section contains all network devices' names and their state. Clicking on such an entry brings up a window showing its IP, broadcast and netmask address.<br />
Below is a list of all wireless networks found by the first wireless adapter and an indicator of their signal strength. Have a look at the <a href="..\workshop-wlan.html">Workshop: Wireless networking</a> for more information on how to set up a connection.<br />
Lastly, you can <span class="menu">Open network preferences...</span> to change your <a href="../preferences/network.html">network configuration</a> or <span class="menu">Quit</span> the applet.</p>
Lastly, you can <span class="menu">Open network preferences…</span> to change your <a href="../preferences/network.html">network configuration</a> or <span class="menu">Quit</span> the applet.</p>
<h2>Status icons</h2>
<table summary="status icons" border="0" cellspacing="0" cellpadding="2">

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

@ -77,8 +77,8 @@ Wherever installed, it's operated via a right-click context menu.</p>
<tr><td><span class="menu">Show text label</span></td><td style="width:10px"></td><td>Shows battery level in percent or remaining time.</td></tr>
<tr><td><span class="menu">Show status icon</span></td><td></td><td>Shows icon of the applet.</td></tr>
<tr><td class="onelinetop"><span class="menu">Show percent / time</span></td><td></td><td>Switch between showing battery level in percent or remaining time (<span class="menu">Show text label</span> has to be active).</td></tr>
<tr><td><span class="menu">Battery info...</span></td><td></td><td>Shows the extended battery info window.</td></tr>
<tr><td><span class="menu">About...</span></td><td></td><td>Shows the About window.</td></tr>
<tr><td><span class="menu">Battery info…</span></td><td></td><td>Shows the extended battery info window.</td></tr>
<tr><td><span class="menu">About…</span></td><td></td><td>Shows the About window.</td></tr>
<tr><td><span class="menu">Quit</span></td><td></td><td>Quits the PowerStatus applet.</td></tr>
</table>

2
userguide/en/desktop-applets/processcontroller.html
View File

@ -81,7 +81,7 @@ To remove the applet again from the Deskbar, uncheck <span class="menu">Live in
<img src="../images/processcontroller-images/memory.png" alt="ProcessController - Memory usage" />
<p>Monitoring memory usage can be rather inaccurate.</p>
<p>This menu allows you to monitor memory usage of different teams in your system. Next to the team's name there are two columns: first with the amount reserved for writable memory, while the second shows all memory including read-only space (shared libraries for example).</p>
<p>The first row <i>System resources &amp; caches...</i> shows the total amount of memory used by the system and all applications. The length of the blue bar is based on the total physical memory in your computer. The next rows show memory used by each process. Note that the length of the bar is based only on the actually used part of the memory.</p>
<p>The first row <i>System resources &amp; caches…</i> shows the total amount of memory used by the system and all applications. The length of the blue bar is based on the total physical memory in your computer. The next rows show memory used by each process. Note that the length of the bar is based only on the actually used part of the memory.</p>
<table>
<tr><td style="width:20px;height:20px;background:#1414E7"></td><td style="width:10px"></td><td>Memory used only by given application (with write access)</td></tr>
<tr><td style="height:20px;background:#A4A4F5"></td><td></td><td>Memory including read-only space (can be shared with other applications)</td></tr>

2
userguide/en/desktop-applets/workspaces.html
View File

@ -68,7 +68,7 @@
<p><br /></p>
<img src="../images/workspaces-images/workspaces.png" alt="workspaces.png" />
<p>You find the Workspaces applet with the other <span class="menu">Desktop applets</span> in the Deskbar. It shows a miniature version of all workspaces. There are several options available from the context menu of the applet's window, which are all pretty self-explaining.<br />
<span class="menu">Change workspace count...</span> will open the <a href="../preferences/screen.html">Screen</a> preferences where you set the number of workspaces and their arrangement (how many rows and columns).</p>
<span class="menu">Change workspace count…</span> will open the <a href="../preferences/screen.html">Screen</a> preferences where you set the number of workspaces and their arrangement (how many rows and columns).</p>
<p>Since the applet is a <a href="../gui.html#replicants">Replicant</a>, you can resize the window as desired and then drag &amp; drop it by its handle onto the desktop (make sure <span class="menu">Show replicants</span> is activated in the Deskbar menu). Hold <span class="key">SHIFT</span> while resizing to keep your screen's aspect ratio.</p>
<h2>

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

@ -145,7 +145,7 @@ Files that you'd like to share with other users in a future multi-user environme
<tr><td align="right"><span class="path">Go/</span></td><td></td><td>Put links to your favorite locations in here to make them available e.g. in open and save panels. See topic <a href="gui.html#favorites-recent">Haiku's GUI: Favorites and recent folders</a>.</td></tr>
<tr><td align="right"><span class="path">Tracker New Template/</span></td><td></td><td>Add a template for any filetype that's then available from Tracker's <span class="menu">File | New...</span> menu. See topic <a href="tracker.html#working-with-files">Tracker: Working with files</a>.</td></tr>
<tr><td align="right"><span class="path">Tracker New Template/</span></td><td></td><td>Add a template for any filetype that's then available from Tracker's <span class="menu">File | New…</span> menu. See topic <a href="tracker.html#working-with-files">Tracker: Working with files</a>.</td></tr>
</table>
</div>

8
userguide/en/filetypes.html
View File

@ -75,8 +75,8 @@
<a name="filetype" id="filetype">The File Type</a></h3>
<p>The above is a PNG file, its MIME string image/png. Let's say you definitely know that it's not a PNG 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> </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> </td><td>opens a file dialog where you choose any file that already has the filetype you're looking for.</td></tr>
<tr><td><span class="button">Select…</span></td><td> </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> </td><td>opens a file dialog where you choose any file that already has the filetype you're looking for.</td></tr>
</table>
<h3>
@ -84,7 +84,7 @@
<a id="preferred-app" name="preferred-app">The Preferred Application</a></h3>
<p>This pop-up 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 pop-up 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>
<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 pop-up 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 href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
@ -105,7 +105,7 @@
<tr><td><span class="menu">Args only</span></td><td> </td><td>Indicates the app doesn't respond to messages.</td></tr>
<tr><td><span class="menu">Background app</span></td><td> </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>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>
<h2>

2
userguide/en/gui.html
View File

@ -144,7 +144,7 @@ You can enter parent folders with the pop-up menu above the file listing.</p>
<a id="favorites-recent" name="favorites-recent">Favorites and recent folders</a></h3>
<p>The <span class="menu">Favorites</span> menu in open and save panels 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" />
<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 | Edit favorites...</span> and delete its entry.<br />
<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 | Edit favorites…</span> and delete its entry.<br />
All Favorites are kept in <span class="path">/boot/home/config/settings/Tracker/Go/</span>. So you might as well add and remove links to files and folders there directly.</p>
<h2>

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

@ -136,7 +136,7 @@
<tr><td><span class="key">ALT</span> + left click</td><td style="width:15px;"></td><td>Left-clicking on a path or URL while holding <span class="key">ALT</span> opens it in the preferred application, e.g. folders in Tracker, pictures in ShowImage. You can limit the selected path by additionally holding <span class="key">SHIFT</span>.</td></tr>
<tr><td><span class="key">ALT</span> <span class="key">N</span></td><td></td><td>Opens another Terminal session in a new window.</td></tr>
<tr><td><span class="key">ALT</span> <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> <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> <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> <span class="key">TAB</span></td><td></td><td>Switches to the next Terminal window.</td></tr>
<tr><td><span class="key">SHIFT</span> <span class="key">←</span> / <span class="key">→</span></td><td></td><td>Switches to the tab to the left/right.</td></tr>
<tr><td><span class="key">ALT</span> <span class="key">SHIFT</span> <span class="key">←</span> / <span class="key">→</span></td><td></td><td>Moves the current tab left/right.</td></tr>

2
userguide/en/preferences/appearance.html
View File

@ -94,7 +94,7 @@
<a id="decorators" name="decorators">Window decorators</a></h2>
<img src="../images/prefs-images/appearance-decorators.png" alt="appearance-decorators.png" />
<p>Decorators determine the look and feel of windows and all GUI elements. Currently Haiku comes with only one default decorator. Should you find and install other decorators, you can choose a different one from the pop-up menu.</p>
<p>Haiku's default decorator lets you set the arrow style of the scroll bar: either single arrows at the end of scrollbars to conserve a bit of space, or double arrows — the traditional BeOS way — potentially saving some mouse moving when scrolling up and down or left and right...</p>
<p>Haiku's default decorator lets you set the arrow style of the scroll bar: either single arrows at the end of scrollbars to conserve a bit of space, or double arrows — the traditional BeOS way — potentially saving some mouse moving when scrolling up and down or left and right…</p>
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>

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

@ -70,7 +70,7 @@
<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>
<p><br /></p>
<img src="../images/prefs-images/datatranslations.png" alt="datatranslations.png" />
<p>Depending on its capabilities, each Translator offers different settings. At least you'll get an <span class="button">Info...</span> button that opens a window with the credits and the installation path.<br />
<p>Depending on its capabilities, each Translator offers different settings. At least you'll get an <span class="button">Info…</span> button that opens a window with the credits and the installation path.<br />
The following table gives an overview of the default Translators and their most useful options.</p>
<table summary="translators" border="0" cellpadding="2" cellspacing="0">
<tr><td><span class="menu">Apple icons</span></td><td>Valid image sizes are 16, 32, 48, 128, 256, 512, 1024 (RGB32 and RGBA32)</td></tr>

21
userguide/en/preferences/e-mail.html
View File

@ -4,7 +4,7 @@
<head>
<!--
*
* Copyright 2008-2011, Haiku. All rights reserved.
* Copyright 2008-2023, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@ -91,8 +91,7 @@ You start by clicking the <span class="button">Add</span> button to create a new
<p>Now you enter your <i>E-mail address</i>, <i>Login name</i> and <i>Password</i>, give an <i>Account name</i> under which it will be known under Haiku and your <i>Real name</i>.</p>
<p>If your account is from a major e-mail provider, Haiku already knows all technical details like server IP addresses. If that is not the case, clicking <span class="button">Next</span> will open another window to enter this information by hand:</p>
<img src="../images/prefs-images/e-mail-new-account-2.png" alt="e-mail-new-account-2.png" />
<p>You first set the <i>Server name</i>, <i>Login type</i> and <i>Connection type</i> for the incoming mail, below that for the outgoing mail. You should find the necessary information on your email provider's website.<br />
See below for more info about the various settings and additional options.</p>
<div class="box-info">If you use GMail as your e-mail provider, you'll have to create a special app password.<br />See Google's support page on how to <a href="https://support.google.com/mail/answer/185833">Sign in with app passwords</a>.</div>
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
@ -108,7 +107,7 @@ See below for more info about the various settings and additional options.</p>
<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" />
<p>First is the <span class="menu">Mail server</span> address for incoming mails. If your provider needs you to log into a specific port, you add that to the address, separated by a colon. For example, <tt>pop.your-provider.org:1400</tt>.</p>
<p>Then you enter your login information, <i>Login name</i> and <i>Password</i>, and if necessary change the <i>Login type</i> from the default <span class="menu">Plain text</span> to <span class="menu">APOP</span> for authentication.</p>
<p>Then you enter your login information, <i>Username</i> and <i>Password</i>, and if necessary change <i>Connection type</i> from <span class="menu">No encryption</span> to <span class="menu">SSL</span> and the <i>Login type</i> from the default <span class="menu">Plain text</span> to <span class="menu">APOP</span> for authentication.</p>
<p>If you use <i>POP3</i> and retrieve mails of this account from different computers, you may want to activate the option to <span class="menu">Leave mail on server</span> and only <span class="menu">Remove mail from server when deleted</span> locally.</p>
<p>If you use <i>IMAP</i> instead, you have the option to <span class="menu">Remove mail from server when deleted</span> locally. You can specify <span class="menu">IMAP folders</span> to only synchronize with a specific folder and its subfolders.</p>
<p>Also, you can opt to only <span class="menu">Partially download messages larger than</span> 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>
@ -120,7 +119,7 @@ See below for more info about the various settings and additional options.</p>
<a id="outgoing" name="outgoing">More on setting up outgoing e-mail</a></h2>
<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" />
<p>First 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>First 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> and change <i>Username</i>, <i>Password</i> and <i>Connection type</i>.</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>
<p>As with incoming mail, you can also change the <i>Destination</i> of your outbox (default: <span class="path">/boot/home/mail/out/</span>).</p>
@ -207,15 +206,13 @@ Outgoing Mail Filters</h3>
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="settings" name="settings">Setting up the Mail Service</a></h2>
<p>Now that your incoming and outgoing mail servers (and maybe some filters, too), are configured, you have to tell the Mail Service that does all the actual checking and fetching how to do its job.</p>
<p>Now that your incoming and outgoing mail servers (and maybe some filters, too), are configured, the Mail Service that does all the actual checking and fetching needs to know how to do its job.</p>
<img src="../images/prefs-images/e-mail-settings.png" alt="e-mail-settings.png" />
<p>Under <i>Mail checking</i> you configure the interval at which the account's mail server is probed for new mail.<br />
If you're on a dial-up connection, you may want to do that <span class="menu">Only when dial-up is connected</span> and also <span class="menu">Schedule outgoing mail when dial-up is disconnected</span> to avoid dialing automatically in regularly only to check for mail.</p>
<p>The Mail Service has a status window which you can set to show up <span class="menu">Never</span>, <span class="menu">While sending</span>, <span class="menu">While sending and receiving</span> or <span class="menu">Always</span>.</p>
<p>Make sure to <span class="menu">Start mail services on startup</span> or there will be no mail_daemon running to do your bidding...</p>
<p>After ticking the checkmark, you can configure the interval at which the account's mail server is probed for new mail.</p>
<p>The Mail Service can trigger notifications that can be set to show up <span class="menu">Never</span>, <span class="menu">While sending</span> or <span class="menu">While sending and receiving</span>.</p>
<p><span class="menu">Edit mailbox menu…</span> will open the folder <span class="path">/boot/home/config/Mail/Menu Links/</span>. All folders or queries (!) or their links put into this folder will appear in the context menu of the mailbox icon of the Mail Services in the Deskbar tray.</p>
<p>From that context menu, you can also <span class="menu">Create new message…</span>, <span class="menu">Check for mail now</span> or edit <span class="menu">Settings…</span>:</p>
<img src="../images/prefs-images/e-mail-mailbox.png" alt="e-mail-mailbox.png" />
<p><span class="menu">Edit mailbox menu...</span> will open the folder <span class="path">/boot/home/config/Mail/Menu Links/</span>. All folders or queries (!) or their links put into this folder will appear in the context menu of the mailbox icon of the Mail Services in the Deskbar tray.</p>
<p>From that menu, you can also <span class="menu">Create new message...</span>, <span class="menu">Check for mail now</span> or edit <span class="menu">Preferences...</span>.</p>
<p>If you hold down <span class="key">SHIFT</span> when invoking the context menu, you'll get additional commands:</p>
<table summary="notofications" border="0" cellpadding="2" cellspacing="0">
<tr><td><span class="menu">Check for mails only</span></td><td style="width:5px;"> </td>

2
userguide/en/preferences/input.html
View File

@ -95,7 +95,7 @@
<img src="../images/prefs-images/mouse.png" alt="mouse.png" />
<p>First you set your type of mouse: 1, 2 or 3 button mouse. You can simulate the 2nd (=right) mouse button by holding down <span class="key">CTRL</span> while left-clicking. For the 3rd (=middle) mouse button, it's <span class="key">CTRL</span> <span class="key">ALT</span> and a left-click.</p>
<p>You can rearrange the mouse buttons by clicking on them and choosing their new meaning from the pop-up menu.</p>
<p>With the sliders to the right, you adjust double-click speed, mouse speed and acceleration. The test area below the mouse graphics can be used to check if the double-click speed meets your taste: if double-clicking a word doesn't select it, it's set too fast (or you'll have to get used to clicking quicker...).</p>
<p>With the sliders to the right, you adjust double-click speed, mouse speed and acceleration. The test area below the mouse graphics can be used to check if the double-click speed meets your taste: if double-clicking a word doesn't select it, it's set too fast (or you'll have to get used to clicking quicker…).</p>
<p>There are three <span class="menu">Focus modes</span> that determine how windows react to clicks:</p>
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
<tr><td class="onelinetop"><span class="menu">Click to focus and raise</span></td><td width="15px"> </td><td>This is the default setting: you click a window and it gets focus and is raised to the top.</td></tr>

12
userguide/en/preferences/keymap.html
View File

@ -70,24 +70,24 @@
<p><br /></p>
<img src="../images/prefs-images/keymap.png" alt="keymap.png" />
<p>To the right, the Keymap window shows a representation of your keyboard. When you press a key, the corresponding key is darkened and the assigned symbol is entered into the <i>Sample and Clipboard</i> text field at the bottom. From there you can also copy and paste it into a document.<br />
Thus, the Keymap preferences are not only for configuring your local keymap, but are also useful when looking for a special symbol used in other languages. For example, you can switch the keymap to "French", find the "ç" and copy it into your mail to François. (Though you'll find the "cedil" also in other keymaps...)</p>
Thus, the Keymap preferences are not only for configuring your local keymap, but are also useful when looking for a special symbol used in other languages. For example, you can switch the keymap to "French", find the "ç" and copy it into your mail to François. (Though you'll find the "cedil" also in other keymaps…)</p>
<p>Pressing modifier keys like <span class="key">SHIFT</span>, <span class="key">CONTROL</span> or <span class="key">OPTION</span> changes the displayed keyboard accordingly.</p>
<p>Then there are the keys that are marked with a blue background. These keys are called <i>Dead Keys</i> that can change the key you press after that. If you click on such a blue key with your mouse, those changeable keys light up yellow. Click again and everything's back to normal. Examples are é, ñ, ó or ë.</p>
<p>Below the keyboard representation are two more options:</p>
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
<tr><td><span class="menu">Select dead keys</span></td><td> </td><td>for setting the above mentioned blue keys.</td></tr>
<tr><td class="onelinetop"><span class="menu">Switch shortcut key...</span></td><td> </td><td>for using the shortcut key in Windows/Linux mode, i.e. <span class="key">CONTROL</span> (normally <span class="key">CTRL</span>) or Haiku mode, i.e. <span class="key">COMMAND</span> (normally <span class="key">ALT</span>).</td></tr>
<tr><td class="onelinetop"><span class="menu">Switch shortcut key…</span></td><td> </td><td>for using the shortcut key in Windows/Linux mode, i.e. <span class="key">CONTROL</span> (normally <span class="key">CTRL</span>) or Haiku mode, i.e. <span class="key">COMMAND</span> (normally <span class="key">ALT</span>).</td></tr>
</table>
<p>The lists on the left offer the available pre-configured keymaps of the system, and below that, if available, user-defined maps. You can change a keymap in the keyboard representation: drag &amp; drop one key on another and they switch places.</p>
<p>You can also create an individual mapping by drag &amp; dropping a character from another app onto the key. For example, you could extend your regular keymap with often used currency symbols. Just click on the <span class="key">CONTROL</span> key and drag &amp; drop the pound symbol from CharacterMap onto the 'P' key to get a ₤ when you press <span class="key">CTRL</span> <span class="key">P</span>.
<br />
By right-clicking a normal key, the context menu offers to <span class="menu">Remove</span> its mapping. Modifier keys can have alternative mappings, like using <span class="key">CAPS LOCK</span> as <span class="key">CTRL</span> key:</p>
<img src="../images/prefs-images/keymap-context.png" alt="keymap-context.png" />
<p>Alternatively to this or drag &amp; dropping of keys, there's the menu <span class="menu">File | Set modifier keys...</span> that opens this window:</p>
<p>Alternatively to this or drag &amp; dropping of keys, there's the menu <span class="menu">File | Set modifier keys…</span> that opens this window:</p>
<img src="../images/prefs-images/keymap-modifiers.png" alt="keymap-modifiers.png" />
<p>Here, you can assign keys to their respective roles or even completely disable the role of a key. You can even assign the same key to different roles, though that's not a good idea most of the time and you'll be warned by a small exclamation mark beside the pop-up menus if you do that.<br />
Pressing <span class="button">Set modifier keys</span> applies your changes and closes the window.</p>
<p>When you're done you can save the result from the menu <span class="menu">File | Save...</span>. Your modified map will only appear in the user-defined list if it's stored in <span class="path">~/config/settings/Keymap/</span>. Otherwise you'll have to manually load it via <span class="menu">File | Open...</span>.</p>
<p>When you're done you can save the result from the menu <span class="menu">File | Save…</span>. Your modified map will only appear in the user-defined list if it's stored in <span class="path">~/config/settings/Keymap/</span>. Otherwise you'll have to manually load it via <span class="menu">File | Open…</span></p>
<p>To better match the Keymap panel to your physical keyboard, there are several different settings available from the <span class="menu">Layout</span> menu.</p>
<p>The font used in the keyboard representation is set from the <span class="menu">Font</span> menu. Note, that it may or may not contain all symbols for a specific keymap.</p>
<p>Finally, there's a <span class="button">Revert</span> button to bring back the settings that were active when you started the Keymap preferences.</p>
@ -99,13 +99,13 @@ Pressing <span class="button">Set modifier keys</span> applies your changes and
<p>There's another method to customize your keymap besides the Keymap preference panel. It involves editing a text file containing loads of hex values, which may appear daunting on first sight, but isn't really that impossible to grasp.</p>
<p>You can dump the current keymap with a command in Terminal:</p>
<pre class="terminal">keymap -d &gt; MyKeymap</pre>
<p>The generated text file can then be opened in a text editor. Make sure to use a fixed font in that editor or you'll never grok that file...<br />
<p>The generated text file can then be opened in a text editor. Make sure to use a fixed font in that editor or you'll never grok that file…<br />
At the beginning of that file, you'll find a legend of a stylized keyboard with the hex value corresponding to each key. Below that are the actual assignments of every value. You can do all the customizing that's also available from the Keymap preference panel, and then some. If you happen to have some special keys on your keyboard, you may be able to activate them. That is, use them as ordinary keys or like an option or control key. You won't be able to, for example, have your multimedia keys de/increase the volume or start some application. For this you can use the <a href="shortcuts.html">Shortcuts</a> preferences.</p>
<p>When you're finished, you'll save the file and have your system load the modified keymap with this command:</p>
<pre class="terminal">keymap -s &lt; MyKeymap</pre>
<p>If you'd like to import this keymap into the Keymap panel, you have to compile it first to a binary format:</p>
<pre class="terminal">keymap -c &lt; MyKeymap</pre>
<p>This will produce a file <span class="cli">keymap.out</span> which you can load into Keymap via its <span class="menu">Open...</span> menu. By the way, the keymap command is able to load this binary format as well: <span class="cli">keymap -l &lt; keymap.out</span></p>
<p>This will produce a file <span class="cli">keymap.out</span> which you can load into Keymap via its <span class="menu">Open…</span> menu. By the way, the keymap command is able to load this binary format as well: <span class="cli">keymap -l &lt; keymap.out</span></p>
<p>This is the dumped file (the rightmost keys of the stylized keyboard are cut-off for a nicer display on this page):</p>
<pre>#!/bin/keymap -s

2
userguide/en/preferences/media.html
View File

@ -140,7 +140,7 @@ Use the checkmark to <span class="menu">Mute</span> a stream.</p>
<tr><td><span class="menu">Input</span></td><td> </td><td>sets the input levels for line-in and microphone.</td></tr>
</table>
<p>It has to be said that these hardware level settings can appear a bit haphazard...<br />
<p>It has to be said that these hardware level settings can appear a bit haphazard…<br />
Haiku probes the hardware and tries to make sense of what it gets back. You may see various duplicate sliders with the same label etc. You'll have to experiment a bit to find the one you're looking for.</p>
<h2>

2
userguide/en/preferences/network.html
View File

@ -100,7 +100,7 @@ Once a WLAN is selected, Haiku will try to connect to it automatically on every
<h2>Settings files</h2>
<p>The network settings are found in the folder <span class="path">/system/settings/network/</span>. Normally you don't have to care about those, other than maybe having to delete them to begin with a clean slate after things have gone terribly wrong...</p>
<p>The network settings are found in the folder <span class="path">/system/settings/network/</span>. Normally you don't have to care about those, other than maybe having to delete them to begin with a clean slate after things have gone terribly wrong…</p>
<p>One file however can be really useful, especially when working from the Terminal. The <tt>hosts</tt> file lets you define aliases to specific IP addresses in the network. For example:</p>
<pre>127.0.0.1 localhost #loopback
192.168.178.3 NAS #Synology

2
userguide/en/preferences/sounds.html
View File

@ -71,7 +71,7 @@
<p>You can assign sounds to certain events in the system. Just select the event from the list and choose a sound from the pop-up menu below.</p>
<table summary="quickinfo" border="0" cellspacing="0" cellpadding="2">
<tr><td><span class="menu">None</span></td><td> </td><td>will silence an event.</td></tr>
<tr><td><span class="menu">Other...</span></td><td> </td><td>will open a file panel to find a new sound that isn't yet in the menu.</td></tr></table>
<tr><td><span class="menu">Other…</span></td><td> </td><td>will open a file panel to find a new sound that isn't yet in the menu.</td></tr></table>
<p>You can use any format that's supported by the system. If <a href="../applications/mediaplayer.html">MediaPlayer</a> can deal with it, so can any other program.<br />
You can "pre-hear" an event's sound by selecting it and using the <span class="button">Play</span> and <span class="button">Stop</span> buttons.</p>

2
userguide/en/preferences/virtualmemory.html
View File

@ -69,7 +69,7 @@
<p>Virtual memory lets the system swap out memory to the harddisk, if the RAM can be used more sensibly for other things. So, even if you have lots of RAM, providing virtual memory is never a bad idea.</p>
<img src="../images/prefs-images/virtualmemory.png" alt="virtualmemory.png" />
<p>Normally, the swap file is written to the boot partition. If you're running low on free memory there, you can deactivate the <span class="menu">Automatic swap management</span> and choose another mounted partition from the popup menu. The swap file size is set with the slider below.<br />
If you often run into disk thrashing due to the virtual memory system swapping memory in and out, you can try to use a separate harddisk for you swap file to avoid I/O congestion. Simply another partition on the same harddisk with your system/data won't help. Upgrading your RAM is of course the most effective way to go...</p>
If you often run into disk thrashing due to the virtual memory system swapping memory in and out, you can try to use a separate harddisk for you swap file to avoid I/O congestion. Simply another partition on the same harddisk with your system/data won't help. Upgrading your RAM is of course the most effective way to go…</p>
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
<tr><td><span class="button">Defaults</span></td><td> </td><td>resets everything to default values.</td></tr>
<tr><td><span class="button">Revert</span></td><td> </td><td>brings back the settings that were active when you started the VirtualMemory preferences.</td></tr>

2
userguide/en/queries.html
View File

@ -81,7 +81,7 @@ Even better, you don't have to double-click to re-do a query. You can <a href="t
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="find-window" name="find-window">The Find window</a></h2>
<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> <span class="key">F</span>. You're presented with the Find window:</p>
<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> <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" />
<ol>
<li><p>Select recent or saved queries or save the current search parameters as <a href="#query-template">Query Template</a>.</p></li>

14
userguide/en/tracker.html
View File

@ -135,13 +135,13 @@ This type-ahead filtering is set in the <a href="#tracker-preferences.html">Trac
<p>The <span class="menu">Window</span> menu offers a number of other functions:</p>
<ul>
<li><p><span class="menu">Resize to fit</span> (<span class="key">ALT</span> <span class="key">Y</span>) - Resizes the window to its ideal size.</p></li>
<li><p><span class="menu">Arrange by...</span> - Only available in Icon or Mini icon view, a submenu allows to set the sorting order to various properties:</p>
<li><p><span class="menu">Arrange by…</span> - Only available in Icon or Mini icon view, a submenu allows to set the sorting order to various properties:</p>
<ul>
<li><p><span class="menu">Name</span>, <span class="menu">Real name</span>, <span class="menu">Size</span>, <span class="menu">Modified</span>, <span class="menu">Created</span>, <span class="menu">Kind</span>, <span class="menu">Location</span>, <span class="menu">Permissions</span></p></li>
<li><p><span class="menu">Reverse order</span> - Inverts the sorting order</p></li>
<li _translation_id="4339"><p><span class="menu">Clean up</span> (<span class="key">ALT</span> <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 according to the above selected criterium.</p></li>
</ul></li>
<li><p><span class="menu">Select...</span> (<span class="key">SHIFT</span> <span class="key">ALT</span> <span class="key">A</span>) - Select files according to a <a href="http://en.wikipedia.org/wiki/Regular_expression" class="external free" title="Wikipedia: Regular expression">regular expression</a>.</p></li>
<li><p><span class="menu">Select…</span> (<span class="key">SHIFT</span> <span class="key">ALT</span> <span class="key">A</span>) - Select files according to a <a href="http://en.wikipedia.org/wiki/Regular_expression" class="external free" title="Wikipedia: Regular expression">regular expression</a>.</p></li>
<li><p><span class="menu">Close</span> (<span class="key">ALT</span> <span class="key">W</span>) - Closes the window. Hold down <span class="key">SHIFT</span> and the menu becomes <span class="menu">Close all</span> which closes every Tracker window.</p></li>
<li><p><span class="menu">Close all in workspace</span> (<span class="key">ALT</span> <span class="key">Q</span>) - Closes every Tracker window in the current workspace. A useful shortcut if you forgot to hold the <span class="key">OPT</span> key while clicking through folders and all those still open Tracker windows clutter your workspace.</p></li>
</ul>
@ -154,7 +154,7 @@ This type-ahead filtering is set in the <a href="#tracker-preferences.html">Trac
<h3>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="tracker-preferences" name="tracker-preferences">Tracker preferences</a></h3>
<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.
<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>
<li><p><span class="menu">Desktop</span> - Decide if all mounted disks appear directly on the Desktop or in a window after clicking a single Disk icon sitting on the Desktop.</p></li>
@ -176,16 +176,16 @@ This type-ahead filtering is set in the <a href="#tracker-preferences.html">Trac
<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><span class="menu">Find...</span> - Find a file or folder. See topic <a href="queries.html">Query</a> for more info.</p></li>
<li><p><span class="menu">Find…</span> - Find a file or folder. See topic <a href="queries.html">Query</a> for more info.</p></li>
<li><p><span class="menu">New</span> - Create a new folder or any other file based on a <i>template</i>.
</p>
<img src="images/tracker-images/new-menu.png" alt="new-menu.png" />
<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><span class="menu">Open with...</span> - A submenu offers all applications that can handle this filetype.
<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><span class="menu">Open with…</span> - A submenu offers all applications that can handle this filetype.
</p>
<img src="images/tracker-images/open-with.png" alt="open-with.png" />
<p>The preferred application that would open the file when double-clicked, is checkmarked. This submenu lists first those applications that can handle the exact filetype, in this case it's a text file, the type <tt>text/plain</tt>. Next come all applications that can handle that supertype in general, here <tt>text/*</tt>. Last in the list are those that can deal with any file. If you don't click on an app in the submenu, but on the <span class="menu">Open with...</span> entry instead, a panel opens:</p>
<p>The preferred application that would open the file when double-clicked, is checkmarked. This submenu lists first those applications that can handle the exact filetype, in this case it's a text file, the type <tt>text/plain</tt>. Next come all applications that can handle that supertype in general, here <tt>text/*</tt>. Last in the list are those that can deal with any file. If you don't click on an app in the submenu, but on the <span class="menu">Open with…</span> entry instead, a panel opens:</p>
<img src="images/tracker-images/open-with-preferred.png" alt="open-with-preferred" />
<p>Here you'll again find the programs that were listed in the submenu. By selecting one and clicking the <span class="button">Open and make preferred</span> button, you changed the preferred application for every file of that filetype, here <tt>text/plain</tt>.</p></li>

8
userguide/en/workshop-email.html
View File

@ -100,18 +100,18 @@ Also, improvements in any of these system areas benefit not just emailing, but a
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="status" name="status">Using custom statuses</a></h2>
<p>When you browse through your newly arrived email, you may want to come back to some of them later to think about it in more depth. While you could use Mail's menu <span class="menu">Close and | Leave as New</span> to keep them in your "<i>New messages</i>" query, things tend to pile up that way...</p>
<p>When you browse through your newly arrived email, you may want to come back to some of them later to think about it in more depth. While you could use Mail's menu <span class="menu">Close and | Leave as New</span> to keep them in your "<i>New messages</i>" query, things tend to pile up that way…</p>
<p>One solution is of course to just start a reply and save it as draft. But if you don't expect to write a reply and just want to re-read the mail later, that isn't ideal.</p>
<img src="images/workshop-email-images/status.png" alt="status.png" />
<p>Better use <span class="menu">Close and | Set to...</span> to create a new status and use that to categorize your mail. For example, you could call the status "<i>Later</i>", and then query for that when you find more time.<br />
<p>Better use <span class="menu">Close and | Set to…</span> to create a new status and use that to categorize your mail. For example, you could call the status "<i>Later</i>", and then query for that when you find more time.<br />
Or you use different statuses for specific projects. For example, I created a status "<i>HUG</i>" (for "Haiku user guide") under which I collect every mail that may influence the contents of the user guide, like commit messages about code changes that alter or introduce some feature or anything else I feel could improve the user guide.<br />
In any case, try to keep the status name short. That way it always fits in a normally wide "Status" column in Tracker.</p>
<p>You don't have to open an email with the <span class="app">Mail</span> application to set its status. With the Tracker add-ons <span class="app">Mark as Read </span> and <span class="app">Mark as...</span> you can select some email files and set their status in one go.</p>
<p>You don't have to open an email with the <span class="app">Mail</span> application to set its status. With the Tracker add-ons <span class="app">Mark as Read </span> and <span class="app">Mark as…</span> you can select some email files and set their status in one go.</p>
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="queries" name="queries">Using queries</a></h2>
<p>Sure, you specify a folder to store all your email, you can open it et voilà, there's all you mail. But over time the folder becomes crowded and showing all will take longer and longer as thousands of files and their attributes have to be parsed and sorted. Also, most of the time you don't really care about two year old emails of Nigerian princes and their inheritory trouble ...</p>
<p>Sure, you specify a folder to store all your email, you can open it et voilà, there's all you mail. But over time the folder becomes crowded and showing all will take longer and longer as thousands of files and their attributes have to be parsed and sorted. Also, most of the time you don't really care about two year old emails of Nigerian princes and their inheritory trouble…</p>
<div class="box-info">A lot of time when populating a folder is spent on putting files read from disk into the correct sorting order and displaying that in the window. If you do have to open a folder with a huge number of files, you can shorten the wait by making the Tracker window "invisible", i.e. either minimize it or change to another workspace. Watch <a href="desktop-applets/processcontroller.html">ProcessController</a> to see how it affects CPU usage.</div>
<p><a href="queries.html">Queries</a>, to the rescue!</p>
<p>By using queries, you can narrow down the view of your mails. Actually, the mailbox icon in the Deskbar uses queries.</p>

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

@ -96,13 +96,13 @@ In any case, to these files we add a couple of attributes. Here we have to decid
<li>Plot</li>
<li>My rating from 1 to 10</li>
<li>Coordinates in my shelf, e.g. A2, B3, so I find the DVD also in Real Life :)</li>
<li>If so, who's borrowed the disk...</li>
<li>If so, who's borrowed the disk…</li>
</ul>
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="custom-filetype" name="custom-filetype">Creating a custom filetype</a></h2>
<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>
<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" />
<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" />
@ -130,14 +130,14 @@ In any case, to these files we add a couple of attributes. Here we have to decid
<a id="pref_app" name="pref_app">Preferred application</a></h3>
<p>This pop-up 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> </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> </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>
<tr><td><span class="button">Select…</span></td><td> </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> </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 href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="extra_attribute" name="extra_attribute">Extra attributes</a></h3>
<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 to enter all the data for the new attribute. You can edit an existing attribute with a double-click.</p>
<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 to enter all the data for the new attribute. You can edit an existing attribute with a double-click.</p>
<img src="images/workshop-filetypes+attributes-images/filetype-extra-attribute.png" alt="filetype-extra-attribute.png" />
<ul>
<li><p><i>Attribute name</i> - Appears e.g. as the column heading in Tracker windows.</p></li>
@ -218,12 +218,12 @@ Since our basic file is a cover image, we go to some online resource like IMdB,
<img src="images/workshop-filetypes+attributes-images/filetypes-dvddb-empty.png" alt="filetypes-dvddb-empty.png" />
<p>By clicking on a yet empty attribute (or pressing <span class="key">ALT</span> <span class="key">E</span>) we enter editing mode and fill each attribute. With <span class="key">TAB</span> and <span class="key">SHIFT</span> <span class="key">TAB</span> you can navigate between attributes.</p>
<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>
<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 href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="query-db" name="query-db">Querying the database</a></h2>
<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>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 layout</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; in our case "application_DVDdb".</p>

2
userguide/en/workshop-wlan.html
View File

@ -99,7 +99,7 @@ ArcorInternet123 00:20:12:a4:29:e1 15 WPA</pre>
The output shows the public name (SSID), MAC address, signal strength and authentication method of all found networks.</p>
<p>To join a network, use this line and insert the respective public name (SSID) and password:</p>
<pre class="terminal">ifconfig /dev/net/iprowifi3945/0 join {SSID} {password}</pre>
<p>Make sure the initial configuration of the wireless network adapter after booting up has finished, before issuing <tt>ifconfig</tt> commands or they might be ignored. Depending on your hardware and network configuration that may take a while. Watch those notifications...</p>
<p>Make sure the initial configuration of the wireless network adapter after booting up has finished, before issuing <tt>ifconfig</tt> commands or they might be ignored. Depending on your hardware and network configuration that may take a while. Watch those notifications…</p>
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>

2
userguide/eo/applications/bepdf.html
View File

@ -74,7 +74,7 @@
</table>
<p><br /></p>
<p>BePDF is a fast launching PDF viewer. Besides viewing, it supports annotating and user-defined bookmarking for unencrypted PDFs. It's fully localized for 20 languages at the moment with additional languages being easily added via text files.</p>
<p>Documentation is available as <a href="file:///boot/system/apps/BePDF/docs/English/table_of_contents.html">HTML</a> or <a href="file:///boot/system/apps/BePDF/docs/English.pdf">PDF</a>. The latter will also open from the menu <span class="menu">Help | Show Help...</span>.</p>
<p>Documentation is available as <a href="file:///boot/system/apps/BePDF/docs/English/table_of_contents.html">HTML</a> or <a href="file:///boot/system/apps/BePDF/docs/English.pdf">PDF</a>. The latter will also open from the menu <span class="menu">Help | Show Help…</span></p>
</div>
</div>

2
userguide/eo/applications/cli-apps.html
View File

@ -104,7 +104,7 @@ Would you like a link to it?" "On Desktop" "In Deskbar" "No thanks"</pre>
<p><img src="../images/apps-images/cli-filepanel.png" alt="cli-filepanel.png" /></p>
</td></tr>
<tr><td><p><span class="cli">hey</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">hey</span> is a littler helper tool that sends BMessages to applications and prints out their answer. It can be used for application scripting, i.e. "remote controlling" a program from a script or the command line. Its usage is a bit complex... <a href="https://www.haiku-os.org/blog/humdinger/2017-11-05_scripting_the_gui_with_hey/">Humdinger's blog post</a> serves as a good introduction, and thanks to Scot Hacker's BeOS Bible, there is a much more comprehensive <a href="http://www.birdhouse.org/beos/bible/bos/ch_scripting6.html">hey tutorial</a> by Chris Herborth.</p>
<td valign="top"><p><span class="cli">hey</span> is a littler helper tool that sends BMessages to applications and prints out their answer. It can be used for application scripting, i.e. "remote controlling" a program from a script or the command line. Its usage is a bit complex… <a href="https://www.haiku-os.org/blog/humdinger/2017-11-05_scripting_the_gui_with_hey/">Humdinger's blog post</a> serves as a good introduction, and thanks to Scot Hacker's BeOS Bible, there is a much more comprehensive <a href="http://www.birdhouse.org/beos/bible/bos/ch_scripting6.html">hey tutorial</a> by Chris Herborth.</p>
</td></tr>
<tr><td><p><span class="cli">notify</span></p></td><td style="width:10px;"> </td>
<td valign="top"><p><span class="cli">notify</span> shows a notification panel with a message. There are various parameters that are described when you call <span class="cli">notify --help</span>. A notification can also be used to show the progress of some action. When doing that, it's important to set a <i>messageID</i> and always use it when you update the progress (a float between 0.0 and 1.0 that's printed as percent). Otherwise you'll see several notification panels if you update quicker then the set timeout.<br />

2
userguide/eo/applications/diskusage.html
View File

@ -72,7 +72,7 @@
<p><br /></p>
<p>DiskUsage shows graphically how the space on your volumes is utilized.<br />
A useful tool to answer the question, "<i>Where has all my disk space gone?</i>".</p>
<p>After launching, DiskUsage shows only an empty window with all mounted volumes as tabs at the top. You'll have to choose the one you're interested in and click <span class="button">Scan</span> to start chugging through the disk. For larger disks this can take some time... While you wait, you may switch to a different tab and start exploring that volume or begin the scan process there as well.<br />
<p>After launching, DiskUsage shows only an empty window with all mounted volumes as tabs at the top. You'll have to choose the one you're interested in and click <span class="button">Scan</span> to start chugging through the disk. For larger disks this can take some time… While you wait, you may switch to a different tab and start exploring that volume or begin the scan process there as well.<br />
It's not recommended to start several concurrent scan processes on the same physical disk, as the constant repositioning of the heads of the drive will only extend the wait.</p>
<p><img id="diskusage" src="../images/apps-images/diskusage.png" alt="diskusage.png" /></p>
<p>The concentric circles represent different levels in the file system hierarchy. Above, the circle in the center represents the <span class="path">/boot/home/</span> folder. Each segment of the ring immediately outside that circle is a file or folder under <span class="path">/boot/home/</span>. Every segment farther outside brings you one level deeper in the file hierarchy. You may have to resize the window to accommodate very deep folders.</p>

2
userguide/eo/applications/drivesetup.html
View File

@ -108,7 +108,7 @@ Besides the familiar icons for harddisks, CD drives and USB sticks etc., there a
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="creating" name="creating">Creating a new partition</a></h2>
<p>When you found unformatted space on a drive, like the above <tt>&lt;empty&gt;</tt>, you can create a new partition in this space with <span class="menu">Partition | Create...</span>(<span class="key">ALT</span> <span class="key">C</span>).</p>
<p>When you found unformatted space on a drive, like the above <tt>&lt;empty&gt;</tt>, you can create a new partition in this space with <span class="menu">Partition | Create…</span>(<span class="key">ALT</span> <span class="key">C</span>).</p>
<img src="../images/apps-images/drivesetup-create.png" alt="drivesetup-create.png" />
<p>You're prompted with this dialog that lets you adjust the partition size and type. Choose <span class="menu">Be File System</span> if you want to use the partition for an Haiku installation or if you want to use all the interesting Haiku features with it, like attributes and queries. Note, that other operating systems might not be able to access such a partition.</p>
<p>The <span class="menu">Active partition</span> checkbox is only available if you have created a primary partition instead of just another logical partition within an extended one. You'll have to tick that checkbox if you plan to use that partition to boot a Haiku installation.</p>

2
userguide/eo/applications/expander.html
View File

@ -81,7 +81,7 @@ Just double-click an archive to see this simple interface:</p>
<p>You can toggle the display of the file listing by un/checking <span class="menu">Show contents</span> or pressing <span class="key">ALT</span> <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">Settings | Settings...</span> or <span class="key">ALT</span> <span class="key">S</span> opens a preference panel that offers some useful settings to adjust Expander's behavior.<br />
<p><span class="menu">Settings | Settings…</span> or <span class="key">ALT</span> <span class="key">S</span> opens a preference panel that offers some useful settings to adjust Expander's behavior.<br />
The options are all self-explanatory:</p>
<p><img id="preferences" src="../images/apps-images/expander-preferences.png" alt="expander-preferences.png" /></p>

12
userguide/eo/applications/haikudepot.html
View File

@ -137,15 +137,15 @@ In the middle are user comments with their nickname, the number of stars they ga
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="menu" name="menu">HaikuDepot and Show menu</a></h2>
<p>In the <span class="menu">HaikuDepot</span> menu at the top of the window, you'll find an item to <span class="menu">Refresh repositories</span>. This will request an up-to-date list of all available packages from the repositories.<br />
The second item is to <span class="menu">Manage repositories...</span>. It opens the <a href="../preferences/repositories.html">Repositories</a> preferences, to add/remove or disable and enable repositories.<br />
<span class="menu">Check for updates...</span> opens the <a href="../apps/softwareupdater.html">SoftwareUpdater</a> to search and install updated packages.<br />
<span class="menu">Settings...</span> opens a window with the currently only option: <span class="menu">Share anonymous usage data with HaikuDepotServer</span>. The data is used to, for example, increase a counter on how often a package is viewed and installed, which then can determine if a package is promoted to the "Featured packages" list.</p>
The second item is to <span class="menu">Manage repositories…</span>. It opens the <a href="../preferences/repositories.html">Repositories</a> preferences, to add/remove or disable and enable repositories.<br />
<span class="menu">Check for updates…</span> opens the <a href="../apps/softwareupdater.html">SoftwareUpdater</a> to search and install updated packages.<br />
<span class="menu">Settings…</span> opens a window with the currently only option: <span class="menu">Share anonymous usage data with HaikuDepotServer</span>. The data is used to, for example, increase a counter on how often a package is viewed and installed, which then can determine if a package is promoted to the "Featured packages" list.</p>
<p>Under <span class="menu">Show</span> you can choose to also display <span class="menu">Develop packages</span> and <span class="menu">Source packages</span> in the packages list. For the normal user those are of no interest and would only clutter the list. They are important, however, for people who need the libraries, headers etc. of a package to develop and compile programs depending on them.</p>
<p>Of more interest are the options to only show <span class="menu">Available packages</span> and <span class="menu">Installed packages</span>.</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="account" name="account">Creating a User Account</a></h2>
<p>To be able to rate a package, you need a user account at the <a href="http://depot.haiku-os.org">Haiku Depot Server</a> that serves all the packages and keeps track of ratings and user comments. You can create an account within the HaikuDepot application by clicking on the menu in the far right of the menu bar that shows your current status: <span class="menu">Not logged in</span>. Choosing <span class="menu">Log in...</span> opens a window with two tabs; one to enter your user name and password (once you have those) to log in, and the other to create a new account:</p>
<p>To be able to rate a package, you need a user account at the <a href="http://depot.haiku-os.org">Haiku Depot Server</a> that serves all the packages and keeps track of ratings and user comments. You can create an account within the HaikuDepot application by clicking on the menu in the far right of the menu bar that shows your current status: <span class="menu">Not logged in</span>. Choosing <span class="menu">Log in…</span> opens a window with two tabs; one to enter your user name and password (once you have those) to log in, and the other to create a new account:</p>
<img src="../images/apps-images/haikudepot-login-tab.png" alt="haikudepot-login-tab.png" />
<p>To create an account you need to:</p>
<ul><li>use an all lower-case user name without special characters</li>
@ -153,8 +153,8 @@ The second item is to <span class="menu">Manage repositories...</span>. It opens
<li>provide a valid email address (if you want a new password sent to you in case you forgot it)</li>
<li>solve the captcha</li>
<li>tick the checkboxes to confirm you're over 16 and have read the usage conditions linked below them.</li></ul>
<p>After logging in, the top-right menu of the HaikuDepot window will now say <span class="menu">Logged in as (...)</span>, showing your user name. The menu now offers you to <span class="menu">Switch account...</span> or <span class="menu">Log out</span>.</p>
<p>As a reminder of what you actually agreed to when you ticked the above mentioned checkbox, there are menu items to <span class="menu">View latest/agreed usage conditions...</span></p>
<p>After logging in, the top-right menu of the HaikuDepot window will now say <span class="menu">Logged in as (…)</span>, showing your user name. The menu now offers you to <span class="menu">Switch account...</span> or <span class="menu">Log out</span>.</p>
<p>As a reminder of what you actually agreed to when you ticked the above mentioned checkbox, there are menu items to <span class="menu">View latest/agreed usage conditions…</span></p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="rating" name="rating">Rating and Commenting</a></h2>

8
userguide/eo/applications/icon-o-matic.html
View File

@ -244,7 +244,7 @@ If not, "Freeze transformation" will apply the current shape transformation to t
With the LOD you control the visibility of a shape depending on its size. That way, you can leave away details of an icon that look good on a bigger icon, but maybe not so much on its smaller version.</p>
<p>This is how it works: A LOD of 1.0 is defined as a 64px icon size. To get the LOD of a particular icon size you simply divide it by 64, e.g. a 16px icon has a LOD of 16/64 = 0.25. A shape won't be visible below its <span class="menu">Min LOD</span> and above its <span class="menu">Max LOD</span>.</p>
<p>So, if you set a shape's <span class="menu">Min LOD</span> to 0.0 and the <span class="menu">Max LOD</span> to 0.5, this means that the shape will only be visible for icon sizes smaller or <i>equal</i> to 32px. If you wanted to exclude the 32px icon size, you'd have to stay below 0.5, say 0.49.</p>
<p>The LOD is not only for leaving out detailing shapes, but also to e.g. change the stroke width at different sizes, if you feel that's needed. Simply duplicate a shape, make your changes and set both of their LOD settings to show either one or the other. Here lies the only source of potential confusion, when you unwittingly overlap LODs of shapes, and wonder why at some size both are visible...<br />
<p>The LOD is not only for leaving out detailing shapes, but also to e.g. change the stroke width at different sizes, if you feel that's needed. Simply duplicate a shape, make your changes and set both of their LOD settings to show either one or the other. Here lies the only source of potential confusion, when you unwittingly overlap LODs of shapes, and wonder why at some size both are visible…<br />
For example, if Shape 1 were to be shown below 48px and Shape 2 from 48px upward (LOD: 48/64 = 0.75):</p>
<table summary="LOD values example" border="0" cellpadding="5">
@ -278,7 +278,7 @@ Of course you can move these indicators to change the gradient to your liking. Y
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="i-o-m-transformer" name="i-o-m-transformer">Transformer</a></h3>
<p>A shape can have Transformers which change its appearance. The effects, however, are more subtle than a truck turning into a battle robot...</p>
<p>A shape can have Transformers which change its appearance. The effects, however, are more subtle than a truck turning into a battle robot…</p>
<h4><a id="i-o-m-transformer-menu" name="i-o-m-transformer-menu">Transformer Add Menu</a></h4>
<table summary=" Transformer Add menu" border="0" cellspacing="0" cellpadding="2">
@ -302,9 +302,9 @@ Of course you can move these indicators to change the gradient to your liking. Y
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="i-o-m-save" name="i-o-m-save">Saving an icon</a></h3>
<p>There's your usual menu bar at the top, <span class="menu">File</span>, <span class="menu">Edit</span>, <span class="menu">Options</span>. The usage is pretty much self-explaining, so we'll only look at how to save your work.</p>
<p><span class="menu">File | Save as...</span> will save in a special Icon-O-Matic format that retains additional information like the names of paths, shapes and styles. These will be stripped from the actual icon once you export it to save space. It's a good idea to back-up your work like this, because without named objects everything's named "&lt;path&gt;/&lt;shape&gt;/&lt;style&gt;" which makes specific changes tedious.</p>
<p><span class="menu">File | Save as…</span> will save in a special Icon-O-Matic format that retains additional information like the names of paths, shapes and styles. These will be stripped from the actual icon once you export it to save space. It's a good idea to back-up your work like this, because without named objects everything's named "&lt;path&gt;/&lt;shape&gt;/&lt;style&gt;" which makes specific changes tedious.</p>
<p><span class="menu">File | Export as...</span> opens a familiar save panel with a file format pop-up menu at the bottom, offering these choices:</p>
<p><span class="menu">File | Export as…</span> opens a familiar save panel with a file format pop-up menu at the bottom, offering these choices:</p>
<table summary="file formats" border="0" cellspacing="0" cellpadding="2">
<tr><td>HVIF</td><td style="width:15px;"></td><td>Haiku Vector Icon Format</td></tr>
<tr><td>HVIF RDef</td><td></td><td>Saves as resource used by programmers</td></tr>

2
userguide/eo/applications/installer.html
View File

@ -81,7 +81,7 @@
<p>In the first pop-up menu you choose the source for the installation. It can be a currently installed Haiku or can come from an install CD or USB drive, etc.<br />
The second pop-up menu specifies the target for the installation. This target partition/volume will be completely overwritten and has to be set aside beforehand by a partitioning tool like GParted.</p>
<p>Clicking the little expander widget will <i>Show optional packages</i>, if available, that you can choose to install in addition to the basic Haiku.</p>
<p>You should do a last check if you really picked the right target before starting the installation process. Click on <span class="button">Setup partitions...</span> to open <a href="drivesetup.html">DriveSetup</a> and have a look at the naming and layout of the available volumes and partitions.</p>
<p>You should do a last check if you really picked the right target before starting the installation process. Click on <span class="button">Setup partitions…</span> to open <a href="drivesetup.html">DriveSetup</a> and have a look at the naming and layout of the available volumes and partitions.</p>
<p><span class="button">Begin</span> starts the installation procedure, which basically copies the <span class="path">/home/</span> and <span class="path">/system/</span> folder onto the target volume and makes it bootable.</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>

11
userguide/eo/applications/list-cli-apps.html
View File

@ -76,7 +76,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>CortexAddOnHost</tt></td><td style="width:10px;"> </td><td>Starts service to monitor audio and video media add-ons in use. </td></tr>
<tr><td><tt>FirstBootPrompt</tt></td><td> </td><td>Language and keymap setup. </td></tr>
<tr><td><tt>[</tt></td><td> </td><td>Returns true/false after comparing items.</td></tr>
<tr><td colspan="3"><a id="A" name="A"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>A</h2></a></td></tr>
<tr><td colspan="3"><a id="A" name="A"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>A - E</h2></a></td></tr>
<tr><td><tt>addattr</tt></td><td> </td><td>Writes an attribute to a file, taking the type into account and converting the values accordingly. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td><tt>alert</tt></td><td> </td><td>Shows a message box. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td><tt>arp</tt></td><td> </td><td>Manipulates the system ARP cache. </td></tr>
@ -134,7 +134,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>error</tt></td><td> </td><td>Prints clear text error messages for given error numbers. </td></tr>
<tr><td><tt>expand</tt></td><td> </td><td>Converts tabs to spaces.</td></tr>
<tr><td><tt>expr</tt></td><td> </td><td>Prints the value of an expression.</td></tr>
<tr><td colspan="3"><a id="F" name="F"><h2>F</h2></a></td></tr>
<tr><td colspan="3"><a id="F" name="F"><h2>F - J</h2></a></td></tr>
<tr><td><tt>factor</tt></td><td> </td><td>Prints the prime factors of integer numbers.</td></tr>
<tr><td><tt>false</tt></td><td> </td><td>Does nothing, indicates "unsuccessful" and returns the value "1".</td></tr>
<tr><td><tt>fdinfo</tt></td><td> </td><td>Shows info about the used file descriptors in the system. </td></tr>
@ -170,7 +170,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>iroster</tt></td><td> </td><td>Lists input devices. </td></tr>
<tr><td><tt>isvolume</tt></td><td> </td><td>Gets information about a mounted volume.</td></tr>
<tr><td><tt>join</tt></td><td> </td><td>For each pair of input lines with identical join fields, write a line to standard output. </td></tr>
<tr><td colspan="3"><a id="K" name="K"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>K</h2></a></td></tr>
<tr><td colspan="3"><a id="K" name="K"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>K - O</h2></a></td></tr>
<tr><td><tt>kernel_debugger</tt></td><td> </td><td>Enters the kernel debugger.</td></tr>
<tr><td><tt>keymap</tt></td><td> </td><td>Loads or saves a keymap.</td></tr>
<tr><td><tt>kill</tt></td><td> </td><td>Sends a signal to quit a process. </td></tr>
@ -224,7 +224,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>nproc</tt></td><td> </td><td>Prints the number of available processing units.</td></tr>
<tr><td><tt>od</tt></td><td> </td><td>Writes an unambiguous representation of a file.</td></tr>
<tr><td><tt>open</tt></td><td> </td><td>Launches an application/document from the shell. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td colspan="3"><a id="P" name="P"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>P</h2></a></td></tr>
<tr><td colspan="3"><a id="P" name="P"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>P - S</h2></a></td></tr>
<tr><td><tt>package</tt></td><td> </td><td>Creates, inspects, or extracts a Haiku package.</td></tr>
<tr><td><tt>package_repo</tt></td><td> </td><td>Creates or inspects a Haiku package repository file.</td></tr>
<tr><td><tt>passwd</tt></td><td> </td><td>Changes the user password. </td></tr>
@ -247,6 +247,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>ramdisk</tt></td><td> </td><td>Creates a ramdisk. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td><tt>rc</tt></td><td> </td><td>Resource compiler.</td></tr>
<tr><td><tt>readlink</tt></td><td> </td><td>Prints the path to the destination of a symbolic link.</td></tr>
<tr><td><tt>recover</tt></td><td> </td><td>A tool that tries to recover files from a corrupted BFS volume (see its <a href="https://www.pinc-software.de/docs/BFS-tools.html#recover">documentation</a> for a bit more info).</td></tr>
<tr><td><tt>reindex</tt></td><td> </td><td>Puts attributes of existing files into newly created indexes. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
<tr><td><tt>release</tt></td><td> </td><td>Releases a semaphore. </td></tr>
<tr><td><tt>renice</tt></td><td> </td><td>Alters the priority of a running process. </td></tr>
@ -284,7 +285,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
<tr><td><tt>sum</tt></td><td> </td><td>Prints checksum and block counts for each file. </td></tr>
<tr><td><tt>sync</tt></td><td> </td><td>Forces changed blocks to disk, updates the superblock. </td></tr>
<tr><td><tt>sysinfo</tt></td><td> </td><td>Shows system info. </td></tr>
<tr><td colspan="3"><a id="T" name="T"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>T</h2></a></td></tr>
<tr><td colspan="3"><a id="T" name="T"><h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>T - Z</h2></a></td></tr>
<tr><td><tt>tac</tt></td><td> </td><td>Concatenates and prints files, last line first. </td></tr>
<tr><td><tt>tail</tt></td><td> </td><td>Prints the last ten lines of a file.</td></tr>
<tr><td><tt>tcpdump</tt></td><td> </td><td>Dumps traffic of a network. </td></tr>

24
userguide/eo/applications/mail.html
View File

@ -65,7 +65,7 @@
<tr class="heading"><td>Enhavtabelo</td></tr>
<tr class="index"><td><a href="#reading">Reading messages</a><br />
<a href="#creating">Creating new messages</a><br />
<a href="#preferences">Preferences</a></td></tr>
<a href="#preferences">Settings</a></td></tr>
</table>
<h2><img src="../../images/apps-images/mail-icon_64.png" alt="mail-icon_64.png" width="64" height="64" />Mail</h2>
@ -86,14 +86,14 @@
<p>You double-click an email file to open it in Mail. The interface is quite simple:</p>
<img src="../images/apps-images/mail-read.png" alt="email-read.png" />
<p>A menu and optional tool bar on top, with an area of the interesting attributes of a mail (to, from, subject, date) below that, and then the actual body of the mail. If the mail appears with strange characters or empty, try to change the <span class="menu">Encoding</span> in the <span class="menu">Message</span> menu.</p>
<p>If there are files attached to an email, they are listed at the end of the message. A right-click on one opens a context menu to <span class="menu">Save attachment...</span> or <span class="menu">Open attachment</span>. You can also drag &amp; drop directly to the Desktop or another Tracker window.</p>
<p>If there are files attached to an email, they are listed at the end of the message. A right-click on one opens a context menu to <span class="menu">Save attachment…</span> or <span class="menu">Open attachment</span>. You can also drag &amp; drop directly to the Desktop or another Tracker window.</p>
<p>Most of the menu and tool bar items are pretty self-explaining, so we'll concentrate just on the highlights.</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>File</h3>
<p>When you close the window of a new mail, its status is normally switched from "New" to "Read". But you can set other statuses as well, by choosing from the <span class="menu">Close and</span> submenu. There you'll also find the option <span class="menu">Set to...</span> to create your own custom statuses, which are saved under <span class="path">~/config/settings/Mail/status/</span>.</p>
<p>When you close the window of a new mail, its status is normally switched from "New" to "Read". But you can set other statuses as well, by choosing from the <span class="menu">Close and</span> submenu. There you'll also find the option <span class="menu">Set to…</span> to create your own custom statuses, which are saved under <span class="path">~/config/settings/Mail/status/</span>.</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Edit</h3>
<p>Here you'll find an item to open Mail's <span class="menu">Preferences...</span> (<a href="#preferences">see below</a>) and a shortcut to manage your <span class="menu">Accounts...</span>, which will open the <a href="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<p>Here you'll find an item to open Mail's <span class="menu">Settings…</span> (<a href="#preferences">see below</a>) and a shortcut to manage your <span class="menu">Accounts…</span>, which will open the <a href="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>View</h3>
<p>You'll only seldomly need these two items, if at all:</p>
@ -109,7 +109,7 @@
<tr><td class="onelinetop"><span class="menu">Reply to sender</span></td><td><span class="key">OPT</span> <span class="key">ALT</span> <span class="key">R</span></td><td></td><td>This on the other hand, sends directly and only to the person listed in the "From" attribute.</td></tr>
<tr><td><span class="menu">Reply to all</span></td><td class="onelinetop"><span class="key">SHIFT</span> <span class="key">ALT</span> <span class="key">R</span></td><td></td><td>Replies to the original sender plus all other (cc'ed) recipients of the original mail.</td></tr>
</table>
<div class="box-info">If you mark a passage in the email before replying to it, only the marked text will be quoted in your answering mail. A nice way to cut down on excessive quoting, which is frowned upon by pretty much everybody...</div>
<div class="box-info">If you mark a passage in the email before replying to it, only the marked text will be quoted in your answering mail. A nice way to cut down on excessive quoting, which is frowned upon by pretty much everybody…</div>
<p>The items to <span class="menu">Forward</span>, <span class="menu">Resend</span> and <span class="menu">Copy to new</span> are again pretty self-explaining.</p>
<p>When you've opened an email from a Tracker or query result window, <span class="menu">Previous message</span> and <span class="menu">Next message</span> will move to the previous/next email in the list.</p>
<p><span class="menu">Save address</span> collects all email addresses from the header and the actual email body in a submenu. Choosing an address will open the <a href="people.html">People</a> application in order to complete and save the contact information.</p>
@ -121,7 +121,7 @@
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="creating" name="creating">Creating new messages</a></h2>
<p>A new email is created by invoking <span class="menu">New mail message</span> of the <span class="menu">File</span> menu or the corresponding icon from the tool bar of an open email. Or you just start the Mail application or choose <span class="menu">Create new message...</span> from the context menu of the mailbox icon in the Deskbar.</p>
<p>A new email is created by invoking <span class="menu">New mail message</span> of the <span class="menu">File</span> menu or the corresponding icon from the tool bar of an open email. Or you just start the Mail application or choose <span class="menu">Create new message…</span> from the context menu of the mailbox icon in the Deskbar.</p>
<img src="../images/apps-images/mail-write.png" alt="email-write.png" />
<p>The window is pretty similar to the one when reading mails. The menu and tool bar items are slightly different and the text boxes have to be filled with the recipient's email address, subject and so on, of course.</p>
<p><span class="menu">Cc</span> is short for the anachronistic term "<i>carbon copy</i>" and results in copies of your mail being sent to the listed people. The difference to just listing a buch of addresses in the "To" field is, that you don't directly address the cc'ed people, thereby signaling that you probably don't expect an answer of them.<br />
@ -140,15 +140,15 @@
<p><span class="menu">Check spelling</span> currently only offers corrections of English texts by marking wrong or unknown words red and showing them in italic.
Right-clicking such a word opens a context menu offering suggestions to correct the word or to <span class="menu">Add</span> it to the accepted vocabulary.</p>
<p>Then, there are again the items to open Mail's <span class="menu">Preferences...</span> (<a href="#preferences">see below</a>) and a shortcut to managing your <span class="menu">Accounts...</span>, which will open the <a href="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<p>Then, there are again the items to open Mail's <span class="menu">Settings…</span> (<a href="#preferences">see below</a>) and a shortcut to managing your <span class="menu">Accounts…</span>, which will open the <a href="../preferences/e-mail.html">E-mail</a> preference panel.</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Message</h3>
<p>With <span class="menu">Add signature</span> you can add predefined texts to the end of your mail. From its submenu you can choose a specific or <span class="menu">Random</span> one.</p>
<img src="../images/apps-images/mail-signature.png" alt="email-signature.png" />
<p>You create new or edit existing signatures with <span class="menu">Edit signatures...</span>, which will open a window where you enter the text itself and the title of your new sig. There, in the <span class="menu">Signature</span> menu, you find items to <span class="menu">Open</span> a specific signature or <span class="menu">Save</span> or <span class="menu">Delete</span> the currently loaded one, Signatures should be saved in <span class="path">~/config/settings/Mail/signatures</span>.</p>
<p>Use <span class="menu">Add enclosure...</span> and <span class="menu">Remove enclosure</span> to add/remove files as attachments. You can also drag &amp; drop files from a Tracker window. Be careful though to drop those in the header section (To/From/Subject area at the top) or they'll get pasted into the email body if they are text files.</p>
<p>You create new or edit existing signatures with <span class="menu">Edit signatures…</span>, which will open a window where you enter the text itself and the title of your new sig. There, in the <span class="menu">Signature</span> menu, you find items to <span class="menu">Open</span> a specific signature or <span class="menu">Save</span> or <span class="menu">Delete</span> the currently loaded one, Signatures should be saved in <span class="path">~/config/settings/Mail/signatures</span>.</p>
<p>Use <span class="menu">Add enclosure…</span> and <span class="menu">Remove enclosure</span> to add/remove files as attachments. You can also drag &amp; drop files from a Tracker window. Be careful though to drop those in the header section (To/From/Subject area at the top) or they'll get pasted into the email body if they are text files.</p>
<img src="../images/apps-images/mail-attachments.png" alt="email-attachments.png" />
@ -160,9 +160,9 @@ Right-clicking such a word opens a context menu offering suggestions to correct
<h2>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="preferences" name="preferences">Preferences</a></h2>
<a id="preferences" name="preferences">Settings</a></h2>
<img src="../images/apps-images/mail-preferences.png" alt="email-preferences.png" />
<p>Mail's preferences come in two parts:</p>
<p>Mail's settings come in two parts:</p>
<h3>
<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>User interface</h3>
<table summary="layout" border="0" cellspacing="0" cellpadding="2">
@ -189,7 +189,7 @@ On Mon, 18 Jan 1998 02:55:16 +0800 you wrote:
<tr><td><span class="menu">Encoding</span></td><td></td><td>Sets the default encoding.</td></tr>
<tr><td class="onelinetop"><span class="menu">Warn unencodable</span></td><td></td><td>If your mail contains characters that can't be encoded with the currently set encoding method, you can turn on being warned about that. That gives you the opportunity to change the encoding before sending. Otherwise unencodable characters are replaced by rectangle symbols.</td></tr>
<tr><td><span class="menu">Text wrapping</span></td><td></td><td>Inserts line-breaks every 76 characters which makes mails easier to read.</td></tr>
<tr><td><span class="menu">Attach attributes</span></td><td></td><td>You can choose to send BFS' attributes of a file alongside the attachments. This is nice for other Haiku users, as they'll get a "complete" file (think artist, album, title attributes of MP3 files), but may cause confusion (or even suspicion) with others, who will wonder what the additional "BeOS Attributes" attachment might be...<br />
<tr><td><span class="menu">Attach attributes</span></td><td></td><td>You can choose to send BFS' attributes of a file alongside the attachments. This is nice for other Haiku users, as they'll get a "complete" file (think artist, album, title attributes of MP3 files), but may cause confusion (or even suspicion) with others, who will wonder what the additional "BeOS Attributes" attachment might be…<br />
Should you opt not to send attributes with your attachments, remember zip up your files before you send them or you'll strip away BFS attributes.</td></tr>
</table>

4
userguide/eo/applications/mediaplayer.html
View File

@ -77,7 +77,7 @@ Below that you find the usual controls to skip to the previous track, play/pause
<h2>Audio and video playback</h2>
<p>Since there aren't any specific features for audio playback, we'll go straight to video or general features.</p>
<img src="../images/apps-images/mediaplayer-info.png" alt="mediaplayer-info.png" />
<p>Available to all media is the <span class="menu">File info...</span> (<span class="key">ALT</span> <span class="key">I</span>). It shows information about the currently loaded file, like playing time or details of the audio/video track and its codec.</p>
<p>Available to all media is the <span class="menu">File info…</span> (<span class="key">ALT</span> <span class="key">I</span>). It shows information about the currently loaded file, like playing time or details of the audio/video track and its codec.</p>
<p>Most of the often used commands from the menus are also available from a right-click context menu on the video area. Convenient when in full-screen mode.<br />
Under <span class="menu">Video</span> you'll find options to zoom the window to various levels or force the aspect ratio to some standard values. Leaving the aspect ration to the default <span class="menu">Stream settings</span> should work best for correctly encoded files.</p>
<p>MediaPlayer supports subtitles in <a href="http://en.wikipedia.org/wiki/SubRip">SRT</a> format. To have them show up under <span class="menu">Subtitles</span>, their filenames have to be identical to their video file, with a suffixed language name and ".srt" instead of the video's extension. For example:</p>
@ -89,7 +89,7 @@ MyMovie.Français.srt</pre>
<p>You can toggle the <span class="menu">Full screen</span> mode (<span class="key">ALT</span> <span class="key">ENTER</span> or <span class="key">F</span> or a double left-click), hide MediaPlayer's window borders and controls with <span class="menu">Hide interface</span> (<span class="key">ALT</span> <span class="key">H</span> or a double right-click) or have its window <span class="menu">Always on top</span> (<span class="key">ALT</span> <span class="key">A</span>).</p>
<h2>Playlists</h2>
<p><span class="menu">MediaPlayer | Playlist...</span> (<span class="key">ALT</span> <span class="key">P</span>) opens a window with the files currently queued up for playback. Double-clicking an entry starts playing it.</p>
<p><span class="menu">MediaPlayer | Playlist…</span> (<span class="key">ALT</span> <span class="key">P</span>) opens a window with the files currently queued up for playback. Double-clicking an entry starts playing it.</p>
<img src="../images/apps-images/mediaplayer-playlist.png" alt="mediaplayer-playlist.png" />
<p>You can add more files by dropping them into the list and rearrange their position via drag &amp; drop. New files are added in the order they were selected from a Tracker window. Drag &amp; dropping them with the right mouse button shows a context menu to insert them <span class="menu">sorted</span> (alphabetically).<br />
From the <span class="menu">Edit</span> menu you can <span class="menu">Randomize</span> or <span class="menu">Remove</span> (<span class="key">DEL</span>) an entry from the list or delete the actual file with <span class="menu">Move to Trash</span> (<span class="key">ALT</span> <span class="key">T</span>).</p>

2
userguide/eo/applications/poorman.html
View File

@ -70,7 +70,7 @@
<p><br /></p>
<p>PoorMan is a nice little webserver that's extremely easy to set up. Naturally it doesn't offer any advanced features like other heavy duty server software, it's after all only a poor man's webserver.</p>
<p>Upon its first launch, PoorMan asks for the folder that is about to be served to the web. If you go with the <span class="button">Default</span>, a new folder <span class="path">/boot/home/public_html</span> is created for you. As a start page a HTML file named by default <span class="cli">index.html</span> has to be present there.</p>
<p>PoorMan presents itself with a simple console that logs its activity. Then, there's status information if the server is running, which folder is being served, and a hit counter. Settings are changed with <span class="menu">Edit | Settings...</span>:
<p>PoorMan presents itself with a simple console that logs its activity. Then, there's status information if the server is running, which folder is being served, and a hit counter. Settings are changed with <span class="menu">Edit | Settings…</span>:
</p>
<p><img id="poorman" src="../images/apps-images/poorman.png" alt="poorman.png" /></p>
<p>The settings panel is divided into three tabs:</p>

4
userguide/eo/applications/showimage.html
View File

@ -94,12 +94,12 @@ ShowImage provides minimal editing features to crop, rotate and flip images and
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Editing</h2>
<img src="../images/apps-images/showimage-edit.jpg" alt="showimage-edit.jpg" />
<p>The <span class="menu">Image</span> menu offers the few image manipulations necessary for an image viewer: rotating and flipping the image. Note however, that the actual image data won't be changed. Only an attribute is added to the file so it'll be shown rotated or flipped the next time you open it.</p>
<p><span class="menu">Use as backgroud...</span> will open the <a href="../preferences/backgrounds.html">Backgrounds</a> preferences to set the current picture as image for your workspaces.</p>
<p><span class="menu">Use as background…</span> will open the <a href="../preferences/backgrounds.html">Backgrounds</a> preferences to set the current picture as image for your workspaces.</p>
<p>Cropping is another feature that's needed sometimes. To define the frame to cut to, you can switch to <span class="menu">Selection mode</span> from the <span class="menu">Edit</span> menu and drag out a box with your left mouse button. If you don't want to change modes first, you can create this box in "normal mode" by simply holding <span class="key">CTRL</span> while left-click-dragging, which otherwise would just pan the image around.<br />
<span class="menu">Clear selection</span> or <span class="key">ESC</span> will remove the selection box.</p>
<p>The following chapter shows how to actually save the cropped area.</p>
<h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Saving and converting</h2>
<p>To save or convert an image into any available format, you can invoke the normal <span class="menu">Save as...</span> item from the <span class="menu">File</span> menu, select the format and choose a file name.<br />
<p>To save or convert an image into any available format, you can invoke the normal <span class="menu">Save as…</span> item from the <span class="menu">File</span> menu, select the format and choose a file name.<br />
Often quicker, especially when the Tracker window with the destination folder is already open, is using drag &amp; drop.</p>
<img src="../images/apps-images/showimage-dnd.jpg" alt="showimage-dnd.jpg" />
<p>This is also how the above mentioned cropping is finalized. Either select a frame as described above, or choose <span class="menu">Edit | Select all</span> for the whole image. Then drag &amp; drop the selection onto the Desktop or any Tracker window to create a new image clipping in the same format of the original image.</p>

Some files were not shown because too many files have changed in this diff Show More