manual/modeling/meshes/editing/mesh/extrude.rst

@@ -62,6 +62,14 @@ Available when a :term:`Vertex` is selected.
 See :ref:`bpy.ops.mesh.extrude_vertices_move`.
 
 
+Extrude Boolean
+===============
+
+Available in any selection mode.
+
+See :doc:`/modeling/meshes/tools/extrude_boolean`.
+
+
 .. _bpy.ops.mesh.extrude_repeat:
 
 Extrude Repeat

manual/modeling/meshes/tools/extrude_boolean.rst

@@ -0,0 +1,54 @@
+.. _bpy.ops.view3d.edit_mesh_extrude_boolean_move_normal:
+
+****************
+Extrude Boolean
+****************
+
+.. reference::
+
+   :Mode:      Edit Mode
+   :Tool:      :menuselection:`Toolbar --> Extrude Boolean`
+   :Menu:      :menuselection:`Mesh --> Extrude --> Extrude Boolean`
+
+This tool is similar to :doc:`/modeling/meshes/editing/face/extrude_faces`
+but before generating the geometry, it displays a preview mesh that will perform boolean
+operations on the original mesh once confirmed.
+
+
+Properties
+----------
+
+Overlap Threshold
+   Threshold for checking overlapping geometry.
+Invert
+   Removes outside faces instead of inside faces.
+Remove coplanar faces
+   Determines what to do with overlapping faces.
+
+
+Example
+-------
+
+Geometry subtraction:
+
+.. figure:: /images/modeling_meshes_tools-extrude_boolean-subtract.gif
+
+   Extrude Boolean - Geometry subtraction example.
+
+Geometry union:
+
+.. figure:: /images/modeling_meshes_tools-extrude_boolean-union.gif
+
+   Extrude Boolean - Geometry union example.
+
+Open geometry intersection:
+
+.. figure:: /images/modeling_meshes_tools-extrude_boolean-intersection_open.gif
+
+   Extrude Boolean - Open geometry intersection example
+
+Wire edge intersection:
+
+.. figure:: /images/modeling_meshes_tools-extrude_boolean-intersection_wires.gif
+
+   Extrude Boolean - Wire edge intersection example.

manual/modeling/meshes/tools/index.rst

@@ -18,6 +18,7 @@ Types
 
    extrude_region.rst
    extrude_manifold.rst
+   extrude_boolean.rst
    extrude_cursor.rst
    loop.rst
    poly_build.rst