- ajout d'un changelog (3.2.2 => 3.2.4 et 3.2.4 => 3.2.6)

- ajout dans le titre et l'introduction d'une r�f�rence � la note NT02-782

1 files changed, 49 insertions, 9 deletions

diff --git a/doc/refman.tex b/doc/refman.tex
index 8af2ff7..6f200aa 100644
--- a/doc/refman.tex
+++ b/doc/refman.tex
@@ -201,7 +201,7 @@
 \setlength{\marginparwidth}{20pt}
 \setlength{\textwidth}{480pt}
 
-\title{Zinc, an advanced scriptable Canvas.\\The 3.2.6 Reference Manual.}
+\title{Zinc, an advanced scriptable Canvas.\\The 3.2.6 Reference Manual.\\\small{[CENA technical Note NT02-782]} }
 \author{Patrick Lecoanet}
 \date{4 July 2002}
 
@@ -221,6 +221,8 @@
 %%
 \chapter{Introduction}
 \concept{introduction}
+
+
 \section{What is Zinc ?}
 
 Zinc widgets are very similar to Tk Canvases in that they support
@@ -272,6 +274,44 @@ This document is Tcl/Tk and Perl/Tk oriented but it should be easy for Python or
 programmers to adapt. Every time a Zinc command is described in this
 document, it is given first in Tcl/Tk idiom and then in Perl/Tk idiom.
 
+This document is also referenced as the CENA technical note NT02-782.
+
+\section{Differences with previous version}
+
+\subsection{Differences between 3.2.6 and 3.2.4 release}
+\begin{itemize}
+\item  many bug corrections, of course!
+\item  this documentation has been improved (changelog, new figures, completions) 
+\item  the contour command can return the contour number
+\item  the ZincDebug.pm perl module has been fairly augmented
+\item  the find command may return item ancestor(s)
+\item  the zinc command may return the version number
+\item  icom items may be scaled and rotated (needs openGL)
+\item  anti-overlapping of tracks labels works again
+\item  tsave can now be used to know if a named transformation is already defined 
+\item  gname can now be used to know if a named gradient is already defined 
+\item  new tags can now be used : ``pathtags'' to go through groups. Yet to be documented!
+\item  find and addtag commands have been modified to be ``pathtag'' compliant
+\item  the clone command only clone one item when using a tag.
+\item  all items have now a -composealpha option
+\item  it is again an error to configure an unexisting option of an item
+\item  all items can now get the keyboard focus; thus focus and 'select item' return a list of two elements.
+\item  new tagged index (bol, eol, bow, eow, up, down) for text items and labels of track, waypoint and tabular
+\end{itemize}
+
+\subsection{Differences between 3.2.4 and 3.2.2 release}
+\begin{itemize}
+\item  many bug corrections, of course!
+\item  Zinc can now use openGL capablities
+\item  many new item options (due to openGL capablilites) and a new triangles item
+\item  a new perl module : ZincDebug.pm to interactively browse the item hierarchy
+\item  as color are all gradient (with alpha transparency) the -alpha option has been removed
+\item  a set of zinc demontrations are available with the zinc-demos command
+\item  many new explanations in this doc: groups, item ids and tags ... 
+\item  the postscript version of this doc has been replaced by a pdf version
+\item  configuring an unexisting option of an item is no more an error (this was a design mistake)
+\item  a perl module ZincText.pm make it easier to implement text input
+\end{itemize}
 
 \section{Where can I find Zinc and documentation ?}
 
@@ -1801,7 +1841,7 @@ false.
 
 \zinccmd{focus}{?tagOrId?}
 
-{\tt\large \$item = \$zinc->{\bf focus}();}\\
+{\tt\large (\$item, \$part) = \$zinc->{\bf focus}();}\\
 {\tt\large \$zinc->{\bf focus}(tagOrId);}
 
 \begin{blockindent}
@@ -1809,8 +1849,9 @@ false.
   more than one item, the first item in display list order that accept the focus is
   used. If no such item exists, the command has no effect.  If {\tt tagOrId} is an empty
   string the focus is reset and no item has the focus.  If {\tt tagOrId} is not specified,
-  the command returns the id of the item with the focus or an empty string if no item has
-  the focus.
+  the command returns a list of two elements. The first is the id of the item with the focus
+  or an empty string if no item has the focus. The second is the item part or an empty
+  string if not appliable.
 
   When the focus has been set to an item that support an insertion cursor, the item will
   display its cursor and the keyboard events will be directed to that item.
@@ -1818,8 +1859,6 @@ false.
   The widget receive keyboard events only if it has the window focus. It may be necessary
   to use the Tk \ident{focus} command to force the focus to the widget window.
 
-  \emph{NB: currently (Version 3.2.4) only text items are really getting the focus.
-  Focus management will be extended to all other items in a near future.}
 \end{blockindent}
 
 
@@ -2136,10 +2175,11 @@ false.
 
   \item{\tt\large
         pathname {\bf select} item\\   
-        \$item = \$zinc->{\bf select}('item');}
+        (\$item, \$part) = \$zinc->{\bf select}('item');}
       
-    Returns the id of the selected item, if the selection is in an item on this
-    widget. Otherwise the command returns an empty string.
+    Returns a list of two elements. The first is the id of the selected item if the selection
+    is in an item on this widget; Otherwise the first element is an empty string. The second
+    element is the part of the item (track, waypoint or tabular item only) or the empty string.
 
   \item{\tt\large
         pathname {\bf select} to tagOrId index\\