Update userguide translations, waddlesplash as nielx

2017-02-01 04:48:59 +01:00
parent 7407e36a10
commit 7a3f3e0965
536 changed files with 4859 additions and 2567 deletions
@@ -122,6 +122,11 @@ Would you like a link to it?" "On Desktop" "In Deskbar" "No thanks"</pre>
 <tr><td><p><span class="cli">diskimage</span></p></td><td style="width:10px;"> </td>
 		<td valign="top"><p><span class="cli">diskimage</span> lets you register a regular file as disk device. For example, you can register a Haiku anyboot image, mount it in Tracker and copy, edit or remove files there before using it as source in the Installer.</p>
 </td></tr>
+<tr><td><p><span class="cli">launch_roster</span></p></td><td style="width:10px;"> </td>
+		<td valign="top"><p>The launch_daemon starts all sorts of services and applications at boot-up. For some it was instructed to re-start them if they were quit. If you don't want that – maybe you'd like to test a modified Tracker, for example – you use <span class="cli">launch_roster</span> to <tt>stop</tt> the re-starting of the application before quitting it. Similarly, you can <tt>start</tt> it again or get <tt>info</tt> about it. Without parameter, <span class="cli">launch_roster</span> lists all apps/services that are under its control.<br />
+For example, this will stop the re-launching of the Deskbar:</p>
+<pre class="terminal">launch_roster stop x-vnd.be-tskb</pre>
+</td></tr>
 <tr><td><p><span class="cli">mountvolume</span><br /><span class="cli">mount</span></p></td><td style="width:10px;"> </td>
 		<td valign="top"><p><span class="cli">mountvolume</span> is preferred by many to mount local partitions and disks, because its usage is so easy: just call it with the name of the partition and you're done. Try <tt>--help</tt> for more options.</p>
 <p><span class="cli">mount</span> can additionally mount remote disks by using a network filesystem, like NFS4. You specify the used filesystem with the <tt>-t</tt> parameter and the remote location with the <tt>-p</tt> parameter. As filesystem parameter you can use anything you find in <span class="path">/system/add-ons/kernel/file_system</span> (and corresponding file hierarchies under <span class="path">~/config</span> or "<span class="path">non-packaged</span>", of course). You also have to create a folder as mountpoint. Here's an example:</p>
@@ -130,6 +135,21 @@ mount -t nfs4 -p "192.168.178.3:volume1" /DiskStation</pre></td></tr>
 <tr><td><p><span class="cli">open</span></p></td><td style="width:10px;"> </td>
 		<td valign="top"><p><span class="cli">open</span> is a very handy little tool. With it you open any file with its preferred application, or start a specific application by its signature without the need to know its exact path. It also works with URLs and even with the "virtual" directories <tt>.</tt> for the current directory and <tt>..</tt> for the parent, opening the folder in Tracker.</p>
 </td></tr>
+<tr><td><p><span class="cli">ramdisk</span></p></td><td style="width:10px;"> </td>
+		<td valign="top"><p>A ramdisk is like a harddisk running only in the computer's memory. That makes it very fast but also volatile, because its contents vanishes when you shut down the computer, or it crashes or you experience a blackout.<br />
+To create a ramdisk of 1 GiB, format to the name "RAMses" and mount it, you enter this in Terminal or create a script of it:</p>
+<pre class="terminal">ramdisk create -s 1gb
+mkfs -q -t bfs /dev/disk/virtual/ram/0/raw RAMses
+mountvolume RAMses</pre>
+<p>Note: When creating a ramdisk, the <span class="cli">ramdisk</span> command prints out the path to it. If you create several disks, that path <span class="path">/dev/disk/virtual/ram/0/raw</span> will change!</p>
+<p>To preserve the contents, at least if no calamity like a blackout etc. strikes, a ramdisk can be set up to read/write an image on the harddisk. For that, you need to supply a file of the desired size that will be read from every time you start your ramdisk, and written to when you unmount it. To create an image file "RAMimage" of 500MiB and format it, do this:</p>
+<pre class="terminal">dd if=/dev/zero of=RAMimage bs=500M count=1
+mkfs -q -t bfs /dev/disk/virtual/ram/0/raw RAMimage</pre>
+<p>From now on, you start the ramdisk like this:</p>
+<pre class="terminal">ramdisk create RAMimage
+mountvolume RAMimage</pre>
+<p>It's very important to always cleanly unmount you ramdisk, either from Tracker or with <span class="cli">unmount /RAMimage</span>, or the changes won't be written back to the image file!</p>
+</td></tr>
 </table>
 </div>
 </div>
@@ -4,7 +4,7 @@
 <head>
 <!-- 
 *
- * Copyright 2015, Haiku. All rights reserved.
+ * Copyright 2015-2017, Haiku. All rights reserved.
 * Distributed under the terms of the MIT License.
 *
 * Authors:
@@ -66,19 +66,21 @@
 <p><br /></p>
 <p>The Debugger is an application the common user hasn't much use for. It's targetted at developers to investigate bugs in programs. Sometimes those bugs result in crashes and that is where even end users come into contact with the Debugger. When a program crashes, you're confronted with this alert:</p>
 <img src="../images/apps-images/debugger_alert.png" alt="debugger_alert.png" />
-<p>It gives three options to react to the crash:</p>
+<p>It gives four options to react to the crash:</p>
 <ul>
 <li><p><span class="button">Terminate</span> will clean up after the crashed app but otherwise does nothing further.</p></li>
 <li><p><span class="button">Debug</span> will start the Debugger for further investigation.</p></li>
+<li><p><span class="button">Write core file</span> creates a possibly huge dump of the system's state. Better attach a regular debug report first when submitting a bug report and only provide a core file on request.</p></li>
 <li><p><span class="button">Save report</span> creates a debug report which is saved as a text file on the Desktop and can be emailed to the developer of the crashed app or attached to a ticket at its bugtracker, if available.<br />
 The debug report contains information on your hardware (type of CPU and used memory etc.), the exact version of Haiku and all available information on the state of the system that could be relevant to the crash.</p></li>
 </ul>
 <p>Describing the usage of the actual Debugger is out of scope for this guide that is addressing the needs of the common user of Haiku. For completeness sake, here's the window that'll come up if you choose the <span class="button">Debug</span> option in the above alert:</p>
 <img src="../images/apps-images/debugger.png" alt="debugger.png" />
 <p>As you'll quickly see when you start poking around a bit, the Debugger is one of the most complex and sophisticated applications for Haiku. If you're a developer and are used to graphical debuggers on other platforms, many features will be familiar to you.</p>
-<p>As there's not a single document explaining the intricacies of Haiku's Debugger, below are a few links that may shed some light. If you have a specific question, you may want to consider posting it on the <a href="http://www.freelists.org/list/haiku-development">development mailing list</a>. If you find more useful resources, please file a <a href="../../../welcome/en/bugreports.html">bugreport</a> with that info.</p>
+<p>Below are a few links that may shed some light on the intricacies of Haiku's Debugger. If you have a specific question, you may want to consider posting it on the <a href="http://www.freelists.org/list/haiku-development">development mailing list</a>. If you find more useful resources, please file a <a href="../../../welcome/en/bugreports.html">bugreport</a> with that info.</p>
 <table summary="layout" border="0" cellpadding="2" cellspacing="0">
-<tr><td><a href="https://www.haiku-os.org/taxonomy/term/1240">Blogposts</a></td><td> </td><td>There are a few articles on the Debugger, mostly by Rene Gollent after implementing a new feature.</td></tr>
+<tr><td class="onelinetop"><a href="https://www.dropbox.com/s/e6gx39r0asc2t8f/DebuggerReferenceManual.pdf?dl=1">Debugger Reference Manual</a></td><td></td><td>This is the most in-depth source on how to work with the Debugger.</td></tr>
+<tr><td><a href="https://www.haiku-os.org/blog/anevilyak/">Blogposts</a></td><td> </td><td>There are a few articles on the Debugger, mostly by Rene Gollent after implementing a new feature.</td></tr>
 <tr><td class="onelinetop"><a href="https://www.youtube.com/watch?v=n-NDFwtmQcI&amp;list=PL2KiE-VO9zk-9XPmfusEDaOFd_7AiVKzz">BeGeistert 026 video</a></td><td> </td><td>A video from the BeGeistert meeting in 2012, in which Ingo Weinhold demonstrates the state of the Debugger back then and shows other interesting tools like the profiler to hunt down bottlenecks.</td></tr>
 </table>

@@ -4,7 +4,7 @@
 <head>
 <!-- 
 *
- * Copyright 2013-2014 Haiku. All rights reserved.
+ * Copyright 2013-2017 Haiku. All rights reserved.
 * Distributed under the terms of the MIT License.
 *
 * Authors:
@@ -60,7 +60,7 @@
 <tr class="index"><td><a href="#filter">The Filter</a><br />
                <a href="#list">The List</a><br />
                <a href="#info">The Info Area</a><br />
-                <a href="#menu">Tools and Options</a><br />
+                <a href="#menu">Tools and Show</a><br />
                <a href="#account">Creating a User Account</a><br />
                <a href="#rating">Rating and Commenting</a><br />
 </td></tr>
@@ -70,18 +70,20 @@
 <table summary="layout" border="0" cellspacing="0" cellpadding="2">
 <tr><td>Deskbar:</td><td style="width:15px;"></td><td><span class="menu">Applications</span></td></tr>
 <tr><td>Location:</td><td></td><td><span class="path">/boot/system/apps/HaikuDepot</span></td></tr>
-<tr><td>Settings:</td><td></td><td><span class="path">~/config/settings/HaikuDepot/</span></td></tr>
+<tr><td>Settings:</td><td></td><td><span class="path">~/config/settings/HaikuDepot/</span> - The main settings of the application<br />
+<span class="path">~/config/cache/HaikuDepot</span> - Cached icons, screenshots, descriptions etc.</td></tr>
 </table>
 <p><br /></p>
-<p>HaikuDepot is the central application when it comes to managing your software packages. With it you can browse and search through package repositories (also called "depots") and install, update and uninstall packages. HaikuDepot starts up with a list of "<i>Featured packages</i>", software that's deemed interesting to many users. As soon as you enter a term in the search box or choose a category, the display changes to smaller icons and more information arranged in columns.</p>
+<p>HaikuDepot is the central application when it comes to managing your software packages. With it you can browse and search through package repositories and install, update and uninstall packages. By default, HaikuDepot starts up with a list of "<i>Featured packages</i>", software that's deemed interesting to many users.</p>
 <img src="../images/apps-images/haikudepot.png" alt="haikudepot.png" />
+<p>As soon as you enter something in the <span class="menu">Search terms</span> box, the display changes to smaller icons and more information arranged in columns.</p>

 <h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
 <a id="filter" name="filter">The Filter</a></h2>
 <p>At the top we find a few means to filter the list of available packages below:</p>
 <ul>
 <li><p>The <span class="menu">Category</span> pop-up menu lets you limit the list to individual categories like "<i>Audio</i>" or "<i>Games</i>".</p></li>
-<li><p>The <span class="menu">Depot</span> pop-up menu determines which online depots are queried or if only those packages shown, that were installed from somewhere other than an online depot ("<i>Local</i>"). Maybe from an USB thumb drive or downloaded from some website or a package that you've built yourself.</p></li>
+<li><p>The <span class="menu">Repositories</span> pop-up menu determines which online repos are queried or if only those packages are shown, that were installed from somewhere other than an online repo ("<i>Local</i>"). Maybe from an USB thumb drive or downloaded from some website or a package that you've built yourself.</p></li>
 <li><p>The <span class="menu">Search terms</span> text field filters the list to those packages that have all the entered (space-delimited) strings in their name or description.</p></li>
 </ul>

@@ -91,7 +93,7 @@
 <p>The status column of a package can have one of several states:</p>
 <ul>
 <li><p><span class="menu">Active</span>: The package is currently installed and ready to be used.</p></li>
-<li><p><span class="menu">Available</span>: The package exists in that depot and can be downloaded and installed. If there are any dependencies on other packages, you'll be informed of that while installing and get the choice of downloading/installing all that's necessary.</p></li>
+<li><p><span class="menu">Available</span>: The package exists in that repository and can be downloaded and installed. If there are any dependencies on other packages, you'll be informed of that while installing and get the choice of downloading/installing all that's necessary.</p></li>
 <li><p><span class="menu">Pending / %</span>: <i>Pending</i> is shown for a package that is queued for download/installation. While a package is downloaded, the progress is shown as percentage.</p></li>
 <li><p><span class="menu">Update available</span>: There's a newer version than your installed one available.</p></li>
 </ul>
@@ -101,7 +103,7 @@
 <a id="info" name="info">The Info Area</a></h2>
 <p>At the bottom is an area that displays information on the package that is currently selected in the list above it.<br />
 To the right of package name, author, rating and version is a button, that – depending on the current state of the package – lets you <span class="button">Install</span>, <span class="button">Uninstall</span> or <span class="button">Update</span> it. If a package is already installed, you'll find an additional button there to <span class="button">Open</span> the application.</p>
-<p>Below are three tabs: About, Ratings, and Changelog.</p>
+<p>Below are four tabs: About, Ratings, Changelog and Contents.</p>
 <ul>
 <li><p _translation_id="5252"><span class="menu">About</span></p>
 <p _translation_id="5253">The first tab has a detailed description of the package, as well as screenshots and a contact address and URL of the team that maintains the packaged software, if available. Clicking the screenshot thumbnail will open it full-size in a new window</p></li>
@@ -110,16 +112,21 @@ To the right of package name, author, rating and version is a button, that – d
 <img src="../images/apps-images/haikudepot-rating-tab.png" alt="haikudepot-rating-tab.png" />
 <p _translation_id="5268">To the left is a statistic, showing the number of stars (1 to 5) the package got from how many users.<br />
 In the middle are user comments with their nickname, the number of stars they gave the package and which version of the package they were rating or commenting on. You'll find more on how to rate a package yourself <a href="#rating">further down</a>.<br />
-With the little thumb up/down icons to the right, you can show your approval or disapproval with a certain comment.</p></li>
+<!--  With the little thumb up/down icons to the right, you can show your approval or disapproval with a certain comment.
+-->
+</p></li>
 <li><p _translation_id="5257"><span class="menu">Changelog</span></p>
-<p _translation_id="5258">The last tab shows the detailed history of all the  versions of the package that have been released so far.</p></li>
+<p _translation_id="5258">Here you find a detailed history of all the  versions of the package that have been released so far, if the maintainer of the package  provides that information.</p></li>
+<li><p><span class="menu">Contents</span></p>
+<p>The last tab shows all the files and folders a package contains. This only works for already downloaded packages.</p></li>
 </ul>

 <h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
-<a id="menu" name="menu">Tools and Options</a></h2>
-<p>In the <span class="menu">Tools</span> menu at the top of the window, you'll find an item to <span class="menu">Refresh depots</span>. This will request an up-to-date list of all available packages from the repositories.</p>
-<p>Under <span class="menu">Options</span> you can choose to also <span class="menu">Show develop packages</span> and <span class="menu">Show 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 other two items, <span class="menu">Show available packages</span> and <span class="menu">Show installed packages</span>, which are pretty self-explanatory.</p>
+<a id="menu" name="menu">Tools and Show</a></h2>
+<p>In the <span class="menu">Tools</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. The other 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.</p>
+<p>Under <span class="menu">Show</span> you can deactivate <span class="menu">Only featured packages</span>. Now you'll always see all packages and not just the featured ones when HaikuDepot starts up or the search text field is empty.<br />
+Furthermore, you can choose to also Show <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>, which are pretty self-explanatory.</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>
@@ -137,7 +144,7 @@ With the little thumb up/down icons to the right, you can show your approval or
 <p>After you've created a user account and are logged in, you can rate a package and leave a comment, if you want. Just hover the mouse over the rating stars in the info area of a package and they turn into a <span class="button">Rating...</span> button. Click it to open the rating window:</p>
 <img src="../images/apps-images/haiku-depot-ratingpanel.png" alt="haiku-depot-ratingpanel.png" />
 <p>Here you move the mouse over the stars to light them up and choose your rating, you can also choose from a number of levels to judge the stability of the application and pick the language of your optional comment. To make a comment meaningful, you should have worked with the application you're about to rate for a while to become familiar with its features, bugs and quirks. And don't write the next great American novel... keep it short, sweet and polite. :)<br />
-After you click <span class="button">Send</span> the data is transmitted to the server. You may have to go to the <span class="menu">Tools</span> menu to <span class="menu">Refresh depots</span> before you can see your changes.</p>
+After you click <span class="button">Send</span> the data is transmitted to the server. You may have to go to the <span class="menu">Tools</span> menu to <span class="menu">Refresh repositories</span> before you can see your changes.</p>
 <p>At any time, you can come back and edit your comment and re-rate it. You can also hide your rating from other users by deactivating the checkbox <span class="menu">Other users can see this rating</span>.</p>
 </div>
 </div>
@@ -316,7 +316,7 @@ Of course you can move these indicators to change the gradient to your liking. Y
 <a id="i-o-m-tips" name="i-o-m-tips">Tips &amp; Tricks</a></h3>
 <p>A few things you should keep in mind when working with Icon-O-Matic and some general tips for its usage:</p>
 <ul>
-<li><p>Read the <a href="http://cgit.haiku-os.org/haiku/plain/docs/icon_guidelines/index.html">Icon Guidelines</a> to learn about important characteristics of Haiku icons, e.g. perspective, colors and shadows.</p></li>
+<li><p>Read the <a href="https://www.haiku-os.org/development/icon-guidelines">Icon Guidelines</a> to learn about important characteristics of Haiku icons, e.g. perspective, colors and shadows.</p></li>
 <li><p>You should always try to minimize your use of paths, those are the most expensive, file size wise. Re-use paths wherever possible and work with manipulated shapes and their transformers instead. Smart use of gradients can also save space.</p></li>
 <li><p>Wherever possible, you should activate Snap-to-Grid from the <span class="menu">Options</span> menu when editing paths. Path points that align with the 64x64 pixel grid use less storage space. You'll also get the crispest look if points are set on exact pixel borders. For example, it is important to align the most prominent outlines with the 16x16 grid.</p></li>
 <li><p>Check the preview to see if your icon still looks good in 16x16. You may want to use the <a href="#i-o-m-shape-lod">Level Of Detail</a> settings described in the Shapes section.</p></li>
@@ -4,7 +4,7 @@
 <head>
 <!-- 
 *
- * Copyright 2010-2014, Haiku. All rights reserved.
+ * Copyright 2010-2016, Haiku. All rights reserved.
 * Distributed under the terms of the MIT License.
 *
 * Authors:
@@ -150,6 +150,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
 <tr><td><tt>fwcontrol</tt></td><td> </td><td>FireWire control program.</td></tr>
 <tr><td><tt>gawk</tt></td><td> </td><td>Pattern scanning and processing language. </td></tr>
 <tr><td><tt>gdb</tt></td><td> </td><td>GNU debugger.</td></tr>
+<tr><td><tt>getarch</tt></td><td> </td><td>Shows the environment's compiler version. </td></tr>
 <tr><td><tt>getlimits</tt></td><td> </td><td>Prints platform dependent limits in a format useful for shell scripts. </td></tr>
 <tr><td><tt>grep</tt></td><td> </td><td>Search for a pattern.</td></tr>
 <tr><td><tt>groups</tt></td><td> </td><td>Prints group memberships for each username. </td></tr>
@@ -173,6 +174,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
 <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>
+<tr><td><tt>launch_roster</tt></td><td> </td><td>Controls the launch_daemon, e.g. stop and restart services. <a href="cli-apps.html">(Haiku specific)</a></td></tr>
 <tr><td><tt>less</tt></td><td> </td><td>Views a file.</td></tr>
 <tr><td><tt>lessecho</tt></td><td> </td><td>Echos its arguments and expands metacharacters, such as * and ? in filenames.</td></tr>
 <tr><td><tt>lesskey</tt></td><td> </td><td>Specifies key binding for less. </td></tr>
@@ -215,6 +217,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
 <tr><td><tt>mount_nfs</tt></td><td> </td><td>Mounts a NFS partition. </td></tr>
 <tr><td><tt>mountvolume</tt></td><td> </td><td>Mounts a volume by name.</td></tr>
 <tr><td><tt>mv</tt></td><td> </td><td>Moves/renames a file. </td></tr>
+<tr><td><tt>nano</tt></td><td> </td><td>The default text editor in the Terminal, a clone of 'Pico'. </td></tr>
 <tr><td><tt>netcat</tt></td><td> </td><td>TCP and UDP utility.</td></tr>
 <tr><td><tt>netstat</tt></td><td> </td><td>Prints network connections, routing tables, interface statistics, masquerade connections and multicast memberships. </td></tr>
 <tr><td><tt>nl</tt></td><td> </td><td>Prints each file with line numbers added. </td></tr>
@@ -247,6 +250,7 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
 <tr><td><tt>pwd</tt></td><td> </td><td>Prints current directory. </td></tr>
 <tr><td><tt>query</tt></td><td> </td><td>A shell utility emulating Tracker's "Find by formula" functionality.  <a href="cli-apps.html">(Haiku specific)</a></td></tr>
 <tr><td><tt>quit</tt></td><td> </td><td>Quits an application. </td></tr>
+<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>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>
@@ -264,8 +268,8 @@ Here's a list of all commandline applications that are shipped with Haiku. Each
 <tr><td><tt>screenmode</tt></td><td> </td><td>Show/sets the screen mode. </td></tr>
 <tr><td><tt>sdiff</tt></td><td> </td><td>Shows or merges differences of two files side-by-side.</td></tr>
 <tr><td><tt>seq</tt></td><td> </td><td>Prints a sequence of numbers.</td></tr>
+<tr><td><tt>setarch</tt></td><td> </td><td>Sets the environment to a specific compiler version. </td></tr>
 <tr><td><tt>setdecor</tt></td><td> </td><td>Shows/sets the decorator. </td></tr>
-<tr><td><tt>setgcc</tt></td><td> </td><td>Shows/sets the used gcc version. </td></tr>
 <tr><td><tt>settype</tt></td><td> </td><td>Sets the MIME type, signature and preferred application of a file. </td></tr>
 <tr><td><tt>setversion</tt></td><td> </td><td>Shows the version of a file.</td></tr>
 <tr><td><tt>setvolume</tt></td><td> </td><td>Sets the system sound volume. </td></tr>
@@ -72,14 +72,14 @@ They can also be moved with <span class="key">←</span> / <span class="key">→
 <p>You can move the mouse pointer pixel by pixel with <span class="key">OPT</span> <span class="key">←</span> / <span class="key">→</span> / <span class="key">↑</span> / <span class="key">↓</span>.</p>
 <p>Clicking on the pop-up menu gives you a number of options:</p>
 <table summary="options" border="0" cellpadding="2" cellspacing="0">
-<tr><td><span class="menu">Save image</span></td><td><span class="key">ALT</span> <span class="key">S</span></td><td> </td><td>Saves the current display as a resource file.</td></tr>
+<tr><td><span class="menu">Save image</span></td><td><span class="key">ALT</span> <span class="key">S</span></td><td> </td><td>Saves the current display as a PNG image.</td></tr>
 <tr><td><span class="menu">Copy image</span></td><td><span class="key">ALT</span> <span class="key">C</span></td><td> </td><td>Copies the current display to the clipboard.</td></tr>
 <tr><td><span class="menu">Hide/Show info</span></td><td><span class="key">ALT</span> <span class="key">T</span></td><td> </td><td>Toggles the display of all the additional information.</td></tr>
 <tr><td><span class="menu">Add a crosshair</span></td><td><span class="key">ALT</span> <span class="key">H</span></td><td> </td><td>Adds a crosshair you can drag around. </td></tr>
 <tr><td><span class="menu">Remove a crosshair</span></td><td><span class="key">ALT</span> <span class="key">SHIFT</span> <span class="key">H</span></td><td> </td><td>Removes the last added crosshair.</td></tr>
 <tr><td><span class="menu">Hide/Show grid</span></td><td><span class="key">ALT</span> <span class="key">G</span></td><td> </td><td>Toggles the overlayed grid.</td></tr>
 <tr><td class="onelinetop"><span class="menu">Freeze/Unfreeze image</span></td><td><span class="key">ALT</span> <span class="key">F</span></td><td> </td><td>Stops/continues updating the magnification area.</td></tr>
-<tr><td><span class="menu">Stick coordinates</span></td><td><span class="key">ALT</span> <span class="key">I</span></td><td> </td><td>Keeps updating the magnification area, but don't follow the mouse pointer any more.</td></tr>
+<tr><td><span class="menu">Stick coordinates</span></td><td><span class="key">ALT</span> <span class="key">I</span></td><td> </td><td>Keeps updating the magnification area, but doesn't follow the mouse pointer any more.</td></tr>
 <tr><td><span class="menu">Make square</span></td><td><span class="key">ALT</span> <span class="key">/</span></td><td> </td><td>Reverts back to a square display after resizing the window.</td></tr>
 <tr><td class="onelinetop"><span class="menu">Decrease window size</span></td><td><span class="key">ALT</span> <span class="key">-</span></td><td> </td><td>Shrinks the magnified area around the mouse pointer.</td></tr>
 <tr><td><span class="menu">Increase window size</span></td><td><span class="key">ALT</span> <span class="key">+</span></td><td> </td><td>Enlarges the magnified area around the mouse pointer.</td></tr>
@@ -69,7 +69,7 @@ double-clicking a supported file.</i></td></tr>
 <img src="../images/apps-images/packageinstaller.png" alt="packageinstaller.png" />
 <p>The main window gives access to two configurations:</p>
 <ul>
-<li>installation type (depending on the developer there might be more than one (standard) installation option)</li>
+<li>type of installation (depending on the developer there might be more than one (standard) installation option).</li>
 <li>Installation location (only entire partitions/hard disks can be chosen, not custom paths)</li>
 </ul>
 <p>After clicking Install the extraction and installation process will begin.</p>
@@ -63,7 +63,7 @@ double-clicking a supported file.</i></td></tr>
 <tr><td>Settings:</td><td></td><td><span class="path">~/config/settings/ShowImage_settings</span></td></tr>
 </table>
 <p><br /></p>
-<p>ShowImage allows you to view images in all formats that are supported through <a href="../preferences/datatranslation.html">DataTranslators</a>. New formats are automatically recognized when their translator is added to the system. This has been done for Haiku's vector icon files, WonderBrush images or when WebP images became available, for example.<br />
+<p>ShowImage allows you to view images in all formats that are supported through <a href="../preferences/datatranslations.html">DataTranslators</a>. New formats are automatically recognized when their translator is added to the system. This has been done for Haiku's vector icon files, WonderBrush images or when WebP images became available, for example.<br />
 ShowImage provides minimal editing features to crop, rotate and flip images and to save them in another format.</p>
 <h2><a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>Viewing</h2>
 <img src="../images/apps-images/showimage-view.jpg" alt="showimage-view.jpg" />
@@ -93,7 +93,7 @@
 		Disables Advanced Configuration and Power Interface hardware support, overriding the ACPI setting in the kernel settings file.</p>
 	<p><span class="menu">Blacklist entries</span><br />
 		Allows to select system files that shall be ignored. Useful e.g. to disable drivers temporarily. See <a href="#troubleshooting">Troubleshooting</a> below.</p></td></tr>
-<tr><td><b>Select debug options</b></td><td> </td><td>Here you'll find several options that help with debugging or getting details for a <a href="../welcome/en/bugreports.html">bug report</a>. Again, a short explanation for each option is displayed at the bottom.</td></tr>
+<tr><td><b>Select debug options</b></td><td> </td><td>Here you'll find several options that help with debugging or getting details for a <a href="../../welcome/en/bugreports.html">bug report</a>. Again, a short explanation for each option is displayed at the bottom.</td></tr>
 <tr><td></td><td></td><td>
 	<p><span class="menu">Enable serial debug output</span><br />
 		Turns on forwarding the syslog output to the serial interface (default: 115200, 8N1).</p>
@@ -119,7 +119,7 @@
 <h2>
 <a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 <a id="troubleshooting" name="troubleshooting">Troubleshooting</a></h2>
-<p>If Haiku refuses to boot on your hardware from the get-go, try out setting different options under <span class="menu">Select safe mode options</span>. Consider filing a <a href="../welcome/en/bugreports.html">bug report</a> in any case.</p>
+<p>If Haiku refuses to boot on your hardware from the get-go, try out setting different options under <span class="menu">Select safe mode options</span>. Consider filing a <a href="../../welcome/en/bugreports.html">bug report</a> in any case.</p>
 <p>On the other hand, if Haiku only suddenly acts up after you have installed some software, especially hardware drivers, you have several options to get Haiku bootable again so you can uninstall the offending package:</p>
 <ul>
 <li><p>Activating <span class="menu">Safe mode</span> will prevent most servers, daemons and the UserBootScript from being started.</p></li>
@@ -84,7 +84,9 @@
 	<tr><td style="width:24px;"><img src="../images/prefs-images/network-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/network.html">Network</a></td><td> </td>
 		<td valign="top">Configure your network.</td></tr>
 	<tr><td style="width:24px;"><img src="../images/prefs-images/printers-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/printers.html">Printers</a></td><td> </td>
-		<td valign="top">Add, remove and configure printers.</td></tr>
+		<td valign="top"><span style="color:silver">Add, remove and configure printers. [<i>still missing</i>]</span></td></tr>
+	<tr><td style="width:24px;"><img src="../images/prefs-images/repositories-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/repositories.html">Repositories</a></td><td> </td>
+		<td valign="top">Manage software repositories.</td></tr>
 	<tr><td style="width:24px;"><img src="../images/prefs-images/screen-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/screen.html">Screen</a></td><td> </td>
 		<td valign="top">Configure resolution, depth, refresh rate and number of used Workspaces.</td></tr>
 	<tr><td style="width:24px;"><img src="../images/prefs-images/screensaver-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/screensaver.html">ScreenSaver</a></td><td> </td>
@@ -48,7 +48,7 @@
 <span>
  «  <a href="network.html">Network</a> 
 ::  <a href="../preferences.html" class="uplink">Preferences</a> 
-::  <a href="screen.html">Screen</a>  »
+::  <a href="repositories.html">Repositories</a>  »
 </span></div>
 </div>

@@ -69,9 +69,9 @@
 <!--
 <div class="nav">
 <div class="inner"><span>
- «  <a href="network.html">Network</a> 
-::  <a href="../preferences.html" class="uplink">Preferences</a> 
-::  <a href="screen.html">Screen</a>  »
+ «  <a href="network.html">Network</a> 
+::  <a href="../preferences.html" class="uplink">Preferences</a> 
+::  <a href="repositories.html">Repositories</a>  »
 </span></div>
 </div>
 -->
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-US">
+<head>
+<!-- 
+ *
+ * Copyright 2017, Haiku. All rights reserved.
+ * Distributed under the terms of the MIT License.
+ *
+ * Authors:
+ *		Humdinger <humdingerb@gmail.com>
+ *
+-->
+	<meta http-equiv="content-type" content="text/html; charset=utf-8" />
+	<meta http-equiv="Content-Style-Type" content="text/css" />
+	<meta name="robots" content="all" />
+	<title>Repositories</title>
+	<link rel="stylesheet" type="text/css" href="../../Haiku-doc.css" />
+</head>
+<body>
+
+<div id="banner">
+<div><span>User guide</span></div>
+</div>
+
+<div class="nav">
+<div class="inner">
+<ul class="lang-menu">
+<li class="now"><img src="../../images/flags/gb.png" alt="" /> English</li>
+<li><a href="../../fr/preferences/repositories.html"><img src="../../images/flags/fr.png" alt="" />Français</a></li>
+<li><a href="../../de/preferences/repositories.html"><img src="../../images/flags/de.png" alt="" />Deutsch</a></li>
+<li><a href="../../it/preferences/repositories.html"><img src="../../images/flags/it.png" alt="" />Italiano</a></li>
+<li><a href="../../ru/preferences/repositories.html"><img src="../../images/flags/ru.png" alt="" />Русский</a></li>
+<li><a href="../../es/preferences/repositories.html"><img src="../../images/flags/es.png" alt="" />Español</a></li>
+<li><a href="../../sv_SE/preferences/repositories.html"><img src="../../images/flags/sv_SE.png" alt="" />Svenska</a></li>
+<li><a href="../../jp/preferences/repositories.html"><img src="../../images/flags/jp.png" alt="" />日本語</a></li>
+<li><a href="../../uk/preferences/repositories.html"><img src="../../images/flags/uk.png" alt="" />Українська</a></li>
+<li><a href="../../zh_CN/preferences/repositories.html"><img src="../../images/flags/zh_CN.png" alt="" /> 中文 ［中文］</a></li>
+<li><a href="../../pt_PT/preferences/repositories.html"><img src="../../images/flags/pt_PT.png" alt="" />Português</a></li>
+<li><a href="../../fi/preferences/repositories.html"><img src="../../images/flags/fi.png" alt="" />Suomi</a></li>
+<li><a href="../../sk/preferences/repositories.html"><img src="../../images/flags/sk.png" alt="" />Slovenčina</a></li>
+<li><a href="../../hu/preferences/repositories.html"><img src="../../images/flags/hu.png" alt="" />Magyar</a></li>
+<li><a href="../../pt_BR/preferences/repositories.html"><img src="../../images/flags/pt_BR.png" alt="" />Português (Brazil)</a></li>
+<li><a href="../../ca/preferences/repositories.html"><img src="../../images/flags/ca.png" alt="" />Català</a></li>
+<li><a href="../../pl/preferences/repositories.html"><img src="../../images/flags/pl.png" alt="" />Polski</a></li>
+<li><a href="../../ro/preferences/repositories.html"><img src="../../images/flags/ro.png" alt="" />Română</a></li>
+</ul>
+
+<span>
+ «  <a href="printers.html">Printers</a> 
+::  <a href="../preferences.html" class="uplink">Preferences</a>
+::  <a href="screen.html">Screen</a>  »
+</span></div>
+</div>
+
+<div id="content">
+<div>
+
+<h2><img src="../../images/prefs-images/repositories-icon_64.png" alt="repositories-icon_64.png" width="64" height="64" />Repositories</h2>
+<table summary="quickinfo" border="0" cellspacing="0" cellpadding="2">
+<tr><td>Deskbar:</td><td style="width:15px;"></td><td><span class="menu">Preferences</span></td></tr>
+<tr><td>Location:</td><td></td><td><span class="path">/boot/system/preferences/Repositories</span></td></tr>
+<tr><td>Settings:</td><td></td><td><span class="path">~/config/settings/Repositories_settings</span></td></tr>
+</table>
+<p>Repositories are collections of software packages. Set up by default, there's the <i>Haiku</i> repo with all of the operating system's packages and <i>HaikuPorts</i>, which provides a large number of ported and native Haiku software. There are several more repositories, curated by members of the Haiku community. Checkout <a href="https://www.haiku-os.org/community/software">Software Sites</a> on the website.</p>
+<p>This is the preference panel to manage your respositories (you can open it also from <a href="../applications/haikudepot.html">HaikuDepot's</a> <span class="menu">Tools</span> menu):</p>
+<img src="../images/prefs-images/repositories.png" alt="repositories.png" />
+<p>The first column in the list of known repositories shows if a repo is currently enabled. If it doesn't have a checkmark, it will not be queried by HaikuDepot or <span class="cli">pkgman</span> from the command line. Use the buttons to <span class="button">Enable</span> or <span class="button">Disable</span> the selected repositories, or double-click a repo to toggle the status.</p>
+<p>Depending on the size of the repository and the speed of the internet connection, enabling a repository may take a few seconds. If it takes longer, you're informed of pending tasks in the little text box above the <span class="button">+/-</span> buttons. If it takes unusually long, you'll be asked to either cancel or retry.</p>
+<p>To be able to remove a repository completely with the "<span class="button">-</span>" button, it has to be disabled.<br />
+You add a new repository with the "<span class="button"> </span>" button, which will open this panel:</p>
+<img src="../images/prefs-images/repositories_add.png" alt="repositories_add.png" />
+<p>To add a new repository, just paste its URL into the text field. It'll be named "Unknown" until you enable it.</p>
+<div class="box-warning">It goes without saying that adding a repository and downloading and installing software from it is a matter of trust. Don't carelessly just add any URL you happen upon on the internets.</div>
+</div>
+</div>
+
+<div class="nav">
+<div class="inner"><span>
+ «  <a href="printers.html">Printers</a> 
+::  <a href="../preferences.html" class="uplink">Preferences</a>
+::  <a href="screen.html">Screen</a>  »
+</span></div>
+</div>
+
+</body>
+</html>
@@ -4,7 +4,7 @@
 <head>
 <!-- 
 *
- * Copyright 2008-2011, Haiku. All rights reserved.
+ * Copyright 2008-2016, Haiku. All rights reserved.
 * Distributed under the terms of the MIT License.
 *
 * Authors:
@@ -46,7 +46,7 @@
 <li><a href="../../ro/preferences/screen.html"><img src="../../images/flags/ro.png" alt="" />Română</a></li>
 </ul>
 <span>
- «  <a href="printers.html">Printers</a> 
+ «  <a href="repositories.html">Repositories</a> 
 ::  <a href="../preferences.html" class="uplink">Preferences</a> 
 ::  <a href="screensaver.html">ScreenSaver</a>  »
 </span></div>
@@ -67,19 +67,19 @@
 <img src="../images/prefs-images/screen.png" alt="screen.png" />
 <p>The top menu specifies if your changes are applied only to the current or to all workspaces. Depending on your graphics card, the other menus contain all supported resolution, color depth and refresh rate settings.</p>
 <p>After clicking on <span class="button">Apply</span>, the graphics mode is changed and an alert appears, asking you to keep or cancel the changes. If you don't answer that alert, the graphics mode reverts after 12 seconds to the previous setting. Maybe you couldn't see the alert because your monitor didn't support the setting.</p>
-<p>To the left, you see a representation of your screen with the manufacturer and model it reports and it's resolution in dots per inch (dpi). Hovering the mouse pointer over it shows a tooltip with the name of graphics card if it's supported by a driver. Otherwise it says "VESA", the quick fallback solution that works with pretty much every hardware.</p>
-<p><span class="button">Revert</span> brings back the setting that was active when you started the Screen preferences.</p>
+<p>There's a key combination that always works, not only when the Screen preferences are open: <span class="key">SHIFT</span> <span class="key">CTRL</span> <span class="key">ALT</span> <span class="key">ESC</span> sets a fall-back video safe mode. Handy if your monitor doesn't report its capabilities correctly and your settings result in a distorted or black screen. Here too, an alert pops up and if you do nothing for 12 seconds or press <span class="key">ESC</span> you'll revert back.</p>
+<p>On the left side of the window, you see a representation of your screen with the manufacturer and model it reports and it's resolution in dots per inch (dpi). It also shows the name of graphics card if it's supported by a driver. Otherwise it says "VESA", the quick fallback solution that works with pretty much every hardware.</p>
 <div class="box-info">While Haiku's VESA mode performs very well, you may experience some limitations. You may not be able to drive your widescreen display in its native resolution, resulting in a somewhat blurred picture. There may also be limitations with regard to available color depths and refresh rates.</div>
+<p><span class="button">Revert</span> brings back the setting that was active when you started the Screen preferences.</p>
 <p>To the bottom left you can set the number of workspaces and arrange them in columns and rows and open the <a href="backgrounds.html">Backgrounds</a> preferences.</p>
-
 </div>
 </div>

 <div class="nav">
 <div class="inner"><span>
- «  <a href="printers.html">Printers</a> 
-::  <a href="../preferences.html" class="uplink">Preferences</a> 
-::  <a href="screensaver.html">ScreenSaver</a>  »
+ «  <a href="repositories.html">Repositories</a> 
+::  <a href="../preferences.html" class="uplink">Preferences</a> 
+::  <a href="screensaver.html">ScreenSaver</a>  »
 </span></div>
 </div>

@@ -107,7 +107,7 @@ In any case, try to keep the status name short. That way it always fits in a nor
 <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>
-<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="applications/processcontroller.html">ProcessController</a> to see how it affects CPU usage.</div>
+<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>
 <img src="images/workshop-email-images/daemon-in-deskbar.png" alt="daemon-in-deskbar.png" />