
diff -r a3caa8bed260 -r 7debc44bf95e tex/vym.tex
--- a/tex/vym.tex	Thu May 17 20:19:07 2007 +0000
+++ b/tex/vym.tex	Tue Jun 19 14:20:29 2007 +0000
@@ -1,11 +1,44 @@
-\documentclass{article}
-\usepackage{a4}
-\usepackage[latin1]{inputenc}
+\documentclass[12pt,a4paper]{article}
+\usepackage[utf8]{inputenc}
 \usepackage{verbatim}
 \usepackage{hyperref}
 \usepackage{graphicx}
 %\usepackage{longtable}
 
+\setlength{\headheight}{0cm}
+\setlength{\headsep}{0cm}
+\setlength{\topskip}{0cm}
+\setlength{\topmargin}{-0.5cm}
+
+\setlength{\parskip}{1.5ex}
+\setlength{\parindent}{0cm}
+\setlength{\oddsidemargin}{0cm}
+\setlength{\textwidth}{16cm}
+\setlength{\textheight}{27cm}
+
+\newlength{\maximgwidth}
+\setlength{\maximgwidth}{14cm}
+\newcommand{\maximage}[1]{	
+	\begin{center}
+		\includegraphics[width=\maximgwidth]{#1} 
+	\end{center}
+}
+\newcommand{\hint}[1]{
+	\begin{center}
+		\begin{tabular}{|rp{12cm}|} \hline
+			
+			{\bf Hint}:& #1\\	\hline
+		\end{tabular}
+	\end{center}
+}
+
+\newcommand{\vym}{{\sc vym }}
+\newcommand{\ra}{$\longrightarrow$}
+\newcommand{\la}{$\longleftarrow$}
+\newcommand{\ua}{$\uparrow$}
+\newcommand{\da}{$\downarrow$}
+\newcommand{\key}[1]{[#1]}
+
 \hypersetup{bookmarks, bookmarksopen,
   pdftitle={VYM - a tool for visual thinking },
   pdfauthor={Uwe Drechsel},    
@@ -19,13 +52,6 @@
   citecolor={red}} 
 
 
-\newcommand{\vym}{{\sc vym }}
-\newcommand{\ra}{$\longrightarrow$}
-\newcommand{\la}{$\longleftarrow$}
-\newcommand{\ua}{$\uparrow$}
-\newcommand{\da}{$\downarrow$}
-\newcommand{\key}[1]{[#1]}
-
 \begin{document}
 \title{
 	\includegraphics[width=8cm]{images/vym-logo-new.png}
@@ -45,9 +71,7 @@
 \section{Introduction}
 \subsection{What is a \vym map?}
 A \vym map (abbreviated below as {\em map}) is a tree like structure:
-\begin{center}
-	\includegraphics[width=12cm]{images/example1.png}
-\end{center}
+\maximage{images/example1.png}
 Such maps can be drawn by hand on a sheet of paper or flip chart and help to
 structure your thoughts. While a tree like structure like the illustration above can be
 drawn manually \vym offers much more features to work with such maps.
@@ -57,7 +81,11 @@
 email by a simple mouse click.
 
 Once you have finished collecting and organising your ideas, you can
-easily generate a variety of outputs including for example a presentation in Open~Office based on a {\em map}.
+easily generate a variety of outputs including for example a
+presentation in Open~Office based on a {\em map}.
+
+\hint{You find the map shown above and others by clicking \begin{center}Help \ra Open vym
+examples\end{center} in the menu bar.}
 
 \subsection{Why should I use {\em maps}? Time, Space and your Brain.}
 \subsubsection*{Space}
@@ -160,9 +188,7 @@
 }. 
 The image below shows the {\em mapeditor}
 together with the often used {\em noteeditor}: 
-\begin{center}
-	\includegraphics[width=8cm]{images/windows.png}
-\end{center}
+\maximage{images/windows.png}
 Most of the time you will work in the {\em mapeditor} by just adding new
 branches, moving around and reordering them. The various ways to do this
 will be explained in \ref{mapeditor}. You can store additional
@@ -191,19 +217,18 @@
 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
+\hint {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.
+toolbars is possible by right-clicking on the toolbar handle.}
 
 \subsection{Maps}
 The  {\em map} itself has always a {\em mapcenter}.  The
-mapcenter has {\em branches} radiating out from the centre just like the trunk of a tree. Each branch in turn may have branches again.
-\begin{center}
-	\includegraphics[width=10cm]{images/branches.png}
-\end{center}
+mapcenter has {\em branches} radiating out from the centre just like the trunk 
+of a tree. Each branch in turn may have branches again.
+	\maximage{images/branches.png}
 We will call a branch directly connected to the mapcenter a {\em
 mainbranch}, because it determines the position of all its child
 branches.
@@ -214,9 +239,7 @@
 
 
 In the toolbar above the mapeditor you see various symbols.
-\begin{center}
-	\includegraphics[width=8cm]{images/default-flags.png}
-\end{center}
+	\maximage{images/default-flags.png}
 These are called {\em flags} and can be used to mark branches in the
 {\em map}, e.g. if something is important or questionable. 
 There are also more flags set by \vym automatically to show additional
@@ -246,14 +269,17 @@
 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-Ins} to add a branch above the selected one or... 
-	\item \key{Ctrl-Ins} to add one below. 
+	\item Use \key{Shift-A} to add a branch above the selected one or... 
+	\item \key{Ctrl-A} to add one below. 
 \end{itemize}
 It is also
 possible to add a branch in such a way, that the current selection
 becomes the child of the new branch, which is like inserting it {\em
 before} the selection. This can be done using the context menu.
 
+\hint{To delete a branch press \key{CTRL-X}. If enabled in the Settings
+menu, you can also use the \key{Del} key.}
+
 \subsection{Navigate through a map}
 \subsubsection*{Select branches}
 To select branches you can use the left button of your mouse or also the
@@ -400,9 +426,7 @@
 mapeditor window. (Note: Like all toolbars you can also move them to the
 left or the right side of the window or even detach them. Just grab the
 very left "dotted" part of the toolbar with your left-mouse button.) 
-\begin{center}
-	\includegraphics[width=8cm]{images/default-flags.png}
-\end{center}
+	\maximage{images/default-flags.png}
 If you have a branch selected, you can set any number of flags by
 clicking them in the toolbar. The toolbar buttons change their state and
 always reflect the flags set in the selected branch. So, to remove a flag from a branch, select the branch and then click the highlighted flag on the toolbar.
@@ -574,9 +598,7 @@
 If you want to attach more text to a branch e.g. a complete email, a
 cooking recipe, or the whole source code of a software project, you can
 use the noteeditor. 
-\begin{center}
-	\includegraphics[width=8cm]{images/noteeditor.png}
-\end{center}
+	\maximage{images/noteeditor.png}
 This editor displays text associated with a branch selected in the mapeditor. The noteeditor
 shows different background colours depending on whether text is associated with a selected branch.
 
@@ -591,9 +613,7 @@
 In the mapeditor itself, to signal that there is a note with more
 information for a particular branch, a little "note" flag will appear next
 to the heading of the branch. This is illustrated in the lower branch on the right hand side:
-\begin{center}
-	\includegraphics[width=8cm]{images/branches-flags.png}
-\end{center}
+	\maximage{images/branches-flags.png}
 
 \subsection{Import and export notes}
 The note is always saved automatically within the \vym map itself.
@@ -705,9 +725,7 @@
 \end{itemize}
 you get a file dialogue where you can choose the output file and the
 file type:
-\begin{center}
-	\includegraphics[width=12cm]{images/export-oo.png}
-\end{center}
+	\maximage{images/export-oo.png}
 The file types represent various templates, which can be created with
 some manual work from an existing Open Office document. The structure of
 \vym map is then inserted into a template. 
@@ -828,16 +846,23 @@
 \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}
+	\maximage{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.
 
+\hint{
+	You can "paste from the past": Go back in time by e.g. with
+	\key{CTRL-Z}, then copy to clipboard by pressing \key{CTRL-C}.
+
+	Now do all actions again, e.g. by \key{CTRL-Y} or clicking on the
+	last action in {\em historywindow}. Now paste from the past with
+	\key{CTRL-V}.
+}
+
 \subsection{Macros} \label{macros}
 Macros have been added to \vym in version~1.9.0. Each function key
 \key{F1} to \key{F12} holds a macro, which is executed on the current
@@ -894,9 +919,7 @@
 \end{itemize}
 The image is still positioned relative to its parent branch, but the
 heading and border of the branch frame adapt to the floating image, see below: 
-\begin{center}
-	\includegraphics[width=11cm]{images/includeImages.png}
-\end{center}
+	\maximage{images/includeImages.png}
 
 \subsection{Modifier Modes} 
 Modifiers are for example the \key{Shift}- the \key{Ctrl}- ot the \key{Alt}-keys. When
@@ -939,9 +962,7 @@
 branches in a real tree. This is especially useful in complex maps,
 where you want to have crossreferences which can not be displayed on the same
 visible area of the {\em mapeditor} window. The following example map still fits on one screen, but shows how data can be crosslinked. In the graphics there is a link from a task (prepare a presentation) to general information:
-\begin{center}
-	\includegraphics[width=12cm]{images/xlink.png}
-\end{center}
+	\maximage{images/xlink.png}
 Note that a xLink which points to a branch that is not visible (because
 it is scrolled), is just shown as a little horizontal arrow. In the
 screenshot above have a look at the \lq Tuesday\rq\ branch.
@@ -987,8 +1008,7 @@
 \subsubsection*{QT Mac Edition:}
 	\vym here provides the well known Mac look and feel.  \vym is
 	available as zipped Mac OS X application. It has been compiled and
-	tested in Mac~OS~10.3, but should also work on Tiger. It is using
-	the Mac version of Trolltechs QT library.  
+	tested in Mac~OS~10.4. It is using the Mac version of Trolltechs QT library.  
 \subsubsection*{X11}
 	\vym can also be run using the Linux version, but then menus and
 	handling will also be those of the Linux version e.g. The menu bar




