[rkward-cvs] SF.net SVN: rkward: [1096] trunk/rkward/rkward/pages

Mon Jan 8 16:09:10 UTC 2007

Revision: 1096
          http://svn.sourceforge.net/rkward/?rev=1096&view=rev
Author:   tfry
Date:     2007-01-08 08:09:10 -0800 (Mon, 08 Jan 2007)

Log Message:
-----------
More help content

Modified Paths:
--------------
    trunk/rkward/rkward/pages/Makefile.am
    trunk/rkward/rkward/pages/rkward_welcome.rkh

Added Paths:
-----------
    trunk/rkward/rkward/pages/rkward_for_new_users.rkh
    trunk/rkward/rkward/pages/rkward_for_r_users.rkh

Modified: trunk/rkward/rkward/pages/Makefile.am
===================================================================

--- trunk/rkward/rkward/pages/Makefile.am	2007-01-08 14:47:42 UTC (rev 1095)
+++ trunk/rkward/rkward/pages/Makefile.am	2007-01-08 16:09:10 UTC (rev 1096)
@@ -1,4 +1,6 @@
 pagesdir = $(kde_datadir)/rkward/pages
 dist_pages_DATA = \
-	rkward_welcome.rkh
+	rkward_welcome.rkh \
+	rkward_for_new_users.rkh \
+	rkward_for_r_users.rkh
 

Added: trunk/rkward/rkward/pages/rkward_for_new_users.rkh
===================================================================
--- trunk/rkward/rkward/pages/rkward_for_new_users.rkh	                        (rev 0)
+++ trunk/rkward/rkward/pages/rkward_for_new_users.rkh	2007-01-08 16:09:10 UTC (rev 1096)
@@ -0,0 +1,11 @@
+<!DOCTYPE rkhelp>
+<document>
+	<title>RKWard for new Users</title>
+	<summary>
+	This page has not yet been written. Therefore, you may want to refer to <link href="rkward://pages/rkward_for_r_users"/> instead, for now.
+	</summary>
+
+	<related>
+		<link href="rkward://page/rkward_for_r_users"/>
+	</related>
+</document>

Added: trunk/rkward/rkward/pages/rkward_for_r_users.rkh
===================================================================
--- trunk/rkward/rkward/pages/rkward_for_r_users.rkh	                        (rev 0)
+++ trunk/rkward/rkward/pages/rkward_for_r_users.rkh	2007-01-08 16:09:10 UTC (rev 1096)
@@ -0,0 +1,58 @@
+<!DOCTYPE rkhelp>
+<document>
+	<title>RKWard for R Users</title>
+	<summary>
+	Briefly explains the main components of RKWard, assuming the user is already familiar with basic concepts of R.
+	</summary>
+	<section title="The Console">
+	First things first: An emulation of the standard R console can be found at the bottom on the screen. There you will notice several buttons, one of which is labelled "R Console" and has a console icon.
+
+	This console works almost exactly like the regular R text console, so you can start working right away. Differences include:
+
+	<ul>
+		<li>Syntax highlighting</li>
+		<li>Pressing the Tab key will not complete local file paths (at the moment), but the names of R symbols and functions</li>
+		<li>While typing function calls, a list of arguments to that function is shown in a box (argument hinting)</li>
+		<li>While the cursor is on an R symbol or function, pressing F2 will search the R help for that symbol. Also available from the Help menu, or the right mouse button menu</li>
+	</ul>
+	</section>
+	<section title="Script Editors">
+	Often it is more conventient to write scripts in a separate file, instead of typing them directly in the console. To open a new script editor (with syntax highlighting, and many more features), chose File->New->Script File, or open an already existing Script file using File->Open R Script File.
+
+	You will note that the editor opens in a new window in the main workplace (the area of the window, that you are most likely reading this text, in). You can open any number of Script editor windows at the same time.
+
+	To run the code in a script editor window, either copy and paste it to the console, or chose one of the actions in the Run menu. such as Run All or Run Selection. Note: The contents of the menus may change according to the type of active window. Hence, if you look at the Run menu while reading this, there will be no entries.
+	</section>
+	<section title="Workspace View">
+	RKWard comes with a "workspace view" or "object browser". By default this is available by clicking on "Workspace" on the left side of the application window. This allows you to examine and manipulate all objects in the R workspace. In case you are not familiar with this aspect of R (usually not directly visible): All the symbols you create are children of the so-called ".GlobalEnv" environment. Symbols defined in loaded libraries are located in their own environments.
+
+	The object browser provides function to select with types of object are shown (on the top). Hovering the mouse over an item will show some additional information on the symbol. Right-clicking on an item will show available actions.
+	</section>
+	<section title="R Help">
+	By default R help pages are shown as HTML, inside RKWard. You can invoke the help in the usual way by running e.g. "?print" or "help (print)" or "help.start ()" in the console. Additionally, there is a tool window to search your installed R help pages. This is accessible using a button located at the bottom of the window (next to the console button). To view a help page found using this tool, double click on it.
+	</section>
+	<section title="Managing installed and loaded Libraries">
+	RKWard provides an advanced dialog to have installation, updating, and loading of packages. This is available from Workspace->Configure Packages.
+	</section>
+	<section title="Window management">
+	All windows shown in the main view area can be detached to a separate top level window using Windows->Detach. Similarily, detached windows can be attached to the main workplace using Window->Attach.
+
+	Windows can be closed using Windows->Close (Ctrl+W by default).
+
+	Tool windows (e.g. the R Console) can be detached and re-attached using the arrow-icon in their window border.
+	</section>
+	<section title="Editing data">
+	RKWard provides a buit-in editor for data.frames. In fact, you can edit many data.frames at the same time, and even while running lengthy calculations. Still the data is stored as a regular data.frame in R. To explore the data editor, either chose File->New->Dataset, or right click a data.frame in the Workspace browser, and chose Edit from the menu.
+
+	Support for adding other types of data, esp. single vectors is planned, but not currently supported.
+	</section>
+	<section title="Everything else">
+	You will notice that RKWard provides a lot of further menu options. These provide access to functionality in R. In fact, they do so by generating R syntax from settings made in a graphical dialog. For instance, select Analysis->Descriptive Statistics. You will notice a small window at the bottom (can be toggled on or off using the "Code" button) that contains the R code needed to generate these statistics. This way, even if you prefer to script your code by hand, you can use dialogs to gain snippets of code for functions you are less familiar with in R.
+
+	Also, all commands that are executed get shown in the Command Log, available as a tool window next to the R Console.
+	</section>
+
+	<related>
+		<link href="rkward://page/rkward_for_new_users"/>
+	</related>
+</document>

Modified: trunk/rkward/rkward/pages/rkward_welcome.rkh
===================================================================
--- trunk/rkward/rkward/pages/rkward_welcome.rkh	2007-01-08 14:47:42 UTC (rev 1095)
+++ trunk/rkward/rkward/pages/rkward_welcome.rkh	2007-01-08 16:09:10 UTC (rev 1096)
@@ -9,8 +9,16 @@
 	</summary>
 
 	<section title="Introduction to RKWard">
+	RKWard is a GUI frontend and IDE to <link href="http://www.r-project.org">R</link>, a powerful scripting language for statistical computing. It aims to provide useful features both to experienced users of R, wishing to exploit R's scripting capabilities, as well as to users new to R, looking for an easy way to do carry out statistical computation tasks.
 	</section>
 
 	<section title="Getting Started">
+	Due to the large differences in prior knowledge of R, we provide two different guides for getting started with RKWard. The first is aimed at users with some knowledge of the R language, and focuses on introducing the IDE features of RKWard: <link href="rkward://page/rkward_for_r_users" />.
+
+	The second gives a more hands on introduction to getting started with RKWard, but does not go quite as deep. If you have never users R or RKWard before, you should start with this guide, then later read the page linked to above: <link href="rkward://page/rkward_for_new_users" />.
 	</section>
+
+	<section title="General Information">
+	For more general information on RKWard, who writes it, how to help, further questions, etc. refer to <link href="http://rkward.sourceforge.net/">the project homepage</link>.
+	</section>
 </document>


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.


