Package: yabasic Version: 2.761-1 Severity: minor Tags: patch
Found some typos in '/usr/share/man/man1/yabasic.1.gz', see attached '.diff'. Hope this helps... -- System Information: Debian Release: testing/unstable APT prefers unstable APT policy: (500, 'unstable') Architecture: i386 (i686) Shell: /bin/sh linked to /bin/bash Kernel: Linux 2.6.12-1-686 Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968) (ignored: LC_ALL set to C) Versions of packages yabasic depends on: ii libc6 2.3.5-4 GNU C Library: Shared libraries an ii libice6 6.8.2.dfsg.1-5 Inter-Client Exchange library ii libncurses5 5.4-9 Shared libraries for terminal hand ii libsm6 6.8.2.dfsg.1-5 X Window System Session Management ii libx11-6 6.8.2.dfsg.1-5 X Window System protocol client li ii xlibs 6.8.2.dfsg.1-5 X Window System client libraries m yabasic recommends no packages. -- no debconf information
--- - 2005-08-27 14:16:12.663371000 -0400 +++ /tmp/yabasic1.gz.12042 2005-08-27 14:16:12.000000000 -0400 @@ -6,7 +6,7 @@ .SH DESCRIPTION Yabasic is a simple, old fashioned basic interpreter with some additional features like subroutines and libraries. -Grafics and printing are limited but very easy to use. +Graphics and printing are limited but very easy to use. Yabasic is documented within the file yabasic.htm, which may or may not be present on your system; in any case this @@ -209,7 +209,7 @@ options to the appropriate entries in the registry. All the options below may be abbreviated, as long as the abbreviation does - not become ambigous. For example, you may write -e instead of -execute. + not become ambiguous. For example, you may write -e instead of -execute. -help or -? Prints a short help message, which itself describes two further @@ -326,7 +326,7 @@ yabasic accepts a number of options on the commandline. All these options below may be abbreviated, as long as the abbreviation does not become - ambigous. For example you may write -e instead of -execute. + ambiguous. For example you may write -e instead of -execute. -help or -? Prints a short help message, which itself describes two further @@ -471,7 +471,7 @@ Note however, that there can only be a single window open at any given moment in time. - Evyerything you have drawn can be send to your printer too, if you use the + Everything you have drawn can be sent to your printer too, if you use the open printer command. To allow for some (very) limited version of animated graphics, yabasic @@ -485,7 +485,7 @@ Before you may read or write a file, you need to open it; once you are done, you should close it. Each open file is designated by a simple number, which might be stored within a variable and must be supplied if you want to access - the file. This is simply done by putting a hash ('#') followd by the number + the file. This is simply done by putting a hash ('#') followed by the number of the file after the keyword input (for reading from) or print (for writing to a file) respectively. @@ -572,7 +572,7 @@ returns the arcus sine of its numeric argument atan() - returns the arcus tangens of its numeric argument + returns the arctangent of its numeric argument bin$() converts a number into a sequence of binary digits @@ -632,7 +632,7 @@ compute the square root of its argument tan() - return the tangens of its argument + return the tangent of its argument xor() compute the exclusive or @@ -1020,16 +1020,16 @@ specify the colour for subsequent drawing of the background box - draw a rectancle. A synonym for rectangle + draw a rectangle. A synonym for rectangle circle draws a circle in the graphic-window clear - Erase circles, rectangles or triangless + Erase circles, rectangles or triangles clear window - clear the graphic window and begin a new page, if prining is under + clear the graphic window and begin a new page, if printing is under way close curve @@ -1134,7 +1134,7 @@ at() - can be used in the print-command to place the output at a specified position - atan() - returns the arcus tangens of its numeric argument + atan() - returns the arctangent of its numeric argument abs() @@ -1208,7 +1208,7 @@ Returns true, if and only if its left and right argument are both true and false otherwise. - Note, that logical shortcutsmay take place. + Note, that logical shortcuts may take place. Example @@ -1248,7 +1248,7 @@ This will print 2. This result is clear, if you note, that the binary representation of 6 and 3 are 110 and 011 respectively; this will yield 010 - in binary representaion or 2 as decimal. + in binary representation or 2 as decimal. See also @@ -1272,7 +1272,7 @@ return 2, and so on. This is mostly used within subroutines, which expect an array among their - parameters. Such subroutines tend to use the arraydim-funtion to check, if + parameters. Such subroutines tend to use the arraydim-function to check, if the array which has been passed, has the right dimension. E.g. a subroutine to multiply two matrices may want to check, if it really is invoked with two 2-dimensional arrays. @@ -1319,7 +1319,7 @@ Our sample array is two dimensional; if you envision it as a matrix this matrix has 10 lines and 20 columns (see the dim-statement above. To state it more formally: The first dimension (lines) has a size of 10, the second - dimension (columns) has a size of 20; these mumbers are those returned by + dimension (columns) has a size of 20; these numbers are those returned by arraysize(a(),1) and arraysize(a(),2) respectively. Refer to the example below for a typical usage. @@ -1493,7 +1493,7 @@ Name - atan() - returns the arcus tangens of its numeric argument + atan() - returns the arctangent of its numeric argument Synopsis @@ -1502,13 +1502,13 @@ Description - The atan is the arcus-tangens-function, i.e. the inverse of the - tan-function. Or, more elaborate: It Returns the angle (in radian, not - degree !), which, fed to the tan-function will produce the argument passed + The atan is the arctangent function, i.e. the inverse of the + tan-function. Or, more elaborately: it returns the angle (in radians, not + degrees!), which, fed to the tan-function will produce the argument passed to the atan-function. The atan-function has a second form, which accepts two arguments: atan(a,b) - which is (mostly) equivilantly to atan(a/b) except for the fact, that the + which is (mostly) equivalently to atan(a/b) except for the fact, that the two-argument-form returns an angle in the range -pi to pi, whereas the one-argument-form returns an angle in the range -pi/2 to pi/2. To understand this you have to be good at math. @@ -1537,7 +1537,7 @@ bind() - Binds a yabasic-program and the yabasic-interpreter together into a standalone program. - box - draw a rectancle. A synonym for rectangle + box - draw a rectangle. A synonym for rectangle break - breaks out of a switch statement or a loop backcolor @@ -1559,7 +1559,7 @@ As with the color-command, the new background color can either be specified as a triple of three numbers or as a single string, that contains those - three numbers sperated by commas. + three numbers separated by commas. Example @@ -1571,7 +1571,7 @@ next y:next x - This changes the background colour of the graphic window repeatidly and + This changes the background colour of the graphic window repeatedly and clears it every time, so that it is filled with the new background colour. See also @@ -1657,7 +1657,7 @@ The bin$-function takes a single numeric argument an converts it into a string of binary digits (i.e. zeroes and ones). If you pass a negative - number to bin$, the resulting string will be preceeded by a '-'. + number to bin$, the resulting string will be preceded by a '-'. If you want to convert the other way around (i.e. from binary to decimal) you may use the dec-function. @@ -1718,7 +1718,7 @@ Name - box - draw a rectancle. A synonym for rectangle + box - draw a rectangle. A synonym for rectangle Synopsis @@ -1787,7 +1787,7 @@ circle - draws a circle in the graphic-window clear - Erase circles, rectangles or triangles clear screen - erases the text window - clear window - clear the graphic window and begin a new page, if prining is + clear window - clear the graphic window and begin a new page, if printing is under way close - close a file, which has been opened before @@ -1900,7 +1900,7 @@ * The graphic-window must have been opened already. * The circle may well extend over the boundaries of the window. * If you have issued open printer before, the circle will finally appear - in the printed hardcopy of the window. + in the printed hard copy of the window. * fill circle will draw a filled (with black ink) circle. * clear circle will erase (or clear) the outline of the circle. * clear fill circle or fill clear circle will erase the full area of the @@ -1945,7 +1945,7 @@ May be used within the circle, rectangle or triangle command and causes these shapes to be erased (i.e. be drawn in the colour of the background). - fill can be used in conjunction with and whereever the fill-clause may + fill can be used in conjunction with and wherever the fill-clause may appear. Used alone, clear will erase the outline (not the interior) of the shape (circle, rectangle or triangle); together with fill the whole shape (including its interior) is erased. @@ -1980,7 +1980,7 @@ It must be issued at least once, before some advanced screen-commands (e.g. print at or inkey$) may be called; this requirement is due to some - limititations of the curses-library, which is used by yabasic under Unix for + limitations of the curses-library, which is used by yabasic under Unix for some commands. Example @@ -2003,7 +2003,7 @@ Name - clear window - clear the graphic window and begin a new page, if prining is + clear window - clear the graphic window and begin a new page, if printing is under way Synopsis @@ -2012,7 +2012,7 @@ Description - clear window clears the graphic window. If you have started prining the + clear window clears the graphic window. If you have started printing the graphic via open printer, the clear window-command starts a new page as well. @@ -2190,7 +2190,7 @@ Alternatively you may specify the color with a single string (as in the second line of the synopsis above); this string should contain three - numbers, seperated by commas. As an example "255,0,255" would be violet. + numbers, separated by commas. As an example "255,0,255" would be violet. Using this variant of the colour-command, you may use symbolic names for colours: open window 100,100 @@ -2351,7 +2351,7 @@ Description - The data-keyword introduces a list of comma-seperated list of strings or + The data-keyword introduces a list of comma-separated list of strings or numbers, which may be retrieved with the read-command. The data-command itself does nothing; it just stores data. A single @@ -2395,13 +2395,13 @@ Description - The date$-function (which must be called without parantheses; i.e. date$() + The date$-function (which must be called without parentheses; i.e. date$() would be an error) returns a string containing various components of a date; an example would be 4-05-27-2004-Thu-May. This string consists of various - fields seperated by hyphens ("-"): - * The day within the week as a number in the range 0 (=sunday) to 6 - (=saturday) (in the example above: 4, i.e. thursday). - * The month as a number in the range 1 (=january) to 12 (=december) (in + fields separated by hyphens ("-"): + * The day within the week as a number in the range 0 (=Sunday) to 6 + (=Saturday) (in the example above: 4, i.e. Thursday). + * The month as a number in the range 1 (=January) to 12 (=December) (in the example: 5 which stands for may). * The day within the month as a number in the range 1 to 31 (in the example: 27). @@ -2411,7 +2411,7 @@ * The abbreviated name of the month (Jan to Dec). Therefore the whole example above (4-05-27-2004-Thu-May) would read: day 4 - in the week (counting from 0), May 27 in the year 2004, which is a thursday + in the week (counting from 0), May 27 in the year 2004, which is a Thursday in May. Note, that all fields within the string returned by date$ have a fixed with @@ -2487,7 +2487,7 @@ The default-clause is an optional part of the switch-statement (see there for more information). It introduces a series of statements, that should be - executed, if none of the casese matches, that have been specified before + executed, if none of the cases matches, that have been specified before (each with its own case-clause). So default specifies a default to be executed, if none of the explicitly @@ -2571,7 +2571,7 @@ end sub - This example creates a 2-dimenional array (i.e. a matrix) with the + This example creates a 2-dimensional array (i.e. a matrix) with the dim-statement and fills it with random numbers. The second dim-statement enlarges the array, all new elements are filled with 0. @@ -2887,7 +2887,7 @@ Note, that end may not end your program immediately; if you have opened a window or called clear screen, yabasic assumes, that your user wants to - study the output of your program after it has ended; therfore it issues the + study the output of your program after it has ended; therefore it issues the line ---Program done, press RETURN--- and waits for a key to be pressed. If you do not like this behaviour, consider using exit. @@ -3393,7 +3393,7 @@ Description - fi marks the end of an if-statement and is exactly equivilent to endif, + fi marks the end of an if-statement and is exactly equivalent to endif, please see there for further information. Example @@ -3425,7 +3425,7 @@ The keyword fill may be used within the circle, rectangle or triangle command and causes these shapes to be filled. - fill can be used in conjunction with and whereever the clear-clause may + fill can be used in conjunction with and wherever the clear-clause may appear. Used alone, fill will fill the interior of the shape (circle, rectangle or triangle); together with clear the whole shape (including its interior) is erased. @@ -3463,9 +3463,9 @@ step is negative). Any for-statement can be replaced by a set of ifs and gotos; as you may - infer from the example below this is normally not feasable. However if you + infer from the example below this is normally not feasible. However if you want to know in detail how the for-statement works, you should study this - example, which presents a for-statement and an exactly equivilant series of + example, which presents a for-statement and an exactly equivalent series of ifs and gotos. Example @@ -3482,7 +3482,7 @@ This example simply prints the numbers 1, 3, 5, 7 and 9. It does this twice: - First with a simple for-statment and then with ifs and gotos. + First with a simple for-statement and then with ifs and gotos. See also @@ -3763,7 +3763,7 @@ print "Hello World !" - Here the goto-statment is used to leave the for-loop prematurely. + Here the goto-statement is used to leave the for-loop prematurely. See also @@ -3866,14 +3866,14 @@ * The one-line-form without the keyword then: if (...) ... This form evaluates the condition and if the result is true executes all - commands (seperated by colons) upt to the end of the line. There is + commands (separated by colons) upt to the end of the line. There is neither an endif keyword nor an else-branch. * The multi-line-form with the keyword then: if (...) then ... elsif (...) ... else ... endif (where elsif and else are optional, whereas endif is not. According to the requirements of your program, you may specify: + elsif(...), which specifies a condition, that will be evaluated only - if the condition(s) whithin if or any preceeding elsif did not + if the condition(s) within if or any preceding elsif did not match. + else, which introduces a sequence of commands, that will be executed, if none of the conditions above did match. @@ -3915,7 +3915,7 @@ Description - The import-statment imports a library. It expects a single argument, which + The import-statement imports a library. It expects a single argument, which must be the name of a library (without the trailing .yab). This library will then be read and parsed and its subroutines (and variables) will be made available within the main program. @@ -4004,8 +4004,8 @@ For normal keys, yabasic simply returns the key, e.g. a, 1 or !. For function keys you will get f1, f2 and so on. Other special keys will return these strings respectively: enter, backspace, del, esc, scrnup (for screen - up), scrndown and tab. Modifier keys (e.g. ctrl, alt or shift) by themself - can not be detected (however, if you press shift and e.g. a simultaniously, + up), scrndown and tab. Modifier keys (e.g. ctrl, alt or shift) by themselves + cannot be detected (however, if you press shift and e.g. a simultaneously, inkey$ will return the letter A instead of a of course). If a graphical window has been opened (via open window) any mouseclick @@ -4083,7 +4083,7 @@ followed by the number, under which the file has been opened. Note, that the input is split at spaces, i.e. if you enter a whole line - consisting of many space-seperated word, the first input-statement will only + consisting of many space-separated word, the first input-statement will only return the first word; the other words will only be returned on subsequent calls to input; the same applies, if a single input reads multiple variables: The first variable gets only the first word, the second one the @@ -4304,7 +4304,7 @@ This example asks a simple yes/no question and goes some way to accept even - incomplete input, while still beeing able to reject invalid input. + incomplete input, while still being able to reject invalid input. This second example demonstrates the capability to assign to the left$-function. @@ -4373,7 +4373,7 @@ * A line has a starting and an end point; therefore the line-command (normally) needs four numbers as arguments, representing these two points. This is the first form appearing within the synopsis. - * You may seperate the two points with either ',' or to, which accounts + * You may separate the two points with either ',' or to, which accounts for the second form of the line-command. * The line-command may be used to draw a connected sequence of lines with a sequence of commands like line x,y; Each command will draw a line from @@ -4627,7 +4627,7 @@ This example prompts for an answer and removes any spaces, which might precede the input; therefore it is even prepared for the (albeit somewhat - patological case, that the user first hits space before entering his answer. + pathological case, that the user first hits space before entering his answer. See also @@ -4684,7 +4684,7 @@ maximum appears. The last loop finally reports the result. Now, the interesting question would be, which will be approached, when we - increase the number of iterations from thousend to infinity. Well, maybe + increase the number of iterations from thousand to infinity. Well, maybe someone could just tell me :-) See also @@ -4889,7 +4889,7 @@ (shift, ctrl or alt): If the shift-key is pressed, mousemod returns 1, for the alt-key 2 and for the ctrl-key 4. If more than one key is pressed, the sum of these values is returned, e.g. mousemod returns 5, if shift and ctrl - are pressed simultanously. + are pressed simultaneously. The mousemod-function accepts zero or one arguments. A single argument should be a string returned by the inkey$-function; if mousemod is called @@ -5354,7 +5354,7 @@ your keyboard; normally (and certainly after you have called on interrupt break), yabasic will terminate with an error message. However after the command on interrupt continue yabasic ignores any keyboard interrupt. This - may be useful, if you do not want your program beeing interruptible during + may be useful, if you do not want your program being interruptible during certain critical operations (e.g. updating of files). Example @@ -5374,7 +5374,7 @@ This program writes a file with 100 random numbers. The on interrupt continue command insures, that the program will not be terminated on a keyboard interrupt and the file will be written entirely in any case. The - sleep-command just stretches the process arificially to give you a chance to + sleep-command just stretches the process artificially to give you a chance to try a ctrl-C. See also @@ -5510,7 +5510,7 @@ If you use yabasic under Unix, you will need a postscript printer (because yabasic produces postscript output). Alternatively you may use ghostscript - to transfrom the postscript file into a form suitable for your printer; but + to transform the postscript file into a form suitable for your printer; but that is beyond the responsibility of yabasic. Example @@ -5620,7 +5620,7 @@ This will print 15. This result is clear, if you note, that the binary representation of 14 and 3 are 1110 and 0011 respectively; this will yield - 1111 in binary representaion or 15 as decimal. + 1111 in binary representation or 15 as decimal. See also @@ -5656,7 +5656,7 @@ Description The pause-command has many different names: You may write pause, sleep or - wait interchangable; whatever you write, yabasic will always do exactly the + wait interchangeably; whatever you write, yabasic will always do exactly the same. The pause-command will simply wait for the specified number of seconds. This @@ -5667,7 +5667,7 @@ depends on the system (Unix, Windows) you are using. The pause-command cannot be interrupted. However, sometimes you may want the - wait to be interuptible by simply pressing a key on the keyboard. In such + wait to be interruptible by simply pressing a key on the keyboard. In such cases you should consider using the inkey$-function, with a number of seconds as an argument). @@ -6000,7 +6000,7 @@ Description - The poke-command may be used to change details of yabasics behaviour. Like + The poke-command may be used to change details of yabasic's behaviour. Like the related function peek, poke does many different things, depending on the arguments supplied. @@ -6084,7 +6084,7 @@ The print-statement outputs strings or characters, either to your terminal (also known as console) or to an open file. - To understand all those uses of the print-statement, let's go throught the + To understand all those uses of the print-statement, let's go through the various lines in the synopsis above: print "foo",a$,b @@ -6158,7 +6158,7 @@ next a - This example draws a cloured ellipse within the text window. + This example draws a colored ellipse within the text window. See also @@ -6177,7 +6177,7 @@ Description - Not a seperate command, but part of the print-command; may be included just + Not a separate command, but part of the print-command; may be included just after print and can only be issued after clear screen has been executed. color() takes one or two string-arguments, specifying the color of the text @@ -6204,7 +6204,7 @@ data "green","yellow","cyan","magenta" - This prints the word " Hallo " in all colors accross your screen. + This prints the word " Hallo " in all colors across your screen. See also @@ -6253,7 +6253,7 @@ only the string value "or" is supported here. The effect is, that only those pixel, which are set in the string will be set in the graphic window. Those pixels, which are not set in the string, will not change in the window (as - opposed to beeing cleared). + opposed to being cleared). Note, that the format of the string returned by this function is due to change as soon as yabasic will learn, how to deal with colors. @@ -6386,7 +6386,7 @@ return - return from a subroutine or a gosub reverse - print reverse (background and foreground colors exchanged) right$() - return (or change) the right end of a string - rinstr() - find the rightmost occurence of one string within the other + rinstr() - find the rightmost occurrence of one string within the other rtrim$() - trim spaces at the right end of a string ran() @@ -6426,7 +6426,7 @@ loop - This example will print a cloured bell-curve. + This example will print a colored bell-curve. See also @@ -6491,7 +6491,7 @@ Description The rectangle-command (also known as box or rect, for short) draws a - recatangle; it accepts four parameters: The x- and y-coordinates of two + rectangle; it accepts four parameters: The x- and y-coordinates of two facing cornerpoints of the rectangle. With the optional clauses clear and fill (which may appear both and in any sequence) the rectangle can be cleared and filled respectively. @@ -6562,7 +6562,7 @@ rem introduces a comment (like # or //), that extends up to the end of the line. - Those comments do not even need a colon (':' infront of them); they (rem, # + Those comments do not even need a colon (':') in front of them; they (rem, # and //) all behave alike except for #, which may only appear at the very beginning of a line; therefore the fourth example in the synopsis above (print "Not a comment" # This is an error !!) is indeed an error. @@ -6570,7 +6570,7 @@ Note, that rem is an abbreviation for remark. remark however is not a valid command in yabasic. - Finally note, that a comment intoduced with '#' may have a special meaning + Finally note, that a comment introduced with '#' may have a special meaning under unix; see the entry for # for details. Example @@ -6714,7 +6714,7 @@ to place multiple return-statements within your subroutine; it's a nice way of controlling the flow of execution. - The second (but historcially first) use of return is to return to the + The second (but historically first) use of return is to return to the position, where a prior gosub has left off. In that case return may not carry a value. @@ -6740,7 +6740,7 @@ This example features a subroutine mark$, that returns its argument in upper case, if it contains the letter "q", or unchanged otherwise. In the - test-text the word quick will end up beeing marked as QUICK. + test-text the word quick will end up being marked as QUICK. The example above demonstrates return within subroutines; please see gosub for an example of how to use return in this context. @@ -6763,7 +6763,7 @@ Description - reverse may be used to print text in reverse. reverse is not a seperate + reverse may be used to print text in reverse. reverse is not a separate command, but part of the print-command; it may be included just after the print and can only be issued once that clear screen has been issued. @@ -6837,7 +6837,7 @@ endif - This program allows the user to enter a length qulified with a unit (either + This program allows the user to enter a length qualified with a unit (either inch or centimeter). This second example demonstrates the capability to assign to the @@ -6855,7 +6855,7 @@ Name - rinstr() - find the rightmost occurence of one string within the other + rinstr() - find the rightmost occurrence of one string within the other Synopsis @@ -6866,8 +6866,8 @@ The rinstr-function accepts two string-arguments and tries to find the second within the first. However, unlike the instr, the rinstr-function - finds the rightmost (or last) occurence of the string; whereas the - instr-function finds the leftmost (or first) occurence. In any case however, + finds the rightmost (or last) occurrence of the string; whereas the + instr-function finds the leftmost (or first) occurrence. In any case however, the position is counted from the left. If you supply a third, numeric argument to the rinstr-function, it will be @@ -6881,7 +6881,7 @@ This simple example will print 7, because it finds the rightmost among the - three occurences of foo within the string. Note, that + three occurrences of foo within the string. Note, that print instr("foofoofoobar","foo") would have printed 1. @@ -6902,7 +6902,7 @@ Description - The rtrim$-function removes all wthitespace from the right end of a string + The rtrim$-function removes all whitespace from the right end of a string and returns the result. Example @@ -7067,7 +7067,7 @@ This program prints an infinite sequence of random number; positive numbers are printed in green, negative numbers are printed red (an exact zero would be printed white). (With a little extra work, this program could be easily - extended into a brogerage system) + extended into a brokerage system) See also @@ -7117,7 +7117,7 @@ Description The sleep-command has many different names: You may write pause, sleep or - wait interchangable; whatever you write, yabasic will always do exactly the + wait interchangeably; whatever you write, yabasic will always do exactly the same. Therefore you should refer to the entry for the pause-function for further @@ -7433,13 +7433,13 @@ space (which shows up as an 'x'). ##,###.## x3,141.59 Nearly the same as above, but the colon from the format shows up within the result. - ##,###.## and an addtional argument of ".," x3.141,59 Similar to the example - above, but colon and dot are replaced with dot and colon respectivly. - ##,###.## and an addtional argument of "_," x3_141,59 Similar to the example + ##,###.## and an additional argument of ".," x3.141,59 Similar to the example + above, but colon and dot are replaced with dot and colon respectively. + ##,###.## and an additional argument of "_," x3_141,59 Similar to the example above, but colon and dot are replaced with underscore and colon respectivly. ##### x3142 The format string does not contain a dot, and therefore the result does not have any fractional digits. - ##.### ##.### As 1000*pi has 4 digits infront of the decimal dot and the + ##.### ##.### As 1000*pi has 4 digits in front of the decimal dot and the format only specifies 2, yabasic does not know what to do; therefore it chooses just to reproduce the format string. @@ -7565,7 +7565,7 @@ Description - The switch-statment selects one of many codepaths depending on a numerical + The switch-statement selects one of many codepaths depending on a numerical or string expression. I.e. it takes an expression (either numeric or string) and compares it with a series of values, each wrapped within a case-clause. If the expression equals the value given in a case-clause, the subsequent @@ -7672,7 +7672,7 @@ Table of Contents - tan() - return the tangens of its argument + tan() - return the tangent of its argument tell - get the current position within an open file text - write text into your graphic-window then - tell the long from the short form of the if-statement @@ -7687,7 +7687,7 @@ Name - tan() - return the tangens of its argument + tan() - return the tangent of its argument Synopsis @@ -7695,7 +7695,7 @@ Description - The tan-function computes the tangens of its arguments (which should be + The tan-function computes the tangent of its arguments (which should be specified in radian). Example @@ -7705,7 +7705,7 @@ next a - This example simply prints the tangens of all angles between 0 and 45 + This example simply prints the tangent of all angles between 0 and 45 degree. See also @@ -7864,7 +7864,7 @@ * The number of minutes, padded with zeroes. * The number of seconds, padded with zeroes. * The number of seconds, that have elapsed since the program has been - started. This value encreases as long as your program runs and is + started. This value increases as long as your program runs and is therefore unbound and not padded with zeroes. At the time of writing this documentation, time$ returns 22-58-53-0. Note, @@ -8211,8 +8211,8 @@ endif - This program asks for a sentence and marks the first (if any) occurence of - the letter 'e' by coverting it to upper case (in contrast to the rest of the + This program asks for a sentence and marks the first (if any) occurrence of + the letter 'e' by converting it to upper case (in contrast to the rest of the sentence, which is converted to lower case). See also @@ -8278,7 +8278,7 @@ The val-function checks, if the start of its string argument forms a floating point number and then returns this number. The string therefore has - to start with digits (only whitespace infront is allowed), otherwise the + to start with digits (only whitespace in front is allowed), otherwise the val-function returns zero. Example @@ -8356,7 +8356,7 @@ print a$ - This example reads a sentence and converts every occurence of the letter e + This example reads a sentence and converts every occurrence of the letter e into uppercase (E). See also @@ -8377,7 +8377,7 @@ Description - The while-keyword starts a while-loop, i.e. a loop that is excuted as long + The while-keyword starts a while-loop, i.e. a loop that is executed as long as the condition (which is specified in braces after the keyword while) evaluates to true. @@ -8418,10 +8418,10 @@ coordinate system to one of nine point within the window. The normal position of the origin is in the upper left corner of the window; however in some cases this is inconvenient and moving the origin may save you from - substracting a constant offset from all of your coordinates. + subtracting a constant offset from all of your coordinates. However, you may not move the origin to an arbitrary position; in horizontal - possition there are only three positions: left, center and right, which are + position there are only three positions: left, center and right, which are decoded by the letters l, c and r. In vertical position the allowed positions are top, center and bottom; encoded by the letters t, c and b. Taking the letters together, you arrive at a string, which might be passed @@ -8476,7 +8476,7 @@ This will print 3. This result is obvious, if you note, that the binary representation of 7 and 4 are 111 and 100 respectively; this will yield 011 - in binary representaion or 2 as decimal. + in binary representation or 2 as decimal. The eor-function is the same as the xor function; both are synonymous; however they have each their own description, so you may check out the entry @@ -8636,7 +8636,7 @@ Description The semicolon (';') may only appear at the last position within a - print-statement. It supresses the implicit newline, which yabasic normally + print-statement. It suppresses the implicit newline, which yabasic normally adds after each print-statement. Put another way: Normally the output of each print-statement appears on a @@ -8731,7 +8731,7 @@ is true. "Nice, but whats this good for ?", I hear you say. Well, just have another - look at the example, especially the second comparison (b/a>2); deviding b by + look at the example, especially the second comparison (b/a>2); dividing b by a is potentially hazardous: If a equals zero, the expression will cause an error and your program will terminate. To avoid this, the first part of the comparison (a<>0) checks, if the second one can be evaluated without risk. @@ -8771,8 +8771,8 @@ be aware, that the subroutine will be able to modify the array you have passed in. So passing an array reference does not create a copy of the array; this has some interesting consequences: - * Speed and space: Creating a copy of an array would be a time- and - resourceconsuming operation; passing just a reference is cheap and fast. + * Speed and space: Creating a copy of an array would be a time (and + resource) consuming operation; passing just a reference is cheap and fast. * Returning many values: A subroutine, that wants to give back more than one value, may require an array reference among its arguments and then store its many return values within this array. This is the only way to @@ -8783,7 +8783,7 @@ As you probably know, windows uses the character '\\' to separate the directories within a pathname; an example would be C:\\yabasic\\yabasic.exe (the usual location of the yabasic executable). However, the very same - character '\\' is used to contstruct escape sequences, not only in yabasic + character '\\' is used to construct escape sequences, not only in yabasic but in most other programming languages. Therefore the string "C:\\t.dat" does not specify the file t.dat within the @@ -8794,7 +8794,7 @@ Escape-sequences Escape-sequences are the preferred way of specifying 'special' characters. - They ar intoduced by the '\\'-character and followed by one of a few regular + They ar introduced by the '\\'-character and followed by one of a few regular letters, e.g. '\\n' or '\\r' (see the table below). Escape-sequences may occur within any string at any position; they are @@ -8804,7 +8804,7 @@ the matching special character just before the program executes. Table 7.1. Escape sequences - Escape Seqence Matching special character + Escape Sequence Matching special character \\n newline \\t tabulator \\v vertical tabulator @@ -8901,7 +8901,7 @@ If you run this program (which may be saved in the file foo.yab) via yabasic foo.yab, the peek("isbound") in the first line will check, if the program is already part of a standalone-program. If not (i.e. if the - yabasic-interpreter and the yabasic-program are seperate files) the + yabasic-interpreter and the yabasic-program are separate files) the bind-command will create a standalone program foo containing both. As a result you would see the output Successfully created the standalone executable 'foo' !. Note: Under Windows you would probably choose the @@ -8925,12 +8925,12 @@ people from having to install yabasic themselves. * There is no easy way to extract your yabasic-program from within the standalone program: If you ever want to change it, you need to have it - around seperately. + around separately. * If a new version of yabasic becomes available, again you need to recreate all of your standalone programs to take advantage of bugfixes and improvements. - So, beeing able to create a standalone program is certainly a good thin, but + So, being able to create a standalone program is certainly a good thing, but certainly not a silver bullet. See also @@ -8964,7 +8964,7 @@ yabasic have been implemented. So please do not take this as a particular good example of yabasic-code. // -// This program demoes yabasic +// This program demos yabasic // @@ -9095,7 +9095,7 @@ print at(32,17) can; label notprime if (lower$(inkey$(0))<>"") then - print at(10,sh) "Wrappinging around once ..."; + print at(10,sh) "Wrapping around once ..."; for x=1 to sw a$=getscreen$(0,0,1,sh-2) b$=getscreen$(1,0,sw-1,sh-2) @@ -9112,7 +9112,7 @@ label bitmap clear screen print - print "Yabasic offers some commands for drawing simple grafics." + print "Yabasic offers some commands for drawing simple graphics." print reverse at(5,12) " Press any key to return to main menu ... " n=20 @@ -9218,7 +9218,7 @@ // Data for main menu: Number and text of entries in main menu data 4 data " Yabasic in a nutshell " -data " Some grafics " +data " Some graphics " data " A rotating Tetraeder " data " Exit this demo "