diff --git a/docs/userguide/applications.html b/docs/userguide/applications.html index 8d3c245634..4ee9c3ce8d 100644 --- a/docs/userguide/applications.html +++ b/docs/userguide/applications.html @@ -49,55 +49,65 @@ Otherwise, uninstalling is simply done by deleting the application's folder.

Haiku's applications

-

Haiku comes with a set of mostly small but essential 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. +

ActivityMonitor
+ - + - + - + - + - + - + - + - + + + - + - + + + - + - + - + - + + + - + - + - + + + - + - + - + + + - + - + - +
ActivityMonitor  A tool to track system resources like CPU and memory usage.
BePDF
BePDF  A PDF viewer
CDPlayer
CDPlayer  A player for audio CDs.
CodyCam
CodyCam  A tool to regularly upload images from a webcam to a server.
DeskCalc
DeskCalc  A calculator.
DiskProbe
DiskProbe  A HEX editor for files and volumes.
DiskUsage
DiskUsage  A tool to visualize a disk's memory usage.
DriveSetup
DriveSetup  A harddisk partitioning tool.
Firefox
Expander A tool to unpack common archives.
Firefox  Mozilla's famous browser.
Icon-O-Matic
Icon-O-Matic  An app to create Haiku's vector icons.
Magnify
Installer The tool to install Haiku to a partition.
Magnify  A magnified view of the area around your mouse pointer.
Mail
Mail  An email client.
MediaPlayer
MediaPlayer  A player for all supported audio/video files.
MidiPlayer
MidiPlayer  A player for MIDI files.
pe
PackageInstaller Installer for BeOS packages in PKG format.
Pe  A texteditor with syntax coloring and much more.
People
People  A contact manager.
Screenshot
Screenshot  A tool to take screenshots.
SoundRecorder
ShowImage A simple image viewer.
SoundRecorder  A tool to record audio from line-in or a microphone.
StyledEdit
StyledEdit  A text editor.
Terminal
Terminal  Access to the bash.
TV
TextSearch A search tool for text files.
TV  A viewer for analog TV.
Vision
Vision  An IRC client.
VLC
VLC  The VideoLAN movie player.
WonderBrush
WonderBrush  Yellowbite's vector graphics programm.

diff --git a/docs/userguide/contents.html b/docs/userguide/contents.html index e34f820972..02fa5a3f6a 100644 --- a/docs/userguide/contents.html +++ b/docs/userguide/contents.html @@ -93,12 +93,12 @@ Below, you'll find the documentation of the most important aspects of Haiku. Nat
  • Haiku's applications
    • Learn how to un/install applications in general and how work with the ones that come with Haiku. - Preferences Configuring and setting up your system. - + diff --git a/docs/userguide/demos.html b/docs/userguide/demos.html index 15ec869348..e6d5182577 100644 --- a/docs/userguide/demos.html +++ b/docs/userguide/demos.html @@ -22,32 +22,32 @@

    There are some nice little games and demo applications for your entertainment. Most of the demos are targeted to developers who are interested in learning from the code, which is of course open source as is everything Haiku. -

    - +

    BSnow
    + - + - + - + - + - + - + - + - + - + - + - + - +
    BSnow  Let it snow.
    Chart
    Chart  Moving through stars and galaxies.
    Clock
    Clock  An analog clock.
    Cortex
    Cortex  See the media_server in action.
    FontDemo
    FontDemo  A slideshow through all your fonts.
    GLDirectMode
    GLDirectMode  A demonstration of OpenGL.
    GLTeapot
    GLTeapot  The rotating OpenGL rendered teapot.
    Gradients
    Gradients  A demonstration of the gradient API .
    Mandelbrot
    Mandelbrot  Computing fractals.
    Pairs
    Pairs  A game to find pairs of matching icons.
    Playground
    Playground  Test the drawing API .
    Pulse
    Pulse  See your CPU's workload.
    Sudoku
    Sudoku  This century's "Solitair".

    diff --git a/docs/userguide/deskbar.html b/docs/userguide/deskbar.html index 2885858ade..1b31d6b2f2 100644 --- a/docs/userguide/deskbar.html +++ b/docs/userguide/deskbar.html @@ -65,13 +65,13 @@ configure.png

    In this panel you set how many recent documents, folders and applications are shown in the Deskbar, or if you show them at all.

    Here, you also configure folders and their contents, which are by default Applications, Demos, Deskbar Applets, and Preferences. You can add your own entries and edit or remove items.
    -This part of the panel is just a representation of the folder /boot/home/config/be. You can just as well link or copy files and folders directly in Tracker to configure your Deskbar.
    +This part of the panel is just a representation of the folder /boot/home/config/be/. You can just as well link or copy files and folders directly in Tracker to configure your Deskbar.
    Another method is to simply drag a file or folder and drop it where you want it into the Deskbar.

    The Tray

    calendar.png -

    Among other things, the tray's housing the clock. Left-click it to toggle between date and time. Right-click it to hide/show it or launch the Time preferences to set it. +

    Among other things, the tray's housing the clock. Left-click it to toggle between date and time. Right-click it to hide/show it or launch the Time preferences to set it. Here you can also launch a calendar that also appears, when you hold down the left mouse button on the clock for a little time.

    Any program can install an icon in the tray to provide an interface to the user. The email system, for instance, shows a different symbol when there's unread mail and offers a context menu to e.g. create or check for new mail. ProcessController is another example that uses its icon in the tray to provide information (CPU/memory usage) and to offer a context menu.

    diff --git a/docs/userguide/desktop-applets.html b/docs/userguide/desktop-applets.html index 9a1a0f05da..48fcabfac7 100644 --- a/docs/userguide/desktop-applets.html +++ b/docs/userguide/desktop-applets.html @@ -24,14 +24,14 @@

    Haiku provides a few useful tools that can be installed on the Desktop or the Deskbar via its Replicant. -

    - +

    LaunchBox
    + - + - + - +
    LaunchBox  Shortcuts to your favorite applications.
    NetworkStatus
    NetworkStatus  Is your connection up?.
    ProcessController
    ProcessController  See and control every running app and service.
    Workspaces
    Workspaces  A miniature version of all workspaces.

    diff --git a/docs/userguide/filetypes.html b/docs/userguide/filetypes.html index 931b626884..c35ea6f35e 100644 --- a/docs/userguide/filetypes.html +++ b/docs/userguide/filetypes.html @@ -45,7 +45,7 @@

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

    +

    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

    diff --git a/docs/userguide/keyboard-shortcuts.html b/docs/userguide/keyboard-shortcuts.html index a2c02c485e..89221468af 100644 --- a/docs/userguide/keyboard-shortcuts.html +++ b/docs/userguide/keyboard-shortcuts.html @@ -22,42 +22,42 @@
    -

    By default, Haiku's option key, to invoke commands from menus for example, is not the usual CTRL key, but ALT instead. This has historical reasons, because the BeOS was inspired somewhat by MacOS. After you get used to it, it actually feels better as e.g. ALT+C and ALT+V is reached more conveniently on the keyboard and these commands seemlessly integrate into the bash shell of the Terminal. -

    In any case, you can switch to the maybe more familiar CTRL key in the Menu preferences. The user guide will always describes the default configuration with the option key being ALT. +

    By default, Haiku's option key, to invoke commands from menus for example, is not the usual CTRL key, but ALT instead. This has historical reasons, because the BeOS was inspired somewhat by MacOS. After you get used to it, it actually feels better as e.g. ALT+C and ALT+V is reached more conveniently on the keyboard and these commands seamlessly integrate into the bash shell of the Terminal, where CTRL+C quits the running process. +

    In any case, you can switch to the maybe more familiar CTRL key in the Menu preferences. The user guide will always describes the default configuration with option key being ALT.

    General shortcuts

    -

    Here's a table of many of the most commonly used shortcuts that are always awailable, even if there isn't a corresponding menu: +

    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 Switch to Workspace X (Fx is the function key corresponding to that workspace).
    CTRL+TAB Hold it to brings up the Twitcher.
    CTRL+ALT+DEL Open the Team Monitor.
    ALT+ESC Enter the menu bar (leave with ESC).
    ALT+C Copy selection to clipboard.
    ALT+X Cut selection to clipboard.
    ALT+V Paste the clipboard's contents.
    ALT+W Close the current window.
    ALT+Q Close the whole application.
    ALT+FxSwitches to Workspace X (Fx is the function key corresponding to that workspace).
    CTRL+TABHold down to bring up the Twitcher.
    CTRL+ALT+DELOpens the Team Monitor.
    ALT+ESCEnters the menu bar (leave with ESC).
    ALT+CCopies selection to clipboard.
    ALT+XCuts selection to clipboard.
    ALT+VPastes the clipboard's contents.
    ALT+WCloses the current window.
    ALT+QCloses the whole application.

    Shortcuts for Tracker navigation

    Additionally to the general shortcuts, here are more for navigating with Tracker:

    - - - - - - + + + + + +
    ALT+CURSOR-UP Open parent folder.
    ALT+CURSOR-DOWN or RETURN Open selected folder.
    WIN-KEY Holding it while opening a folder will automatically close the parent folder. This also works when navigating with the mouse.
    right MENU-KEY Open the Deskbar menu (leave with ESC)
    ALT+Z Undo the last action. The undo history is only limited by the available memory. Note, that this only works for actions on the file itself, changed attributes and permission settings can't be undone. Also, once a file is removed from Trash it's gone for good.
    ALT+SHIFT+Z Redo the action you just reverted with ALT+Z
    ALT+CURSOR-UPOpens the parent folder.
    ALT+CURSOR-DOWN or RETURNOpens the selected folder.
    WIN-KEYHolding it while opening a folder will automatically close the parent folder. This also works when navigating with the mouse.
    right MENU-KEYOpens the Deskbar menu (leave with ESC)
    ALT+ZUndo last action. The undo history is only limited by the available memory. Note, that this only works for actions on the file itself, changed attributes and permission settings can't be undone. Also, once a file is removed from Trash it's gone for good.
    ALT+SHIFT+ZRedo the action you just reverted with ALT+Z

    Other key combinations

    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.
    ALT Adds or removes the item you're clicking on from the selection.
    SHIFTThis will select everything between the first selected item and the one you click on.
    ALTAdds or removes the item you're clicking on from the selection.

    In a Tracker window, if you just start typing, Tracker scrolls to and selects the file that best fits your incremental search. If there's no file starting with your typed letters, files that contain the search string anywhere in their name or other displayed attributes are selected. This search is not case-sensitive.
    The letters you type appear at the bottom-left, where normally the number of items are listed. After a second it reverts back and you could start a new incremental search. diff --git a/docs/userguide/preferences.html b/docs/userguide/preferences.html index 475e20e97b..92a933a8d2 100644 --- a/docs/userguide/preferences.html +++ b/docs/userguide/preferences.html @@ -15,66 +15,77 @@

    Contents     - Previous: Desktop Applets -     + Previous: Workshop +

    -

    While a key philosophy of Haiku is to cut down on options and have sensible defaults instead, there are some things that have to be configured or can be set to individual preference. -

    - +

    While a key philosophy of Haiku is to cut down on options and have sensible defaults instead, there are some things that have to be configured or can be set to individual preference. You find all panels in Deskbar's Preferences menu. +

    Appearance
    + - + - + - + - + - + - + - + - + + + + + - + - + - + + + + + - + - + - + - +
    Appearance  Configure certain aspects of the graphical interface.
    Backgrounds
    Backgrounds  Set a color or image as background of the Desktop or any other folder.
    DataTranslations
    DataTranslations  Settings for all supported file formats.
    E-mail
    E-mail  Configure your email accounts.
    FileTypes
    FileTypes  Add, remove and configure filetypes.
    Fonts
    Fonts  Set your system fonts.
    Keyboard
    Keyboard  Configure repeat delay and rate.
    Keymap
    Keymap  Set the mapping of your keyboard.
    Media
    Media Audio and video settings like volume and in/output devices.
    Menu  Configure the behaviour of menus and the command key (CTRL/ALT.
    Mouse
    Mouse  Configure your mouse.
    Network
    Network  Configure your network.
    Printers
    Printers Add, remove and configure printers.
    Screen  Configure resolution, depth and refresh rate.
    ScreenSaver
    ScreenSaver  Add, remove and configure a screen saver.
    Sounds
    Sounds  Assign a sound to different system events.
    Time
    Time  Set time, date and timezone.
    VirtualMemory
    VirtualMemory  Set the amount of swap space.

    - + diff --git a/docs/userguide/prefs-appearance.html b/docs/userguide/prefs-appearance.html new file mode 100644 index 0000000000..49812f1ff8 --- /dev/null +++ b/docs/userguide/prefs-appearance.html @@ -0,0 +1,68 @@ + + + + + Appearance + + + + + +
    +

    + Preferences +     + Next: Backgrounds +

    +
    + +
    + +

    The Appearance preferences lets you change some aspects of Haiku's visuals. +

    + +

    Colors

    +appearance-colors.png +
    +

    In the first tab, Colors, 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. +

    + +

    Antialiasing

    +appearance-antialiasing.png +
    +

    The second tab, Antialiasing, provides different settings for how things are rendered on screen.
    +An activated Glyph hinting 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. +

    See the difference of the two settings with these magnified screenshots: +

    +appearance-glyph-off.png appearance-glyph-on.png +
    +

    Another technique to improve rendering is Antialiasing, which supports all vector graphics as well as text. It smoothes lines by changing the color of certain pixels. There are two methods for that:

    +

    Greyscale changes the intensity of pixels at the edge.
    +LCD subpixel 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. +

    Again, the two different methods with magnified screenshots: +

    +appearance-glyph-off.png appearance-subpixel.png +
    +

    Subpixel based antialiasing adds a slight colored shine to objects. Something not everyone tolerates. In Haiku you can mix the two antialiasing methods and find the right setting for you by using a slider. +

    Note: The subpixel based antialiasing in combination with the glyph hinting is subject of a software patent and is therefore not available by default. Depending on where in the world you live, you may get an unlocked version. Sorry about that. Talk with your representative. +


    +

    + + +
    Defaults resets everything to default values.
    Revert brings back the settings that were active when you started the Appearance preferences.
    +

    +
    + +
    +

    + Preferences +     + Next: Backgrounds +

    +
    + + + diff --git a/docs/userguide/prefs-backgrounds.html b/docs/userguide/prefs-backgrounds.html new file mode 100644 index 0000000000..00e623f268 --- /dev/null +++ b/docs/userguide/prefs-backgrounds.html @@ -0,0 +1,61 @@ + + + + + Backgrounds + + + + + +
    +

    + Preferences +     + Previous: Appearance +     + Next: DataTranslations +

    +
    + +
    + +

    You can set a color or an image as background for every folder and the Desktop for every workspace. +

    +backgrounds.png +

    +

    The top drop-down menu specifies if your changes are applied to the current workspace, all workspaces, a specific folder or as default for every new folder. +

    Below that you can assign an image or select None if you want simply a colored background. +

    If you are using an image, you have to decide on the placement: +

    + + + + +
    Manual lets you specify the coordinates. You can drag the picture around in the preview to the left or enter X and Y manually.
    Center centers the picture in the middle of the screen.
    Scale to fit enlarges the picture with no regard to its aspect ratio until it fills the screen.
    Tile fills the screen by repeating the picture.
    +

    If you are using an image you can activate Icon label outline which will put an thin contour around an icon's label. +

    If an icon label's actual text is black or white depends on setting of the color picker. A dark color sets the text to white, a light color to black. So, if you assign a very bright image to the background, you should also set the color picker to a bright color in order to have icon labels readable in black. (Or use the outline option above.)
    +The selected color is also reflected in the Workspaces applet, which ignores images as backgrounds. +

    + + +
    Revert brings back the settings that were active when you started the Backgrounds preferences.
    Apply sets your changes.
    +

    + +
    + +
    +

    + Preferences +     + Previous: Appearance +     + Next: DataTranslations +

    +
    + + + diff --git a/docs/userguide/prefs-datatranslations.html b/docs/userguide/prefs-datatranslations.html new file mode 100644 index 0000000000..dc625b8001 --- /dev/null +++ b/docs/userguide/prefs-datatranslations.html @@ -0,0 +1,70 @@ + + + + + DataTranslations + + + + + +
    +

    + Preferences +     + Previous: Backgrounds +     + Next: E-mail +

    +
    + +
    + +

    Every application has the ability to open and save every file format for which there's a Translator installed. The settings for these Translators are configured in the DataTranslations preferences. +

    +datatranslations.png +

    +

    Depending on its capabilities, each Translator offers different settings. At least you'll get an Info... button that opens a window with the credits and the installation path.
    +The following table gives an overview of the default Translators and their most useful options. +

    + + + + + + + + + + + + + + + +
    BMP Images24bit, uncompressed, no transparency
    EXR ImagesILM's high dynamic-range (HDR) format
    GIF Images8bit, lossless compression, transparency
    +You can reduce the filesize by limiting the number of used colors and the palette.
    +You can write images with transparency, either by automatically using the alpha channel or by setting the RGB value that will be transparent by hand.
    JPEG2000 Images24bit, compressed, no transparency
    +Here, you normally only care about the output quality.
    JPEG Images24bit, compressed, no transparency
    +Besides the output quality you can also set a smoothing that will lessen compression artefacts but can blur the picture a little.
    PCX Images24bit, uncompressed, no transparency, PC Paintbrush Exchange format
    PNG Images32bit, lossless compression, transparency
    PPM Images24bit, uncompressed, no transparency, Portable PixMap format
    RAW Imagesup to 48bit, uncompressed, no transparency
    RTF Text FilesFormatted text
    SGI Images24bit, optional lossless compression, transparency
    StyledEdit FilesFormatted text
    TGA Images32bit, optional lossless compression, transparency
    TIFF Images24bit, optional lossless compression, layers, transparency
    WonderBrush Images32bit, layers, transparency, vector/pixel data
    +


    +

    Note: Screenshots, charts, black&white drawings and other images with few used colors, as well as small pictures are best saved as GIF (up to 256 colors) or PNG (millions of colors). JPEG, for example, introduces compression artefacts without gain in smaller filesize. +

    + +
    + +
    +

    + Preferences +     + Previous: Backgrounds +     + Next: E-mail +

    +
    + + + diff --git a/docs/userguide/prefs-e-mail.html b/docs/userguide/prefs-e-mail.html new file mode 100644 index 0000000000..81c549e303 --- /dev/null +++ b/docs/userguide/prefs-e-mail.html @@ -0,0 +1,143 @@ + + + + + E-mail + + + + + +
    +

    + Preferences +     + Previous: DataTranslations +     + Next: FileTypes +

    +
    + +
    + +

    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.
    +The configuration is done in the E-Mail preference panel. +

    + +

    Creating a new e-mail account

    +

    Let's go through the process of setting up an e-mail account.
    +You start by clicking the Add button to create a new, unnamed account. Then you declare the Account Type which is either Receive Mail Only, Send Mail Only, or the most usual type, Send and Receive Mail. +

    Now you enter an Account Name, your Real Name and the Return Address where replies will be sent to. +

    + +

    Setting up incoming e-mail

    +

    Click on Incoming under your account's name to set up how e-mails are received. +

    +

    e-mail-in.png +

    +

    From the drop-down menu you choose the protocol used by your provider. IMAP and POP3 are supported. +

    Next is the Mail Server address for incoming mails. If your provider needs you to log into a specific port, you add that to the address, separated by a colon. For example, pop.your-provider.org:1400. +

    Then you enter your login information, Username and Password, and if necessary change the Login Type from the default Plain Text to APOP for authentication. +

    If you retrieve mails of this account from different computers, you may want to activate the option to Leave mail on server and only Remove mail from server when deleted locally. +

    The New Mail Notification offers different methods to announce the arrival of new mail. Try different settings to see what works best for you. +

    You can change the Location of your inbox (default: /boot/home/mail/in/), which is useful if you'd like to separate the mails from different accounts into their own folders. However, queries let you sort things out just as well. +

    Last on this page, you can opt to only Partially download messages 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. +

    + +

    Setting up outgoing e-mail

    +

    Click on Outgoing under your account's name to set up how e-mails are sent. +

    +

    e-mail-out.png +

    +

    As with incoming mail, you can also change the Location of your outbox (default: /boot/home/mail/out/). +

    Next is the SMTP Server address for outgoing mails. As with the incoming server before, you can use a specific port if needed, e.g. mail.your-provider.org:1200. +

    If you need to login, you change the Login Type to ESMTP and enter username and password above. The other type is used for providers that need you to check for mail with POP3 before SMTP for identification. + +

    Setting up e-mail filters

    +

    If you want to filter your incoming email, you click on E-Mail Filters 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 R5 Daemon Filter that's used for backward compatibility, there are two other Incoming Mail Filters you can add. +

    + +

    Spam Filter

    +

    e-mail-filter-spam.png +

    +

    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 Match Header filter, you're able to automatically sort out detected spam mails. + +

    Match Header

    +

    e-mail-filter-header.png +

    +

    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: +

    + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Name the name of the sender
    From the e-mail address of the sender
    To your e-mail address (different for each e-mail account)
    Reply To the e-mail address replies are sent to
    When the date and time the mail was received
    Subject the subject line
    Cc addresses of anyone receiving a carbon copy (Cc)
    Account the name of the e-mail's account
    Status The current status of the e-mail. Normally, this can be "Read", "Replied", "Sent", "Forwarded", "New", or anything you have designated yourself. However, unless you change it yourself in a filter, it will always be "New" when the mail_daemon fetched the mail.
    Priority is set by the sender's e-mail program (e.g. "urgent")
    Thread essentially the same as "Subject", but without things like Re: or Fwd:
    Classification Group depending on what the spam filter classified it as, this will either be empty (if uncertain) or contain the word "Genuine" or "Spam"
    Spam/Genuine Estimate this is a numerical estimate that the spam filter assigned to the e-mail. They are shown in scientific notation, where 1.065e-12 translates to 1.065 divided by 10 to the 12th power, which in this case translates to 0.000000000001065.
    +

    +

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

    +

    Outgoing Mail Filters

    +

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

    + +

    Setting up the mail_daemon

    +

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

    +

    e-mail-settings.png +

    +

    Under Mail Checking you configure the interval at which the account's mail server is probed for new mail.
    +If you're on a dial-up connection, you may want to do that Only When Dial-Up is Connected and also Schedule Outgoing Mail When Dial-Up is Disconnected to avoid dialing automatically in regularly only to check for mail. +

    The mail_daemon has a status window which you can set to show up Never, While Sending, While Sending and Receiving or Always. +

    Make sure to Start Mail Services on Startup or there will be no mail_daemon running to do your bidding... +

    +

    e-mail-mailbox.png +

    +

    Edit Mailbox Menu... will open the folder /boot/home/config/Mail/Menu Links/. All folders or queries (!) or their links put into this folder will appear in the context menu of the mailbox icon of the Mail Services in the Deskbar tray. +

    From that menu, you can also Create New Message...s, Check For Mail Now or Edit Preferences.... +

    The mailbox icon itself shows if there are unread messages (status "New") when there are envelopes inside. +

    +
    + +
    +

    + Preferences +     + Previous: DataTranslations +     + Next: FileTypes +

    +
    + + + diff --git a/docs/userguide/prefs-filetypes.html b/docs/userguide/prefs-filetypes.html new file mode 100644 index 0000000000..9654e60420 --- /dev/null +++ b/docs/userguide/prefs-filetypes.html @@ -0,0 +1,43 @@ + + + + + FileTypes + + + + + +
    +

    + Preferences +     + Previous: E-mail +     + Next: Fonts +

    +
    + +
    + +

    Please refer to topic Filetypes and the workshop Filetypes, Attributes, Index and Queries that explains most of this preference panel. +

    + +
    + + + + diff --git a/docs/userguide/prefs-fonts.html b/docs/userguide/prefs-fonts.html new file mode 100644 index 0000000000..b3443802de --- /dev/null +++ b/docs/userguide/prefs-fonts.html @@ -0,0 +1,53 @@ + + + + + Fonts + + + + + +
    +

    + Preferences +     + Previous: FileTypes +     + Next: Keyboard +

    +
    + +
    + +

    +fonts.png +

    +

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

    + + +
    Defaults resets everything to default values.
    Revert brings back the settings that were active when you started the Fonts preferences.
    + +

    Installing new fonts

    +

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

    +
    + + + + + diff --git a/docs/userguide/prefs-images/appearance-antialiasing.png b/docs/userguide/prefs-images/appearance-antialiasing.png new file mode 100644 index 0000000000..f4709a1df0 Binary files /dev/null and b/docs/userguide/prefs-images/appearance-antialiasing.png differ diff --git a/docs/userguide/prefs-images/appearance-colors.png b/docs/userguide/prefs-images/appearance-colors.png new file mode 100644 index 0000000000..0a16464472 Binary files /dev/null and b/docs/userguide/prefs-images/appearance-colors.png differ diff --git a/docs/userguide/prefs-images/appearance-glyph-off.png b/docs/userguide/prefs-images/appearance-glyph-off.png new file mode 100644 index 0000000000..e37aa6e529 Binary files /dev/null and b/docs/userguide/prefs-images/appearance-glyph-off.png differ diff --git a/docs/userguide/prefs-images/appearance-glyph-on.png b/docs/userguide/prefs-images/appearance-glyph-on.png new file mode 100644 index 0000000000..f5862619c4 Binary files /dev/null and b/docs/userguide/prefs-images/appearance-glyph-on.png differ diff --git a/docs/userguide/prefs-images/appearance-subpixel.png b/docs/userguide/prefs-images/appearance-subpixel.png new file mode 100644 index 0000000000..949c904fdc Binary files /dev/null and b/docs/userguide/prefs-images/appearance-subpixel.png differ diff --git a/docs/userguide/prefs-images/backgrounds.png b/docs/userguide/prefs-images/backgrounds.png new file mode 100644 index 0000000000..879ac7b301 Binary files /dev/null and b/docs/userguide/prefs-images/backgrounds.png differ diff --git a/docs/userguide/prefs-images/datatranslations.png b/docs/userguide/prefs-images/datatranslations.png new file mode 100644 index 0000000000..8cb7ccd19a Binary files /dev/null and b/docs/userguide/prefs-images/datatranslations.png differ diff --git a/docs/userguide/prefs-images/e-mail-filter-header.png b/docs/userguide/prefs-images/e-mail-filter-header.png new file mode 100644 index 0000000000..ed701387a0 Binary files /dev/null and b/docs/userguide/prefs-images/e-mail-filter-header.png differ diff --git a/docs/userguide/prefs-images/e-mail-filter-spam.png b/docs/userguide/prefs-images/e-mail-filter-spam.png new file mode 100644 index 0000000000..ee0b4c42bd Binary files /dev/null and b/docs/userguide/prefs-images/e-mail-filter-spam.png differ diff --git a/docs/userguide/prefs-images/e-mail-in.png b/docs/userguide/prefs-images/e-mail-in.png new file mode 100644 index 0000000000..0c5fa22d95 Binary files /dev/null and b/docs/userguide/prefs-images/e-mail-in.png differ diff --git a/docs/userguide/prefs-images/e-mail-mailbox.png b/docs/userguide/prefs-images/e-mail-mailbox.png new file mode 100644 index 0000000000..1703e39fb1 Binary files /dev/null and b/docs/userguide/prefs-images/e-mail-mailbox.png differ diff --git a/docs/userguide/prefs-images/e-mail-out.png b/docs/userguide/prefs-images/e-mail-out.png new file mode 100644 index 0000000000..c6ef7eccd2 Binary files /dev/null and b/docs/userguide/prefs-images/e-mail-out.png differ diff --git a/docs/userguide/prefs-images/e-mail-settings.png b/docs/userguide/prefs-images/e-mail-settings.png new file mode 100644 index 0000000000..1241493016 Binary files /dev/null and b/docs/userguide/prefs-images/e-mail-settings.png differ diff --git a/docs/userguide/prefs-images/fonts.png b/docs/userguide/prefs-images/fonts.png new file mode 100644 index 0000000000..9803357511 Binary files /dev/null and b/docs/userguide/prefs-images/fonts.png differ diff --git a/docs/userguide/prefs-images/keyboard.png b/docs/userguide/prefs-images/keyboard.png new file mode 100644 index 0000000000..9badb7a874 Binary files /dev/null and b/docs/userguide/prefs-images/keyboard.png differ diff --git a/docs/userguide/prefs-images/keymap.png b/docs/userguide/prefs-images/keymap.png new file mode 100644 index 0000000000..612f113b8e Binary files /dev/null and b/docs/userguide/prefs-images/keymap.png differ diff --git a/docs/userguide/prefs-images/menu.png b/docs/userguide/prefs-images/menu.png new file mode 100644 index 0000000000..dff3296926 Binary files /dev/null and b/docs/userguide/prefs-images/menu.png differ diff --git a/docs/userguide/prefs-images/mouse.png b/docs/userguide/prefs-images/mouse.png new file mode 100644 index 0000000000..80367b7a26 Binary files /dev/null and b/docs/userguide/prefs-images/mouse.png differ diff --git a/docs/userguide/prefs-images/network.png b/docs/userguide/prefs-images/network.png new file mode 100644 index 0000000000..89913aec27 Binary files /dev/null and b/docs/userguide/prefs-images/network.png differ diff --git a/docs/userguide/prefs-images/screen.png b/docs/userguide/prefs-images/screen.png new file mode 100644 index 0000000000..de9571ddfe Binary files /dev/null and b/docs/userguide/prefs-images/screen.png differ diff --git a/docs/userguide/prefs-images/screensaver-fade.png b/docs/userguide/prefs-images/screensaver-fade.png new file mode 100644 index 0000000000..3d0607256f Binary files /dev/null and b/docs/userguide/prefs-images/screensaver-fade.png differ diff --git a/docs/userguide/prefs-images/screensaver-modules.png b/docs/userguide/prefs-images/screensaver-modules.png new file mode 100644 index 0000000000..2eb1d3255c Binary files /dev/null and b/docs/userguide/prefs-images/screensaver-modules.png differ diff --git a/docs/userguide/prefs-images/sounds.png b/docs/userguide/prefs-images/sounds.png new file mode 100644 index 0000000000..58812dc9ac Binary files /dev/null and b/docs/userguide/prefs-images/sounds.png differ diff --git a/docs/userguide/prefs-images/time-time.png b/docs/userguide/prefs-images/time-time.png new file mode 100644 index 0000000000..8f78d8f7db Binary files /dev/null and b/docs/userguide/prefs-images/time-time.png differ diff --git a/docs/userguide/prefs-images/time-timezone.png b/docs/userguide/prefs-images/time-timezone.png new file mode 100644 index 0000000000..97d15bdd79 Binary files /dev/null and b/docs/userguide/prefs-images/time-timezone.png differ diff --git a/docs/userguide/prefs-images/virtualmemory.png b/docs/userguide/prefs-images/virtualmemory.png new file mode 100644 index 0000000000..5202609c6b Binary files /dev/null and b/docs/userguide/prefs-images/virtualmemory.png differ diff --git a/docs/userguide/prefs-keyboard.html b/docs/userguide/prefs-keyboard.html new file mode 100644 index 0000000000..8bd2b4f3ec --- /dev/null +++ b/docs/userguide/prefs-keyboard.html @@ -0,0 +1,51 @@ + + + + + Keyboard + + + + + +
    +

    + Preferences +     + Previous: Fonts +     + Next: Keymap +

    +
    + +
    + +

    +keyboard.png +

    +

    Set the repeat rate and the delay until a held down key starts to repeat. You can test your settings in the text field at the bottom. +

    + + +
    Defaults resets everything to default values.
    Revert brings back the settings that were active when you started the Keyboard preferences.
    +

    + +
    + + + + + diff --git a/docs/userguide/prefs-keymap.html b/docs/userguide/prefs-keymap.html new file mode 100644 index 0000000000..08f8d1ab63 --- /dev/null +++ b/docs/userguide/prefs-keymap.html @@ -0,0 +1,55 @@ + + + + + Keymap + + + + + +
    +

    + Preferences +     + Previous: Keyboard +     + Next: Media +

    +
    + +
    + +

    +keymap.png +

    +

    The Keymap window shows a representation of your keyboard. When you press a key, the corresponding key is inverted and the assigned symbol is entered into the text field at the top. From there you can copy and paste it into any document.
    +Thus, the Keymap preferences are not only for configuring your local keymap, but are also useful when looking for a special symbol used in other languages. For example, you can switch the keymap to "French", find the "ç" and copy it into your mail to François. (Though you'll find the "cedil" also in other keymaps...") +

    Pressing modifier keys like SHIFT or AltGr, you'll find more special characters. +

    Then there are the keys that are marked with a yellow outline. These are keys that can change the key you press after that. If you press a yellow key twice, those changeable keys are marked with a red outline. Examples are é, ñ, ó or ë. +

    You set the used font, which may or may not contain all symbols for a specific keymap from the Font menu. +

    + + +
    Revert brings back the settings that were active when you started the Keymap preferences.
    Use applies your changes.
    +

    + +
    + + + + + diff --git a/docs/userguide/prefs-menu.html b/docs/userguide/prefs-menu.html new file mode 100644 index 0000000000..dec887e571 --- /dev/null +++ b/docs/userguide/prefs-menu.html @@ -0,0 +1,54 @@ + + + + + Menu + + + + + +
    +

    + Preferences +     + Previous: Media +     + Next: Mouse +

    +
    + +
    + +

    +menu.png +

    +

    You can change the font face and size used in menus, as well as the color of the menu/menubar. +

    Always Show Triggers will always underline the letter for the keyboard shortcut of a menu item. If you don't activate this option, the underlining will only appear when...???? +

    With the last items in this preference panel you set the system wide shortcut key. Either the Haiku default ALT or the CTRL key used on some other platforms.
    +While it's useful to have always the same modifier key for shortcuts across different operating systems, don't dismiss Haiku's default too quickly. After you get used to it, it actually feels better as e.g. ALT+C and ALT+V is reached more conveniently on the keyboard and these commands seamlessly integrate into the bash shell of the Terminal, where CTRL+C quits the running process. +

    + + +
    Defaults resets everything to default values.
    Revert brings back the settings that were active when you started the Menu preferences.
    +

    + +
    + + + + + diff --git a/docs/userguide/prefs-mouse.html b/docs/userguide/prefs-mouse.html new file mode 100644 index 0000000000..41733c6b21 --- /dev/null +++ b/docs/userguide/prefs-mouse.html @@ -0,0 +1,60 @@ + + + + + Mouse + + + + + +
    +

    + Preferences +     + Previous: Menu +     + Next: Network +

    +
    + +
    + +

    +mouse.png +

    +

    Set your type of mouse: 1, 2 or 3 button mouse. You can simulate the 2nd (=right) mouse button by holding down CTRL while left-clicking. For the 3rd (=middle) mouse button, it's CTRL+ALT and a left-click. A middle-click is also simulated by clicking left and right button together. Useful for notebooks, which mostly don't have a 3rd button. +

    You can rearrange the mouse buttons by clicking on them and choose their new meaning from the drop-down menu. +

    With the sliders to the right, you adjust double-click speed, mouse speed and acceleration. +

    Focus follows mouse means, that you don't have to click into a window to activate it. There are three modes: +

    + + + +
    Enabled The window under the mouse pointer is always activated automatically, but doesn't pop to the front.
    Warping Choosing a window from Deskbar or the Twitcher will have the mouse pointer glide smoothly toward it.
    Instant-Warping Choosing a window from Deskbar or the Twitcher will have the mouse pointer jump instantly toward it.
    +

    All settings are immediately applied. +

    + + +
    Defaults resets everything to default values.
    Revert brings back the settings that were active when you started the Mouse preferences.
    +

    + +
    + + + + + diff --git a/docs/userguide/prefs-network.html b/docs/userguide/prefs-network.html new file mode 100644 index 0000000000..39f9da30af --- /dev/null +++ b/docs/userguide/prefs-network.html @@ -0,0 +1,52 @@ + + + + + Network + + + + + +
    +

    + Preferences +     + Previous: Mouse +     + Next: Printers +

    +
    + +
    + +

    +network.png +

    +

    At the top, you choose which network adapter to configure. +

    Then you specify if you get your network settings dynamically from a server or router via DHCP or if you're using static addresses. If it's the latter, you'll have to fill out IP Address, Netmask, Gateway and DNS Servers yourself. Otherwise the panel will show the addresses currently set with DHCP. +

    + + +
    Revert brings back the settings that were active when you started the Network preferences.
    Apply sets the entered configuration.
    +

    + +
    + + + + + diff --git a/docs/userguide/prefs-screen.html b/docs/userguide/prefs-screen.html new file mode 100644 index 0000000000..1f08295fe1 --- /dev/null +++ b/docs/userguide/prefs-screen.html @@ -0,0 +1,51 @@ + + + + + Screen + + + + + +
    +

    + Preferences +     + Previous: Printers +     + Next: ScreenSaver +

    +
    + +
    + +

    Each of your workspaces can have its own resolution and color depth. +

    +screen.png +

    +

    The top drop-down menu specifies if your changes are applied only to the current or to all workspaces. Depending on your graphics card, the other two drop-down menus contain all supported resolution and depth settings. +

    After clicking on Apply, 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. +

    To the left, you can set the number of workspaces and open the Backgrounds preferences. +

    Revert brings back the setting that was active when you started the Screen preferences. +

    + +
    + + + + + diff --git a/docs/userguide/prefs-screensaver.html b/docs/userguide/prefs-screensaver.html new file mode 100644 index 0000000000..888316d4c5 --- /dev/null +++ b/docs/userguide/prefs-screensaver.html @@ -0,0 +1,59 @@ + + + + + ScreenSaver + + + + + +
    +

    + Preferences +     + Previous: Screen +     + Next: Sounds +

    +
    + +
    + +

    The panel of the ScreenSaver preferences is split into two tabs: +

    + +

    Fade

    +screensaver-fade.png +
    +

    The top checkbox enables/disables the screen saver.
    +With the slider below it, you control after how long an idle time the screen saver kicks in. +

    The next two sliders are only usable after you activated their checkboxes:
    +One slider determines after how many minutes the screen is powered off.
    +The other, after how many minutes you need a password to unlock your machine. +

    By clicking into different corners of the two screens at the bottom, you tell the system when to immediately start the screen saver or when to prevent it from kicking in when you rest the mouse in the indicated corner. Click in the middle of the screens to disable that feature again. +

    + +

    Modules

    +screensaver-modules.png +
    +

    The second tab shows a list of all installed screen saver modules and their individual settings. You can test your settings with the Test button below the list and add modules with the Add... button beside it. Other ways to install new screen savers is by a simple drag&drop into the list. Of course, you can also copy/delete a module's file in its respective user folder, i.e. /boot/common/add-ons/screensavers/ or /boot/home/config/add-ons/screensavers/ (see topic Filesystem layout). +

    + +
    + +
    +

    + Preferences +     + Previous: Screen +     + Next: Sounds +

    +
    + + + diff --git a/docs/userguide/prefs-sounds.html b/docs/userguide/prefs-sounds.html new file mode 100644 index 0000000000..2f2009e8de --- /dev/null +++ b/docs/userguide/prefs-sounds.html @@ -0,0 +1,48 @@ + + + + + Sounds + + + + + +
    +

    + Preferences +     + Previous: ScreenSaver +     + Next: Time +

    +
    + +
    + +sounds.png +
    +

    You can assign sounds to certain events in the system. Just select the event from the list and choose a sound from the drop-down menu below. None will silence an event. Other... will open a file panel to find a new sound that isn't yet in the menu.
    +You can use any format that's supported by the system. If MediaPlayer can deal with it, so can any other program. +

    You can "pre-hear" an event's sound by selecting it and using the Play and Stop buttons. +

    + +
    + + + + + diff --git a/docs/userguide/prefs-time.html b/docs/userguide/prefs-time.html new file mode 100644 index 0000000000..6e8ccd710e --- /dev/null +++ b/docs/userguide/prefs-time.html @@ -0,0 +1,58 @@ + + + + + Time + + + + + +
    +

    + Preferences +     + Previous: Sounds +     + Next: VirtualMemory +

    +
    + +
    + +

    The panel of the Time preferences is split into two tabs: +

    + +

    Date & Time

    +time-time.png +
    +

    On the left side, you can set the day of the month by simply clicking on it in the calendar. You change the month and year by clicking on it and using the up/down arrows to the right or the cursor keys on your keyboard. +

    Similarly, you set the time. There are two modes for the clock: + + + +
    Local to display your local time.
    GMT to display Greenwich Mean Time.
    +

    + +

    Timezone

    +time-timezone.png +
    +

    Simply find and choose your location from the drop-down menu and the list of cities and press Set Time Zone to set your zone. +

    Revert brings back the settings that were active when you started the Time preferences. +

    + +
    + +
    +

    + Preferences +     + Previous: Sounds +     + Next: VirtualMemory +

    +
    + diff --git a/docs/userguide/prefs-virtualmemory.html b/docs/userguide/prefs-virtualmemory.html new file mode 100644 index 0000000000..34292a63d0 --- /dev/null +++ b/docs/userguide/prefs-virtualmemory.html @@ -0,0 +1,47 @@ + + + + + VirtualMemory + + + + + +
    +

    + Preferences +     + Previous: Time +

    +
    + +
    + +

    Virtual memory let's the system swap out memory to harddisk, if the RAM can be used more sensibly for other things. So, even if you have lots of RAM, providing virtual memory is never a bad idea. +

    virtualmemory.png +
    +

    You can set the size to even more than your physical memory size if needed. With today's huge harddisks, assigning the physical memory size shouldn't be a problem. Still, you can quickly adjust the size if your free space ever runs low. In that case you should also have a look at DiskUsage to find out what's eating up your diskspace. +

    Normally, the swap file's written to your boot partition. If you often run into disk thrashing due to the virtual memory system swapping memory in and out, you can try to use a separate harddisk for you swap file. Simply another partition on the same harddisk with your system/data won't help.
    +Upgrading your RAM is of course the most effective way to go... +

    + + +
    Defaults resets everything to default values.
    Revert brings back the settings that were active when you started the VirtualMemory preferences.
    +

    + +
    + + + diff --git a/docs/userguide/queries.html b/docs/userguide/queries.html index 12a5b93758..8295ffb3c1 100644 --- a/docs/userguide/queries.html +++ b/docs/userguide/queries.html @@ -24,7 +24,7 @@
    -

    A query is a file search based on file attributes and can be performed within Tracker or in Terminal. Queries are saved in "/boot/home/queries" and by default last seven days before being purged. Note, that these aren't static result lists of your search, but are the query formulas which trigger a new search whenever you open them. +

    A query is a file search based on file attributes and can be performed within Tracker or in Terminal. Queries are saved in "/boot/home/queries/" and by default last seven days before being purged. Note, that these aren't static result lists of your search, but are the query formulas which trigger a new search whenever you open them.

    The Find window

    diff --git a/docs/userguide/tracker-add-ons.html b/docs/userguide/tracker-add-ons.html index f39a98bf3b..d741ae6992 100644 --- a/docs/userguide/tracker-add-ons.html +++ b/docs/userguide/tracker-add-ons.html @@ -37,7 +37,7 @@ Of course, you have to take care of possible shortcut collisions when deciding o

    Haiku's Tracker Add-Ons

    These Tracker Add-Ons come with every Haiku installation:

    - +
    diff --git a/docs/userguide/workshop-filetypes+attributes.html b/docs/userguide/workshop-filetypes+attributes.html index 5bb678b526..75e88e802f 100644 --- a/docs/userguide/workshop-filetypes+attributes.html +++ b/docs/userguide/workshop-filetypes+attributes.html @@ -16,10 +16,8 @@ Contents     Previous: Queries - + Next: Preferences

    @@ -30,7 +28,7 @@

    Preparations

    -

    Let's first decide what filetype and attributes would serve our needs. Originally, I wanted to use a Bookmark file with a link to the movie's IMdB page, but Haiku doesn't have a "bookmarkable" browser like BeOS' NetPositiv at the moment, so I came up with this: The file itself will be a JPEG image for the movie cover.
    +

    Let's first decide what filetype and attributes would serve our needs. Originally, I wanted to use a Bookmark file with a link to the movie's IMdB page, but Haiku doesn't have a "bookmarkable" browser like BeOS' NetPositive at the moment, so I came up with this: The file itself will be a JPEG image for the movie cover.
    To that we add a couple of attributes. Here we have to decide if we want to query it later (then we have to add it to the index) and if so, what type of attribute it should be. Numbers (int, float) can be evaluated differently than text (/= vs. is/contains/starts with).

    Here's are the attributes I'd like to see for my DVDs: @@ -158,10 +156,8 @@ Open the folder containing your DVDdb files and arrange the attributes how you'd Contents     Previous: Queries - + Next: Preferences

    diff --git a/docs/userguide/workspaces.html b/docs/userguide/workspaces.html index fb26e4b39a..bc679d1aa8 100644 --- a/docs/userguide/workspaces.html +++ b/docs/userguide/workspaces.html @@ -23,7 +23,7 @@
    -

    Workspaces are virtual desktops, complete with their own resolution, colour depth and background. Up to 32 of these workspaces can be set from the Screen preferences. +

    Workspaces are virtual desktops, complete with their own resolution, color depth and background. Up to 32 of these workspaces can be set from the Screen preferences.

    The Workspaces Applet

    Background-B Opens the Background preferences to change the color or image of the Desktop or any folder. Invoked on an image file the Background panel is launched with that image already loaded as a potential background.
    DiskUsage-I