From: havill Date: Fri, 3 Jan 2003 19:15:15 +0000 (+0000) Subject: fixed grammar in tutorial.sgml X-Git-Tag: r0-51-3~7 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2c136f08664a641d6ee63c8aebd41b960194a5a8;p=thirdparty%2Fnewt.git fixed grammar in tutorial.sgml --- diff --git a/tutorial.sgml b/tutorial.sgml index 3b46998..91e58b7 100644 --- a/tutorial.sgml +++ b/tutorial.sgml @@ -44,7 +44,7 @@ which were removed while this tutorial was written. The latest version of Red Hat Linux. As this install code runs in an environment with limited resources (most importantly limited filesystem space), newt's size was immediately an issue. To help minimize its size, the following design -decisions were made early in it's implementation: +decisions were made early in its implementation: @@ -241,10 +241,10 @@ int newtFinished(void); -newtFinished() restores the terminal to it's appearance when +newtFinished() restores the terminal to its appearance when newtInit() was called (if possible -- on some terminals the cursor will be moved to the bottom, but it won't be possible to remember the original -terminal contents) and places the terminal in it's original input state. +terminal contents) and places the terminal in its original input state. If this function isn't called, the terminal will probably need to be reset with the reset command before it can be used easily. @@ -362,7 +362,7 @@ void newtResume(void); -newtSuspend() tells newt to return the terminal to it's initial +newtSuspend() tells newt to return the terminal to its initial state. Once this is done, the application can suspend itself (by sending itself a SIGTSTP, fork a child program, or do whatever else it likes. When it wants to resume using the newt interface, @@ -468,7 +468,7 @@ int main(void) { While most newt applications do use windows, newt's window support is actually extremely limited. Windows must be destroyed in the -opposite order they were created, and only the topmost window may be +opposite of the order they were created, and only the topmost window may be active. Corollaries to this are: @@ -494,8 +494,8 @@ unsuitable for some tasks. Creating Windows -There are two main ways of opening newt windows; with or without -explicit sizings. When grids (which will be introduced later is this +There are two main ways of opening newt windows: with or without +explicit sizings. When grids (which will be introduced later in this tutorial) are used, a window may be made to just fit the grid. When grids are not used, explicit sizing must be given. @@ -552,7 +552,7 @@ and continue appropriately. All newt components are stored in a common data type, a newtComponent (some of the particulars of newtComponents have already been mentioned. While this makes it easy for programmers to pass -components around, it does force them to make sure they use they don't pass +components around, it does force them to make sure they don't pass entry boxes to routines expecting push buttons, as the compiler can't ensure that for them. @@ -627,7 +627,7 @@ completely. Notice that this function doesn't fit in with newt's normal naming convention. It is an older interface which will not work for all forms. It was left in newt only for legacy applications. It is a -simpler interface then the new newtFormRun() though, and is still used +simpler interface than the new newtFormRun() though, and is still used quite often as a result. When an application is done with a form, it destroys the form and @@ -822,11 +822,11 @@ box. This can provide a nice shortcut for users. -After an entry box has been created, it's contents can be set by +After an entry box has been created, its contents can be set by newtEntrySet(). After the entry box itself, the new string to place in the entry box is passed. The final parameter, cursorAtEnd, controls where the cursor will appear in the entry box. If it is zero, the cursor -remains at it's present location; a nonzero value moves the cursor to the +remains at its present location; a nonzero value moves the cursor to the end of the entry box's new value. While the simplest way to find the value of an entry box is by using a @@ -834,7 +834,7 @@ While the simplest way to find the value of an entry box is by using a newtEntryGetValue() returns a pointer to the string which the entry box currently contains. The returned pointer may not be valid once the user further modifies the entry box, and will not be valid after the -entry box has been destroyed, so be sure to save it's value in a more +entry box has been destroyed, so be sure to save its value in a more permanent location if necessary. Entry boxes allow applications to filter characters as they are entered. @@ -953,7 +953,7 @@ the text which is displayed to the right of the area which is checked. The sequence which the checkbox should go through (defValue must be in seq. seq may be NULL, in which case " *" is used. The final parameter, result, should point to a character which the -checkbox should always record it's current value in. If result is +checkbox should always record its current value in. If result is NULL, newtCheckboxGetValue() must be used to get the current value of the checkbox. @@ -1328,7 +1328,7 @@ For lists which only allow a single selection, newtListboxGe should be used to find out which listbox item is currently selected. It returns the key of the currently selected item. -Normally, a listbox is as wide as it's widest element, plus space for a +Normally, a listbox is as wide as its widest element, plus space for a scrollbar if the listbox is supposed to have one. To make the listbox any larger then that, use newtListboxSetWidth(), which overrides the natural list of the listbox. Once the width has been set, it's fixed. The