Haiku/userguide
1
0
Fork 0
mirror of https://review.haiku-os.org/userguide synced 2024-11-23 07:08:25 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

* Fixed typos.

Browse Source 
* 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
This commit is contained in:
Joachim Seemer 2009-07-08 16:26:00 +00:00
parent c30e2c16ac
commit ead72567a5
3 changed files with 8 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
userguide/en/applications/apps-icon-o-matic.html
View File

@ -243,10 +243,10 @@ width="32" height="32" /></td>
width="64" height="64" /></td></tr>
</table>
<p>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.<br />
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.</p>
<p>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 <span class="menu">Min LOD</span> and above its <span class="menu">Max LOD</span>.</p>
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.</p>
<p>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 <span class="menu">Min LOD</span> and above its <span class="menu">Max LOD</span>.</p>
<p>So, if you set a shape's <span class="menu">Min LOD</span> to 0.0 and the <span class="menu">Max LOD</span> to 0.5, this means that the shape will only be visible for icon sizes smaller or <i>equal</i> to 32px. If you wanted to exclude the 32px icon size, you'd have to stay below 0.5, say 0.49.</p>
<p>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...<br />
<p>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...<br />
For example, if Shape 1 were to be shown below 48px and Shape 2 from 48px upward (LOD: 48/64 = 0.75):</p>
<table summary="LOD values example" border="0" cellpadding="5">
@ -297,7 +297,7 @@ Of course you can move these indicators to change the gradient to your liking. Y
<p>Besides a <span class="menu">Name</span> and the actual <span class="menu">Width</span> for the transformer, the <span class="menu">Property</span> view has these (depending on its type slightly differing) options:</p>
<table summary="Transformer properties" border="0" cellspacing="0" cellpadding="2">
<tr><td><span class="menu">Caps</span></td><td style="width:15px;"></td><td><i>Stroke only</i>. Defines the end caps of a line: <span class="menu">Butt</span>, <span class="menu">Square</span> or <span class="menu">Round</span>.</td></tr>
<tr><td><span class="menu">Detect Orient.</span></td><td></td><td><i>Contour only</i>. Makes sure the contour always extends outwards when you have self-intesecting paths.</td></tr>
<tr><td><span class="menu">Detect Orient.</span></td><td></td><td><i>Contour only</i>. Makes sure the contour always extends outwards when you have self-intersecting paths.</td></tr>
<tr><td><span class="menu">Joins</span></td><td></td><td>Defines how lines are joint at a point: <span class="menu">Miter</span>, <span class="menu">Round</span> or <span class="menu">Bevel</span>.</td></tr>
<tr><td><span class="menu">Miter Limit</span></td><td></td><td>Only when the above <span class="menu">Joins</span> is set to "Miter" this setting influences the looks of the miter joint. </td></tr>
</table>

2
welcome/en/bugreports.html
View File

@ -32,7 +32,7 @@
<h1>Reporting bugs</h1>
<p>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.<br /><br />
Please follow these guidelines to create helpful bug reports:</p>
To keep our bugtracker effective, it's essential to abide by the <a href="http://dev.haiku-os.org/wiki/BugTrackerEtiquette">Bug Tracker Etiquette</a>. Besides, please follow these guidelines to create helpful bug reports:</p>
<ol>
<li><p>Before reporting a bug please <a href="http://dev.haiku-os.org/query?status=new&amp;status=assigned&amp;status=reopened&amp;status=closed&amp;summary=~text+you+want+to+search+for&amp;order=priority">make sure</a> that it does not yet exist. You can also use the <a href="http://dev.haiku-os.org/search?q=&amp;noquickjump=1&amp;ticket=on">search</a> function for this.</p></li>
<li><p>After you have established this is a unique bug, make your information as accurate as possible:

5
welcome/welcome.html
View File

@ -34,7 +34,8 @@
<p>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 <i>alpha release</i> 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.</p>
<h1><a id="bugreport" name="bugreport">Beware of Bugs</a></h1>
<p>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. <b>We discourage using alpha versions as a production system. Your data could very well be altered, mangled or downright destroyed.</b></p>
<p>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.<p>
<div class="box-warning">We discourage using alpha versions as a production system. Your data could very well be altered, mangled or downright destroyed.</div>
<p>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.</p>
<ul>
@ -72,7 +73,7 @@
</ul>
<h1><a id="contact" name="contact">Getting in contact</a></h1>
<p>Get in contact with other developers and users and join the discussions in our forums or mailing lists.</p>
<p>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 <a href="http://www.haiku-os.org/node/2517">Mailing List Etiquette</a>.</p>
<ul>
<li><a href="http://www.haiku-os.org/forum" class="printurl">Haiku Forums</a></li>
<li><a href="http://www.freelists.org/list/haiku" class="printurl">General mailing list</a></li>