Warning, /education/kturtle/doc/using-kturtle.docbook is written in an unsupported language. File is not indexed.
0001 <chapter id="using-kturtle"> 0002 <title>Using &kturtle;</title> 0003 0004 <screenshot> 0005 <screeninfo>Here is a screenshot of &kturtle; in action</screeninfo> 0006 <mediaobject> 0007 <imageobject> 0008 <imagedata fileref="mainwindow_flower_nrs.png" format="PNG"/> 0009 </imageobject> 0010 <textobject> 0011 <phrase>&kturtle; Main Window</phrase> 0012 </textobject> 0013 </mediaobject> 0014 </screenshot> 0015 0016 <para>The main window of &kturtle; has three main parts: <link linkend="the-editor">the editor</link> (1) on the left where you type the &turtlescript; commands, the <link linkend="the-canvas">the canvas</link> (2) on the right where the turtle make your drawing, and the <link linkend="the-inspector">inspector</link> (3) which gives you information when your program executes. Besides these you find <link linkend="the-menubar">the menu bar</link> (5) from where all the actions can be reached, <link linkend="the-toolbar">the toolbar</link> (4) that allows you to quickly select the most used actions, the <guilabel>Console:</guilabel> input box, that you can use to enter a one line command to test it, and <link linkend="the-statusbar">the statusbar</link> (along the bottom of the window) where you will find feedback on the state of &kturtle;.</para> 0017 0018 <sect1 id="the-editor"> 0019 <title>The Editor</title> 0020 <para>In the editor you type the &turtlescript; commands. Most of functions of the editor can be found in the <link linkend="the-file-menu">File</link> and <link linkend="the-edit-menu">Edit</link> menus. The editor can be docked on each border of the main window or it can be detached and placed anywhere on your desktop.</para> 0021 <para>You have several ways to get some code in the editor. The easiest way is to use an example: choose the <menuchoice><guimenu>File</guimenu><guisubmenu>Examples</guisubmenu></menuchoice> submenu and select an example. The file example you choose will be opened in the <link linkend="the-editor">the editor</link>, you can then use the <menuchoice><guimenu>Run</guimenu><guimenuitem>Run</guimenuitem></menuchoice> menu item (shortcut: <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>) or the <inlinemediaobject> <imageobject> <imagedata fileref="media-playback-pause.png" format="PNG"/> </imageobject> </inlinemediaobject> <guibutton>Run</guibutton> button from the toolbar to run the code if you like.</para> 0022 <para>You can open &turtlescript; files by choosing the <menuchoice><guimenu>File</guimenu><guimenuitem>Open...</guimenuitem></menuchoice> menu item.</para> 0023 <para>The third way is to directly type your own code in the editor or to copy/paste some code.</para> 0024 </sect1> 0025 0026 0027 <sect1 id="the-canvas"> 0028 <title>The Canvas</title> 0029 <para>The canvas is the domain of the turtle, here the turtle draws according to the commands it gets. After getting some code in the <link linkend="the-editor">Editor</link> and executing it, two things can happen: either the code executes fine, and will you most likely see something change on the canvas; or you have made an error in your code in that case the error tab will appear explaining you what mistake you made.</para> 0030 <para>You can zoom in and out the canvas with your mouse wheel.</para> 0031 </sect1> 0032 0033 0034 <sect1 id="the-inspector"> 0035 <title>The Inspector</title> 0036 <para>The inspector informs you about the variables, the learned functions and show the code tree while the program is running.</para> 0037 <para>The inspector can be docked on each border of the main window or it can be detached and placed anywhere on your desktop.</para> 0038 </sect1> 0039 0040 0041 <sect1 id="the-toolbar"> 0042 <title>The Toolbar</title> 0043 <para>Here you can quickly reach the most used actions. The Toolbar also contains the <guilabel>Console:</guilabel> input box, where you can quickly invoke commands, this might be useful in case you want to test a command without modifying the content of the <link linkend="the-editor">Editor</link>.</para> 0044 <para>You can configure the toolbar using <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Toolbars...</guimenuitem></menuchoice> to better fit your preferences.</para> 0045 </sect1> 0046 0047 0048 <sect1 id="the-menubar"> 0049 <title>The Menubar</title> 0050 <para>In the menubar you find all the actions of &kturtle;. They are in the following groups: <guimenu>File</guimenu>, <guimenu>Edit</guimenu>, <guimenu>Canvas</guimenu>, <guimenu>Run</guimenu>, <guimenu>Tools</guimenu>, <guimenu>Settings</guimenu>, and <guimenu>Help</guimenu>. This section describes them all.</para> 0051 0052 <sect2 id="the-file-menu"> 0053 <title>The File Menu</title> 0054 0055 <variablelist> 0056 <anchor id="file-new" /> 0057 <varlistentry> 0058 <term><menuchoice> 0059 <shortcut> 0060 <keycombo>&Ctrl;<keycap>N</keycap></keycombo> 0061 </shortcut> 0062 <guimenu>File</guimenu> 0063 <guimenuitem>New</guimenuitem> 0064 </menuchoice></term> 0065 <listitem><para>Creates a new, empty &turtlescript; file.</para></listitem> 0066 </varlistentry> 0067 </variablelist> 0068 <variablelist> 0069 <anchor id="file-open" /> 0070 <varlistentry> 0071 <term><menuchoice> 0072 <shortcut> 0073 <keycombo>&Ctrl;<keycap>O</keycap></keycombo> 0074 </shortcut> 0075 <guimenu>File</guimenu> 0076 <guimenuitem>Open...</guimenuitem> 0077 </menuchoice></term> 0078 <listitem><para>Opens a &turtlescript; file.</para></listitem> 0079 </varlistentry> 0080 </variablelist> 0081 <variablelist> 0082 <anchor id="file-open-recent" /> 0083 <varlistentry> 0084 <term><menuchoice> 0085 <guimenu>File</guimenu> 0086 <guisubmenu>Open Recent</guisubmenu> 0087 </menuchoice></term> 0088 <listitem><para>Opens a &turtlescript; file that has been opened recently.</para></listitem> 0089 </varlistentry> 0090 </variablelist> 0091 <variablelist> 0092 <anchor id="file-open-examples" /> 0093 <varlistentry> 0094 <term><menuchoice> 0095 <guimenu>File</guimenu> 0096 <guisubmenu>Examples</guisubmenu> 0097 </menuchoice></term> 0098 <listitem><para>Open example &turtlescript; programs. The examples are in your favorite language that you can choose in the <menuchoice><guimenu>Settings</guimenu><guisubmenu>Script Language</guisubmenu></menuchoice> submenu.</para></listitem> 0099 </varlistentry> 0100 </variablelist> 0101 <variablelist> 0102 <anchor id="file-get-more-examples" /> 0103 <varlistentry> 0104 <term><menuchoice> 0105 <guimenu>File</guimenu> 0106 <guimenuitem>Get more examples...</guimenuitem> 0107 </menuchoice></term> 0108 <listitem><para>Open the <guilabel>Get Hot New Stuff</guilabel> dialog to download 0109 additional &turtlescript; files from the Internet.</para></listitem> 0110 </varlistentry> 0111 </variablelist> 0112 0113 <variablelist> 0114 <anchor id="file-save" /> 0115 <varlistentry> 0116 <term><menuchoice> 0117 <shortcut> 0118 <keycombo>&Ctrl;<keycap>S</keycap></keycombo> 0119 </shortcut> 0120 <guimenu>File</guimenu> 0121 <guimenuitem>Save</guimenuitem> 0122 </menuchoice></term> 0123 <listitem><para>Saves the currently opened &turtlescript; file.</para></listitem> 0124 </varlistentry> 0125 </variablelist> 0126 <variablelist> 0127 <anchor id="file-save-as" /> 0128 <varlistentry> 0129 <term><menuchoice> 0130 <shortcut> 0131 <keycombo>&Ctrl;&Shift;<keycap>S</keycap></keycombo> 0132 </shortcut> 0133 <guimenu>File</guimenu> 0134 <guimenuitem>Save As...</guimenuitem> 0135 </menuchoice></term> 0136 <listitem><para>Saves the currently opened &turtlescript; file on a specified location.</para></listitem> 0137 </varlistentry> 0138 </variablelist> 0139 <variablelist> 0140 <anchor id="file-export-to-html" /> 0141 <varlistentry> 0142 <term><menuchoice> 0143 <guimenu>File</guimenu> 0144 <guimenuitem>Export to HTML...</guimenuitem> 0145 </menuchoice></term> 0146 <listitem><para>Exports the current content of the Editor as an &HTML; file that includes highlighting colors.</para></listitem> 0147 </varlistentry> 0148 </variablelist> 0149 <variablelist> 0150 <anchor id="file-print" /> 0151 <varlistentry> 0152 <term><menuchoice> 0153 <shortcut> 0154 <keycombo>&Ctrl;<keycap>P</keycap></keycombo> 0155 </shortcut> 0156 <guimenu>File</guimenu> 0157 <guimenuitem>Print...</guimenuitem> 0158 </menuchoice></term> 0159 <listitem><para>Prints the current code in the editor.</para></listitem> 0160 </varlistentry> 0161 </variablelist> 0162 <variablelist> 0163 <anchor id="file-quit" /> 0164 <varlistentry> 0165 <term><menuchoice> 0166 <shortcut> 0167 <keycombo>&Ctrl;<keycap>Q</keycap></keycombo> 0168 </shortcut> 0169 <guimenu>File</guimenu> 0170 <guimenuitem>Quit</guimenuitem> 0171 </menuchoice></term> 0172 <listitem><para>Quits &kturtle;.</para></listitem> 0173 </varlistentry> 0174 </variablelist> 0175 </sect2> 0176 0177 <sect2 id="the-edit-menu"> 0178 <title>The Edit Menu</title> 0179 <variablelist> 0180 <anchor id="edit-undo" /> 0181 <varlistentry> 0182 <term><menuchoice> 0183 <shortcut> 0184 <keycombo>&Ctrl;<keycap>Z</keycap></keycombo> 0185 </shortcut> 0186 <guimenu>Edit</guimenu> 0187 <guimenuitem>Undo</guimenuitem> 0188 </menuchoice></term> 0189 <listitem><para>Undoes the last change to code. &kturtle; has unlimited undos.</para></listitem> 0190 </varlistentry> 0191 </variablelist> 0192 <variablelist> 0193 <anchor id="edit-redo" /> 0194 <varlistentry> 0195 <term><menuchoice> 0196 <shortcut> 0197 <keycombo>&Ctrl;&Shift;<keycap>Z</keycap></keycombo> 0198 </shortcut> 0199 <guimenu>Edit</guimenu> 0200 <guimenuitem>Redo</guimenuitem> 0201 </menuchoice></term> 0202 <listitem><para>Redoes an undone change to the code.</para></listitem> 0203 </varlistentry> 0204 </variablelist> 0205 <variablelist> 0206 <anchor id="edit-cut" /> 0207 <varlistentry> 0208 <term><menuchoice> 0209 <shortcut> 0210 <keycombo>&Ctrl;<keycap>X</keycap></keycombo> 0211 </shortcut> 0212 <guimenu>Edit</guimenu> 0213 <guimenuitem>Cut</guimenuitem> 0214 </menuchoice></term> 0215 <listitem><para>Cuts the selected text from <link linkend="the-editor">the editor</link> to the clipboard.</para></listitem> 0216 </varlistentry> 0217 </variablelist> 0218 <variablelist> 0219 <anchor id="edit-copy" /> 0220 <varlistentry> 0221 <term><menuchoice> 0222 <shortcut> 0223 <keycombo>&Ctrl;<keycap>C</keycap></keycombo> 0224 </shortcut> 0225 <guimenu>Edit</guimenu> 0226 <guimenuitem>Copy</guimenuitem> 0227 </menuchoice></term> 0228 <listitem><para>Copies the selected text from <link linkend="the-editor">the editor</link> to the clipboard.</para></listitem> 0229 </varlistentry> 0230 </variablelist> 0231 <variablelist> 0232 <anchor id="edit-paste" /> 0233 <varlistentry> 0234 <term><menuchoice> 0235 <shortcut> 0236 <keycombo>&Ctrl;<keycap>V</keycap></keycombo> 0237 </shortcut> 0238 <guimenu>Edit</guimenu> 0239 <guimenuitem>Paste</guimenuitem> 0240 </menuchoice></term> 0241 <listitem><para>Pastes the text from the clipboard to <link linkend="the-editor">the editor</link>.</para></listitem> 0242 </varlistentry> 0243 </variablelist> 0244 <variablelist> 0245 <anchor id="edit-select-all" /> 0246 <varlistentry> 0247 <term><menuchoice> 0248 <shortcut> 0249 <keycombo>&Ctrl;<keycap>A</keycap></keycombo> 0250 </shortcut> 0251 <guimenu>Edit</guimenu> 0252 <guimenuitem>Select All</guimenuitem> 0253 </menuchoice></term> 0254 <listitem><para>Selects all the text from <link linkend="the-editor">the editor</link>.</para></listitem> 0255 </varlistentry> 0256 </variablelist> 0257 <variablelist> 0258 <anchor id="edit-find" /> 0259 <varlistentry> 0260 <term><menuchoice> 0261 <shortcut> 0262 <keycombo>&Ctrl;<keycap>F</keycap></keycombo> 0263 </shortcut> 0264 <guimenu>Edit</guimenu> 0265 <guimenuitem>Find...</guimenuitem> 0266 </menuchoice></term> 0267 <listitem><para>With this action you can find phrases in the code.</para></listitem> 0268 </varlistentry> 0269 </variablelist> 0270 <variablelist> 0271 <anchor id="edit-find-next" /> 0272 <varlistentry> 0273 <term><menuchoice> 0274 <shortcut> 0275 <keycombo><keysym>F3</keysym></keycombo> 0276 </shortcut> 0277 <guimenu>Edit</guimenu> 0278 <guimenuitem>Find Next</guimenuitem> 0279 </menuchoice></term> 0280 <listitem><para>Use this to find the next occurrence of the phrase you searched for.</para></listitem> 0281 </varlistentry> 0282 </variablelist> 0283 <variablelist> 0284 <anchor id="edit-find-previous" /> 0285 <varlistentry> 0286 <term><menuchoice> 0287 <shortcut> 0288 <keycombo>&Shift;<keysym>F3</keysym></keycombo> 0289 </shortcut> 0290 <guimenu>Edit</guimenu> 0291 <guimenuitem>Find Previous</guimenuitem> 0292 </menuchoice></term> 0293 <listitem><para>Use this to find the previous occurrence of the phrase you searched for.</para></listitem> 0294 </varlistentry> 0295 </variablelist> 0296 <!--<variablelist> 0297 <anchor id="edit-replace" /> 0298 <varlistentry> 0299 <term><menuchoice> 0300 <shortcut> 0301 <keycombo>&Ctrl;<keycap>R</keycap></keycombo> 0302 </shortcut> 0303 <guimenu>Edit</guimenu> 0304 <guimenuitem>Replace...</guimenuitem> 0305 </menuchoice></term> 0306 <listitem><para>With this action you can replace text in the code.</para></listitem> 0307 </varlistentry> 0308 </variablelist>--> 0309 <variablelist> 0310 <anchor id="toggle-insert" /> 0311 <varlistentry> 0312 <term><menuchoice> 0313 <shortcut> 0314 <keycombo>&Ins;</keycombo> 0315 </shortcut> 0316 <guimenu>Edit</guimenu> 0317 <guimenuitem>Overwrite Mode</guimenuitem> 0318 </menuchoice></term> 0319 <listitem><para>Toggle between the 'insert' and 'overwrite' mode.</para></listitem> 0320 </varlistentry> 0321 </variablelist> 0322 </sect2> 0323 0324 0325 <sect2 id="the-canvas-menu"> 0326 <title>The Canvas Menu</title> 0327 <variablelist> 0328 <anchor id="canvas-export-to-image" /> 0329 <varlistentry> 0330 <term><menuchoice> 0331 <guimenu>Canvas</guimenu> 0332 <guimenuitem>Export to Image (PNG)...</guimenuitem> 0333 </menuchoice></term> 0334 <listitem><para>Exports the current content of the <link linkend="the-canvas">Canvas</link> as a raster image of the PNG (Portable Network Graphics) type.</para></listitem> 0335 </varlistentry> 0336 </variablelist> 0337 <variablelist> 0338 <anchor id="canvas-export-to-drawing" /> 0339 <varlistentry> 0340 <term><menuchoice> 0341 <guimenu>Canvas</guimenu> 0342 <guimenuitem>Export to Drawing (SVG)...</guimenuitem> 0343 </menuchoice></term> 0344 <listitem><para>Exports the current content of the <link linkend="the-canvas">Canvas</link> as a vector drawing of the &SVG; (Scalable Vector Graphics) type.</para></listitem> 0345 </varlistentry> 0346 </variablelist> 0347 <variablelist> 0348 <anchor id="canvas-print" /> 0349 <varlistentry> 0350 <term><menuchoice> 0351 <guimenu>Canvas</guimenu> 0352 <guimenuitem>Print Canvas...</guimenuitem> 0353 </menuchoice></term> 0354 <listitem><para>Prints the current content of the <link linkend="the-canvas">Canvas</link>.</para></listitem> 0355 </varlistentry> 0356 </variablelist> 0357 </sect2> 0358 0359 <sect2 id="the-run-menu"> 0360 <title>The Run Menu</title> 0361 <variablelist> 0362 <anchor id="run-execute" /> 0363 <varlistentry> 0364 <term><menuchoice> 0365 <shortcut> 0366 <keycombo><keysym>F5</keysym></keycombo> 0367 </shortcut> 0368 <guimenu>Run</guimenu> 0369 <guimenuitem>Run</guimenuitem> 0370 </menuchoice></term> 0371 <listitem><para>Starts the execution of the commands in the editor.</para></listitem> 0372 </varlistentry> 0373 </variablelist> 0374 <variablelist> 0375 <anchor id="run-pause" /> 0376 <varlistentry> 0377 <term><menuchoice> 0378 <shortcut> 0379 <keycombo><keysym>F6</keysym></keycombo> 0380 </shortcut> 0381 <guimenu>Run</guimenu> 0382 <guimenuitem>Pause</guimenuitem> 0383 </menuchoice></term> 0384 <listitem><para>Pauses the execution. This action is only enabled when the commands are actually executing.</para></listitem> 0385 </varlistentry> 0386 </variablelist> 0387 <variablelist> 0388 <anchor id="run-stop" /> 0389 <varlistentry> 0390 <term><menuchoice> 0391 <shortcut> 0392 <keycombo><keysym>F7</keysym></keycombo> 0393 </shortcut> 0394 <guimenu>Run</guimenu> 0395 <guimenuitem>Abort</guimenuitem> 0396 </menuchoice></term> 0397 <listitem><para>Stops the execution. This action is only enabled when the commands are actually executing.</para></listitem> 0398 </varlistentry> 0399 </variablelist> 0400 <variablelist> 0401 <anchor id="run-speed" /> 0402 <varlistentry> 0403 <term><menuchoice> 0404 <guimenu>Run</guimenu> 0405 <guisubmenu>Run Speed</guisubmenu> 0406 </menuchoice></term> 0407 <listitem><para>Present a list of possible execution speeds, consisting of: <guimenuitem>Full Speed (no highlighting and inspector)</guimenuitem>, <guimenuitem>Full Speed</guimenuitem>, <guimenuitem>Slow</guimenuitem>, <guimenuitem>Slower</guimenuitem>, <guimenuitem>Slowest</guimenuitem> and <guimenuitem>Step-by-Step</guimenuitem>. When the execution speed is set to <guimenuitem>Full Speed</guimenuitem> (default) we can barely keep up with what is happening. Sometimes this behavior is wanted, but sometimes we want to keep track of the execution. In the latter case you want to set the execution speed to <guimenuitem>Slow</guimenuitem>, <guimenuitem>Slower</guimenuitem> or <guimenuitem>Slowest</guimenuitem>. When one of the slow modes is selected the current position of the executor will be shown in the editor. <guimenuitem>Step-by-Step</guimenuitem> will execute one command at a time.</para></listitem> 0408 </varlistentry> 0409 </variablelist> 0410 </sect2> 0411 0412 0413 0414 <sect2 id="the-tools-menu"> 0415 <title>The Tools Menu</title> 0416 <variablelist> 0417 <anchor id="tools-direction-chooser" /> 0418 <varlistentry> 0419 <term><menuchoice> 0420 <guimenu>Tools</guimenu> 0421 <guimenuitem>Direction Chooser...</guimenuitem> 0422 </menuchoice></term> 0423 <listitem><para>This action opens the direction chooser dialog.</para></listitem> 0424 </varlistentry> 0425 </variablelist> 0426 <variablelist> 0427 <anchor id="tools-color-chooser" /> 0428 <varlistentry> 0429 <term><menuchoice> 0430 <guimenu>Tools</guimenu> 0431 <guimenuitem>Color Picker...</guimenuitem> 0432 </menuchoice></term> 0433 <listitem><para>This action opens the color picker dialog.</para></listitem> 0434 </varlistentry> 0435 </variablelist> 0436 </sect2> 0437 0438 <sect2 id="the-setting-menu"> 0439 <title>The Settings Menu</title> 0440 <variablelist> 0441 <anchor id="settings-set-script-language" /> 0442 <varlistentry> 0443 <term><menuchoice><guimenu>Settings</guimenu><guisubmenu>Script Language</guisubmenu></menuchoice></term> 0444 <listitem><para><action>Choose</action> the language for the code.</para></listitem> 0445 </varlistentry> 0446 </variablelist> 0447 <variablelist> 0448 <anchor id="settings-toggle-editor" /> 0449 <varlistentry> 0450 <term><menuchoice> 0451 <shortcut> 0452 <keycombo>&Ctrl;<keycap>E</keycap></keycombo> 0453 </shortcut> 0454 <guimenu>Settings</guimenu> 0455 <guimenuitem>Show Editor</guimenuitem> 0456 </menuchoice></term> 0457 <listitem><para>Show or hide the <link linkend="the-editor">Editor</link>.</para></listitem> 0458 </varlistentry> 0459 </variablelist> 0460 <variablelist> 0461 <anchor id="settings-toggle-inspector" /> 0462 <varlistentry> 0463 <term><menuchoice> 0464 <shortcut> 0465 <keycombo>&Ctrl;<keycap>I</keycap></keycombo> 0466 </shortcut> 0467 <guimenu>Settings</guimenu> 0468 <guimenuitem>Show Inspector</guimenuitem> 0469 </menuchoice></term> 0470 <listitem><para>Show or hide <link linkend="the-inspector">the inspector</link>.</para></listitem> 0471 </varlistentry> 0472 </variablelist> 0473 <variablelist> 0474 <anchor id="settings-toggle-errors" /> 0475 <varlistentry> 0476 <term><menuchoice> 0477 <guimenu>Settings</guimenu> 0478 <guimenuitem>Show Errors</guimenuitem> 0479 </menuchoice></term> 0480 <listitem><para>Show or hide the <guilabel>Errors</guilabel> tab with a list of errors resulting from running the code. If this option is enabled, click on <guilabel>Canvas</guilabel> to see the turtle again.</para></listitem> 0481 </varlistentry> 0482 </variablelist> 0483 <variablelist> 0484 <anchor id="settings-toggle-linenumbers" /> 0485 <varlistentry> 0486 <term><menuchoice> 0487 <shortcut> 0488 <keycombo><keysym>F11</keysym></keycombo> 0489 </shortcut> 0490 <guimenu>Settings</guimenu> 0491 <guimenuitem>Show Line Numbers</guimenuitem> 0492 </menuchoice></term> 0493 <listitem><para>With this action you can show the line numbers in <link linkend="the-editor">the editor</link>. This can be handy for finding errors.</para></listitem> 0494 </varlistentry> 0495 </variablelist> 0496 <variablelist> 0497 <anchor id="settings-toggle-toolbar" /> 0498 <varlistentry> 0499 <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Show Toolbar</guimenuitem></menuchoice></term> 0500 <listitem><para><action>Toggle</action> the Main Toolbar.</para></listitem> 0501 </varlistentry> 0502 </variablelist> 0503 <variablelist> 0504 <anchor id="settings-toggle-statusbar" /> 0505 <varlistentry> 0506 <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Show Statusbar</guimenuitem></menuchoice></term> 0507 <listitem><para><action>Toggle</action> the Statusbar.</para></listitem> 0508 </varlistentry> 0509 </variablelist> 0510 <variablelist> 0511 <anchor id="settings-configure-shortcuts" /> 0512 <varlistentry> 0513 <term><menuchoice> 0514 <guimenu>Settings</guimenu> 0515 <guimenuitem>Configure Shortcuts...</guimenuitem> 0516 </menuchoice></term> 0517 <listitem><para>Standard &kde; dialog to configure the shortcuts.</para></listitem> 0518 </varlistentry> 0519 </variablelist> 0520 <variablelist> 0521 <anchor id="settings-configure-toolbars" /> 0522 <varlistentry> 0523 <term><menuchoice> 0524 <guimenu>Settings</guimenu> 0525 <guimenuitem>Configure Toolbars...</guimenuitem> 0526 </menuchoice></term> 0527 <listitem><para>The standard &kde; dialog for configuring the toolbars.</para></listitem> 0528 </varlistentry> 0529 </variablelist> 0530 </sect2> 0531 0532 <sect2 id="the-help-menu"> 0533 <title>The Help Menu</title> 0534 <para>&kturtle; has a default &kde; <guimenu>Help</guimenu> menu as described in the 0535 <ulink url="help:/fundamentals/menus.html#menus-help">&kde; Fundamentals</ulink> 0536 with one additional entry:</para> 0537 <variablelist> 0538 <anchor id="help-context-help" /> 0539 <varlistentry> 0540 <term><menuchoice> 0541 <shortcut> 0542 <keycombo><keysym>F2</keysym></keycombo> 0543 </shortcut> 0544 <guimenu>Help</guimenu> 0545 <guimenuitem>Help on: ...</guimenuitem> 0546 </menuchoice></term> 0547 <listitem><para>This is a very useful function: it provides help on the code where the cursor in the editor is at. So, ⪚, you have used the <userinput>print</userinput> command in your code, and you want to read and to know what the handbook says on this command. You just move your cursor so it is in the <userinput>print</userinput> command and you press <keysym>F2</keysym>. The handbook will then show all info on the <userinput>print</userinput> command.</para> 0548 <para>This function can prove to be useful while learning &turtlescript;.</para></listitem> 0549 </varlistentry> 0550 </variablelist> 0551 </sect2> 0552 0553 </sect1> 0554 0555 0556 <sect1 id="the-statusbar"> 0557 <title>The Statusbar</title> 0558 <para>On the status bar you get feedback of the state of &kturtle;. On the left side it shows the feedback on the last action. On the right side you find the current location of the cursor (line and column numbers). In the middle of the status bar is indicated the current language used for the commands.</para> 0559 </sect1> 0560 0561 </chapter>