Jan 29, 2023 · Jan 26, 2023 · Jan 28, 2023 · Jan 26, 2023 · Jan 28, 2023
diff --git a/doc/source/dotnet.rst b/doc/source/dotnet.rst

 Before interacting with any of the objects or APIs provided by the
 ``Python.Runtime`` namespace, calling code must have acquired the Python
 global interpreter lock by calling the ``PythonEngine.AcquireLock``
 method. The only exception to this rule is the
 ``PythonEngine.Initialize`` method, which may be called at startup
 without having acquired the GIL.

 When finished using Python APIs, managed code must call a corresponding
 ``PythonEngine.ReleaseLock`` to release the GIL and allow other threads
 to use Python.

 A ``using`` statement may be used to acquire and release the GIL:
 global interpreter lock by ``using'' ``Py.GIL()``. The only exception to
 this rule is the ``PythonEngine.Initialize`` method, which may be called
 at startup without having acquired the GIL. The GIL is released again
 by disposing the return value of `Py.GIL()`:

 .. code:: csharp

   using (Py.GIL())
   {
       PythonEngine.Exec("doStuff()");
   }

   // or
   {
       using var _ = Py.GIL()
       PythonEngine.Exec("doStuff()");
   }

   // or
   var gil = Py.GIL();
   try
   {
       PythonEngine.Exec("doStuff()");
   }
   finally
   {
       gil.Dispose();
   }

 TheAcquireLock and ReleaseLock methods arethinwrappers over the
 unmanaged``PyGILState_Ensure`` and ``PyGILState_Release``functions
 from the Python API, and the documentation for those APIs applies to the
 managed versions.
 The``Py.GIL()'' object is athinwrapper over the unmanaged
 ``PyGILState_Ensure``(on construction)and ``PyGILState_Release``(on
 disposal) functionsfrom the Python API, and the documentation for those
 APIs applies to themanaged versions.

 Passing C# Objects to the Python Engine
 ---------------------------------------
Original file line number	Diff line number	Diff line change
Expand Up		@@ -42,28 +42,39 @@ application.

		Before interacting with any of the objects or APIs provided by the
		``Python.Runtime`` namespace, calling code must have acquired the Python
		global interpreter lock by calling the ``PythonEngine.AcquireLock``
		method. The only exception to this rule is the
		``PythonEngine.Initialize`` method, which may be called at startup
		without having acquired the GIL.

		When finished using Python APIs, managed code must call a corresponding
		``PythonEngine.ReleaseLock`` to release the GIL and allow other threads
		to use Python.
Comment on lines -50 to -52 Copy link Member lostmsuJan 26, 2023• edited Loading Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. IMHO, "when finished" section needs corresponding replacement (maybe merged with the acquisition part). Copy link MemberAuthor filmorJan 28, 2023 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Better? lostmsu reacted with thumbs up emoji

		A ``using`` statement may be used to acquire and release the GIL:
		global interpreter lock by ``using'' ``Py.GIL()``. The only exception to
		this rule is the ``PythonEngine.Initialize`` method, which may be called
		at startup without having acquired the GIL. The GIL is released again
		by disposing the return value of `Py.GIL()`:

		.. code:: csharp

		using (Py.GIL())
		{
		PythonEngine.Exec("doStuff()");
		}

		// or
		{
		using var _ = Py.GIL()
		PythonEngine.Exec("doStuff()");
		}

		// or
		var gil = Py.GIL();
		try
		{
		PythonEngine.Exec("doStuff()");
		}
		finally
		{
		gil.Dispose();
		}

		TheAcquireLock and ReleaseLock methods arethinwrappers over the
		unmanaged``PyGILState_Ensure`` and ``PyGILState_Release``functions
		from the Python API, and the documentation for those APIs applies to the
		managed versions.
		The``Py.GIL()'' object is athinwrapper over the unmanaged
		``PyGILState_Ensure``(on construction)and ``PyGILState_Release``(on
		disposal) functionsfrom the Python API, and the documentation for those
		APIs applies to themanaged versions.

		Passing C# Objects to the Python Engine
		---------------------------------------
Expand Down