Before diving into all the applications that come with Haiku, let's have a more detailed look at how to install and uninstall programs you downloaded somewhere, for example from a site mentioned on the Welcome page.
-Haiku software always comes as an archive. Most of the time it's a ZIP, some old BeOS packages come in Software Valet's PKG format. Software Valet was able to automatically execute installation scripts, so after double-clicking you just select a destination folder and everything's taken care of.
If it's a ZIP archive, double-clicking opens Expander where you also set the destination and unpack it. As explained in the topic Filesystem layout, that destination is either
 | ActivityMonitor | @@ -117,7 +123,9 @@ Otherwise, uninstalling is simply done by deleting the application's folder. | A viewer for analog TV. [still missing] |
Besides the above listed programs, which are all maintained by the Haiku project, there are a few essential applications bundled in a standard Haiku system. Bugs and feature requests for those have to be filed with the particular maintainer.
 | BePDF | diff --git a/docs/userguide/en/applications/apps-icon-o-matic.html b/docs/userguide/en/applications/apps-icon-o-matic.html index ba43ff282c..39e30a5ebd 100644 --- a/docs/userguide/en/applications/apps-icon-o-matic.html +++ b/docs/userguide/en/applications/apps-icon-o-matic.html @@ -63,7 +63,7 @@ |
Icons are stored as an attribute with their file. However, that doesn't mean that every file has to have this attribute to appear with an icon in a Tracker window: data files inherit their icon from their filetype. To globally change the filetype's icon you use the FileTypes preferences. If you only want to add a special icon to an individual file, you use the FileType Add-On on it instead. See topic Filetypes for more information.
Icon-O-Matic is Haiku's icon editor that can save your work as HVIF, SVG or PNG. The icon can also be directly attached as attribute to an existing file or exported as a resource or source file used by developers. Since the application was tailored to the optimized HVIF format, its usage reflects the inner workings of this format.
Other than your normal vector graphics software, you don't deal with separate objects that each include all their specific properties like path, stroke width, stroke and fill color etc. Rather, you assemble your objects ("shapes") from shared paths and colors ("styles") and set certain properties. This re-using of elements is one secret of HVIF's efficiency. Although that imposes some constraints on the icon designer, there are a few advantages, too.
@@ -121,7 +121,7 @@ For example, by re-using a path, several objects can be modified together by man
A path consists of several points which are connected with lines or Bezier curves. To add or change points, make sure, the path is selected in the path list.
@@ -185,7 +185,7 @@ width="16" height="16" />A shape groups together one or more paths with a style. Practically, it's the object that you'll actually see on the canvas. The grouping is done with the checkboxes in front of the paths and styles: Just select your shape and tick off the desired path(s) and a style.
A shape defines how a path and style is applied, e.g. if the object is filled or only stroked (which is done by using Transformers on the shape, we'll get to that later). Also, a shape can be moved, rotated or resized without touching the used path. That way, you can re-use a single path and get different, but related, shapes.
@@ -259,7 +259,7 @@ For example, if Shape 1 were to be shown below 48px and Shape 2 from 48px upwardA style can either be a solid color or some type of gradient.
Besides the predefined colors under , you can mix your own by clicking on the current color. Also, note the slider under the color spectrum which sets the alpha-channel (transparency).
A shape can have Transformers which change its appearance. The effects, however, are more subtle than a truck turning into a battle robot...
@@ -300,7 +300,7 @@ Of course you can move these indicators to change the gradient to your liking. YThere's your usual menu bar at the top, , , . The usage is pretty much self-explaining, so we'll only look at how to save your work.
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 "<path>/<shape>/<style>" which makes specific changes tedious.
@@ -319,7 +319,7 @@ Of course you can move these indicators to change the gradient to your liking. YA few things you should keep in mind when working with Icon-O-Matic and some general tips for its usage:
Haiku is not a multi-user system yet. Once it is though, every user has her own home folder that is not accessible to anyone else. Every application or added component like Tracker Add-Ons, Translators etc. as well as any data that's supposed to be shared between different users, go here.
-This folder belongs to you. Here you can create and delete files and folders as you wish. However, you shouldn't mess too much with the ~/config/ directory and its subfolders. You could delete e.g. the ~/config/settings/ folder without damaging the operating system itself, but who wants to lose all his configurations and application settings? In any case, the system warns you with the at the top mentioned alert.
Besides the ~/config/add-ons/ folder, which mirrors the system's add-ons folder for additional components as described above, there are a few other folders of interest. (By the way, the tilde ("~") is a shortcut for your home folder, so you don't always have to write "/boot/home/" in Terminal.)
| Complements the system's /boot/system/bin/ folder and holds all your command line programs. | ||
| ~/config/boot/ | - | This folder is the place for User Scripts that are executed before or after the system boots up or shuts down. | This folder is the place for User Scripts that are executed before or after the system boots up or shuts down. | + +
| ~/config/boot/launch/ | + | Links to programs or documents in this folder are automatically launched on every boot-up. |
| ~/config/fonts/ | Simply copy a TrueType or Postscript font into this folder and its usable right away. |
| shows a hierarchical list of filetypes where you navigate to image | GIF Image. | ||
| opens a file dialog where you choose any file that already has the filetype you're looking for. |
This drop-down menu shows a list of all applications that can handle this particular filetype. From here you can choose which program should open this specific file when it's double-clicked. You could, for example, change a HTML file's preferred application from the browser to a text editor while you're working on it. Every other HTML file still opens in the browser, only this particular one starts in your text editor.
The is the one that's set globally for that filetype. If you don't find the program you want to associate with this file in the drop-down menu, you'll again find the buttons and which do the similar thing described under "The File Type" above.
-If you're wondering why the icon well on the top right is empty: Icons are normally inherited from the system default for that filetype. You can open the Filetype Add-On of a file that contains an icon and drag&drop it into your file's icon well. Or you double-click the icon well and create or edit your own icon. For more info on icons and how to create your own, see topic Icon-O-Matic.
-If you invoke the Filetype Add-On on an executable (here: StyledEdit), you'll get a different dialog:
On top, you'll see, instead of a standardized MIME string, the unique application signature. With it, the system finds the program wherever it's installed.
@@ -75,7 +84,9 @@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 context menu when you right-click on a file of that type.
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.
-The Filetypes preferences don't deal with individual files but with global settings of filetypes. You can change default icons and preferred applications or add, remove, or alter attributes of whole filetypes. You can even create your own filetype from scratch.
All filetypes and their configurations are stored in /boot/home/config/settings/beos_mime/. Before you start experimenting, it may be prudent to make a backup of that folder...
To learn more about the Filetypes preferences see the workshop: Filetypes, Attributes, Index and Queries.
diff --git a/docs/userguide/en/gui.html b/docs/userguide/en/gui.html index 3a18a0e2c9..e7dfdb8b20 100644 --- a/docs/userguide/en/gui.html +++ b/docs/userguide/en/gui.html @@ -54,14 +54,18 @@When opening or saving a file from any application, a panel like this opens:
It has all the usual things: A list of files of the current folder to choose from, in case of a save panel, a text field to enter a filename and a drop-down menu for different file formats and their settings.
You can enter parent folders with the drop-down menu above the file listing.
If you already have a Tracker window with the location for a file open, you can simply drag either any file or the folder-representation (i.e. the symbol to the far right in its menu bar) into the panel. This changes the panel to that new location.
-You can use many of the shortcuts also used in Tracker. Besides the commands that are also available through the menu, there are a few not that obvious:
| ALT N | Creates a new folder. | |
| ALT H | Takes you to your Home folder. |
The menu 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.
To add a Favorite, you simply navigate to your destination and choose . From now on it will appear in every open/save panel. To remove a Favorite, choose and delete its entry.
diff --git a/docs/userguide/en/images/apps-images/magnify.png b/docs/userguide/en/images/apps-images/magnify.png
new file mode 100644
index 0000000000..6fea1ac224
Binary files /dev/null and b/docs/userguide/en/images/apps-images/magnify.png differ
diff --git a/docs/userguide/en/images/workspaces-images/workspaces.png b/docs/userguide/en/images/workspaces-images/workspaces.png
index b3dda79e8c..eca9fdc0da 100644
Binary files a/docs/userguide/en/images/workspaces-images/workspaces.png and b/docs/userguide/en/images/workspaces-images/workspaces.png differ
diff --git a/docs/userguide/en/index.html b/docs/userguide/en/index.html
index 2e5314b508..9c6f4c6e03 100644
--- a/docs/userguide/en/index.html
+++ b/docs/userguide/en/index.html
@@ -41,7 +41,8 @@
Attributes and Queries are key features of Haiku. While attributes are useful on their own, to display additional information on a file, for a query on them, they need to be indexed. It puts them into a lookup table, which in turn makes queries lightning fast.
The index is part of the filesystem and is kept for every volume/partition separately.
There are several commands to manage the index:
In any case, you can switch to the maybe more familiar CTRL key in the Keymap preferences. The user guide will always describes the default configuration with the command key being ALT.
If you're in doubt which keys are the OPT or MENU keys on your particular keymap/keyboard-layout, again use the Keymap preferences. There you can see what keystroke is sent when you press a key on your keyboard.
-Here's a table of many of the most commonly used shortcuts that are always available, even if there isn't a corresponding menu:
| ALT Fx | Switches to Workspace X (Fx is the function key corresponding to that workspace). | |
| ALT Q | Quits an application. |
Additionally to the general shortcuts, here are some more for navigating with Tracker:
| ALT ↑ | Opens the parent folder. | |
| ALT SHIFT Z | Redo the action you just reverted with ALT Z. |
| ALT N | Opens another Terminal session in a new window. | |
| ALT T | Opens another Terminal session in a new tab. | CTRL D | Closes the current Terminal session. |
You can add or remove items to/from a selection by holding down a modifier key while clicking on a entry (or file in case of Tracker).
| SHIFT | This will select everything between the first selected item and the one you click on. |
The Appearance preferences lets you change some aspects of Haiku's visuals.
-
In the first tab, , you can change the colors of different parts of the user interface. The color well accepts drag&drops from other programs, letting you drag colors over from e.g. WonderBrush, Icon-O-Matic or the Backgrounds panel.
-
The second tab, , provides different settings for how things are rendered on screen.
-An activated aligns all letters in such a way that their vertical and horizontal edges rest exactly between two pixels. The result is a perfect contrast, especially when dealing with black on white. Text appears crisper. There's also a setting for "" that's especially helpful with low resolution devices like netbooks. Small fonts can look pretty bad when hinting is turned on, but with this setting you still have the advantage of hinting for text editors and Terminal.
See the difference hinting makes with these magnified screenshots:
It should be pointed out that all the Magnify windows on this page are of course rendered themselves with the different options as well. So, you get a real world impression of the settings by comparing, for example, the bold yellow tab title or the text "33 x 15 @ 8 pixels/pixel".
-Another technique to improve rendering is Antialiasing, which supports all vector graphics as well as text. It smooths lines by changing the color of certain pixels. There are two methods for that:
changes the intensity of pixels at the edge.
does an even better job, especially with (high resolution) LCD monitors. Instead of the intensity of a pixel, it changes its color which moves an edge by a fraction of a pixel, because LCD displays produce every pixel with a red, green and blue component.
Let's go through the process of setting up an e-mail account.
You start by clicking the button to create a new, unnamed account. This opens a panel where you fill in your account info:
If your account is from a major e-mail provider, Haiku already knows all technical details like server IP addresses and the following information is already filled in automatically. If that is not the case, just follow this guide and fill in the details to your e-mail account accordingly.
Click on under your account's name to set up how e-mails are received.
@@ -83,7 +83,7 @@ You start by clicking the button to create a new
Last on this page, you can opt to only that are larger than a certain size. This will only get the header and you can decide if you want to download the rest of the message plus possible attachments after seeing the subject and who sent it. Useful if you have a slow connection.
Click on under your account's name to set up how e-mails are sent.
@@ -92,19 +92,23 @@ You start by clicking the button to create a new
If you need to login, you change the Login Type to and enter username and password above. The other type is used for providers that need you to check for mail with for identification.
If you want to filter your incoming email, you click on under your account's name to set up automatic sorting. You can add any number of filters that are applied one after the other. You can rearrange them by drag&dropping them to their new position.
Besides the that's used for backward compatibility, there are two other you can add.
The spam filter uses statistical methods to classify a mail as unwanted spam. It assigns a value between 0 and 1 to it and you can decide what are the limits for a genuine mail and what will be considered spam.
You can have that spam rating added to the start of the subject.
Also, the spam filter can learn from all incoming e-mail. Of course, you'll have to teach it by sorting out the false positives, mails that were mistakenly marked as spam. You'll find more on that when we discuss the application Mail.
Together with the following filter, you're able to automatically sort out detected spam mails.
-
This filter compares a header to a search pattern and performs some action when it matches.
With the first text field you specify which header to check against. These are available:
The second text field holds your search pattern. It accepts regular expressions which gives it great flexibility, while unfortunately complicating things a bit. Read up on it a bit, it's well worth it and simple search patterns aren't that complicated at all.
With the drop-down menu below it, you assign an action when the pattern matches. You can move or delete a mail, set the status to "Read" or anything else or set the e-mail account you'll reply with.
-At this moment, there's only one filter that deals with outgoing mail: fortune.
It will attach a randomly chosen funny or wise "fortune cookie" to the end of every mail before it's sent out. You can do a dry run by issuing the command fortune in a Terminal.
Now that your incoming and outgoing mail servers (and maybe some filters, too), are configured, you have to tell the mail_server that does all the actual mail checking and fetching how to do its job.
diff --git a/docs/userguide/en/preferences/prefs-fonts.html b/docs/userguide/en/preferences/prefs-fonts.html
index 2458254665..9b588c6807 100644
--- a/docs/userguide/en/preferences/prefs-fonts.html
+++ b/docs/userguide/en/preferences/prefs-fonts.html
@@ -51,12 +51,14 @@
You install new fonts by copying them into their respective user folder, i.e. /boot/common/fonts/ or /boot/home/config/fonts/ (see topic Filesystem layout).
-
-