[Bf-docboard-svn] bf-manual: [9858] trunk/blender_docs/manual/sculpt_paint/sculpting/tools: Fixes and add brush information

[Julien Kaspar]

Revision: 9858
          https://developer.blender.org/rBM9858
Author:   JulienKaspar
Date:     2023-01-08 18:31:47 +0100 (Sun, 08 Jan 2023)
Log Message:
-----------
Fixes and add brush information
The smooth brush now has more info on relative strength
and Shift workflow.
Clay brushes clarify why they are good for building shapes.

Modified Paths:
--------------
    trunk/blender_docs/manual/sculpt_paint/sculpting/tools/clay.rst
    trunk/blender_docs/manual/sculpt_paint/sculpting/tools/clay_strips.rst
    trunk/blender_docs/manual/sculpt_paint/sculpting/tools/smooth.rst

Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/clay.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/clay.rst	2023-01-08 15:26:21 UTC (rev 9857)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/clay.rst	2023-01-08 17:31:47 UTC (rev 9858)
@@ -14,7 +14,8 @@
 on which the brush acts. That's because it behaves like a combination of the
 :doc:`Flatten </sculpt_paint/sculpting/tools/flatten>` and *Draw* brushes.
 
-This brush is useful for building and removing volumes and shapes like real clay.
+This brush is useful for building and removing volumes and shapes like real clay,
+because it flattens details as you add/subtract from the surfaces.
 
 If used together with :ref:`Dyntopo <bpy.ops.sculpt.dynamic_topology_toggle>`
 it's easy to continuously build shapes, even in a single stroke.

Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/clay_strips.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/clay_strips.rst	2023-01-08 15:26:21 UTC (rev 9857)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/clay_strips.rst	2023-01-08 17:31:47 UTC (rev 9858)
@@ -8,14 +8,16 @@
    :Mode:      Sculpt Mode
    :Tool:      :menuselection:`Toolbar --> Clay Strips`
 
-Similar to the :doc:`Draw </sculpt_paint/sculpting/tools/clay>` brush,
+Similar to the :doc:`Clay </sculpt_paint/sculpting/tools/clay>` brush,
 but it uses a square tip shape instead of a round one.
 
+Just like the *Clay* brush, it's useful for building and removing volumes
+and shapes like real clay, because it flattens details as you add/subtract from the surfaces.
+
 Clay Strips is very commonly used for aggressive building of volumes
-and more controlled and deliberate control over shapes on the surface.
+and deliberate control over shapes on the surface.
 This brush alone can be used for a fast rough pass over the entire sculpt,
 with additional smoothing or polishing often required afterwards.
-
 This brush can be very versatile with varying stroke directions, repeated strokes
 and pen pressure to achieve various results.
 

Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/smooth.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/smooth.rst	2023-01-08 15:26:21 UTC (rev 9857)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/smooth.rst	2023-01-08 17:31:47 UTC (rev 9858)
@@ -15,6 +15,11 @@
 Also available as a :doc:`Mesh Filter </sculpt_paint/sculpting/tools/mesh_filter>`
 to smooth all unmasked areas at once.
 
+.. note::
+   The brush called *Smooth* will be used whenever holding :kbd:`Shift` and sculpting.
+   If the smoothing strength or behavior needs to be changed, switch to the *Smooth*
+   brush and adjust the settings there.
+
 Brush Settings
 ==============
 
@@ -21,6 +26,11 @@
 General
 *******
 
+Strength
+   The strength of the smoothing is relative to the density of the mesh.
+   If the resolution is increased on the sculpted mesh,
+   the strength of the smooth brush will be weaker than before and needs to be increased.
+
 Direction :kbd:`Ctrl`
 
    Smooth
@@ -38,7 +48,7 @@
 ******
 
 Deformation
-   Deformation type that is used in the brush.
+   There are two deformation types.
 
    Laplacian
       Smooths the surface and volumes. This is the default behavior.