
diff -r 9c86935835a4 -r 2c40ff8ca7ba tex/vym.tex
--- a/tex/vym.tex	Wed May 02 15:31:20 2007 +0000
+++ b/tex/vym.tex	Wed May 30 15:23:07 2007 +0000
@@ -4,11 +4,7 @@
 \usepackage{verbatim}
 \usepackage{hyperref}
 \usepackage{graphicx}
-\usepackage{longtable}
-
-
-%\input{udmath}
-
+%\usepackage{longtable}
 
 \hypersetup{bookmarks, bookmarksopen,
   pdftitle={VYM - a tool for visual thinking },
@@ -34,7 +30,7 @@
 \title{
 	\includegraphics[width=8cm]{images/vym-logo-new.png}
 	\\
-VYM \\ -- \\View Your Mind\\ {\small Version 1.8.71}}
+VYM \\ -- \\View Your Mind\\ {\small Version 1.9.0}}
 \author{\textcopyright Uwe Drechsel  }
 
 
@@ -148,10 +144,22 @@
 
 \section{The Concept of the \vym application}
 %TODO may add a general introduction here...
-\subsection{Windows: Mapeditor, Noteeditor, and more}
-\vym uses two windows in the main: an editor for the map itself and another one for
-notes asociated with the branches, which are part of the map. Let's call them {\em mapeditor} and {\em noteeditor}: 
-
+\subsection{The Mainwindow and its satellites} \label{satellite}
+\vym comes with several windows, the central one being the {\em
+mapeditor}.
+More windows, each having a special purpose, can be opened and arranged
+around the mainwindow\footnote{
+	The advantage of having separate window instead of integrating them
+	in a combined workspace is flexibility in arranging the windows. For
+	example I usually have the {\em noteeditor} "behind" the {\em
+	mapeditor}. On Linux my windowmanager (KDE) allows me to enter text
+	into a small visible corner of the {\em noteeditor} withour clicking
+	the mouse button in it. I just push the mouse around to set the
+	window focus, a concept which is useful also working with 
+	\href{http://www.gimp.org}{http://www.gimp.org}.
+}. 
+The image below shows the {\em mapeditor}
+together with the often used {\em noteeditor}: 
 \begin{center}
 	\includegraphics[width=8cm]{images/windows.png}
 \end{center}
@@ -162,9 +170,13 @@
 type or copy\&paste it into the {\em noteeditor}. Working with notes is
 explained in \ref{noteeditor}
  
-A third window which can be toggled on or off is the {\em history
-window}. It can be used to see the latest actions performed on a map and
-also to undo and redo actions. Details are in \ref{historywindow}.
+Here is a list of the available satellite windows:
+\begin{itemize}
+	\item Noteeditor (see \ref {noteeditor})
+	\item Historywindow (see \ref{historywindow})
+	\item Branch Property Window (see \ref{propwindow})
+\end{itemize}
+
 
 \subsection{Menus and Context menus}
 At the top of each window you will find the menubar. The options provided there
@@ -175,15 +187,16 @@
 
 \subsection{Toolbars}
 The toolbars in the mainwindows give quick access to many functions and
-also display the state of a branch. For example a part of of the map
-can be hidden when the map is exported into an Open~Office presentation.
-To show this the branch in the map will show a little cloud symbol,
-which is also "switched on" in the toolbar.
+also display the state of selected objects in the map. For example a
+branch may show certain {\em flags}, the corresponding flags are also
+set in the toolbar. 
 
-Note that you can reposition all toolbars by simply grabbing and draging them to a new position. For example you can move the flags-toolbar from its original horizontal
-position on top of the mapeditor to a vertical position on the right
-side. You can even detach it and make it "float" separate from the other
-windows. Or just insert it again at its original position.
+Note that you can reposition all toolbars by simply grabbing and
+dragging them with the toolbar handle to a new position. For example you
+can move the flags-toolbar from its original horizontal position on top
+of the mapeditor to a vertical position on the right side.  Or just
+insert it again at its original position. Also hiding some of the
+toolbars is possible by right-clicking on the toolbar handle.
 
 \subsection{Maps}
 The  {\em map} itself has always a {\em mapcenter}.  The
@@ -213,9 +226,6 @@
 "thumb-up" flag is set, then the "thumb down" is reset and vice
 versa. You can change this default behaviour in the settings menu.
 
-%TODO add info about toolbars e.g. undo/redo, ...
-%TODO or reference to advanced editing undo/redo
-
 \section{Mapeditor} \label {mapeditor}
 \subsection{Start a new map}
 After \vym is started two windows will open: the {\em mapeditor} and the {\em noteditor}. Usually you will work in both windows, but at the moment we
@@ -236,8 +246,8 @@
 Sometimes it comes in handy to be able to add a new branch above or below the current
 one. 
 \begin{itemize}
-	\item Use \key{Shift} \together with \key{Ins} to add a branch above the selected one or... 
-	\item \key{Ctrl} \together with \key{Ins} to add one below. 
+	\item Use \key{Shift-Ins} to add a branch above the selected one or... 
+	\item \key{Ctrl-Ins} to add one below. 
 \end{itemize}
 It is also
 possible to add a branch in such a way, that the current selection
@@ -366,7 +376,7 @@
 	\item use the menu and choose e.g Format \ra Set Color
 	\item use the toolbar
 		\begin{center}
-			\includegraphics[width=3cm]{images/colour-buttons.png}
+			\includegraphics[width=3cm]{images/color-buttons.png}
 		\end{center}	
 \end{itemize}
 The first button (black in the graphic above) shows the current colour.
@@ -408,7 +418,7 @@
 webbrowser to the mapeditor while a branch is selected there.
 
 You can also add an image to a branch by opening the context menu of the
-branch. Right click the selected branch, choose "Add" then "Add Image". A
+branch. Right click the selected branch, choose "Add Image". A
 dialog window enables you choose the image to load. 
 \footnote{Supported image types are: PNG, BMP, XBM, XPM and PNM. It may
 	also support JPEG, MNG and GIF, if specially configured during
@@ -442,17 +452,16 @@
 changing its z-value (put it into background) etc.
 
 \subsubsection*{Frames}
-A frame can be added to a branch by clicking with the
-right-mouse button.  A context menu will open, where you can choose the
-frame. At the moment just a rectangle is offered. "No Frame" will be offered as the default for branches,
-nevertheless you can use images as frames. Have a look at the demo map
-{\tt todo.vym} as an example, where the mapcenter is a cloud. You can
-use an external drawing program like {\tt gimp} to create an image,
+A frame can be added to a branch in the {\em property window} (see
+\ref{propwindow}). 
+Alternatively, you can use use images as frames. Have a look at the demo
+map {\tt todo.vym} as an example, where the mapcenter is a cloud. You
+can use an external drawing program like {\tt gimp} to create an image,
 preferable with an transparency channel, so that you can design frames
-which don't use a rectangular borderline, just like the cloud.
+which don't use a rectangular borderline, just like that cloud.
 
 
-\subsection{Background design}
+\subsection{Design of map background and connecting links }
 The design of the background of a map and also of the links connecting
 various parts of the map can be changed by
 \begin{itemize}
@@ -460,8 +469,11 @@
 	\item Right clicking on the canvas, which will open a context menu
 \end{itemize}
 
-\subsubsection*{Background colour}
+\subsubsection*{Background }
 The colour is set (and also displayed) as "Set background colour".
+Alternatevily you can set an background image, though this is not
+recommended in general. Working on the map becomes slow and the image
+currently cannot be positioned freely.
 
 \subsubsection*{Link colour}
 Links connecting branches can be coloured in one of two ways:
@@ -514,6 +526,11 @@
 For more information on working with bookmarks and webbrowsers see
 section \ref{bookmarks}.
 
+In the context menu there is also an option to open all URLs found
+in the selected subtree of the map. That's useful to simultanously open
+a collection of URLs in the webbrowser, especially if the browser can
+open them in tabs (like Konqueror).
+
 
 \subsubsection*{\vym map}
 To link to to another map right click on a branch and choose "Edit \vym link". A file dialog opens where you can choose the map. A
@@ -524,6 +541,10 @@
 Clicking this flag beside the branch heading, in the toolbar or in the context menu of a branch will open the map in another tab (see \ref{tabs} for working with
 multiple maps). To delete an existing link, just right click the branch and select "Delete \vym link".
 
+In the context menu there is also an option to open all vymlinks found
+in the selected subtree of the map. That's useful to simultanously open
+a collection of related maps.
+
 Technical note: Internally \vym uses absolute paths, to avoid opening
 several tabs containing the same map. When a map is saved, this path is
 converted to a relative one (e.g. {\tt /home/user/vym.map} might become
@@ -584,11 +605,6 @@
 functions. You can delete the complete note by clicking the
 trashcan. Only the note itself is printed by clicking the printer icon.
 
-When pasting into the editor using the X11 copy\&paste mechanism, the
-editor will create a paragraph for each new line. Usually this is not
-wanted, so there you can convert all paragraphs into linebreaks by using
-Edit~\ra~Remove~Paragraphs or \key{ALT-X}.
-
 \subsection{RichText: Colours, paragraphs and formatted text}
 \vym supports formatted text (QT Rich Text) in the noteeditor since
 version 1.4.7.  Colours and text attributes (e.g. italic, bold) can be
@@ -599,7 +615,7 @@
 
 \subsection{Fonts and how to switch them quickly}
 The noteeditor is designed to be used for simple notes, not really as a full
-featured word processor. Because of many requests \vym now supports 
+featured word processor. Because of many requests \vym supports 
 formatted text in the noteeditor\footnote{
 	\vym uses the QRichtText format, which is basically a subset of the
 	formatting provided in HTML.}
@@ -627,6 +643,7 @@
 an email. Normally \vym will generate a new paragraph for each new line.
 This usually is not what you want, so you can choose from the menu
 
+
 \section{Hello world}
 This section is about how \vym can interact with other applications.
 Many applications can now read and write their data using XML, the
@@ -791,8 +808,35 @@
 
 \section{Advanced Editing}
 
+\subsection{Properties of an object} 
+For any branch you can open a satellite window (see \ref{satellite}):
+the {\em property window}:
+\begin{center}
+	\includegraphics[width=8cm]{images/propwindow.png}
+	\label{propwindow}
+\end{center}
+%FIXME create screenshot
+%FIXME explain the tabs
+
+\begin{itemize}
+	\item Frame
+	\item Link (see \ref{hideunselected})
+	\item Layout (see \ref{incimg})
+\end{itemize}
+
 \subsection{Changing the history: Undo and Redo}
-%FIXME
+\vym keeps track of all changes done in a map. The default number of
+changes which can be undone is~75. The complete history can be seen in
+the {\em historywindow}:
+\begin{center}
+	\includegraphics[width=8cm]{images/historywindow.png}
+	\label{historywindow}
+\end{center}
+A single step back be undone or redone with \key{CTRL-Z} or \key{CTRL-Y},
+or by using the buttons in the toolbar or the {\em historywindow}.
+Inside the {\em historywindow}, you can click on a line to unwind all
+actions done until that point in time -- or redo all changes by clicking
+on the last line.
 
 \subsection{Macros} \label{macros}
 Macros have been added to \vym in version~1.9.0. Each function key
@@ -807,7 +851,7 @@
 Settings menu. More information on using scripts in \vym is found in
 appendix~\ref{scripts}.
 
-\subsection{How to deal with Bookmarks} \label{bookmarks}
+\subsection{Bookmarks} \label{bookmarks}
 \subsubsection*{Open new tabs instead of new windows}
 If you use konqueror as your browser, \vym will remember the konqueror session which
 was opened first by \vym. You can also press \key{Ctrl} and click to
@@ -837,13 +881,13 @@
 \end{itemize}
 The URL will be build from the number in the heading.
 
-\subsection{Associating images with a branch} 
+\subsection{Associating images with a branch} \label{incimg}
 The default setting for an image is for it to float "freely". Images can be
 positioned anywhere on the canvas, but may end up in the same place as other
 parts of the map obscuring that part of the map.
 
 The solution is to insert or include them "into" a branch. This can be done via
-the context menu of their parent branch:
+the property window (see \ref{propwindow}):
 \begin{itemize}
 	\item Include images horizontally
 	\item Include images vertically
@@ -857,9 +901,10 @@
 \subsection{Modifier Modes} 
 Modifiers are for example the \key{Shift}- the \key{Ctrl}- ot the \key{Alt}-keys. When
 pressed while applying mouse actions, they will cause \vym to use
-a "modified" action. e.g. you can move branches with the mouse. If
-\key{Ctrl} or \key{Alt}is pressed while releasing the branch, it will be
-added above/below the target, not as child of the target.
+a "modified" version of the action which usually would be done. 
+
+%\key{Ctrl} or \key{Alt}is pressed while releasing the branch, it will be
+%added above/below the target, not as child of the target.
 
 Without a modifier key pressed, the first mouse click on a branch just selects
 it. For the behaviour of the \key{Ctrl} modifier there are several
@@ -867,13 +912,14 @@
 \begin{center}
 	\includegraphics[width=3cm]{images/modmodes.png}
 \end{center}
-The default is to copy the colour from the clicked branch to the already
-selected branch. In the toolbar shown above the default modifier is
-selected, namely to copy the colour of a branch. The second modifier
+The default mode is to copy the colour from the clicked branch to the already
+selected branch. The figure above shows the toolbar with the default modifier 
+selected. The second modifier
 let's you easily copy a whole branch with a single click. The third
-modifier lets you create links between branches called {\em xLinks}. They will be explained in the next section.
+modifier lets you create links between branches called {\em xLinks}.
+They will be explained in the next section \ref{xlinks}.
 
-\subsection{Hide links of unselected objects}
+\subsection{Hide links of unselected objects} \label{hidelink}
 Sometimes it would be useful to position a branch freely, just like a
 mainbranch or an image. This is possible for all
 branches, you can use a mainbranch and hide its connecting link to the
@@ -882,8 +928,9 @@
 \begin{center}
 	\includegraphics[width=9cm]{images/hiddenlink.png}
 \end{center}
-To hide the link between a branch and its parent open the context
-menu (Right Click) and check Hide link if object is not selected.
+To hide the link between a branch and its parent open the
+\ref{propwindow} and check "Hide link if object is not selected" on
+"Link" tab.
 
 
 \subsection{XLinks} \label{xlinks}
@@ -906,11 +953,17 @@
 link should start and drag the mouse pointer to the branch where the link is to end. (The link is drawn to follow the mouse pointer). When you release the mouse over a branch the xLink becomes permanent.
 
 \subsubsection*{Modify or delete a xLink}
-First select a branch at either end of the xLink. Then open the context menu and select \lq Edit xLink\rq. A submenu contains all the xLinks of the branch (if there are any). They are named like the branches, where they end. Choose one and the xLink dialogue opens, where you can set colour, width and also delete the xLink.
+First select a branch at either end of the xLink. Then open the context
+menu and select \lq Edit xLink\rq. A submenu contains all the xLinks of
+the branch (if there are any). They are named like the branches, where
+they end. Choose one and the xLink dialogue opens, where you can set
+colour, width and also delete the xLink.
 
 \subsubsection*{Follow a xLink}
 In a complex \vym map it sometimes comes in handy to be able to jump to the other end
-of a xLink. You can do this by opening the context menu of the branch and clicking on \lq Goto xLink\rq and selecting the xLink you want to follow.
+of a xLink. You can do this by opening the context menu of the branch
+and clicking on \lq Goto xLink\rq and selecting the xLink you want to
+follow.
 
 
 
@@ -922,10 +975,11 @@
 shortcuts also have a look at the context menu.
 
 \subsection{Adding a whole map or a part of a map}
-Select a branch where you want to add a previously saved map ({\tt .vym})or a part
-of a map ({\tt .vyp}) , then open the context menu and choose {\em Add \ra Add Map (Insert)}. For the import you can choose between {\em Add Map (Insert)} and {\em Add Map (Replace)}: The imported data will be added after the selected branch.
-
-\label{historywindow}
+Select a branch where you want to add a previously saved map ({\tt
+.vym})or a part of a map ({\tt .vyp}) , then open the context menu and
+choose {\em Add \ra Add Map (Insert)}. For the import you can choose
+between {\em Add Map (Insert)} and {\em Add Map (Replace)}: The imported
+data will be added after the selected branch.
 
 \section{\vym on Mac OS X}
 \subsection{Overview}
@@ -992,7 +1046,7 @@
 \begin{center}
 \begin{tabular}{cccp{8cm}}\\ 
 \bf Option	& \bf Comment & \bf Argument & \bf Description \\ \hline
-v & version &			& Show version ov \vym\\
+v & version &			& Show version and codename of \vym\\
 l & local	&			& Use local paths to stylesheets, translations, icons, 
                           etc. instead of system paths. Useful for testing\\
 h & help	&			& Show help\\




