[Bf-docboard-svn] bf-manual: [7475] trunk/blender_docs/manual: Clarify Knife Project in Manual

[Aaron Carlisle]

Revision: 7475
          https://developer.blender.org/rBM7475
Author:   Blendify
Date:     2020-12-10 21:31:41 +0100 (Thu, 10 Dec 2020)
Log Message:
-----------
Clarify Knife Project in Manual

Clarify knife project tool's  cutting object requirements.

Inspired by comment to another users answer suggesting it should be in the documentation.
in [[ https://blender.stackexchange.com/questions/16031/knife-project-not-working | Blender.stackexchange entry ]].

Author: @jjones780

Differential Revision: https://developer.blender.org/D9794

Modified Paths:
--------------
    trunk/blender_docs/manual/glossary/index.rst
    trunk/blender_docs/manual/modeling/meshes/editing/mesh/knife_project.rst

Modified: trunk/blender_docs/manual/glossary/index.rst
===================================================================
--- trunk/blender_docs/manual/glossary/index.rst	2020-12-10 01:26:00 UTC (rev 7474)
+++ trunk/blender_docs/manual/glossary/index.rst	2020-12-10 20:31:41 UTC (rev 7475)
@@ -101,6 +101,12 @@
 
       See also :doc:`Boolean Modifier </modeling/modifiers/generate/booleans>`.
 
+   Boundary
+   Boundary Edge
+      An edge with nothing connected on one side.
+      The primitives, being manifold objects, do not have boundary edges.
+      See also :term:`Non-manifold`
+
    Bounding Box
       The box that encloses the shape of an object. The box is aligned with the local space of the object.
 

Modified: trunk/blender_docs/manual/modeling/meshes/editing/mesh/knife_project.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/editing/mesh/knife_project.rst	2020-12-10 01:26:00 UTC (rev 7474)
+++ trunk/blender_docs/manual/modeling/meshes/editing/mesh/knife_project.rst	2020-12-10 20:31:41 UTC (rev 7475)
@@ -16,11 +16,20 @@
 This works by using the outlines of other selected objects in Edit Mode to cut into the mesh
 along the view axis, resulting geometry inside the cutters outline will be selected.
 
-Outlines can be wire or boundary edges.
+Outlines can be a wireframe or :term:`Boundary Edges<Boundary Edge>` i.e. the unconnected edges of a mesh.
 
+.. note::
+
+    The primitives, being manifold objects, do not have wireframe or boundary edges.
+    In the case of the cube, deleting the top face will result in cutting edges.
+
+    :ref:`Select Non-Manifold <bpy.ops.mesh.select_non_manifold>`
+    (Wire, Boundaries) will highlight the cutting edges of mesh objects.
+
 To use Knife Project, first while in *Object Mode*, select the "cutting object"
 then add to that selection with :kbd:`Shift-LMB` the "object to be cut".
-Now, enter *Edit Mode* and press *Knife Project* (found in the Toolbar).
+Now, enter *Edit Mode* and choose :menuselection:`Mesh --> Knife Project`
+(found in the :ref:`header<ui-region-header>`).
 
 .. seealso::
 
@@ -27,6 +36,13 @@
    :doc:`3D Viewport Alignment </editors/3dview/navigate/align>` to adjust the projection axis.
 
 
+Options
+=======
+
+Cut Through
+   Projects the cut through the entire mesh.
+
+
 Examples
 ========