From 5f8448ef6b85a9ff72c5af4cec99183c8bb60dc6 Mon Sep 17 00:00:00 2001 From: marha Date: Tue, 10 Apr 2012 14:58:33 +0200 Subject: Updated following packages: bigreqsproto-1.1.2 fontsproto-2.1.2 recordproto-1.14.2 scrnsaverproto-1.2.2 xcmiscproto-1.2.2 libXt-1.1.3 xhost-1.0.5 kbproto-1.0.6 libXrender-0.9.7 libxkbfile-1.0.8 freetype-2.4.9 libXaw-1.0.10 libXpm-3.5.10 xproto-7.0.23 --- libXaw/specs/AsciiSource.xml | 48 ++++++++++++++++++++++---------------------- 1 file changed, 24 insertions(+), 24 deletions(-) (limited to 'libXaw/specs/AsciiSource.xml') diff --git a/libXaw/specs/AsciiSource.xml b/libXaw/specs/AsciiSource.xml index bd51f990a..b3ca6da12 100644 --- a/libXaw/specs/AsciiSource.xml +++ b/libXaw/specs/AsciiSource.xml @@ -50,7 +50,7 @@ into an internal buffer. This buffer may then be modified, provided the text widget is in the correct edit mode, just as if it were a source of type XawAsciiString. Unlike R3 and earlier versions of the AsciiSrc, it is now possible to specify an editable disk source. The file is not -updated, however, until a call to XawAsciiSave is made. When the +updated, however, until a call to is made. When the source is in this mode the useStringInPlace resource is ignored. @@ -68,22 +68,22 @@ In the default case for AsciiSrc objects of type XawAsciiStringuseStringInPlace is false, and the widget owns the string. The initial value of the string resource, and any update made by the application -programmer to the string resource with XtSetValues, is copied +programmer to the string resource with , is copied into memory private to the widget, and managed internally by the widget. The application writer does not need to worry about running out of buffer space (subject to the total memory available to the application). The performance does not decay linearly as the buffer grows large, as is necessarily the case when the text buffer is used -in place. The application writer must use XtGetValues to +in place. The application writer must use to determine the contents of the text buffer, which will return a copy of the widget's text buffer as -it existed at the time of the XtGetValues call. This copy +it existed at the time of the call. This copy is not affected by subsequent updates to the text buffer, i.e., it is not updated as the user types input into the text buffer. This copy is freed upon the next call to XtGetValues to retrieve the string resource; however, to conserve memory, -there is a convenience routine, XawAsciiSourceFreeString, allowing the +there is a convenience routine, , allowing the application programmer to direct the widget to free the copy. @@ -94,12 +94,12 @@ is the string owner. The widget will take the value of the string resource as its own text buffer, and the length resource indicates the buffer size. In this case the buffer contents change as the user types at the widget; -it is not necessary to call XtGetValues on the string +it is not necessary to call on the string resource to determine the contents of the buffer-it will simply return the address of the application's implementation of the text buffer. - + Resources @@ -206,7 +206,7 @@ retrieved from the argument list or from the resource database: - + Convenience Routines @@ -220,11 +220,11 @@ commonly used functionality of the AsciiSrc. When the AsciiSrc widget is not in useStringInPlace mode space must be allocated whenever the file is saved, or the string is -requested with a call to XtGetValues. This memory is allocated on the +requested with a call to . This memory is allocated on the fly, and remains valid until the next time a string needs to be allocated. You may save memory by freeing this string as soon as you are done -with it by calling XawAsciiSourceFreeString. - +with it by calling . + void XawAsciiSourceFreeString Widget w @@ -247,8 +247,8 @@ Specifies the AsciiSrc object. This function will free the memory that contains the string pointer returned -by XtGetValues. This will normally happen automatically when -the next call to XtGetValues occurs, or when the widget is destroyed. +by . This will normally happen automatically when +the next call to occurs, or when the widget is destroyed. @@ -256,8 +256,8 @@ the next call to XtGetValues occurs, or when the widget is To save the changes made in the current text source into a file use -XawAsciiSave. - +. + Boolean XawAsciiSave Widget w @@ -279,7 +279,7 @@ Specifies the AsciiSrc object. -XawAsciiSave returns True if the save was successful. + returns True if the save was successful. It will update the file named in the string resource. If the buffer has not been changed, no action will be taken. This function only works on an AsciiSrc of type XawAsciiFile. @@ -288,8 +288,8 @@ only works on an AsciiSrc of type XawAsciiFile. To save the contents of the current text buffer into a named file use -XawAsciiSaveAsFile. - +. + Boolean XawAsciiSaveAsFile Widget w @@ -323,7 +323,7 @@ The name of the file to save the current buffer into. This function returns True if the save was successful. -XawAsciiSaveAsFile will work with a buffer of either type + will work with a buffer of either type XawAsciiString or type XawAsciiFile. @@ -332,10 +332,10 @@ This function returns True if the save was successful. To find out if the text buffer in an AsciiSrc object has changed -since the last time it was saved with XawAsciiSave or queried +since the last time it was saved with or queried -use XawAsciiSourceChanged. - +use . + Boolean XawAsciiSourceChanged Widget w @@ -359,8 +359,8 @@ Specifies the AsciiSrc object. This function will return True if the source has changed since the last time it was saved or queried. The internal change flag is -reset whenever the string is queried via XtGetValues or the -buffer is saved via XawAsciiSave. +reset whenever the string is queried via or the +buffer is saved via . -- cgit v1.2.3