[Bf-docboard-svn] bf-manual: [9005] branches/blender-3.1-release/blender_docs/manual/files/import_export/obj.rst: Update OBJ exporter docs for 3.1

[Aaron Carlisle]

Revision: 9005
          https://developer.blender.org/rBM9005
Author:   Blendify
Date:     2022-02-24 01:08:07 +0100 (Thu, 24 Feb 2022)
Log Message:
-----------
Update OBJ exporter docs for 3.1

rB4e44cfa3d9969f0f3e175b53f116f377278a3245

Modified Paths:
--------------
    branches/blender-3.1-release/blender_docs/manual/files/import_export/obj.rst

Modified: branches/blender-3.1-release/blender_docs/manual/files/import_export/obj.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/files/import_export/obj.rst	2022-02-23 23:50:23 UTC (rev 9004)
+++ branches/blender-3.1-release/blender_docs/manual/files/import_export/obj.rst	2022-02-24 00:08:07 UTC (rev 9005)
@@ -5,37 +5,23 @@
 
 .. reference::
 
-   :Category:  Import-Export
    :Menu:      :menuselection:`File --> Import/Export --> Wavefront (.obj)`
 
 OBJ is a widely used de facto standard in the 3D industry.
 The OBJ format is a popular plain text format, however, it has only basic geometry and material support.
 
-- Mesh: vertices, faces, edges, normals, UVs
-- Separation by groups/objects
-- Materials/textures
-- NURBS curves and surfaces
-
 .. note::
 
-   There is no support for mesh vertex colors, armatures, animation,
-   lights, cameras, empty objects, parenting, or transformations.
+   There is no support for armatures, lights, cameras, empty objects, parenting, or transformations.
+   See `Compatibility`_ for more information.
 
-.. note::
 
-   Blender now only supports complex node-based shading. OBJ having a fixed pipeline-like support of materials,
-   this add-on uses the :doc:`generic wrapper </addons/import_export/node_shaders_info>`
-   featured by Blender to convert between both.
-
-
 Usage
 =====
 
-Import/Export geometry and curves to the OBJ format.
+Export geometry and curves to the OBJ format.
 
-If there is a matching ``.MTL`` for the OBJ then its materials will be imported too.
 
-
 .. _bpy.ops.wm.obj_export:
 
 Exporting
@@ -51,7 +37,7 @@
    Exports a numbered OBJ for each frame from the start to the end frame.
    Please be aware that this can take quite a long time.
 Frame Start, End
-   Todo.
+   The first and last frame to export, used to determine the range of exported frames.
 
 
 Object Properties
@@ -69,10 +55,11 @@
 Selected Only
    Only export the selected objects. Otherwise export all objects in the scene.
 Properties
-   Todo.
+   For properties that have different settings for the viewport/final render pick which is used for output.
+   One example where this is important is the :doc:`/modeling/modifiers/generate/subdivision_surface`.
 
-   :Viewport (Default): todo.
-   :Render: todo.
+   :Viewport (Default): Use viewport properties.
+   :Render: Use final render properties.
 
 
 Geometry Export
@@ -106,11 +93,12 @@
 Material Groups
    Create OBJ groups per material.
 Vertex Groups
-   Todo.
+   Export the name of the vertex group of a face.
+   It is approximated by choosing the vertex group with the most members among the vertices of a face.
 Smooth Groups
    Write Blender's sharp edges as smooth groups.
 Bitflag Groups
-   Todo.
+   Generate Bitflags for smooth Groups.
 
 
 Importing
@@ -124,9 +112,3 @@
 =============
 
 NURBS surfaces, text3D and metaballs are converted to meshes at export time.
-
-Some of the following features are missing:
-
-- NURBS Surfaces -- this could be added but is not widely used.
-- Advanced Material Settings -- There are material options documented
-  but very few files use them and there are few examples available.