Revision: 41325
http://projects.blender.org/scm/viewvc.php?view=rev&root=bf-blender&revision=41325
Author: campbellbarton
Date: 2011-10-28 01:10:46 +0000 (Fri, 28 Oct 2011)
Log Message:
-----------
patch [#29049] Minor phrasing and grammar patch
Modified Paths:
--------------
trunk/blender/doc/python_api/rst/info_quickstart.rst
trunk/blender/doc/python_api/rst/info_tips_and_tricks.rst
trunk/blender/doc/python_api/sphinx_doc_gen.py
Modified: trunk/blender/doc/python_api/rst/info_quickstart.rst
===================================================================
--- trunk/blender/doc/python_api/rst/info_quickstart.rst 2011-10-28
00:37:42 UTC (rev 41324)
+++ trunk/blender/doc/python_api/rst/info_quickstart.rst 2011-10-28
01:10:46 UTC (rev 41325)
@@ -67,7 +67,7 @@
Accessing datablocks
^^^^^^^^^^^^^^^^^^^^
-Python accesses Blender's data in the same way as the animation system and
user interface, which means any setting that is changed via a button can also
be changed from Python.
+Python accesses Blender's data in the same way as the animation system and
user interface; this implies that any setting that can be changed via a button
can also be changed from Python.
Accessing data from the currently loaded blend file is done with the module
:mod:`bpy.data`. This gives access to library data. For example:
@@ -101,7 +101,7 @@
Accessing attributes
^^^^^^^^^^^^^^^^^^^^
-Once you have a data block such as a material, object, groups etc. its
attributes can be accessed just like changing a setting in the interface; in
fact, the button tooltip also displays the Python attribute which can help in
finding what settings to change in a script.
+Once you have a data block, such as a material, object, groups etc., its
attributes can be accessed much like you would change a setting using the
graphical interface. In fact, the tooltip for each button also displays the
Python attribute which can help in finding what settings to change in a script.
>>> bpy.data.objects[0].name
'Camera'
@@ -179,7 +179,7 @@
But ``bpy.context.scene.objects.active = obj`` will work as expected.
-The context attributes change depending on where it is accessed. The 3D view
has different context members to the Console, so take care when accessing
context attributes that the user state is known.
+The context attributes change depending on where they are accessed. The 3D
view has different context members than the console, so take care when
accessing context attributes that the user state is known.
See :mod:`bpy.context` API reference
@@ -256,6 +256,8 @@
#. Press Ctrl+Right twice to change to the Scripting layout.
+#. Click the button labeled ``New`` and the confirmation pop up in order to
create a new text block.
+
#. Press Ctrl+V to paste the code into the text panel (the upper left frame).
#. Click on the button **Run Script**.
@@ -269,6 +271,7 @@
.. seealso:: The class members with the **bl_** prefix are documented in the
API
reference :class:`bpy.types.Operator`
+.. note:: The output from the ``main`` function is sent to the terminal; in
order to see this, be sure to :ref:`use the terminal <use_the_terminal>`.
Example Panel
-------------
@@ -285,6 +288,8 @@
#. Press Ctrl+Right twice to change to the Scripting layout
+#. Click the button labeled ``New`` and the confirmation pop up in order to
create a new text block.
+
#. Press Ctrl+V to paste the code into the text panel (the upper left frame)
#. Click on the button **Run Script**.
@@ -310,7 +315,7 @@
Blender defines a number of Python types but also uses Python native types.
-Blender's Python API can be split up into 3 categories.
+Blender's Python API can be split up into 3 categories.
Native Types
Modified: trunk/blender/doc/python_api/rst/info_tips_and_tricks.rst
===================================================================
--- trunk/blender/doc/python_api/rst/info_tips_and_tricks.rst 2011-10-28
00:37:42 UTC (rev 41324)
+++ trunk/blender/doc/python_api/rst/info_tips_and_tricks.rst 2011-10-28
01:10:46 UTC (rev 41325)
@@ -7,6 +7,8 @@
Some of these are just python features that scripters may not have thought to
use with blender, others are blender specific.
+.. _use_the_terminal:
+
Use The Terminal
================
Modified: trunk/blender/doc/python_api/sphinx_doc_gen.py
===================================================================
--- trunk/blender/doc/python_api/sphinx_doc_gen.py 2011-10-28 00:37:42 UTC
(rev 41324)
+++ trunk/blender/doc/python_api/sphinx_doc_gen.py 2011-10-28 01:10:46 UTC
(rev 41325)
@@ -102,7 +102,7 @@
# extra info, not api reference docs
# stored in ./rst/info/
INFO_DOCS = (
- ("info_quickstart.rst", "Blender/Python Quickstart: new to
blender/scripting and want to get you're feet wet?"),
+ ("info_quickstart.rst", "Blender/Python Quickstart: new to
blender/scripting and want to get your feet wet?"),
("info_overview.rst", "Blender/Python API Overview: a more complete
explanation of python integration"),
("info_best_practice.rst", "Best Practice: Conventions to follow for
writing good scripts"),
("info_tips_and_tricks.rst", "Tips and Tricks: Hints to help you while
writeing scripts for blender"),
_______________________________________________
Bf-blender-cvs mailing list
[email protected]
http://lists.blender.org/mailman/listinfo/bf-blender-cvs
