Index: cmdtext.h
===================================================================
--- cmdtext.h	(revision 23621)
+++ cmdtext.h	(working copy)
@@ -96,10 +96,12 @@
 PyDoc_STRVAR(scribus_getframetext__doc__,
 QT_TR_NOOP("getText([\"name\"]) -> string\n\
 \n\
-Returns the text of the text frame \"name\". If this text frame has some text\n\
-selected, the selected text is returned. All text in the frame, not just\n\
-currently visible text, is returned. If \"name\" is not given the currently\n\
-selected item is used.\n\
+Returns the visible text of the text frame \"name\". If this text frame has\n\
+some text selected, the selected text is returned.\n\
+\n\
+If \"name\" is not given the currently selected item is used.\n\
+\n\
+If you need all the text, not just the visible part, try getAllText() instead.\n\
 "));
 /*! Get frame text */
 PyObject *scribus_getframetext(PyObject * /*self*/, PyObject* args);
@@ -109,9 +111,11 @@
 QT_TR_NOOP("getAllText([\"name\"]) -> string\n\
 \n\
 Returns the text of the text frame \"name\" and of all text frames which are\n\
-linked with this frame. If this textframe has some text selected, the selected\n\
-text is returned. If \"name\" is not given the currently selected item is\n\
-used.\n\
+linked with this frame. All text in the frame, not just currently visible text,\n\
+is returned. If this textframe has some text selected, the selected text is\n\
+returned.\n\
+\n\
+If \"name\" is not given the currently selected item is used.\n\
 "));
 /*! Get all text */
 PyObject *scribus_gettext(PyObject * /*self*/, PyObject* args);
@@ -189,6 +193,9 @@
 not given the currently selected Item is used.\n\
 \n\
 May throw IndexError for an insertion out of bounds.\n\
+\n\
+After invoking this function, calling layoutText() may be necessary before\n\
+further calls to getText().
 "));
 /*! Insert text */
 PyObject *scribus_inserttext(PyObject * /*self*/, PyObject* args);
