Enlightenment CVS committal
Author : dj2
Project : e17
Module : docs
Dir : e17/docs/ewlbook/xml
Modified Files:
contributing.xml getting_started.xml intro.xml
widget_packing.xml widgets.xml
Log Message:
- gramattical fixes
===================================================================
RCS file: /cvsroot/enlightenment/e17/docs/ewlbook/xml/contributing.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -3 -r1.1 -r1.2
--- contributing.xml 9 Jul 2004 03:21:44 -0000 1.1
+++ contributing.xml 18 Jul 2004 20:45:02 -0000 1.2
@@ -17,7 +17,7 @@
<para>
If you wish to contribute to the EWL or another part of the EFL, take a look at the
<literal><ulink
url="http://www.enlightenment.org";>www.enlightenment.org</ulink></literal>
-website, all the information on accessing CVS and the mailing lists can be found
there.
+website. All the information on accessing CVS and the mailing lists can be found
there.
</para>
<para>Thank you.</para>
===================================================================
RCS file: /cvsroot/enlightenment/e17/docs/ewlbook/xml/getting_started.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -3 -r1.2 -r1.3
--- getting_started.xml 16 Jul 2004 04:11:17 -0000 1.2
+++ getting_started.xml 18 Jul 2004 20:45:02 -0000 1.3
@@ -104,8 +104,8 @@
}
</programlisting>
<para>
-The <function>destroy_cb</function> will be setup as the callback EWL will make
-when the window manager requests the application terminate. Callbacks will be
described
+The <function>destroy_cb</function> will be used by EWL when the window
+manager requests the application terminate. Callbacks will be described
further in the <link linkend="sec-Callbacks">Callbacks</link> section.
</para>
@@ -193,7 +193,7 @@
</para>
<para>
-Once the window is all set up and ready to go a simple call to
+Once the window is all set up and ready to go, a simple call to
<function>ewl_widget_show()</function> will have EWL display the window.
</para>
@@ -209,7 +209,7 @@
</para>
<para>
-Thats it. Although its probably one of the simplest EWL applications that can be
produced
+That's it. Although it's probably one of the simplest EWL applications that can be
produced,
it will be used as a basis for many of the other examples presented in this tutorial,
and
many EWL applications that are produced.
</para>
@@ -315,7 +315,7 @@
</para>
<para>
-This ones a bit longer then the simple creating of a window, but then it also includes
+This one's a bit longer than the simple creating of a window, but then it also
includes
more functionality. If you run this program you should see a simple window with a bit
of text saying 'Hello' at the top and a text area. Typing in the text area and hitting
'Enter' will display 'Hello' plus whatever you've typed.
@@ -355,9 +355,9 @@
<para>
The text that has been entered is retrieved with a call to
-<function>ewl_entry_get_text()</function> giving the text widget we want to retrieve
-from. This will return a pointer to the text string, it is the applications
responsibility
-to free this pointer.
+<function>ewl_entry_get_text()</function> passing the text widget from which
+we want to retrieve the text. This will return a pointer to the text string,
+it is the applications responsibility to free this pointer.
</para>
<para>
@@ -423,7 +423,7 @@
ewl_widget_show(label);
</programlisting>
<para>
-Now that we have our containing box setup we create the actual text element
+Now that we have our containing box set up, we create the actual text element
that is going to function as our label. The label is created with a
call to <function>ewl_text_new()</function> specifying the text
we wish to display. Once the widget is created we attach it to the box
@@ -445,8 +445,8 @@
</itemizedlist>
<para>
-Once all the widget properties are specified we attach some text formatting
-properties to the widget. The first, <function>ewl_text_style_set()</function>
+Once all the widget properties are specified, we attach some text formatting
+properties to the widget. The first, <function>ewl_text_style_set()</function>,
sets the style of the text object. The styles change the appearance of the text
by applying some kind of filter, in this case, creating a 'soft shadow' appearance
to the widget. We then set the colour of the text to red by calling
@@ -488,14 +488,14 @@
<para>
A callback is a function that will be called when a specific event happens. These
events
-can be anything from the user clicking a button, or the window being destroyed by the
+can be anything from the user clicking a button to the window being destroyed by the
window manager.
</para>
<para>
-For all the events that an application wishes to know about, a callback is registered
+For the events that an application needs notification a callback is registered
through EWL. This is done with the <function>ewl_callback_append()</function>. This
-function takes four parameters, the object to attach the callback too, the callback
+function takes four parameters: the object to attach the callback too, the callback
desired, the callback function and any user data.
</para>
@@ -604,7 +604,7 @@
<para>
The callback function has a signature like
-<literal>void fcn(Ewl_Widget *, void *, void *)</literal> the first parameter is the
+<literal>void fcn(Ewl_Widget *, void *, void *)</literal>. The first parameter is the
widget that activated this callback. The second parameter is the event data and the
third parameter is the user attached data.
</para>
===================================================================
RCS file: /cvsroot/enlightenment/e17/docs/ewlbook/xml/intro.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -3 -r1.1 -r1.2
--- intro.xml 9 Jul 2004 03:21:44 -0000 1.1
+++ intro.xml 18 Jul 2004 20:45:02 -0000 1.2
@@ -14,7 +14,7 @@
</itemizedlist>
<para>
-EWL works in a similar fashion to other widget libraries, being
+EWL works in a similar fashion to other widget libraries, as it is
based on a callback system. As elements are created and added to the
interface, any desired event callbacks are registered, these functions
will be triggered when the specified event happens.
===================================================================
RCS file: /cvsroot/enlightenment/e17/docs/ewlbook/xml/widget_packing.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -3 -r1.2 -r1.3
--- widget_packing.xml 16 Jul 2004 04:11:17 -0000 1.2
+++ widget_packing.xml 18 Jul 2004 20:45:02 -0000 1.3
@@ -2,7 +2,7 @@
<title>Widget Packing</title>
<para>
-As your writting an EWL application you will need to start laying out the
+As you're writing an EWL application you will need to start laying out the
widgets into the different boxes. To do so, you'll need a bit of information
on how EWL packs widgets together.
</para>
===================================================================
RCS file: /cvsroot/enlightenment/e17/docs/ewlbook/xml/widgets.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -3 -r1.5 -r1.6
--- widgets.xml 18 Jul 2004 20:25:52 -0000 1.5
+++ widgets.xml 18 Jul 2004 20:45:02 -0000 1.6
@@ -14,7 +14,7 @@
The box widgets allow you to specify different ways in which the
application will be laid out. You can create either a horizontal (hbox)
or vertical (vbox) box. A vertical box will have its children packed
-from top to bottom, while a horizontal box will have its widgets
+from top to bottom while a horizontal box will have its widgets
packed from left to right.
</para>
@@ -222,7 +222,7 @@
ewl_widget_show(o);
</programlisting>
</example>
-This example will create an <literal>Ewl_Dialog</literal> with two buttons
+This example will create an <literal>Ewl_Dialog</literal> with two buttons:
an OK button and a Cancel button. The dialog itself is created with the
call to <function>ewl_dialog_new()</function> passing the position of the
buttons relative to the window itself. The possible values are:
@@ -414,9 +414,9 @@
<para>
It is also possible to pack other widgets into the filedialog itself. This is done
through
-the normal <function>ewl_container_append_child()</function>. So, if you wanted for
example,
-to add a 'Home' button, you could create the button and pack it into the file dialog
where
-it will appear down the left side.
+the normal <function>ewl_container_append_child()</function>. So, if you
+needed, for example, to add a 'Home' button, you could create the button and pack it
+into the file dialog where it will appear down the left side.
</para>
<para>
@@ -622,9 +622,9 @@
<para>
The colour of the text can be manipulated with the
-<function>ewl_text_color_set(Ewl_Text *, int r, int g, int b, int a</function>
+<function>ewl_text_color_set(Ewl_Text *, int r, int g, int b, int a)</function>
call while the current colour information can be retrieved with the
-<function>ewl_text_color_get(Ewl_Text *, int *r, int *g, int *b, int *a</function>.
+<function>ewl_text_color_get(Ewl_Text *, int *r, int *g, int *b, int *a)</function>.
</para>
<para>
@@ -637,7 +637,7 @@
<para>
To retrieve or set the alignment of the text widget there are the two
-functions <function>ewl_text_align_set(Ewl_Text *, unsigned int align)</function>
+functions: <function>ewl_text_align_set(Ewl_Text *, unsigned int align)</function>
and <function>unsigned int ewl_text_align_get(Ewl_Text *)</function>. Where
the align parameter is one of the EWL alignment flags:
<itemizedlist mark="bullet" spacing="compact">
@@ -727,8 +727,8 @@
ewl_widget_show(m);
</programlisting>
</example>
-Creating the basic video object is no simpler then creating the object and
-showning it (assuming you've appending it to whatever container it is being
+Creating the basic video object is no harder then creating the object and
+showning it (assuming you've appended it to whatever container it is being
placed into). We hook the two callbacks
<literal>EWL_CALLBACK_REALIZE</literal> and
<literal>EWL_CALLBACK_VALUE_CHANGED</literal>. We hook in the realize
@@ -851,7 +851,7 @@
<para>
The main callback used by a Ewl_Window is the
<literal>EWL_CALLBACK_DELETE_WINDOW</literal>.
-This will be called when, for whatever reason, the window is being destroyed by the
+This will be called when the window is being destroyed by the
window manager. It should be used to cleanup any resources that the application has
used before exiting the application.
</para>
@@ -883,9 +883,9 @@
The first three calls are pretty self explanatory. The
<function>ewl_window_set_borderless()</function>
can be used to tell the window manager not to display any decoration around the
window, this includes
the border and the title bar. The function <function>ewl_window_move()</function> is
used to
-position the window to a specific place on the desktop, indexed from the top left
corner. The opposite
-to this is <function>ewl_window_get_position()</function> which will return the
position of the
-window on the desktop.
+position the window to a specific place on the desktop, indexed from the top
+left corner. There is also a <function>ewl_window_get_position()</function> which
will return the position
+of the window on the desktop.
</para>
</sect1>
-------------------------------------------------------
This SF.Net email is sponsored by BEA Weblogic Workshop
FREE Java Enterprise J2EE developer tools!
Get your free copy of BEA WebLogic Workshop 8.1 today.
http://ads.osdn.com/?ad_id=4721&alloc_id=10040&op=click
_______________________________________________
enlightenment-cvs mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/enlightenment-cvs
