diff --git a/docs/Haiku-doc.css b/docs/Haiku-doc.css index 51da22d9e8..94790dcf81 100644 --- a/docs/Haiku-doc.css +++ b/docs/Haiku-doc.css @@ -122,10 +122,10 @@ div.bottomnav p { border-style: dotted; border-width: thin; border-color: #dcdcdc; - padding: 0px 15px 0px 80px; + padding: 10px 15px 10px 80px; margin-bottom: 15px; margin-top: 15px; - min-height: 32px; + min-height: 42px; } .box-info { background: #e4ffde url(userguide/images/alert_info_32.png) 15px 15px no-repeat; diff --git a/docs/userguide/en/applications.html b/docs/userguide/en/applications.html index 1ce642d215..822db47f8a 100644 --- a/docs/userguide/en/applications.html +++ b/docs/userguide/en/applications.html @@ -40,7 +40,7 @@

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.

-

Installing applications

+

Installing applications

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

@@ -52,15 +52,15 @@ If it's a ZIP archive, double-clicking opens Expander w

Some programs need further configurations. For example, Tracker Add-Ons, Translators or other system enhancing components have to be put into the right folders. Either you'll find a little script file (often with the suffix .sh) like install that you simply double click to have all taken care of.
Sometimes you'll find folders that link to the correct destination named "drag [filename] here...". So, you simply follow that instruction and you're done.

Most of the time, however, nothing of the sort is necessary and you're done after unpacking.
-See topic Deskbar or LaunchBox to see how to add shortcuts to your newly installed application.

+See topic Deskbar or LaunchBox to see how to add shortcuts to your newly installed application.

-

Uninstalling applications

+

Uninstalling applications

If the installation was done with an install script, chances are, there's an uninstall script as well. In that case, double-click it and you're done.
Otherwise, uninstalling is simply done by deleting the application's folder.

-

This, of course, leaves back possible configuration files in your ~/config/settings folder. This may be on purpose, if you want to keep those settings in case you'll install it again in the future. Also, when the installation involved those "drag [filename] here..." folders, those files are also left behind.

+

This, of course, leaves back possible configuration files in your ~/config/settings folder. This may be on purpose, if you want to keep those settings in case you'll install the program again in the future. Also, when the installation involved those "drag [filename] here..." folders, those files are also left behind.

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's applications

+

Haiku's applications

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.

@@ -82,7 +82,7 @@ Otherwise, uninstalling is simply done by deleting the application's folder.

- + diff --git a/docs/userguide/en/applications/apps-diskprobe.html b/docs/userguide/en/applications/apps-diskprobe.html index afb7cd94ce..71937a2457 100644 --- a/docs/userguide/en/applications/apps-diskprobe.html +++ b/docs/userguide/en/applications/apps-diskprobe.html @@ -49,7 +49,7 @@ width="64" height="64" />DiskProbe

diskprobe.png

The main view shows always one block of data, the size of which can be adjusted with View | BlockSize. To the left is the offset to the start of the block, in the middle the data as HEX values and to the right the same as ASCII symbols.
You can move from block to block with the slider above or with ALT ← and ALT → and switch between the HEX and ASCII columns with TAB.

-

Block | Selection will not only show the selection with different endianess (and different radix), it will also interprete the selection as a block offset that you can jump to. It will be greyed out if the position is outside of the file/device.
+

Block | Selection will not only show the selection with different endianess (and different radix), it will also interprete the selection as a block offset that you can jump to. It will be grayed out if the position is outside of the file/device.
This is a handy feature mostly when looking at file systems, as they often contain pointers to other blocks.

If the file you're probing includes attributes, the Attributes menu can be used to open any of them in a new DiskProbe window. Here's the copyright attribute of the AboutSystem application:

diskprobe-about-attr.png

diff --git a/docs/userguide/en/applications/apps-expander.html b/docs/userguide/en/applications/apps-expander.html index fe9330e906..b9d4e60529 100644 --- a/docs/userguide/en/applications/apps-expander.html +++ b/docs/userguide/en/applications/apps-expander.html @@ -5,7 +5,7 @@ + diff --git a/docs/userguide/en/applications/apps-showimage.html b/docs/userguide/en/applications/apps-showimage.html index 50e1604e85..5f0b0f699a 100644 --- a/docs/userguide/en/applications/apps-showimage.html +++ b/docs/userguide/en/applications/apps-showimage.html @@ -15,14 +15,14 @@ - Showimage + ShowImage

@@ -37,12 +37,12 @@

showimage-icon_64.pngShowimage

+width="64" height="64" />ShowImage
iconActivityMonitor 
iconDriveSetup  A harddisk partitioning tool. [still missing]
iconExpander A tool to unpack common archives. [still missing]
A tool to unpack common archives.
iconIcon-O-Matic  An app to create Haiku's vector icons. [still missing]
iconInstaller 
- - + +
Deskbar:No entry, normally launched via double-clicking a supported file.
Location:/boot/beos/apps/Showimage
Settings:~/config/settings/Showimage_settings
Location:/boot/beos/apps/ShowImage
Settings:~/config/settings/ShowImage_settings

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/attributes.html b/docs/userguide/en/attributes.html index 37ed96fb14..1e24dafb71 100644 --- a/docs/userguide/en/attributes.html +++ b/docs/userguide/en/attributes.html @@ -5,7 +5,7 @@

-

The common folder - /boot/common/

+

The common folder - /boot/common/

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.

-

The home folder - /boot/home/

+

The home folder - /boot/home/

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.)

@@ -101,7 +101,7 @@ If you do want to know more about how things tick in Haiku, have a look at this - + diff --git a/docs/userguide/en/filetypes.html b/docs/userguide/en/filetypes.html index 7c18c98890..b8e9c263a2 100644 --- a/docs/userguide/en/filetypes.html +++ b/docs/userguide/en/filetypes.html @@ -38,31 +38,26 @@

Other than Windows, Haiku doesn't rely on the 3-letter file extension for a file type (e.g. .txt, .jpg, .mp3). This method is only a last resort fallback. Haiku uses MIME types just like it's custom on the internet.

-

Setting the filetype of a specific file

+

Setting the filetype of a specific file

You can change the type of a specific file, its icon and the associated application. Select the file and invoke the Add-Ons | Filetype add-on from the right-click context menu.

filetype-addon.png -

The File Type

+

The File Type

This is a JPEG file, it's MIME string image/jpeg. Let's say you definitely know that it's not a JPEG but a GIF. You can change that either by entering the correct MIME string by hand or with one of the two buttons below the textbox:

In this MIME database Haiku keeps track of all the different filetypes and their settings.
~/config/settings/kernel/drivers/ There, one settings files that may be of interest. kernel offers some low level configurations like disabling SMP, activating serial debugging or enabling advanced power management. You activate a configuration line by removing the commentary symbol "#". Be careful here!
There's one settings file that may be of interest: kernel offers some low level configurations like disabling SMP, activating serial debugging or enabling advanced power management. You activate a configuration line by removing the commentary symbol "#". Be careful here!
~/config/settings/Tracker/  Here are some interesting subfolders:
Select... shows a hierarchical list of filetypes where you navigate to image | GIF Image.
Same as... opens a file dialog where you choose any file that already has the filetype you're looking for.
-

The Preferred Application

+

The Preferred Application

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 Default Application 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 Select... and Same As... which do the similar thing described under "The File Type" above.

-

The Icon

+

The Icon

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 in Icon-O-Matic.

-

Global settings with the Filetypes Preferences

-

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.

- -

Special settings for applications

+

Special settings for applications

If you invoke the Filetype Add-On on an executable (here: StyledEdit), you'll get a different dialog:

filetype-addon-stylededit.png

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.

@@ -72,11 +67,16 @@ Multiple Launch Many instances of the app can run simultaneously. Exclusive Launch Really only one instance with that app's signature is allowed to run at a time. Args Only Indicates the app doesn't respond to messages. -Background App The app won't appear in Twitcher or the list of running apps of the Deskbar. +Background App The app won't appear in Twitcher or the list of running apps of the Deskbar.

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 Open with... 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.

+

Global settings with the Filetypes Preferences

+

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 dbf8ef3ff3..8b7445fd38 100644 --- a/docs/userguide/en/gui.html +++ b/docs/userguide/en/gui.html @@ -51,14 +51,14 @@

  • The resize button. Dragging anywhere else on a window's border will move the window.

    • -

    Open and save panels

    +

    Open and save panels

    When opening or saving a file from any application, a panel like this opens:

    open-save.png

    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 menubar) into the panel. This changes the panel to that new location.

    +

    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.

    -

    Keyboard shortcuts

    +

    Keyboard shortcuts

    You can use many of the shortcuts also used in Tracker. Besides the commands that are also available through the File menu, there are a few not that obvious:

    @@ -69,7 +69,7 @@ You can enter parent folders with the drop-down menu above the file listing.

    ALT N Creates a new folder.
    ALT H Takes you to your Home folder.
    -

    Favorites and recent folders

    +

    Favorites and recent folders

    The menu Favorites 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.

    favorites.png

    To add a Favorite, you simply navigate to your destination and choose Favorites | Add Current Folder. From now on it will appear in every open/save panel. To remove a Favorite, choose Favorites | Configure Favorites... and delete its entry.
    diff --git a/docs/userguide/en/index.html b/docs/userguide/en/index.html index 0bbadada64..8a8abcd4dd 100644 --- a/docs/userguide/en/index.html +++ b/docs/userguide/en/index.html @@ -39,7 +39,7 @@

    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.

    -

    Indexing commands in Terminal

    +

    Indexing commands in Terminal

    There are several commands to manage the index: