From 3dcda2693e5f3c6123ab9d4c5619028688054fcd Mon Sep 17 00:00:00 2001 From: Joachim Seemer Date: Wed, 8 Jul 2009 16:26:00 +0000 Subject: [PATCH] * Fixed typos. * Added links to bug tracker and mailing list etiquettes. I don't think those have to be available offline. Other opinions? * Moved warning about the alpha status in welcome.html into a warning box. git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@31461 a95241bf-73f2-0310-859d-f6bbb57e9c96 --- docs/userguide/en/applications/apps-icon-o-matic.html | 8 ++++---- docs/welcome/en/bugreports.html | 2 +- docs/welcome/welcome.html | 5 +++-- 3 files changed, 8 insertions(+), 7 deletions(-) diff --git a/docs/userguide/en/applications/apps-icon-o-matic.html b/docs/userguide/en/applications/apps-icon-o-matic.html index f8f5aff2ee..41d0928623 100644 --- a/docs/userguide/en/applications/apps-icon-o-matic.html +++ b/docs/userguide/en/applications/apps-icon-o-matic.html @@ -243,10 +243,10 @@ width="32" height="32" /> width="64" height="64" />

See how there are no numbers in the 16px version of the BeVexed icon? That's done with the "Level of Detail" setting of their shapes.
-With the LOD you control the visibility of a shape depending on its size. That way, you can leave away details of an icon that looks good on a bigger icon, but maybe not so much on its smaller version.

-

This is how it works: A LOD of 1.0 is defined as a 64px icon size. So, to get the LOD of a particular icon size you simply divide it by 64, e.g. a 16px icon has a LOD of 16/64 = 0.25. A shape won't be visible below its Min LOD and above its Max LOD.

+With the LOD you control the visibility of a shape depending on its size. That way, you can leave away details of an icon that look good on a bigger icon, but maybe not so much on its smaller version.

+

This is how it works: A LOD of 1.0 is defined as a 64px icon size. To get the LOD of a particular icon size you simply divide it by 64, e.g. a 16px icon has a LOD of 16/64 = 0.25. A shape won't be visible below its Min LOD and above its Max LOD.

So, if you set a shape's Min LOD to 0.0 and the Max LOD to 0.5, this means that the shape will only be visible for icon sizes smaller or equal to 32px. If you wanted to exclude the 32px icon size, you'd have to stay below 0.5, say 0.49.

-

The LOD is not only for leaving out detailing shapes, you can also use it to e.g. change the stroke width at different sizes, if you feel that's needed. Simply duplicate a shape, make your changes and set both of their LOD settings to show either one or the other. Here lies the only source of potential confusion, when you're unwittingly overlap LODs of shapes, and wonder why at some size both are visible...
+

The LOD is not only for leaving out detailing shapes, but also to e.g. change the stroke width at different sizes, if you feel that's needed. Simply duplicate a shape, make your changes and set both of their LOD settings to show either one or the other. Here lies the only source of potential confusion, when you unwittingly overlap LODs of shapes, and wonder why at some size both are visible...
For example, if Shape 1 were to be shown below 48px and Shape 2 from 48px upward (LOD: 48/64 = 0.75):

@@ -297,7 +297,7 @@ Of course you can move these indicators to change the gradient to your liking. Y

Besides a Name and the actual Width for the transformer, the Property view has these (depending on its type slightly differing) options:

- +
CapsStroke only. Defines the end caps of a line: Butt, Square or Round.
Detect Orient.Contour only. Makes sure the contour always extends outwards when you have self-intesecting paths.
Detect Orient.Contour only. Makes sure the contour always extends outwards when you have self-intersecting paths.
JoinsDefines how lines are joint at a point: Miter, Round or Bevel.
Miter LimitOnly when the above Joins is set to "Miter" this setting influences the looks of the miter joint.
diff --git a/docs/welcome/en/bugreports.html b/docs/welcome/en/bugreports.html index 8dd6951d03..74634355d1 100644 --- a/docs/welcome/en/bugreports.html +++ b/docs/welcome/en/bugreports.html @@ -32,7 +32,7 @@

Reporting bugs

Since our developers are unable to test every hardware combination, nor every different way of interacting with the operating system, we are relying on you to give us some input on how things work at your end. Since this is a very early product, it is very likely that you will encounter bugs. We thank you for taking the time to report these.

-Please follow these guidelines to create helpful bug reports:

+To keep our bugtracker effective, it's essential to abide by the Bug Tracker Etiquette. Besides, please follow these guidelines to create helpful bug reports:

  1. Before reporting a bug please make sure that it does not yet exist. You can also use the search function for this.

  2. After you have established this is a unique bug, make your information as accurate as possible: diff --git a/docs/welcome/welcome.html b/docs/welcome/welcome.html index 32a07c5561..4041bcf219 100644 --- a/docs/welcome/welcome.html +++ b/docs/welcome/welcome.html @@ -34,7 +34,8 @@

    Thank you very much for checking out Haiku! This is our first public release. We hope to attract new developers to our project and give future users a chance to check out Haiku. We realize that this alpha release does not yet fully live up to the goals that we have set for ourselves and doesn't offer all the features and well-rounded end-user experience planned for the final R1 version. However, we hope that this release lets you discover Haiku's great potential and that you share our excitement.

    Beware of Bugs

    -

    We were working very hard to fix all possibly show stopping bugs, however, being an alpha release, there are bound to be plenty left undiscovered. We discourage using alpha versions as a production system. Your data could very well be altered, mangled or downright destroyed.

    +

    We were working very hard to fix all possibly show stopping bugs, however, being an alpha release, there are bound to be plenty left undiscovered.

    +

    We discourage using alpha versions as a production system. Your data could very well be altered, mangled or downright destroyed.

    One of the main reasons for releasing an alpha version is to attract more people to test the system and discover bugs or provide suggestions for future enhancements. Please file bugs and enhancements in our bug tracker after using its search function to avoid duplicates.

      @@ -72,7 +73,7 @@

    Getting in contact

    -

    Get in contact with other developers and users and join the discussions in our forums or mailing lists.

    +

    Get in contact with other developers and users and join the discussions in our forums or mailing lists. When many different people come together, rules have to established to keep communication effective. Please respect our Mailing List Etiquette.