Update userguide from i18n.haiku-os.org.

2012-08-18 10:28:04 +02:00
parent 9ff0fe5615
commit 5bde1d438b
460 changed files with 5370 additions and 2957 deletions
@@ -53,6 +53,7 @@

 <div id="content">
 <div>
+<div class="box-info">La traduzione di questa pagina non è stata completata. Per questo motivo le parti non tradotte sono visibili in inglese.</div>

 <h2><img src="../../images/apps-images/expander-icon_64.png" alt="expander-icon_64.png" width="64" height="64" />Expander</h2>
 <table summary="layout" border="0" cellspacing="0" cellpadding="2">
@@ -65,15 +66,15 @@
 È sufficiente effettuare un doppio clic su un archivio per visualizzare la semplice interfaccia dell'applicazione :</p>
 <p><img id="expander" src="../images/apps-images/expander.png" alt="expander.png" /></p>
 <table summary="layout" border="0" cellspacing="0" cellpadding="2">
-<tr><td style="width:80px;"><span class="button">Origine</span></td><td style="width:70px;"><span class="key">ALT</span> <span class="key">S</span></td><td>aprirà una finestra di selezione file per cercare un archivio da decomprimere.</td></tr>
+<tr><td style="width:80px;"><span class="button">Origine</span></td><td style="width:70px;"><span class="key">ALT</span> <span class="key">O</span></td><td>aprirà una finestra di selezione file per cercare un archivio da decomprimere.</td></tr>
 <tr><td><span class="button">Destinazione</span></td><td><span class="key">ALT</span> <span class="key">D</span></td><td>aprirà una finestra di selezione file per impostare una destinazione.</td></tr>
 <tr><td><span class="button">Espandi</span></td><td><span class="key">ALT</span> <span class="key">E</span></td><td>darà inizio al processo di decompressione che può sempre essere annullato con <span class="key">ALT</span> <span class="key">K</span>.</td></tr>
 </table>
 <p>È possibile attivare o disattivare la visualizzazione dei file tramite l'impostazione di <i>Show Contents</i> o premendo <span class="key">ALT</span> <span class="key">L</span>.</p>
 <div class="box-info">Expander si occupa solamente di decomprimere interi archivi.<br />
 Non è possibile né decomprimere singoli file né aggiungerne o rimuoverne da un archivio esistente.</div>
-<p><span class="menu">Edit | Preferences...</span> o <span class="key">ALT</span> <span class="key">P</span> apre un pannello per le preferenze che offre alcune impostazioni utili per configurare il comportamento di Expander.<br />
-Le opzioni si spiegano tutte pressoché da sole:</p>
+<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>

 </div>
@@ -22,7 +22,7 @@
 <body>

 <div id="banner">
-<div><span>User guide</span></div>
+<div><span>Guida dell'utente</span></div>
 </div>

 <div class="nav">
@@ -49,7 +49,7 @@

 <div id="content">
 <div>
-<div class="box-info">The translation of this page isn't yet complete. Until it is, unfinished parts use the English original.</div>
+<div class="box-info">La traduzione di questa pagina non è stata completata. Per questo motivo le parti non tradotte sono visibili in inglese.</div>

 <h1>Benvenuto alla guida dell'utente Haiku</h1>

@@ -4,7 +4,7 @@
 <head>
 <!-- 
 *
- * Copyright 2008-2011, Haiku. All rights reserved.
+ * Copyright 2008-2012, Haiku. All rights reserved.
 * Distributed under the terms of the MIT License.
 *
 * Authors:
@@ -13,6 +13,7 @@
 *		Andrea
 *		Barrett
 *		giuseppe
+ *		Humdinger
 *
 -->
 	<meta http-equiv="content-type" content="text/html; charset=utf-8" />
@@ -104,14 +105,17 @@ Si può aggiungere ed eliminare ogni voce come collegamenti alle applicazioni, d
 </table></li>
 <li><p><b>Applications</b></p>
 <table summary="layout" border="0" cellpadding="2" cellspacing="0">
-<tr><td><span class="menu">Ordina le applicazioni attive</span></td><td> </td><td>Ordina alfabeticamente le applicazioni in esecuzione.</td></tr>
-<tr><td><span class="menu">Tracker sempre primo</span></td><td> </td><td> Anche se le applicazioni vengono ordinate alfabeticamente la voce Tracker rimane la prima della lista.</td></tr>
-<tr><td class="onelinetop"><span class="menu">Mostra l'espansore dell'applicazione</span></td><td> </td><td>Offre un piccolo widget per mostrare o nascondere tutte le finestre di un programma direttamente dalla sua voce nella Deskbar.</td></tr>
-<tr><td><span class="menu">Espandi le nuove applicazioni</span></td><td> </td><td>I programmi appena lanciati hanno la loro finestra  estesa automaticamente.</td></tr>
+<tr><td><span class="menu">Sort running applications</span></td><td> </td><td>Sorts the list of running programs alphabetically.</td></tr>
+<tr><td><span class="menu">Tracker always first</span></td><td> </td><td>Even if you sort alphabetically, the Tracker entry always stays first in the list.</td></tr>
+<tr><td class="onelinetop"><span class="menu">Show application expander</span></td><td> </td><td>Provides a small widget to show/hide all windows of a program directly under its entry in the Deskbar.</td></tr>
+<tr><td><span class="menu">Expand new applications</span></td><td> </td><td>Newly launched programs have their windows automatically expanded under their entry in the Deskbar.</td></tr>
+<tr><td><span class="menu">Hide application names</span></td><td> </td><td>Removes the text labels of running applications.</td></tr>
+<tr><td><span class="menu">Icon size</span></td><td> </td><td>Adjusts the icon size of running applications. </td></tr>
 </table></li>
 <li><p><b>Clock</b></p>
 <table summary="layout" border="0" cellpadding="2" cellspacing="0">
-<tr><td><span class="menu">Mostra i secondi</span></td><td> </td><td>Aggiunge la visualizzazione dei secondi sull'orologio.</td></tr>
+<tr><td><span class="menu">Show seconds</span></td><td> </td><td>Adds the display of seconds to the clock.</td></tr>
+<tr><td><span class="menu">Show day of week</span></td><td> </td><td>Adds the abbreviation of the weekday to the clock.</td></tr>
 </table></li>
 </ul>

@@ -64,7 +64,7 @@
 Wherever installed, it's operated via a right-click context menu.</p>
 <p><img src="../images/networkstatus-images/applet.png" alt="NetworkStatus applet" /><br />
 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.<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>

 <h2>Icone di stato</h2>
@@ -53,13 +53,14 @@

 <div id="content">
 <div>
+<div class="box-info">La traduzione di questa pagina non è stata completata. Per questo motivo le parti non tradotte sono visibili in inglese.</div>

 <h1>La struttura del FileSystem di Haiku</h1>

 <p>Il filesystem di Haiku è molto trasparente, per non confondere l'utente si cerca sempre di non assegnare nomi criptici per i file e per le cartelle di sistema. Le cartelle ed i file sono importanti per il corretto funzionamento del sistema e sono protetti dalle modifiche accidentali mostrando uno dei seguenti avvertimenti:</p>
 <img src="images/filesystem-layout-images/achtung-user.png" alt="achtung-user.png" /> 
 <img src="images/filesystem-layout-images/achtung-system.png" alt="achtung-system.png" />
-<p>Il secondo avvertimento compare qualora si provi a rinominare o a cancellare qualcosa nella gerarchia di sistema. Il bottone "<span class="button">Do it</span>" diventerà cliccabile solamente tenendo premuto il tasto <span class="key">SHIFT</span>.</p>
+<p>The second alert pops up if you try to rename or delete something in the system hierarchy. Here, the "<span class="button">Rename</span>" button will only become clickable when you're holding down the <span class="key">SHIFT</span> key.</p>
 <p>Generalmente, ci sono tre directory separate che partono dalla cartella principale del volume di avvio:</p>
 <table summary="layout" border="0" cellspacing="0" cellpadding="2">
 <tr><td><span class="path">/boot/system/</span></td><td> </td><td>appartiene al sistema. Non deve essere modificata!</td></tr>
@@ -78,13 +78,14 @@
 <li>Si può mandare una finestra in background con un click destro sul suo tab (o sul suo bordo).</li></ul></li>
 <li><p>Il pulsante di chiusura.</p></li>
 <li><p>Il bottone "zoom" (o <span class="key">CTRL</span> <span class="key">ALT</span> <span class="key">Z</span>). Nella maggior parte delle applicazioni, espanderà la finestra alla dimensione massima. Ma questo, tuttavia, non è obbligatorio. Le finestre del Tracker, per esempio, verranno ridimensionate per adattarsi nel miglior modo possibile al contenuto.</p></li>
-<li><p>L'angolo di ridimensionamento. Il trascinamento di una finestra in qualsiasi altro luogo sul confine sposterà la finestra.</p></li>
+<li><p>The window border. Left-dragging moves the window, right-dragging resizes.</p></li>
+<li><p>The resize corner.</p></li>
 </ol>

 <h2>
 <a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 <a id="move-resize" name="move-resize">A quick way to move or resize windows</a></h2>
-<p>Moving and resizing windows is a large part of interacting with several concurrently running applications. Instead of aiming at the small yellow title tab or the even tinier window border, there's a more convenient way to move a window. Also, additionally to its small size, the resize corner has another limitation: It only allows resizing at and in the direction of the lower right corner.</p>
+<p>Moving and resizing windows is a large part of interacting with several concurrently running applications. Instead of aiming at the small yellow title tab or the even tinier window border, there's a more convenient way to move a window. Also, additionally to its small size, the resize corner has another limitation: It only allows resizing at and in the direction of the lower right corner. <br />Right-dragging a border for resizing works, but again you'll have to aim carefully.</p>
 <p>To address these issues, Haiku provides a neat solution using the window management key combo <span class="key">CTRL</span> <span class="key">ALT</span> and the mouse. See also chapter <a href="keyboard-shortcuts.html#general">Shortcuts and key combinations</a> for more shortcuts concerning window management.</p>
 <img src="images/gui-images/resizing.png" alt="resizing.png" />
 <p>Holding down <span class="key">CTRL</span> <span class="key">ALT</span> will highlight the window borders nearest to the mouse pointer. Move the mouse in the direction of another border to change the target. Click and dragging with the <i>right mouse button</i> will resize the window along the highlighted border(s).</p>
@@ -106,7 +107,7 @@ While holding <span class="key">OPT</span>, tabs change color when they overlap;
 <table summary="layout" border="0" cellspacing="0" cellpadding="2" vspace="10">
 <tr><td><img src="images/gui-images/gui-tiling.png" alt="gui-tilinging.png" /></td><td></td>
 <td><p>"<i>Tiling</i>" means gluing windows horizontally or vertically together.<br />
-Again, while holding <span class="key">OPT</span>, the borders that'll fuse together when you drop the window change color when brought near each other.</p></td></tr></table>
+Again, while holding <span class="key">OPT</span>, the borders that'll fuse together when you drop the window, change color when brought near each other.</p></td></tr></table>
 <p>Separation is done in the same way, by holding <span class="key">OPT</span> while dragging a window by its tab out of the group.</p>

 <h2>
@@ -70,8 +70,6 @@
 		<td valign="top">Configura gli account per le tue e-mail</td></tr>
 	<tr><td style="width:24px;"><img src="../images/prefs-images/filetypes-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/filetypes.html">FileTypes</a></td><td> </td>
 		<td valign="top">Aggiunge, rimuove e configura i tipi di file.</td></tr>
-	<tr><td style="width:24px;"><img src="../images/prefs-images/fonts-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/fonts.html">Fonts</a></td><td> </td>
-		<td valign="top">Configura i caratteri del sistema.</td></tr>
 	<tr><td style="width:24px;"><img src="../images/prefs-images/keyboard-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/keyboard.html">Keyboard</a></td><td> </td>
 		<td valign="top">Configura il ritardo di ripetizione e la frequenza.</td></tr>
 	<tr><td style="width:24px;"><img src="../images/prefs-images/keymap-icon_16.png" alt="icon" width="16" height="16" /></td><td><a href="preferences/keymap.html">Keymap</a></td><td> </td>
@@ -4,7 +4,7 @@
 <head>
 <!-- 
 *
- * Copyright 2008-2009, Haiku. All rights reserved.
+ * Copyright 2008-2012, Haiku. All rights reserved.
 * Distributed under the terms of the MIT License.
 *
 * Authors:
@@ -59,21 +59,40 @@
 <table summary="quickinfo" border="0" cellspacing="0" cellpadding="2">
 <tr><td>Deskbar:</td><td style="width:15px;"></td><td><span class="menu">Preferenze</span></td></tr>
 <tr><td>Localita:</td><td></td><td><span class="path">/boot/system/preferences/Appearance</span></td></tr>
-<tr><td>Impostazioni:</td><td></td><td><span class="path">~/config/settings/system/app_server/appearance</span></td></tr>
+<tr><td>Impostazioni:</td><td></td><td><span class="path">~/config/settings/system/app_server/appearance</span><br />
+<span class="path">~/config/settings/system/app_server/decorator_settings</span><br />
+<span class="path">~/config/settings/system/app_server/fonts</span></td></tr>
 </table>
 <p>Le preferenze in Appearance permettono di cambiare alcuni aspetti visivi di Haiku .</p>

+<h2>
+<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
+<a id="fonts" name="fonts">Fonts</a></h2>
+<img src="../images/prefs-images/appearance-fonts.png" alt="appearance-fonts.png" />
+<p>Haiku defines three standard fonts for different purposes. You set plain, bold and fixed font types and sizes that will be used throughout the system. Besides these, there's also a separate setting for the font used in menus.</p>
+
+<h3>
+<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
+<a id="installing_fonts" name="installing_fonts">Installing new fonts</a></h3>
+<p>You install new fonts by copying them into their respective user folder, i.e. <span class="path">/boot/common/data/fonts/</span> or <span class="path">/boot/home/config/data/fonts/</span> (see topic <a href="../filesystem-layout.html">Filesystem layout</a>).</p>
+
 <h2>
 <a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
 <a id="colors" name="colors">Colori</a></h2>
 <img src="../images/prefs-images/appearance-colors.png" alt="appearance-colors.png" />
-<p>Nella prima tab, <span class="menu">Colori</span>, si possono cambiare i colori di diverse parti dell'interfaccia utente. Il colore accetta anche drag&amp;drop da altri programmi, permettendo di prendere colori da, per esempio, <span class="app">WonderBrush</span>, <span class="app">Icon-O-Matic</span> o dal pannello di <span class="app">Backgrounds</span>.</p>
+<p>In the <span class="menu">Colors</span> tab, you can change the colors of different parts of the user interface. The color well accepts drag&amp;drops from other programs, letting you drag colors over from e.g. <span class="app">WonderBrush</span>, <span class="app">Icon-O-Matic</span> or the <span class="app">Backgrounds</span> panel.</p>
+
+<h2>
+<a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
+<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>

 <h2>
 <a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
 <a id="antialiasing" name="antialiasing">Antialiasing</a></h2>
 <img src="../images/prefs-images/appearance-antialiasing.png" alt="appearance-antialiasing.png" />
-<p>The second tab, <span class="menu">Antialiasing</span>, provides different settings for how things are rendered on screen.</p>
+<p>The tab <span class="menu">Antialiasing</span> provides different settings for how things are rendered on screen.</p>

 <h3>
 <a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
@@ -45,7 +45,7 @@
 <span>
  «  <a href="e-mail.html">E-mail</a> 
 ::  <a href="../preferences.html" class="uplink">Preferenze</a> 
-::  <a href="fonts.html">Fonts</a>  »
+::  <a href="keyboard.html">Keyboard</a>  »
 </span></div>
 </div>

@@ -69,7 +69,7 @@
 <div class="inner"><span>
  «  <a href="e-mail.html">E-mail</a> 
 ::  <a href="../preferences.html" class="uplink">Preferenze</a> 
-::  <a href="fonts.html">Fonts</a>  »
+::  <a href="keyboard.html">Keyboard</a>  »
 </span></div>
 </div>
 -->
@@ -41,7 +41,7 @@
 <li><a href="../../en/preferences/keyboard.html"><img src="../../images/flags/gb.png" alt="" />English</a></li>
 </ul>
 <span>
- «  <a href="fonts.html">Fonts</a> 
+ «  <a href="filetypes.html">FileTypes</a> 
 ::  <a href="../preferences.html" class="uplink">Preferenze</a> 
 ::  <a href="keymap.html">Keymap</a>  »
 </span></div>
@@ -71,7 +71,7 @@
 <!--
 <div class="nav">
 <div class="inner"><span>
- «  <a href="fonts.html">Fonts</a> 
+ «  <a href="filetypes.html">FileTypes</a> 
 ::  <a href="../preferences.html" class="uplink">Preferenze</a> 
 ::  <a href="keymap.html">Keymap</a>  »
 </span></div>
@@ -52,13 +52,14 @@

 <div id="content">
 <div>
+<div class="box-info">La traduzione di questa pagina non è stata completata. Per questo motivo le parti non tradotte sono visibili in inglese.</div>

 <h1>Team Monitor</h1>

 <p>Con la scorciatoia <span class="key">CTRL</span> <span class="key">ALT</span> <span class="key">DEL</span> è possibile avviare il Team Monitor che elenca tutti i programmi in esecuzione.</p>
 <img src="images/teammonitor-images/teammonitor.png" alt="teammonitor.png" />
-<p>I programmi lanciati dal sistema sono segnati in blu, quelli lanciati dall'utente sono di colore nero.<br />
-Le applicazioni che non rispondono sono segnate in rosso, indice che molto probabilmente sono andate in crash, è possibile chiudere un programma selezionandolo e premendo il bottone <span class="button">Kill Application</span>.</p>
+<p>Programs that were launched by the system are blue, those started by the user black.<br />
+Applications that are unresponsive, which is often a sign the program has crashed, are marked red. You can try to quit a program by selecting it and pressing <span class="button">Quit application</span> (or either <span class="key">DEL</span> or <span class="key">Q</span>). If that doesn't work, try <span class="button">Kill application</span> (or <span class="key">SHIT</span> <span class="key">DEL</span> or <span class="key">K</span>) instead.</p>
 <p>E' possibile aprire il Terminale con <span class="key">OPT</span> <span class="key">ALT</span> <span class="key">T</span>.</p>
 <p>Se il Tracker o la Deskbar vanno in crash oppure si bloccano, apparirà un nuovo bottone (potrebbe essere necessario chiudere prima le applicazioni interessate): <span class="button">Restart the Desktop</span> che riavvierà il Tracker e/o la Deskbar.</p>

@@ -0,0 +1,145 @@
+<?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" xml:lang="en">
+<head>
+<!-- 
+ *
+ * Copyright 2012, Haiku, Inc. 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>Workshop: Wireless networking</title>
+	<link rel="stylesheet" type="text/css" href="../Haiku-doc.css" />
+</head>
+<body>
+
+<div id="banner">
+<div><span>Guida dell'utente</span></div>
+</div>
+
+<div class="nav">
+<div class="inner">
+<ul class="lang-menu">
+<li class="now"><img src="../images/flags/it.png" alt="" /> Italiano</li>
+<li><a href="../fr/workshop-wlan.html"><img src="../images/flags/fr.png" alt="" />Français</a></li>
+<li><a href="../de/workshop-wlan.html"><img src="../images/flags/de.png" alt="" />Deutsch</a></li>
+<li><a href="../ru/workshop-wlan.html"><img src="../images/flags/ru.png" alt="" />Русский</a></li>
+<li><a href="../es/workshop-wlan.html"><img src="../images/flags/es.png" alt="" />Español</a></li>
+<li><a href="../sv_SE/workshop-wlan.html"><img src="../images/flags/sv_SE.png" alt="" />Svenska</a></li>
+<li><a href="../jp/workshop-wlan.html"><img src="../images/flags/jp.png" alt="" />日本語</a></li>
+<li><a href="../uk/workshop-wlan.html"><img src="../images/flags/uk.png" alt="" />Українська</a></li>
+<li><a href="../zh_CN/workshop-wlan.html"><img src="../images/flags/zh_CN.png" alt="" /> 中文 ［中文］</a></li>
+<li><a href="../pt_PT/workshop-wlan.html"><img src="../images/flags/pt_PT.png" alt="" />Português</a></li>
+<li><a href="../fi/workshop-wlan.html"><img src="../images/flags/fi.png" alt="" />Suomi</a></li>
+<li><a href="../sk/workshop-wlan.html"><img src="../images/flags/sk.png" alt="" />Slovenčina</a></li>
+<li><a href="../en/workshop-wlan.html"><img src="../images/flags/gb.png" alt="" />English</a></li>
+</ul>
+
+<span>
+ «  <a href="workshop-email.html">Workshop: Managing Email</a> 
+::  <a href="contents.html" class="uplink">Contents</a> 
+::  <a href="applications.html">Applications</a>  »
+</span></div>
+</div>
+
+<div id="content">
+<div>
+<div class="box-info">La traduzione di questa pagina non è stata completata. Per questo motivo le parti non tradotte sono visibili in inglese.</div>
+
+
+<table class="index" id="index" summary="index">
+<tr class="heading"><td>Index</td></tr>
+<tr class="index"><td>
+	<a href="#firmware">Getting supported hardware to work</a><br />
+	<a href="#gui">Joining a wireless network</a><br />
+	<a href="#commandline">Joining from the command line</a><br />
+	<a href="#tips">Tips</a>
+</td></tr>
+</table>
+
+<h1>Workshop: Wireless networking</h1>
+
+<p>Getting the networking to run is essential in today's need for permanent internet connection. As keeping up to date with all the different and ever changing hardware and drivers is quite impossible for a small project, Haiku relies on a <a href="http://www.freebsd.org">FreeBSD</a> compatibility layer for its networking drivers.<br />
+This ensures a massive amount of supported hardware, though probably not 100% of what's out there. See <a href="https://www.haiku-os.org/guides/daily-tasks/wireless#hardware-notes">this list online</a> for a list of supported models or check <a href="http://www.freebsd.org/releases/9.0R/hardware.html#WLAN">FreeBSD 9's release hardware notes</a>.</p>
+<div class="box-info">Currently only PCI, PCI-X, PCI-Express, Mini PCI, and Mini PCI-Express devices are expected to work.<br />
+PCMCIA, CardBus, ExpressCard, USB and ISA devices still need more work to become functional.</div>
+
+<h2>
+<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
+<a id="firmware" name="firmware">Getting supported hardware to work</a></h2>
+<p>Even if the first hurdle of generally supported hardware is taken, some wireless network cards require binary firmware modules to properly operate. Haiku cannot include some of these proprietary firmware files due to licensing issues. Haiku does however include a simple script which will retrieve and install all of the needed proprietary bits for you. Generally, if you are planning to use wireless networking, it is a good idea to run this script to ensure your system has all of these firmwares available when they are needed.</p>
+<p>Open a Terminal and type:</p>
+<pre class="terminal">install-wifi-firmwares.sh</pre>
+<p>Now review the licenses and accept them to install all of the available firmware files.</p>
+
+<p>If you don't have internet access to download those lacking firmwares under Haiku, there's an offline method, see under <a href="#tips">tips</a> below.</p>
+
+<h2>
+<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
+<a id="gui" name="gui">Joining a wireless network</a></h2>
+<p>By default, Haiku will join the first unencrypted wireless network it finds after booting up. To connect to a specific network, you use the Desktop applet <a href="desktop-applets/networkstatus.html">NetworkStatus</a>.</p>
+<p>Right-click on its icon in the Deskbar and choose the network's public name (which is the "SSID" it broadcasts) from the context menu.</p>
+<img src="images/workshop-wlan-images/join-network.png" alt="join-network.png" />
+<p>A window opens where you enter the type of authentication (probably WPA/WPA2, WEP is not a secure encryption anymore!) and the password for that wireless network. Click <span class="button">OK</span> to start the login process.<br /> Depending on your hardware and network configuration this may take a while. You'll be kept informed of the progress by notifications:</p>
+<img src="images/workshop-wlan-images/join-status.gif" alt="join-network.gif" />
+<p>Once it reads "Ready" and the NetworkStatus icon in the Deskbar shows a green round light, the connection is established. If the notifications end in "No link" and a yellow triangle, something went wrong, probably an incorrect password.</p>
+
+<h2>
+<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
+<a id="commandline" name="commandline">Joining from the command line</a></h2>
+<p>If you prefer to use the command line or would like to use scripting or the <span class="path">~/config/boot/UserBootscript</span> to automate things to join a specific network on bootup, there's the command <tt>ifconfig</tt>.</p>
+<p>Start a Terminal and enter the first line to scan for available wireless networks:</p>
+<pre class="terminal">ifconfig /dev/net/iprowifi3945/0 scan
+name                             address              signal  auth
+haiku-top                        01:d0:19:a6:88:42        30  WPA
+ArcorInternet123                 00:20:12:a4:29:e1        15  WPA</pre>
+<p>The path to your wireless network adapter has to be adjusted, of course.<br />
+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>
+
+<h2>
+<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
+<a id="tips" name="tips">Tips</a></h2>
+<ul><li><p>Here is how you get to install your firmware if you don't yet have a working internet connection under Haiku. You download the following files while in another operating system, boot Haiku, copy them to their respective location and invoke the <span class="cli">install-wifi-firmwares.sh</span> script.</p>
+
+<ul>
+<li><p>Copy these two to <span class="path">/boot/system/data/firmware/broadcom43xx/b43-fwcutter/</span>:<br />
+		- <a href="http://www.haiku-files.org/files/wifi-firmwares/b43/fwcutter/b43-fwcutter-012.tar.bz2">http://www.haiku-files.org/files/wifi-firmwares/b43/fwcutter/b43-fwcutter-012.tar.bz2</a><br />
+		- <a href="http://cgit.haiku-os.org/haiku/plain/src/system/libroot/posix/glibc/string/byteswap.h">http://cgit.haiku-os.org/haiku/plain/src/system/libroot/posix/glibc/string/byteswap.h</a></p>
+</li>
+<li><p>Copy this to <span class="path">/boot/system/data/firmware/broadcom43xx/b43-fwcutter/bits</span>:<br />
+		- <a href="http://cgit.haiku-os.org/haiku/plain/src/system/libroot/posix/glibc/include/arch/x86/bits/byteswap.h">http://cgit.haiku-os.org/haiku/plain/src/system/libroot/posix/glibc/include/arch/x86/bits/byteswap.h</a></p>
+</li>
+<li><p>Copy this to <span class="path">/boot/system/data/firmware/broadcom43xx/</span>:<br />
+		- <a href="http://www.haiku-files.org/files/wifi-firmwares/b43/wl_apsta-3.130.20.0.o">http://www.haiku-files.org/files/wifi-firmwares/b43/wl_apsta-3.130.20.0.o</a></p>
+</li>
+<li><p>Copy this to <span class="path">/boot/system/data/firmware/marvell88w8335/</span>:<br />
+		- <a href="http://www.haiku-files.org/files/wifi-firmwares/marvell/malo-firmware-1.4.tgz">http://www.haiku-files.org/files/wifi-firmwares/marvell/malo-firmware-1.4.tgz</a></p>
+</li>
+</ul>
+<p>When all those files are in their place, proceed as described above, i.e. open a Terminal and type:</p>
+<pre class="terminal">install-wifi-firmwares.sh</pre>
+<p>Review the licenses and accept them to install all of the now available firmware files.</p>
+</li></ul>
+
+</div>
+</div>
+
+<div class="nav">
+<div class="inner"><span>
+ «  <a href="workshop-email.html">Workshop: Managing Email</a> 
+::  <a href="contents.html" class="uplink">Contenuti</a> 
+::  <a href="applications.html">Applicazioni</a>  »
+</span></div>
+</div>
+
+</body>
+</html>