One method to quickly get to all the app's files is to do a quick query for a significant part of the application's name. This will reveal the app's binary, its installation folder and its settings as well as possible links in the Deskbar etc. Simply select all relevant files and delete them.
Haiku comes with a set of mostly small but essential applications. You'll find all of them at /boot/beos/apps/ or /boot/common/apps/. Applications that are not usually launched by a double-click on a data file (e.g. ShowImage for image files) can be found in the Applications menu of the Deskbar.
+
Haiku comes with a set of mostly small but essential applications. You'll find all of them at /boot/system/apps/ or /boot/common/apps/. Applications that are not usually launched by a double-click on a data file (e.g. ShowImage for image files) can be found in the Applications menu of the Deskbar.
You can track system resources by launching the ActivityMonitor and activating different items of interest.
diff --git a/docs/userguide/en/applications/apps-cdplayer.html b/docs/userguide/en/applications/apps-cdplayer.html
index 8668e7920d..c52a277840 100644
--- a/docs/userguide/en/applications/apps-cdplayer.html
+++ b/docs/userguide/en/applications/apps-cdplayer.html
@@ -40,7 +40,7 @@
width="64" height="64" />CDPlayer
PoorMan is a nice little webserver that's extremly easy to set up. Naturally it doesn't offer any advanced features like other heavy duty server software, it's after all only a poor man's webserver.
+
Upon its first launch, PoorMan asks for the folder that is about to be served to the web. If you go with the Default, a new folder /boot/home/public_html is created for you. As a start page a HTML file named by default index.html has to be present there.
+
PoorMan presents itself with a simple console that logs its activity, information if the server is running and which directory is being served, a hit counter and a menubar to access e.g. the settings:
+
+
The settings panel is divided into three tabs:
+
In Site you can select another folder to serve, enter another start page and have the option to send a file listing if the start page isn't present.
+Logging lets you de/activate logging to the console or optionally to a separate logfile.
+The Advanced tab holds the setting for the maximum simultaneous connections.
+
The menu items of the console window are all self-explanatory. With them you can e.g. save (parts) of the console output, clear the console or logging file and start/stop the server or clear the hit counter.
+
+
If you want to try out if PoorMan's working, choose /boot/apps/BePDF/docs/ as folder and index.html as start page. Then point your browser to the URL 127.0.0.1, which is your local host.
StyledEdit is Haiku's simple text editor. Although it saves files in plain text format, additional attributes are written in order to have limited formatting capabilities when viewed with StyledEdit.
~/config/settings/Terminal_settings
-~/.profile - adds/overrides defaults in /boot/beos/etc/profile
-~/.inputrc - adds/overrides defaults in /boot/beos/etc/inputrc
+~/.profile - adds/overrides defaults in /boot/system/etc/profile
+~/.inputrc - adds/overrides defaults in /boot/system/etc/inputrc
The Terminal is Haiku's interface to bash, the Bourne Again Shell.
Please refer to the topic on Scripting for a few links to online tutorials on working in the shell. Here, we'll concentrate on the Terminal application itself.
@@ -58,7 +58,7 @@ Pressing OK will save the current settings as defaul
Coming from Unix, there are countless possibilities to customize the bash itself. There are two files that are especially important to the user: .profile and .inputrc
-Both files can be created in the home/ folder and add or override the system defaults that are defined in /boot/beos/etc/.
+Both files can be created in the home/ folder and add or override the system defaults that are defined in /boot/system/etc/.
.profile
The .profile is loaded every time you open a new Terminal. It sets all kinds of aliases and variables that will affect bash's behavior and appearance. You'll find many online resources that will detail all possibilities.
Documentation is still missing. If you want to work on it, please announce it on the Documentation mailing list to avoid duplication.
diff --git a/docs/userguide/en/bash-scripting.html b/docs/userguide/en/bash-scripting.html
index a4a5a49550..3ba6e82785 100644
--- a/docs/userguide/en/bash-scripting.html
+++ b/docs/userguide/en/bash-scripting.html
@@ -52,10 +52,10 @@ If they don't exist already, you'll have to create the needed files yourself. Ot
/boot/home/config/boot/UserBootscript will be executed after the system has finished its boot process. For example, you could launch a number of programs that would then be automatically started on every boot up:
Remember to end a command with an "&" to start it as a background process, or the script will halt until that command has finished (in this case: the launched app was closed again).
One or more LaunchBox applets can be started to organize shortcuts to your favorite applications or documents. You decide if each is shown on all or just the current workspace. They can also serve to quickly open a document in a specific application. For example, you could drag&drop a HTML file onto a text editor in a LaunchBox to open it in the editor instead of its preferred application, the browser.
The second alert pops up if you try to rename or delete something in the system hierarchy. Here, the "Do it" button will only become clickable when you're holding down the SHIFT key.
Generally, there are three separate branches springing from the root folder of the boot volume:
-
/boot/beos/
belongs to the system. Don't touch!
+
/boot/system/
belongs to the system. Don't touch!
/boot/common/
holds files that are shared between users.
/boot/home/
is your personal folder where you keep your data and settings.
The fact that it's called "beos" shows Haiku's BeOS heritage. It wasn't renamed yet to ensure backward compatibility with BeOS software.
Whatever it's named, you should not alter what's inside. Every update of Haiku can add, remove or overwrite anything within it. If you want to add functionality, maybe with other Tracker Add-Ons or Translators or maybe another hardware driver, you install these things under your own /boot/home/ hierarchy or, if it's supposed to be for every user, under /boot/common/. As long as Haiku isn't multi-user, this distinction has no apparent effect, as there's only one user with one home folder. But since there will be support for more users than one eventually, it makes sense to learn the right way from the start.
So, let's say you want to install a new Translator for the latest image format, you don't simply copy it into the respective system folder. Remember: Don't touch!
Instead, you put it into the mirrored hierarchy under /boot/common/ or /boot/home/config/.
In our example the location for Translators in the system folder would be
-
/boot/beos/add-ons/Translators/
+
/boot/system/add-ons/Translators/
So, the user "mirror" folder is either
/boot/home/config/add-ons/Translators/
or
@@ -86,7 +86,7 @@ If you do want to know more about how things tick in Haiku, have a look at this
Again from our BeOS legacy, the be folder contains what's shown in the Deskbar menu. You can add and remove items either with the Deskbar configuration panel or by putting files, folders or links into this folder directly.
~/config/bin/
-
Complements the system's /boot/beos/bin/ folder and holds all your command line programs.
+
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.
diff --git a/docs/userguide/en/installation/install-boot-process.html b/docs/userguide/en/installation/install-boot-process.html
index bf21deb6c8..fb6212fdde 100644
--- a/docs/userguide/en/installation/install-boot-process.html
+++ b/docs/userguide/en/installation/install-boot-process.html
@@ -45,7 +45,7 @@ OK, not going into more detail as that's not essential here.
Boot managers range from totally simple ones that are just enough to find the partition marked active and jump to the partition boot code of said partition, to almost complete operating systems with editing capabilities and other fancy features.
The Partition Boot Record
-
Additionally to the Master Boot Record, there can also be a partition boot record. It's located at the start of a partition and contains further boot code. Depending on the boot manager you are using and how you configured it, this boot code will be executed or not. In the case of Haiku the partition boot code does locate the /boot/beos/system/zbeos" file which then starts the operating system boot process. Additionally it contains the partition offset needed to access this partition during boot. A wrong value for that offset is probably one of the most common reason why a Haiku installation doesn't start to boot.
+
Additionally to the Master Boot Record, there can also be a partition boot record. It's located at the start of a partition and contains further boot code. Depending on the boot manager you are using and how you configured it, this boot code will be executed or not. In the case of Haiku the partition boot code does locate the /boot/system/system/zbeos" file which then starts the operating system boot process. Additionally it contains the partition offset needed to access this partition during boot. A wrong value for that offset is probably one of the most common reason why a Haiku installation doesn't start to boot.
As mentioned, whether or not the partition boot code is used depends on the boot manager and boot manager configuration. If you take GRUB installed as boot manager in the MBR and booting Linux. GRUB knows how to handle most Linux filesystems and it does know how to load and start a Linux kernel off of it. Therefore it can directly load Linux without the need for any additional boot code.
However GRUB does neither know how to handle BFS and find the zbeos boot loader, nor would it really know how to execute it. Therefore you cannot use GRUB to directly boot Haiku.
Instead you need to chainload the partition boot code of the BFS partition, as it knows how to handle both the BFS and zbeos.
Now the block that sets the defaults for timezone and keymap:
# Add symlink/file (timezone and keymap settings) to the image.
AddSymlinkToHaikuImage home config settings
- : /boot/beos/etc/timezones/Europe/Paris : timezone ;
+ : /boot/system/etc/timezones/Europe/Paris : timezone ;
AddFilesToHaikuImage home config settings : German
: Key_map ;
The build process can be fine tuned until it fits your needs. You could create your own folder haiku/trunk/user_data/ and put files there that are then copied or unzipped into the image. Zipping is important when dealing with Haiku files and their attributes, because zipping them up will preserve them on non-BFS partitions.
@@ -163,7 +163,7 @@ AddOptionalHaikuImagePackages WonderBrush ;
# Add symlink/file (timezone and keymap settings) to the image.
AddSymlinkToHaikuImage home config settings
- : /boot/beos/etc/timezones/Europe/Paris : timezone ;
+ : /boot/system/etc/timezones/Europe/Paris : timezone ;
AddFilesToHaikuImage home config settings : German
: Key_map ;
diff --git a/docs/userguide/en/installing.html b/docs/userguide/en/installing.html
index 148c9060c3..0b7836ce8d 100644
--- a/docs/userguide/en/installing.html
+++ b/docs/userguide/en/installing.html
@@ -83,7 +83,7 @@ This is also how you update the code in the future.
Now the block that sets the defaults for timezone and keymap:
# Add symlink/file (timezone and keymap settings) to the image.
AddSymlinkToHaikuImage home config settings
- : /boot/beos/etc/timezones/Europe/Paris : timezone ;
+ : /boot/system/etc/timezones/Europe/Paris : timezone ;
AddFilesToHaikuImage home config settings : German
: Key_map ;
The build process can be fine tuned until it fits your needs. You could create your own folder haiku/trunk/user_data/ and put files there that are then copied or unzipped into the image. Zipping is important when dealing with Haiku files with their attributes, because zipping them up will preserve them on non-BFS partitions.
@@ -128,7 +128,7 @@ HAIKU_IMAGE_HOST_NAME = "TEST" ;
# Add symlink/file (timezone and keymap settings) to the image.
AddSymlinkToHaikuImage home config settings
- : /boot/beos/etc/timezones/Europe/Paris : timezone ;
+ : /boot/system/etc/timezones/Europe/Paris : timezone ;
AddFilesToHaikuImage home config settings : German
: Key_map ;
diff --git a/docs/userguide/en/preferences/prefs-appearance.html b/docs/userguide/en/preferences/prefs-appearance.html
index 158cfc9239..9d828e49ab 100644
--- a/docs/userguide/en/preferences/prefs-appearance.html
+++ b/docs/userguide/en/preferences/prefs-appearance.html
@@ -37,7 +37,7 @@
Appearance
Deskbar:
Preferences
-
Location:
/boot/beos/preferences/Appearance
+
Location:
/boot/system/preferences/Appearance
Settings:
~/config/settings/system/app_server/appearance
The Appearance preferences lets you change some aspects of Haiku's visuals.
~/config/settings/* - Every Translator creates its own settings file here after you've changes its defaults. ~/config/settings/system/DataTranslations settings - Stores the panel's window position.
Haiku provides a system that retrieves e-mail regularly via a mail_daemon and saves each mail as a single text file. It parses the mail and fills its attributes with all necessary header information, like from, to, subject and its unread status. Now it can be queried by you or any application. This system also makes switching e-mail clients easy as all the data and your configuration stays the same.
diff --git a/docs/userguide/en/preferences/prefs-filetypes.html b/docs/userguide/en/preferences/prefs-filetypes.html
index 25be90fb5b..f289c858fa 100644
--- a/docs/userguide/en/preferences/prefs-filetypes.html
+++ b/docs/userguide/en/preferences/prefs-filetypes.html
@@ -40,7 +40,7 @@
width="64" height="64" />FileTypes
Deskbar:
Preferences
-
Location:
/boot/beos/preferences/FileTypes
+
Location:
/boot/system/preferences/FileTypes
Settings:
~/config/settings/FileTypes settings ~/config/settings/beos_mime/* - Stores all MIME types as folders.
~/config/settings/system/app_server/workspaces ~/config/settings/kernel/drivers/vesa - Only when running in VESA mode. ~/config/settings/Screen_data - Stores the panel's window position.
~/config/settings/RTC_time_settings
-~/config/settings/timezone - A link to the current timezone in /boot/beos/etc/timezones/*/*
+~/config/settings/timezone - A link to the current timezone in /boot/system/etc/timezones/*/* ~/config/settings/Time_settings - Stores the panel's window position.
The panel of the Time preferences is split into two tabs:
Applications can install add-ons so they can be invoked easily on a selection of files from Tracker. Only the add-ons that can handle a specific filetype are presented under Add-Ons from the context menu or the File menu of a Tracker window. Some add-ons don't necessarily need a file to work on and are thus always present.
Tracker Add-Ons, or links to applications that can act as add-ons, can be installed in three different locations (see topic Filesystem layout):
-
/boot/beos/system/add-ons/Tracker/
for system provided add-ons.
+
/boot/system/system/add-ons/Tracker/
for system provided add-ons.
/boot/common/add-ons/Tracker/
for add-ons available to every user.
/boot/home/config/add-ons/Tracker/
for add-ons only available to yourself.
diff --git a/docs/userguide/en/tracker.html b/docs/userguide/en/tracker.html
index e7a17494fc..8e5a542b0e 100644
--- a/docs/userguide/en/tracker.html
+++ b/docs/userguide/en/tracker.html
@@ -47,24 +47,32 @@ The above settings will automatically mount any storage device you connect/inser
Before you disconnect e.g. a harddrive or USB stick, make sure you have successfully unmounted the volume. This guarantees that all data transfer has finished. Otherwise you may lose data or corrupt the disk!
By default, when you double-click a folder, Tracker opens a new window while leaving the parent window open. This can quickly lead to an overcrowded desktop.
+You can prevent that by holding down the left WIN key, which automatically closes the parent window.
+This is also true for keyboard navigation. For more on that, see topic Shortcuts and key combinations.
Moving through your folders is one of Trackers main purposes, just like the file managers on other platforms. Haiku's Tracker has some unique features that will help you doing that efficiently.
Instead of double-clicking your way down folder after folder, there's a better way to drill down:
-
Right-click onto a folder, and at the top of the usual context menu you'll find a submenu of the current folder that let's you navigate down a level. Just move down the hierarchy until you find the file or folder you're looking for and click on it to open it. The above shows the contents of the folder /boot/beos/system/.
+
+
Right-click onto a folder, and at the top of the usual context menu you'll find a submenu of the current folder that let's you navigate down a level. Just move down the hierarchy until you find the file or folder you're looking for and click on it to open it. The above shows the contents of the folder /boot/system/documentation/.
A similar method can be used from any Tracker window:
Click on the area in the lower left, where the number of items is listed, and you'll get submenus for every level above your current location. From there you can drill down through the folders as usual.
Note, that the Desktop is always the topmost level as that is where Tracker shows mounted volumes. So, if you want to go to another disk, you first have to navigate to the top (Desktop) and cross over to your other disk from there.
-
You'll get the same submenu-navigating when you drag a file over a folder. After a short while of hovering, a submenu pops up and you can drill down to your destination. If you initiated the drag with the right mousebutton, you can choose between copying, moving or linking the file when you release the mouse.
-
By default, when you double-click a folder, Tracker opens a new window while leaving the parent window open. This can quickly lead to an overcrowded desktop.
-You can prevent that by holding down the left WIN key, which automatically closes the parent window.
-This is also true for keyboard navigation. For more on that, see topic Shortcuts and key combinations.
+
You'll get the same submenu-navigating when you drag a file over a folder. After a short while of hovering, a submenu pops up and you can drill down to your destination. If you initiated the drag with the right mousebutton, you can choose between copying, moving or linking the file when you release the mouse.
You may be familiar with the concept from file managers of other operating systems: typing the first few letters of a filename will jump to the first file matching these starting characters. Haiku took the idea a step further. If there isn't a file starting with those letters it will jump to the first file including the string anywhere in its name. And if there's nothing with the string in its filename, the attributes are searched next.
+
+
In the above example, there are many files starting with "Haiku logo", rendering simpler approaches to typing ahead quite useless. In Haiku however, typing "web" jumps right to its first occurence in "Haiku logo - website". The characters you enter appear in the bottom left corner where you normally find the item count of all files in the folder. A second after entering a character, the display jumps back to normal and you're ready for a new type ahead search.
Close (ALTW) - Closes the window. Hold down SHIFT and the menu becomes Close All which closes every Tracker window.
+
Close All in Workspace (ALTQ) - Closes every Tracker window in the current workspace. A useful shortcut if you forgot to hold the WIN key while clicking through folders and all those still open Tracker windows clutter your workspace.
Sometimes you just want to rearrange a few icons without doing a complete Clean Up (ALTK). In that case, you select these icons and start to drag them to their new location. Before you drop them there, keep ALT pressed. This will align the icons to the invisible grid.
The rest of the functions are pretty self-explanatory, leaving the Tracker preferences.