+ documented blocks, search, and the browser

docs/fpc.sty

@@ -144,6 +144,7 @@
 %
 \newcommand{\var}[1]{\texttt {#1}}
 \newcommand{\file}[1]{\textsf {#1}}
+\newcommand{\key}[1]{\textsc{#1}}
 %
 % Useful references.
 %

docs/ide.tex

@@ -47,7 +47,7 @@ at the command line. It can also be started from a graphical user
 interface such as \windows. 
 \begin{remark}
 Under \windows, it is possible to switch between windowed mode and 
-full screen mode by pressing \textsc{Alt-Enter}).
+full screen mode by pressing \key{Alt-Enter}).
 \end{remark}
 %
 % IDE command-line options.
@@ -116,7 +116,7 @@ at the right edge of the menu, a clock is displayed.
 
 The IDE can be left by selecting \var{File|Exit} in the menu
 \footnote{\var{File|Exit} means select the item Exit in the menu File}
-or by pressing \textsc{Alt-X}.
+or by pressing \key{Alt-X}.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 % Navigating in the IDE
@@ -130,8 +130,8 @@ All functionality of the IDE is available through use of the keyboard.
 \item It is used for typing and navigating through the sources.
 \item Editing commands such as copying and pasting text.
 \item Moving and resizing windows.
-\item It can be used to access the menu, by pressing \textsc{ALT} and the
-appropriate highlighted menu letter, or by pressing \textsc{F10} and
+\item It can be used to access the menu, by pressing \key{ALT} and the
+appropriate highlighted menu letter, or by pressing \key{F10} and
 navigating through the menu with the arrow keys.
 
 more information on the menu can be found in \sees{idemenu}
@@ -150,7 +150,7 @@ IDE. The left button is used to select menu items, press buttons, select
 text blocks etc. 
 
 The right mouse button is used to access the local menu, if
-it is available. Holding down the \textsc{Ctrl} or \textsc{Alt} key and 
+it is available. Holding down the \key{Ctrl} or \key{Alt} key and 
 clicking the right button will execute user defined functions, 
 see \sees{prefmouse}.
 
@@ -212,14 +212,14 @@ At the top of the window 3 things are displayed:
 \item 
 At the upper left corner of the window, a \emph{close icon} is shown. 
 When clicked, the window will be closed. It can be also closed by
- pressing \textsc{Alt-F3} or selecting the menu item \var{Window|Close}. 
+ pressing \key{Alt-F3} or selecting the menu item \var{Window|Close}. 
 All open windows can be closed by selecting the menu item 
 \var{Window|Close all}.
 \item In the middle, the title of the window is displayed.
 \item At the upper right corner, a small green arrow is visible.
 Clicking this arrow zooms the window so it covers the whole desktop. 
 Clicking this arrow on a zoomed window will restore old size of the 
-window. Pressing the key \textsc{F5} has the same effect as clicking 
+window. Pressing the key \key{F5} has the same effect as clicking 
 that arrow. The same effect can be achieved with the menu item \var{Window|Zoom}.
 Windows and dialogs which aren't resizeable can't be zoomed, either.
 \end{itemize}
@@ -247,29 +247,29 @@ To move a window, either:
 \item using the mouse, click on the title bar and drag the window 
 with the mouse.
 \item using the keyboard, go into the size/move mode
-by pressing \textsc{Ctrl-F5} or selecting the menu item
+by pressing \key{Ctrl-F5} or selecting the menu item
 \var{Window|Size/Move}. . Using the cursor keys the window can be moved. 
-The size/move mode can be left by pressing \textsc{Enter}. 
+The size/move mode can be left by pressing \key{Enter}. 
 In this case, the window will keep its size and position. 
-Alternativly, pressing \textsc{Esc} will restore the old position.
+Alternativly, pressing \key{Esc} will restore the old position.
 \end{itemize} 
 To resize a window, either:
 \begin{itemize}
 \item using the mouse, click on the lower right corner of the window
 and drag it.
 \item using the keyboard, go into the size/move mode
-by pressing \textsc{Ctrl-F5} or selecting the menu item
+by pressing \key{Ctrl-F5} or selecting the menu item
 \var{Window|Size/Move}. The window frame will be green to indicate that
 the IDE is in size/move mode. 
 By pressing shift and the cursor keys simultaneously, the window can 
 be resized.  The size/move mode can be left by pressing
-\textsc{Enter}. In this case, the window will keep the new size.
-Pressing \textsc{Esc} will restore the old size.
+\key{Enter}. In this case, the window will keep the new size.
+Pressing \key{Esc} will restore the old size.
 \end{itemize}
 Not all windows can be resized. This applies, for example, to
 \emph{dialog windows} (\sees{dialogwindow}).
 
-A window can also be hidden. To hide a window, the \textsc{Ctrl-F6} key
+A window can also be hidden. To hide a window, the \key{Ctrl-F6} key
 combination can be used, or the \var{Window|Hide} menu may be selected.
 To restore a Hidden window, it is necessary to select it from the window
 list. More information about the window list can be found in the next
@@ -287,15 +287,15 @@ An inactive window is identified by a grey frame. An inactive window can
 be made active in one of several ways:
 \begin{itemize}
 \item using the mouse, activate a window by clicking on it.
-\item using the keyboard, pressing \textsc{F6} will step trough all open 
-windows. To activate the previously activated window, \textsc{Shift-F6} can
+\item using the keyboard, pressing \key{F6} will step trough all open 
+windows. To activate the previously activated window, \key{Shift-F6} can
 be used.
 \item the menu item \var{Window|Next} can be used to activate the next 
 window in the list of windows, while \var{Window|Previous} will select
 the previous window.
 \item If the window has a number in the upper right corner, it can be
-activated by pressing \textsc{Alt-<number>}.
-\item Pressing \textsc{Alt-0} will pop up a dialog with a lis  with all 
+activated by pressing \key{Alt-<number>}.
+\item Pressing \key{Alt-0} will pop up a dialog with a lis  with all 
 available windows which allows a quick activation of windows which 
 don't have a number.
 \end{itemize}
@@ -361,18 +361,18 @@ The menu can be accessed in a number of ways:
 \begin{enumerate}
 \item By using the mouse to select items. The mouse cursor should be located
 over the desired menu item, and a left mouse click will then select it.
-\item By pressing \textsc{F10}. This will switch the IDE focus to the menu. 
+\item By pressing \key{F10}. This will switch the IDE focus to the menu. 
 Use the arrow keys can then be used to navigate in the menu, the 
-\textsc{Enter} key should be used to select items.
-\item To access menu items directly, \textsc{Alt-<highlighted menu letter>}
+\key{Enter} key should be used to select items.
+\item To access menu items directly, \key{Alt-<highlighted menu letter>}
 can be used to select a menu item. Afterwards submenu entries can be selected 
-by pressing the highlighted letter, but without \textsc{Alt}. 
-E.g. \textsc{Alt-S G} is a fast way to display the \emph{goto line} dialog.
+by pressing the highlighted letter, but without \key{Alt}. 
+E.g. \key{Alt-S G} is a fast way to display the \emph{goto line} dialog.
 \end{enumerate}
 Every menu item is explained by a short text in the status bar.
 
 When a local menu is available, it can be accessed by pressing
-the right mouse button or \textsc{Alt-F10}. 
+the right mouse button or \key{Alt-F10}. 
 
 In the subsequent, all menu entries and their actions are described.
 %
@@ -384,9 +384,9 @@ In the subsequent, all menu entries and their actions are described.
 \item[New] Opens a new, empty editor window. 
 \item[New from template] Prompts for a template to be used, asks to fill in
 any parameters, and then starts a new editor window with the template.
-\item[Open] (\textsc{F3}) Presents a file selection dialog, and opens 
+\item[Open] (\key{F3}) Presents a file selection dialog, and opens 
 the selected file in a new editor window. 
-\item[Save] (\textsc{F2}) Saves the contents of the current edit window 
+\item[Save] (\key{F2}) Saves the contents of the current edit window 
 with the current filename. If the current edit window does not yet have
 a filename, a dialog is presented to enter a filename.
 \item[Save as] Presents a dialog in which a filename can be entered. The
@@ -396,7 +396,7 @@ filename is stored for further save actions.
 The current working directory is then changed to the selected directory.
 \item[Dos shell] executes a command shell. After the shell exited, the
 IDE resumes.
-\item[Exit] (\textsc{ALT-X}) Exits the IDE. If any unsaved files are 
+\item[Exit] (\key{ALT-X}) Exits the IDE. If any unsaved files are 
 in the editor, the IDE will ask if these files should be saved.
 \end{description}
 %
@@ -405,7 +405,7 @@ in the editor, the IDE will ask if these files should be saved.
 \subsection{The Edit menu}
 \label{se:menuedit}
 \begin{description}
-\item[Undo] (\textsc{ALT-BkSP})
+\item[Undo] (\key{ALT-BkSP})
 Undo the last editing action. The editing actions are stored in a buffer,
 selecting this mechanism will move backwards through this buffer, i.e.
 multiple undo levels are possible.
@@ -419,16 +419,16 @@ Undo all actions in the undo buffer. If a new empty file was started, this
 action should clear the window contents again.
 \item[Redo all]
 Redo all editing actions that were undone.
-\item[Cut] (\textsc{Shift-DEL}) Copy the current selection to the clipboard
+\item[Cut] (\key{Shift-DEL}) Copy the current selection to the clipboard
 and delete the selection from the text. Any previous clipboard contents is
 lost after this action. After this action, the clipboard contents can be 
 pasted elsewhere in the text.
-\item[Copy] (\textsc{Ctrl-INS}) Copy the current selection to the clipboard.
+\item[Copy] (\key{Ctrl-INS}) Copy the current selection to the clipboard.
 Any previous clipboard contents is lost after this action. 
 After this action, the clipboard contents can be pasted elsewhere in the text.
-\item[Paste] (\textsc{Shift-INS}) Insert the current clipboard contents in
+\item[Paste] (\key{Shift-INS}) Insert the current clipboard contents in
 the text at the cursor position. The clipboard contents remains as it was.
-\item[Clear] (\textsc{Ctrl-DEL}) clears (i.e. deletes) the current
+\item[Clear] (\key{Ctrl-DEL}) clears (i.e. deletes) the current
 selection.
 \item[Show clipboard] Opens a window in which the current clipboard contents
 is shown.
@@ -439,15 +439,15 @@ is shown.
 \subsection{The Search menu}
 \label{se:menusearch}
 \begin{description}
-\item[Find] (\textsc{Ctrl-Q F}) presents the search dialog. A search text 
+\item[Find] (\key{Ctrl-Q F}) presents the search dialog. A search text 
 can be entered, and when the dialog is closed, the entered text is searched
 in the active window. If the text is found, it will be selected. 
-\item[Replace] (\textsc{Ctrl-Q A} presents the search and replace dialog.
+\item[Replace] (\key{Ctrl-Q A} presents the search and replace dialog.
 After the dialog is closed, the search text will be replaced by the replace
 text in the active window.
-\item[Search again] (\textsc{CTRL-L}) repeats the last search or search and replace action,
+\item[Search again] (\key{CTRL-L}) repeats the last search or search and replace action,
  using  the same parameters.
-\item[Go to line number] (\textsc{Alt-G}) prompts for a line number, and
+\item[Go to line number] (\key{Alt-G}) prompts for a line number, and
 then jumps to this line number.
 \item[Find procedure]
 Not yet implemented.
@@ -466,18 +466,18 @@ Not yet implemented.
 \subsection{The Run menu}
 \label{se:menurun}
 \begin{description}
-\item[Run] (\textsc{Ctrl-F9})
+\item[Run] (\key{Ctrl-F9})
 If the sources were modified, compile the program. If the compile is
 successful, the program is executed. If the primary file  was set, then 
 that is used to determine which program to execute. See \sees{menucompile}
 for more information on how to set the primary file.
-\item[Step over] (\textsc{F8})
+\item[Step over] (\key{F8})
 Run the program till the next source line is reached. If any calls to 
 procedures are made, these will be executed completely as well.
-\item[Trace into] (\textsc{F7})
+\item[Trace into] (\key{F7})
 Execute the current line. If the current line contains a call to another
 procedure, the process will stop at the entry point of the called procedure.
-\item[Goto cursor] (\textsc{F4})
+\item[Goto cursor] (\key{F4})
 Runs the program till the execution point matches the line where the cursor
 is.
 \item[until return]
@@ -485,7 +485,7 @@ Runs the current procedure till it exits.
 \item[parameters]
 This menu item allows to enter parameters that will be passed on to the
 program when it is being executed.
-\item[program reset] (\textsc{Ctrl-F2}) if the program is being run or 
+\item[program reset] (\key{Ctrl-F2}) if the program is being run or 
 debugged, the debug session is aborted, and the running program is killed.
 \end{description}
 %
@@ -494,9 +494,9 @@ debugged, the debug session is aborted, and the running program is killed.
 \subsection{The Compile menu}
 \label{se:menucompile}
 \begin{description}
-\item[Compile] (\textsc{Alt-F9}) Compiles the contents of the active window.  
+\item[Compile] (\key{Alt-F9}) Compiles the contents of the active window.  
 If the primary file was set, the primary file is compiled instead.
-\item[Make] (\textsc{F9}) Compiles the contents of the active window, and
+\item[Make] (\key{F9}) Compiles the contents of the active window, and
 any files that the unit or program depends on and that were modified since
 the last compile.
 If the primary file was set, the primary file is compiled instead.
@@ -512,7 +512,7 @@ file need not be loaded in the IDE for this to have effect.
 Clears the primary file. After this command, any run or compile action will
 act on the active window.
 \item[Information] Displays some information about the current program.
-\item[Compiler messages] (\textsc{F12}) displays the compiler messages
+\item[Compiler messages] (\key{F12}) displays the compiler messages
 window. This window will display the messages generated by the compiler
 during the last compile.
 \end{description}
@@ -523,18 +523,18 @@ during the last compile.
 \label{se:menudebug}
 \begin{description}
 \item[Output]
-\item[User screen] (\textsc{Alt-F5}) switches to the screen as it was last
+\item[User screen] (\key{Alt-F5}) switches to the screen as it was last
 left by the running program.
-\item[Breakpoint] (\textsc{Ctrl-F8})
+\item[Breakpoint] (\key{Ctrl-F8})
 Sets a breakpoint at the current line. When debugging, program execution
 will stop at this breakpoint.
-\item[Call stack] (\textsc{Ctrl-F3})
+\item[Call stack] (\key{Ctrl-F3})
 Shows the call stack. The call stack is the list of addresses (and
 filenames and line numbers, if this information was compiled in) of 
 procedures that are currently being called in the running program.
 \item[Registers]
 Shows the current content of the CPU registers. 
-\item[Add watch] (\textsc{Ctrl-F7}) Add a watch. A watch is an expression
+\item[Add watch] (\key{Ctrl-F7}) Add a watch. A watch is an expression
 that can be evaluated by the IDE and shown in a special window. usually this
 is the contents of some variable. 
 \item[Watches]
@@ -551,12 +551,12 @@ directly.
 \subsection{The Tools menu}
 \label{se:menutools}
 \begin{description}
-\item[Messages] (\textsc{F11}) Show the messages window. 
+\item[Messages] (\key{F11}) Show the messages window. 
 This window contains the output from one of the tools. For more information,
 see \sees{toolsmessages}.
-\item[Goto next] (\textsc{Alt-F8}) goto next message.
-\item[Goto previous] (\textsc{Alt-F7}) goto previous message
-\item[Grep] (\textsc{SHIFT-F2}) Prompts for a regular expression and options
+\item[Goto next] (\key{Alt-F8}) goto next message.
+\item[Goto previous] (\key{Alt-F7}) goto previous message
+\item[Grep] (\key{SHIFT-F2}) Prompts for a regular expression and options
 to be given to grep, and then executes \file{grep} with the given expression and
 options. For this to work, the \file{grep} program must be installed on your
 system, and be in a directory that is in the \var{PATH}. For more
@@ -645,19 +645,19 @@ Tiles all opened windows on the desktop.
 Cascades all opened windows on the desktop.
 \item[Close all]
 Close all opened windows.
-\item[Size/move] (\textsc{Ctrl-F5})
+\item[Size/move] (\key{Ctrl-F5})
 Put the IDE in Size/move modus; after this command the active window can be
 moved and resized using the arrow keys.
-\item[Zoom] (\textsc{F5})
+\item[Zoom] (\key{F5})
 Zooms or unzooms the current window. 
-\item[Next] (\textsc{F6})
+\item[Next] (\key{F6})
 Activates the next window in the window list.
-\item[Previous] (\textsc{SHIFT-F6})
+\item[Previous] (\key{SHIFT-F6})
 Activates the previous window in the window list.
-\item[Hide] (\textsc{Ctrl-F6})
+\item[Hide] (\key{Ctrl-F6})
 Hides the active window. 
-\item[Close] (\textsc{ALT-F3}) closes the active window.
-\item[List] (\textsc{Alt-0}) shows the list of opened windows. From there a
+\item[Close] (\key{ALT-F3}) closes the active window.
+\item[List] (\key{Alt-0}) shows the list of opened windows. From there a
 window can be activated, closed, shown and hidden.
 \item[Refresh display]
 Redraws the screen.
@@ -695,12 +695,12 @@ can be found in the \emph{help system}. The help system is activated
 
 \subsection{Navigating in the help system}
 The help system contains hyperlinks which can be accessed by clicking
-them with the mouse. Alternativly, \textsc{Tab} and \textsc{Shift-Tab}
+them with the mouse. Alternativly, \key{Tab} and \key{Shift-Tab}
 can be used to move between the different hyperlinks of a page
-and the \textsc{Enter} key can be used to select them.
+and the \key{Enter} key can be used to select them.
 
-The contents of the help system is displayed, if \textsc{Shift-F1} is
-pressed. To go back to the last help topic, \textsc{press Alt-F1}. 
+The contents of the help system is displayed, if \key{Shift-F1} is
+pressed. To go back to the last help topic, \key{press Alt-F1}. 
 This also works if the help window isn't displayed on the desktop.
 
 \subsection{Working with help files}
@@ -758,17 +758,36 @@ text.
 Text can be selected in 3 ways:
 \begin{enumerate}
 \item using the mouse, dragging the mouse over existing text selects it.
-\item using the keyboard, press \textsc{Ctrl-K B} to mark the beginning of
-the selected text, and \textsc{Ctrl-K K} to mark the end of the selected
+\item using the keyboard, press \key{Ctrl-K B} to mark the beginning of
+the selected text, and \key{Ctrl-K K} to mark the end of the selected
 text.
-\item using the keyboard, hold the \textsc{Shift} key depressed while
+\item using the keyboard, hold the \key{Shift} key depressed while
 navigating with the cursor keys.
 \end{enumerate}
 
+There are also some special select commands:
+\begin{enumerate}
+\item The current line can be selected using \key{Ctrl-K L}.
+\item The current word can be selected using \key{Ctrl-K T}.
+\end{enumerate}
+
 In the \fpc IDE, selected text is persistent. After selecting a range of 
-text, the cursor can be moved, and the selection will not be destroyed.
- 
+text, the cursor can be moved, and the selection will not be destroyed;
+hence the term 'block' is more appropriate for the selection, and will be
+used henceforth...
 
+Several commands can be executed on a block:
+\begin{itemize}
+\item Move the block to a new location (\key{Ctrl-K V}).
+\item Copy the block to another location (\key{Ctrl-K C}).
+\item Delete the block (\key{Ctrl-K Y}).
+\item Write the block to a file (\key{Ctrl-K W}).
+\item Read the contents of a file into a block (\key{Ctrl-K R}).
+\item Indent a block (\key{Ctrl-K I}).
+\item Undent a block (\key{Ctrl-K U}).
+\item Print the block contents (\key{Ctrl-K P}).
+\item Restrict a search to the block contents.
+\end{itemize}
 
 %
 % Bookmarks
@@ -780,22 +799,95 @@ cursor position. Later, the cursor can be returned to this position
 by pressing a keyboard shortcut.
 
 Up to 9 bookmarks per source file can be set up, they are set by
-\textsc{Ctrl-K-<Number>} (where number is the number of the mark).
-To go to a previously set bookmark, press \textsc{Ctrl-Q-<Number}.
+\key{Ctrl-K <Number>} (where number is the number of the mark).
+To go to a previously set bookmark, press \key{Ctrl-Q <Number>}.
 
 \begin{remark}
-Currently, the bookmarks aren't stored if the IDE is left. This may
+Currently, the bookmarks are not stored if the IDE is left. This may
 change in future implementations of the IDE.
 \end{remark}
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 % Searching in the text
-\section{Searching in the text}
+\section{Searching and replacing}
 \label{se:searching}
+The IDE allows to search for text in the active editor window. 
+To search for text, one  of the following can be done:
+\begin{enumerate}
+\item Select "Search|Find" in the menu.
+\item Press \key{Ctrl-Q F}.
+\end{enumerate}
+After that, a dialog will pop up in which you can enter the following
+options:
+\begin{description}
+\item[Text to find] the text to be searched for. If a block was active when
+the dialog was started, this is proposed.
+\item[Case sensitive] when checked, the search is case sensitive.
+\item[Whole words only] when checked, the search text must appear in the
+text as a complete word.
+\item[Direction] the direction in which the search must be conducted,
+starting from the specified origin.
+\item[Scope] should the search be on the whole file, or just the selected
+text.
+\item[Origin] should the search start from the cursor position or the start
+of the scope.
+\end{description}
+After the dialog is closed, the search is performed using the given options.
 
+A search can be repeated (using the same options) in one of 2 ways:
+\begin{enumerate}
+\item Select "Search|Find again" from the menu.
+\item Press \key{Ctrl-L}.
+\end{enumerate}
+
+It is also possible to replace occurences of a text with another text. 
+This can be done in a similar manner to searching for a text:
+\begin{enumerate}
+\item Select "Search|Replace" from the menu.
+\item Press \key{Ctrl-Q A}.
+\end{enumerate}
+A dialog, similar to the search dialog will pop up.
+In this dialog, in addition to the things that can be filled in in the
+search dialog, the following things can be entered:
+\begin{description}
+\item [New text] text by which found text will be replaced.
+\item [Prompt on replace] before a replacement is made, the IDE will ask for
+confirmation.
+\end{description}
+If the dialog is closed with the 'OK' button, only the next occurrence the
+the search text will be replaced. 
+If the dialog is closed with the 'Change All' button, all occurrences of 
+the search text will be replaced.
 
 \subsection{The symbol browser}
-%%%!!!!!!!!!!!!!!
+\label{se:browser}
+The symbol browser allows to find all occurrences of a symbol. A symbol 
+can be a variable, type, procedure or constant that occurs in your program.
+
+To enable the symbol browser, the program or unit must be compiled with
+browser information. This can be done by setting the browser information
+option in the compiler options dialog.
+
+The IDE allows to browse several types of symbol:
+\begin{description}
+\item[procedures] Allows to quickly jump to a procedure definition or
+implementation.
+\item[Objects] Allows to quickly browse an object.
+\item[Modules] Allows to browse a module.
+\item[Globals] Allows to browse any global symbol.
+\item[Arbitrary symbol] Allows to browse an arbitrary symbol.
+\end{description}
+In all cases, first a symbol to be browsed must be selected. After that,
+a browse window appears. In the browse window, all locations where the 
+symbol was encountered are shown. Selecting a location and pressing the
+space bar will cause the editor to jump to that location; the line
+containing the symbol will be highlighted. 
+
+If the location is in a source file that is not yet displayed, a new 
+window will be opened with the source file loaded.
+
+After the desired location was reached, the browse window can be closed 
+with the usual commands. 
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 % Running programs
@@ -823,12 +915,12 @@ The output of the external utilies is redirected by the IDE and it
 will be displayed in the message window. The message window is
 displayed automatically, if an external tool was run. The
 messages window can be also display manual by the selecting the
-menu item \var{Tools|Messages} or by pressing the key \textsc{F11}.
+menu item \var{Tools|Messages} or by pressing the key \key{F11}.
 
 If the output of the tools contains filenames and line numbers,
-you can goto the source line by pressing \textsc{Enter} or
+you can goto the source line by pressing \key{Enter} or
 double clicking the output line. To trace the source, press
-\textsc{Space}. The difference between goto and tracking is that
+\key{Space}. The difference between goto and tracking is that
 goto closes the message window while tracking keeps the message
 window active and the source file is displayed only in the background.
 
@@ -840,7 +932,7 @@ fail. In this case, please refer the sources of the IDE.
 \label{se:grep}
 One external tool in the Tools menu is already predefined: an
 menu item to call the \file{grep} utility (\var{Tools|Grep} or
-\textsc{Shift-F2}). \file{grep} search for a given string in files and
+\key{Shift-F2}). \file{grep} search for a given string in files and
 returns the lines which contain the string. The search string can
 be even a regular expression (see \sees{regexpr}).
 
@@ -852,7 +944,7 @@ inserting chars into the window which was active when calling the
 ascii chart. To get the ascii code of a char move the blocking block
 cursor on this char or click with the mouse on it. To insert a
 char into an editor window, double click it with the mouse
-or press \textsc{Enter} while the cursor is on it.
+or press \key{Enter} while the cursor is on it.
 
 \subsection{The calculator}
 \label{se:calculator}
@@ -863,10 +955,10 @@ about the supported operations, see table \seet{calculatorcommands}.
 \begin{FPCltable}{p{5cm}lll}{Calculator commands}{calculatorcommands}
 Operation & Button & Key \\
 \hline
-Add two numbers & \var{+} & \textsc{+} \\
-Subtract two numbers & \var{\-} & \textsc{\-} \\
-Multiply two numbers & \var{*} & \textsc{*} \\
-Divide two numbers & \var{/} & \textsc{/} \\
+Add two numbers & \var{+} & \key{+} \\
+Subtract two numbers & \var{\-} & \key{\-} \\
+Multiply two numbers & \var{*} & \key{*} \\
+Divide two numbers & \var{/} & \key{/} \\
 Calculate power & \var{x\^y} & \\
 Add the displayed number to the memory & \var{M+} & \\
 Subtract the displayed number from the memory & \var{M-} & \\
@@ -877,11 +969,11 @@ Square the display contents & \var{x\^2} & \\
 Calculate the reciproke value & \var{1/x} & \\
 Calculate the square root & \var{sqr} & \\
 Calulate the natural logarithm &  \var{log} & \\
-Delete the last typed digit & \var{<-} & \textsc{Backspace} \\
-Delete the display & \var{C} & \textsc{C} \\
+Delete the last typed digit & \var{<-} & \key{Backspace} \\
+Delete the display & \var{C} & \key{C} \\
 Change the sign & \var{+\-} & \\
-Get result of operation & \var{=} & \textsc{Enter} \\
-Do per cent calculation & \var{\%} & \textsc{\%}
+Get result of operation & \var{=} & \key{Enter} \\
+Do per cent calculation & \var{\%} & \key{\%}
 \end{FPCltable}
 
 \subsection{Adding new tools}
@@ -1023,11 +1115,11 @@ item \var{Reverse mouse buttons}.
 The two lists with the radio buttons allows you
 to configure the behavior of the
 right mouse button, if it is clicked together while
-pressing the \textsc{Ctrl} or
-\textsc{Alt} key in an edit window.
+pressing the \key{Ctrl} or
+\key{Alt} key in an edit window.
 
-The following actions can be assigned to \textsc{Ctrl}-right mouse button or
-\textsc{Alt}-right mouse button:
+The following actions can be assigned to \key{Ctrl}-right mouse button or
+\key{Alt}-right mouse button:
 
 \begin{description}
 \item [Topic search] The keyword at the mouse cursor is searched in the
@@ -1077,133 +1169,136 @@ WordStar and should be well known to Turbo Pascal users.
 \begin{FPCltable}{p{5cm}ll}{General}{shortcutsgeneral}
 Command & Key shortcut & Alternative \\
 \hline
-Help & \textsc{F1} & \\
-Goto last help topic & \textsc{Alt-F1} & \\
-Search word at cursor position in help & \textsc{Ctrl-F1} & \\
-Help index & \textsc{Shift-F1} & \\
-Close active window & \textsc{Alt-F3} & \\
-Zomm/Unzoom window & \textsc{F5} & \\
-Move/Zoom active window & \textsc{Ctrl-F5} & \\
-Switch to next window & \textsc{F6} & \\
-Switch to last window & \textsc{Shift-F6} & \\
-Menu & \textsc{F10} & \\
-Local menu & \textsc{Alt-F10} & \\
-List of windows & \textsc{Alt-0} & \\
-Active another window & \textsc{Alt-<digit>} & \\
-Call \var{GREP} utility & \textsc{Shift-F2} & \\
-Exit IDE & \textsc{Alt-X} & \\
+Help & \key{F1} & \\
+Goto last help topic & \key{Alt-F1} & \\
+Search word at cursor position in help & \key{Ctrl-F1} & \\
+Help index & \key{Shift-F1} & \\
+Close active window & \key{Alt-F3} & \\
+Zomm/Unzoom window & \key{F5} & \\
+Move/Zoom active window & \key{Ctrl-F5} & \\
+Switch to next window & \key{F6} & \\
+Switch to last window & \key{Shift-F6} & \\
+Menu & \key{F10} & \\
+Local menu & \key{Alt-F10} & \\
+List of windows & \key{Alt-0} & \\
+Active another window & \key{Alt-<digit>} & \\
+Call \var{GREP} utility & \key{Shift-F2} & \\
+Exit IDE & \key{Alt-X} & \\
 \end{FPCltable}
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \begin{FPCltable}{p{5cm}ll}{Compiler}{shortcutscompiler}
 Command & Key shortcut & Alternative \\
 \hline
-Reset debugger/program & \textsc{Ctrl-F2} & \\
-Display call stack & \textsc{Ctrl-F3} & \\
-Run til cursor & \textsc{F4} & \\
-Switch to user screen & \textsc{Alt-F5} & \\
-Trace into & \textsc{F7} & \\
-Add watch & \textsc{Ctrl-F7} & \\
-Step over & \textsc{F8} & \\
-Set breakpoint at current line & \textsc{Ctrl-F8} & \\
-Make & \textsc{F9} & \\
-Run & \textsc{Ctrl-F9} & \\
-Compile the active source file & \textsc{Alt-F9} & \\
-Message & \textsc{F11} & \\
-Compiler messages & \textsc{F12} & \\
+Reset debugger/program & \key{Ctrl-F2} & \\
+Display call stack & \key{Ctrl-F3} & \\
+Run til cursor & \key{F4} & \\
+Switch to user screen & \key{Alt-F5} & \\
+Trace into & \key{F7} & \\
+Add watch & \key{Ctrl-F7} & \\
+Step over & \key{F8} & \\
+Set breakpoint at current line & \key{Ctrl-F8} & \\
+Make & \key{F9} & \\
+Run & \key{Ctrl-F9} & \\
+Compile the active source file & \key{Alt-F9} & \\
+Message & \key{F11} & \\
+Compiler messages & \key{F12} & \\
 \end{FPCltable}
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \begin{FPCltable}{p{5cm}ll}{Text navigation}{shortcutstextnavigation}
 Command & Key shortcut & Alternative \\
 \hline
-Char left & \textsc{Arrow left} & \textsc{Ctrl-S} \\
-Char right & \textsc{Arrow right} & \textsc{Ctrl-D} \\
-Line up & \textsc{Arrow up} & \textsc{Ctrl-E} \\
-Line down & \textsc{Arrow down} & \textsc{Ctrl-X} \\
-Word left & \textsc{Ctrl-Arrow left} & \textsc{Ctrl-A} \\
-Word right & \textsc{Ctrl-Arror right} & \textsc{Ctrl-F} \\
-Scroll one line up & \textsc{Ctrl-W} & \\
-Scroll one line down & \textsc{Ctrl-Z} & \\
-Page up & \textsc{PageUp} & \textsc{Ctrl-R} \\
-Page down & \textsc{PageDown} & \\
-Beginning of Line & \textsc{Pos1} & \textsc{Ctrl-Q-S} \\
-End of Line & \textsc{End} & \textsc{Ctrl-Q-D} \\
-First line of window & \textsc{Ctrl-Pos1} & \textsc{Ctrl-Q-E} \\
-Last line of window & \textsc{Ctrl-End} & \textsc{Ctrl-Q-X} \\
-First line of file & \textsc{Ctrl-PageUp} & \textsc{Ctrl-Q-R} \\
-Last line of file & \textsc{Ctrl-PageDown} & \textsc{Ctrl-Q-C} \\
-Last cursor position & \textsc{Ctrl-Q-P} & \\
+Char left & \key{Arrow left} & \key{Ctrl-S} \\
+Char right & \key{Arrow right} & \key{Ctrl-D} \\
+Line up & \key{Arrow up} & \key{Ctrl-E} \\
+Line down & \key{Arrow down} & \key{Ctrl-X} \\
+Word left & \key{Ctrl-Arrow left} & \key{Ctrl-A} \\
+Word right & \key{Ctrl-Arror right} & \key{Ctrl-F} \\
+Scroll one line up & \key{Ctrl-W} & \\
+Scroll one line down & \key{Ctrl-Z} & \\
+Page up & \key{PageUp} & \key{Ctrl-R} \\
+Page down & \key{PageDown} & \\
+Beginning of Line & \key{Pos1} & \key{Ctrl-Q-S} \\
+End of Line & \key{End} & \key{Ctrl-Q-D} \\
+First line of window & \key{Ctrl-Pos1} & \key{Ctrl-Q-E} \\
+Last line of window & \key{Ctrl-End} & \key{Ctrl-Q-X} \\
+First line of file & \key{Ctrl-PageUp} & \key{Ctrl-Q-R} \\
+Last line of file & \key{Ctrl-PageDown} & \key{Ctrl-Q-C} \\
+Last cursor position & \key{Ctrl-Q-P} & \\
 \end{FPCltable}
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \begin{FPCltable}{p{5cm}ll}{Edit}{shortcutsedit}
 Command & Key shortcut & Alternative \\
 \hline
-Delete char & \textsc{Del} & \textsc{Ctrl-G} \\
-Delete left char & \textsc{Backspace} & \textsc{Ctrl-H} \\
-Delete line & \textsc{Ctrl-Y} & \\
-Delete til end of line & \textsc{Ctrl-Q-Y} & \\
-Delete word & \textsc{Ctrl-T} & \\
-Insert line & \textsc{Ctrl-N} & \\
-Toggle insert mode & \textsc{Insert} & \textsc{Ctrl-V} \\
+Delete char & \key{Del} & \key{Ctrl-G} \\
+Delete left char & \key{Backspace} & \key{Ctrl-H} \\
+Delete line & \key{Ctrl-Y} & \\
+Delete til end of line & \key{Ctrl-Q-Y} & \\
+Delete word & \key{Ctrl-T} & \\
+Insert line & \key{Ctrl-N} & \\
+Toggle insert mode & \key{Insert} & \key{Ctrl-V} \\
 \end{FPCltable}
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \begin{FPCltable}{p{5cm}ll}{Block commands}{shortcutsblockcommands}
 Command & Key shortcut & Alternative \\
 \hline
-Goto Beginning of selected text & \textsc{Ctrl-Q-B} & \\
-Goto end of selected text & \textsc{Ctrl-Q-K} & \\
-Select current line & \textsc{Ctrl-K-L} & \\
-Print selected text & \textsc{Ctrl-K-P} & \\
-Select current word & \textsc{Ctrl-K-T} & \\
-Delete selected text & \textsc{Ctrl-Del} & \textsc{Ctrl-K-Y} \\
-Copy selected text to cursor position & \textsc{Ctrl-K-C} & \\
-Move selected text to cursor position & \textsc{Ctrl-K-V} & \\
-Copy selected text to clipboard & \textsc{Ctrl-Ins} & \\
-Move selected text to the clipboard & \textsc{Shift-Del} & \\
-Indent block one coloumn & \textsc{Ctrl-K-I} & \\
-Unindent block one coloumn & \textsc{Ctrl-K-U} & \\
-Insert text from clipboard & \textsc{Shift-Insert} & \\
-Insert file & \textsc{Ctrl-K-R} & \\
-Write selected text to file & \textsc{Ctrl-K-W} & \\
+Goto Beginning of selected text & \key{Ctrl-Q-B} & \\
+Goto end of selected text & \key{Ctrl-Q-K} & \\
+Select current line & \key{Ctrl-K-L} & \\
+Print selected text & \key{Ctrl-K-P} & \\
+Select current word & \key{Ctrl-K-T} & \\
+Delete selected text & \key{Ctrl-Del} & \key{Ctrl-K-Y} \\
+Copy selected text to cursor position & \key{Ctrl-K-C} & \\
+Move selected text to cursor position & \key{Ctrl-K-V} & \\
+Copy selected text to clipboard & \key{Ctrl-Ins} & \\
+Move selected text to the clipboard & \key{Shift-Del} & \\
+Indent block one coloumn & \key{Ctrl-K-I} & \\
+Unindent block one coloumn & \key{Ctrl-K-U} & \\
+Insert text from clipboard & \key{Shift-Insert} & \\
+Insert file & \key{Ctrl-K-R} & \\
+Write selected text to file & \key{Ctrl-K-W} & \\
 \end{FPCltable}
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \begin{FPCltable}{p{5cm}ll}{Change selection}{changeselection}
 Command & Key shortcut & Alternative \\
 \hline
-Mark beginning of selected text & \textsc{Ctrl-K-B} & \\
-Mark end of selected text& \textsc{Ctrl-K-K} & \\
-Remove selection & \textsc{Ctrl-K-H} & \\
-Extend selection one char to the left & \textsc{Shift-Arrow left} & \\
-Extend selection one char to the right & \textsc{Shift-Arrow right} & \\
-Extend selection to the beginning of the line & \textsc{Shift-Pos1} & \\
-Extend selection to the end of the line & \textsc{Shift-End} & \\
-Extend selection to the same coloumn in the last row & \textsc{Shift-Arrow up} & \\
-Extend selection to the same coloumn in the next row & \textsc{Shift-Arrow down} & \\
-Extend selection to the end of the line & \textsc{Shift-End} & \\
-Extend selection one word to the left & \textsc{Ctrl-Shift-Arrow left} & \\
-Extend selection one word to the right & \textsc{Ctrl-Shift-Arrow right} & \\
-Extend selection one page up & \textsc{Shift-PageUp} & \\
-Extend selection one page down & \textsc{Shift-PageDown} & \\
-Extend selection to the beginning of the file & \textsc{Ctrl-Shift-Pos1} &
-\textsc{Ctrl-Shift-PageUp} \\
-Extend selection to the end of the file & \textsc{Ctrl-Shift-End} &
-\textsc{Ctrl-Shift-PageUp} \\
+Mark beginning of selected text & \key{Ctrl-K-B} & \\
+Mark end of selected text& \key{Ctrl-K-K} & \\
+Remove selection & \key{Ctrl-K-H} & \\
+Extend selection one char to the left & \key{Shift-Arrow left} & \\
+Extend selection one char to the right & \key{Shift-Arrow right} & \\
+Extend selection to the beginning of the line & \key{Shift-Pos1} & \\
+Extend selection to the end of the line & \key{Shift-End} & \\
+Extend selection to the same coloumn in the last row & \key{Shift-Arrow up} & \\
+Extend selection to the same coloumn in the next row & \key{Shift-Arrow down} & \\
+Extend selection to the end of the line & \key{Shift-End} & \\
+Extend selection one word to the left & \key{Ctrl-Shift-Arrow left} & \\
+Extend selection one word to the right & \key{Ctrl-Shift-Arrow right} & \\
+Extend selection one page up & \key{Shift-PageUp} & \\
+Extend selection one page down & \key{Shift-PageDown} & \\
+Extend selection to the beginning of the file & \key{Ctrl-Shift-Pos1} &
+\key{Ctrl-Shift-PageUp} \\
+Extend selection to the end of the file & \key{Ctrl-Shift-End} &
+\key{Ctrl-Shift-PageUp} \\
 \end{FPCltable}
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \begin{FPCltable}{p{5cm}ll}{Misc. commands}{shortcutsmisccommands}
 Command & Key shortcut & Alternative \\
 \hline
-Save file & \textsc{F2} & \textsc{Ctrl-K-S} \\
-Open file & \textsc{F3} & \\
-Search & \textsc{Ctrl-Q-F} & \\
-Search again & \textsc{Ctrl-L}\ & \\
-Search and replace & \textsc{Ctrl-Q-A} & \\
-Set mark & \textsc{Ctrl-K-n} (where n can be 0..9) & \\
-Goto mark & \textsc{Ctrl-Q-n} (where n can be 0..9) & \\
-Undo & \textsc{Alt-Backspace} & \\
+Save file & \key{F2} & \key{Ctrl-K-S} \\
+Open file & \key{F3} & \\
+Search & \key{Ctrl-Q-F} & \\
+Search again & \key{Ctrl-L}\ & \\
+Search and replace & \key{Ctrl-Q-A} & \\
+Set mark & \key{Ctrl-K-n} (where n can be 0..9) & \\
+Goto mark & \key{Ctrl-Q-n} (where n can be 0..9) & \\
+Undo & \key{Alt-Backspace} & \\
 \end{FPCltable}
 %
 %  $Log$
-%  Revision 1.1.2.1  2000-11-12 23:40:32  michael
+%  Revision 1.1.2.2  2000-11-13 23:46:03  michael
+%  + documented blocks, search, and the browser
+%
+%  Revision 1.1.2.1  2000/11/12 23:40:32  michael
 %  + Changes for final version
 %
 %  Revision 1.1  2000/07/13 09:10:04  michael