From 88a73b852c0bf0c5567f8231700e789cee87b00b Mon Sep 17 00:00:00 2001
From: mertz
Date: Mon, 8 Jul 2002 13:01:15 +0000
Subject: - ajout de le doc de la command find('ancestors') - duplication tr�s
 partielle des commandes de recherches d�crites dans addtag dans la commande
 find pour faciliter la lecture de la doc

---
 doc/refman.tex | 55 ++++++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 48 insertions(+), 7 deletions(-)

(limited to 'doc')

diff --git a/doc/refman.tex b/doc/refman.tex
index d979708..489e0a7 100644
--- a/doc/refman.tex
+++ b/doc/refman.tex
@@ -1136,8 +1136,8 @@ In this chapter, we first list all commands by categories, then we details each
 \item{Transformations} :  \cmdref{rotate}  \cmdref{scale} \cmdref{tapply} \cmdref{tdelete}
 \cmdref{transform} \cmdref{translate} \cmdref{treset} \cmdref{tsave}
 
-\item{Display list or priorities} : \cmdref{chggroup} \cmdref{group} \cmdref{lower}
-\cmdref{raise}
+\item{Groups, Display list and Priorities} : \cmdref{chggroup} \cmdref{find}('ancestors') \cmdref{group} \cmdref{lower}
+\cmdref{raise} 
 
 \item{Tag management} : \cmdref{addtag} \cmdref{dtag} \cmdref{find} \cmdref{gettags} \cmdref{hastag}
 
@@ -1287,6 +1287,15 @@ reference) and all list parameters are given as array references.
     more on this subject).
 
   \item{\tt\large
+        pathname {\bf addtag} tag ancestors tagOrId ?tagOrId2?\\
+        \$zinc->{\bf addtag}(tag, 'ancestors', tagOrId, ?tagOrId2?);}
+
+	Selects all ancestors (i.e. parent groups) of tagOrId.  If
+    	{\tt tagOrId} names more than one item, the first, (or the topmost)
+	of these items in the display list will be used. If ?tagOrId2? is specified,
+        only parent groups with this tag are selected.
+
+  \item{\tt\large
         pathname {\bf addtag} tag below tagOrId\\ 
         \$zinc->{\bf addtag}(tag, 'below', tagOrId);}
 
@@ -1724,11 +1733,43 @@ false.
   args}. See the \cmdref{addtag} command for an explanation of {\tt searchCommand} and the
   various {\tt args}. The items are sorted in drawing order, topmost first. \\
   For example:\\
-  \code{ \# to get the item under the mouse cursor:\\ \$item = \$zinc->find('withtag',
-  'current');\\
-  \# to get the closest item of a point:\\ \$closest = \$zinc->find ('closest', \$x, \$y);
-}
-
+  \code{ \# to get the item under the mouse cursor:\\
+	\$item = \$zinc->find('withtag', 'current');\\
+	\# to get the closest item of a point:\\ \$closest = \$zinc->find ('closest', \$x, \$y);
+  }
+  As detailled in \cmdref{addtag} command the following searchCommands are possible:
+  \begin{itemize}
+	\item{\tt\large
+        	pathname {\bf find} above tagOrId \\
+        	\$zinc->{\bf find}('above', tagOrId);}
+	\item{\tt\large
+       		pathname {\bf find} all ?inGroup? ?recursive?\\
+        	\$zinc->{\bf find}('all', ?inGroup?, ?recursive?);}
+	\item{\tt\large
+        	pathname {\bf find} atpriority priority ?tagOrId?\\
+        	\$zinc->{\bf find}('atpriority', priority, ?tagOrId?);}
+	\item{\tt\large
+        	pathname {\bf find} ancestors tagOrId ?tagOrId2?\\
+        	\$zinc->{\bf find}('ancestors', tagOrId, ?tagOrId2?);}
+	\item{\tt\large
+        	pathname {\bf find} below tagOrId\\ 
+        	\$zinc->{\bf find}('below', tagOrId);}
+	\item{\tt\large
+        	pathname {\bf find} closest x y ?halo? ?startItem?, ?recursive?\\ 
+        	\$zinc->{\bf find}('closest', x, y, ?halo?, ?startItem?, ?recursive?);}
+	\item{\tt\large
+        	pathname {\bf find} enclosed xo yo xc yc ?inGroup? ?recursive?\\ 
+        	\$zinc->{\bf find}('enclosed', xo, yo, xc, yc, ?inGroup?, ?recursive?);}
+	\item{\tt\large
+        	pathname {\bf find} overlapping xo yo xc yc ?inGroup? ?recursive?\\ 
+        	\$zinc->{\bf find}('overlapping', xo, yo, xc, yc, ?inGroup?, ?recursive?);}
+	\item{\tt\large
+        	pathname {\bf find} withtag tagOrId\\ 
+        	\$zinc->{\bf find}('withtag', tagOrId);}
+	\item{\tt\large
+        	pathname {\bf find} withtype type ?tagOrId?\\ 
+        	\$zinc->{\bf find}('withtype', type, ?tagOrId?);}
+  \end{itemize}
 \end{blockindent}
 
 
-- 
cgit v1.1