DXmCreateSvn man page on Ultrix

Man page or keyword search:  
man Server   3690 pages
apropos Keyword Search (all sections)
Output format
Ultrix logo
[printable version]

DXmCreateSvn(3X)					      DXmCreateSvn(3X)

NAME
       DXmCreateSvn - Creates an SVN widget

SYNOPSIS
       Widget DXmCreateSvn(parent, name, arglist, argcount)
	       Widget  parent;
	       char    *name;
	       Arg     *arglist;
	       int     argcount;

PARAMETERS
       The  identifier	(widget	 ID) of the parent widget.  A character string
       that defines the name of the widget.  The  application  argument	 list.
       An  integer  that represents the number of arguments in the application
       argument list.  If  there  are  no  arguments  in  the  argument	 list,
       argcount	 must  equal 0.	 However, when argcount equals 0, the argument
       list does not have to be Null.

DESCRIPTION
       The DXmCreateSvn routine allows you to create a hierarchical  structure
       of  information	that is presented to a user in an organized manner and
       in a way that lets the user navigate in, and select from,  that	struc‐
       ture.  Your application need only tell the SVN widget about the organi‐
       zation of the data and respond to SVN widget callbacks; the SVN	widget
       is responsible for actually displaying the data.

       You  can use SVN to display hierarchical information in three different
       formats, or modes: Outline format.  Tree format, which can be  oriented
       from  the  top, the left, in outline form, and in a user-defined style.
       Column format, which differs from outline format in that a window  pane
       separates  a  set  of components from the rest of the display.  You can
       scroll horizontally on each side,  independently	 of  the  other	 side.
       However, you have only one vertical scroll bar.

       Each  SVN  line,	 or  entry,  in	 your hierarchy can display as many as
       thirty pieces of	 information  (called  components)  depending  on  the
       amount  of information users need.  The components can be of three data
       types: text, pixmaps, and widgets.

       The SVN widget includes additional support routines (also described  in
       this  document) that allow your application to insert and remove compo‐
       nents, set the text associated with a component, set a component to  be
       hidden,	set and determine a components's width, and determine a compo‐
       nent's number.

       When you create an SVN widget, note that applications must be  able  to
       communicate  with the widget through Toolkit routine calls that request
       information about and manipulate selections.  As such, when you use the
       DXmCreateSvn  routine  to  create  the SVN widget, you must include the
       following SVN  callbacks:  DXmSvnNattachToSourceCallback	 DXmSvnNgetEn‐
       tryCallback DXmSvnNselectAndConfirmCallback

   Callback Structures
       You can set the following widget-specific resources in the arglist:

       XtCallbackList	DXmSvnNattachToSourceCallback  Boolean	       DXmSvn‐
       NcolumnLines;  Dimension	       DXmSvnNdefaultSpacing;	XtCallbackList
       DXmSvnNdetachFromSourceCallback	XtCallbackList	DXmSvnNdisplayChanged‐
       Callback short		 DXmSvnNdisplayMode;  XtCallbackList   DXmSvn‐
       NdraggingCallback  XtCallbackList   DXmSvnNdraggingEndCallback  XtCall‐
       backList	  DXmSvnNentrySelectedCallback	XtCallbackList	 DXmSvnNentry‐
       TransferCallback XtCallbackList	DXmSvnNentryUnselectedCallback Boolean
       DXmSvnNexpectHighlighting; XtCallbackList  DXmSvnNextendConfirmCallback
       Boolean		 DXmSvnNfixedWidthEntries;   XmFontList	      DXmSvnN‐
       fontList;     XmFontList		 DXmSvnNfontListLevel0;	    XmFontList
       DXmSvnNfontListLevel1;	   XmFontList		DXmSvnNfontListLevel2;
       XmFontList	 DXmSvnNfontListLevel3;	   XmFontList	      DXmSvnN‐
       fontListLevel4; Boolean	       DXmSvnNforceSeqGetEntry; XtCallbackList
       DXmSvnNgetEntryCallback	Dimension	  DXmSvnNghostHeight;	Pixmap
       DXmSvnNghostPixmap;    Dimension		 DXmSvnNghostWidth;   Position
       DXmSvnNghostX;	 Position	     DXmSvnNghostY;	XtCallbackList
       DXmSvnNhelpRequestedCallback;	Dimension	  DXmSvnNindentMargin;
       Boolean	       DXmSvnNliveScrolling; Boolean	     DXmSvnNmultipleS‐
       elections;      XmString		   DXmSvnNnavWindowTitle;     longword
       DXmSvnNnumberOfEntries;	Widget		  DXmSvnNoutlineHScrollWidget;
       Widget		DXmSvnNpaneWidget;  XtCallbackList   DXmSvnNpopupMenu‐
       Callback	     longword		  DXmSvnNprimaryPercentage	Widget
       DXmSvnNprimaryWindowWidget Position	  DXmSvnNsecondaryBaseX; Bool‐
       ean		   DXmSvnNsecondaryComponentsUnmapped;		Widget
       DXmSvnNsecondaryWindowWidget;  XtCallbackList  DXmSvnNselectAndConfirm‐
       Callback	   short	      DXmSvnNselectionMode;	XtCallbackList
       DXmSvnNselectionsDraggedCallback Boolean		DXmSvnNshowPathToRoot;
       short			 DXmSvnNstartColumnComponent;		 short
       DXmSvnNstartLocationCursor; XtCallbackList  DXmSvnNtransitionsDoneCall‐
       back Dimension	    DXmSvnNtreeArcWidth; Boolean	  DXmSvnNtree‐
       CenteredComponents;  Boolean	     DXmSvnNtreeEntryOutlines; Boolean
       DXmSvnNtreeEntryShadows; Boolean		DXmSvnNtreeIndexAll; Dimension
       DXmSvnNtreeLevelSpacing; Boolean		DXmSvnNtreePerpendicularLines;
       Dimension	DXmSvnNtreeSiblingSpacing;   short	       DXmSvn‐
       NtreeStyle;	Boolean		     DXmSvnNtruncateText;      Boolean
       DXmSvnNuseScrollButtons;

   Resources
       Callback (or callbacks) made when a widget attaches to the source  data
       module,	which  then  calls the DXmSvnAddEntries routine to specify the
       initial entries (and number of entries) in  the	data  hierarchy.   The
       callback	 reason	 is  DXmSvnCRAttachToSource.   The  default  is	 Null.
       Access is CG.  A Boolean resource that, when True, specifies that  col‐
       umns are to be separated with a line.  The default is False.  Access is
       CSG.  The number of pixels between components.  The default is 12  pix‐
       els.   Access  is  CSG.	Callback made when the widget is detached from
       the source data module (the widget is being destroyed).	 The  applica‐
       tion  records that this widget will never call back.  The callback rea‐
       son is DXmSvnCRDetachFromSource.	 The default is Null.  Access is  CSG.
       Callback	 made  when  the entries currently being displayed to the user
       have changed.  This change may be in response to an expand or  collapse
       operation, scrolling, or the application issuing calls to the DXmSvnPo‐
       sitionDisplay routine.

	      The callback reason is  DXmSvnCRDisplayChanged.	An  additional
	      callback	field  is loc_cursor_entry_number, which is the number
	      of the entry where the location cursor is	 currently  displayed.
	      The  default  is	Null.  Access is CSG.  Specifies which display
	      should appear on the screen, indicated by one of	the  following
	      values:

	      ────────────────────────────────────────────────────

	      Value		       Description

	      ────────────────────────────────────────────────────

	      DXmSvnKdisplayOutline    Display in outline mode.

	      DXmSvnKdisplayColumns    Display in column mode.

	      DXmSvnKdisplayTree       Display in tree mode.

	      DXmSvnKdisplayAllModes   Used	only	by    the
				       DXmSvnSetComponentHidden
				       routine	to  hide a compo‐
				       nent in all modes.

	      DXmSvnKdisplayNone       Used    only    by     the
				       DXmSvnSetComponentHidden
				       routine	to  display  (not
				       hide)  a	 component in any
				       mode.

	      ────────────────────────────────────────────────────

	      The default is DXmSvnKdisplayOutline.  Access is CSG.   Callback
	      made  when  a  user  presses MB2 to drag a set of entries.  This
	      callback is required for application-controlled dragging	(which
	      you set by using the DXmSvnSetApplDragging routine).

	      The  callback reason is DXmSvnCRDragging.	 Other callback fields
	      are as follows:

	      ─────────────────────────────────────────────────────

	      Field			Description

	      ─────────────────────────────────────────────────────

	      time			The time that  the  button
					press event occurred

	      x				The   x	 position  of  the
					pointer

	      y				The  y	position  of   the
					pointer

	      dragged_entry_number	The  number  of	 the entry
					currently  being   dragged
					while MB2 is pressed

	      loc_cursor_entry_number	The  number  of	 the entry
					where the location  cursor
					is currently displayed

	      event			A  pointer  to	the XEvent
					that generated this  call‐
					back

	      ─────────────────────────────────────────────────────

	      The  default  is	Null.	Access is CSG.	Callback made when the
	      user releases MB2 after dragging a set of entries.   This	 call‐
	      back  is required for application-controlled dragging (which you
	      set by using the DXmSvnSetApplDragging routine).

	      The callback  reason  is	DXmSvnCRDraggingEnd.   Other  callback
	      fields are as follows:

	      ─────────────────────────────────────────────────────

	      Field			Description

	      ─────────────────────────────────────────────────────

	      time			The  time  that the button
					release event occurred

	      x				The x position of the cur‐
					sor  when the mouse button
					was released

	      y				The y position of the cur‐
					sor  when the mouse button
					was released

	      loc_cursor_entry_number	The number  of	the  entry
					where  the location cursor
					is currently displayed

	      event			A pointer  to  the  XEvent
					that  generated this call‐
					back

	      ─────────────────────────────────────────────────────

	      The default is Null.  Access is CSG.   Callback  made  when  the
	      user  selects  an	 entry.	  The  fields provided in the callback
	      structure enable the  application	 to  obtain  more  information
	      about the selected entry from the source module.

	      The  callback  reason  is DXmSvnCREntrySelected.	Other callback
	      fields are as follows:

	      ──────────────────────────────────────────────

	      Field		 Description

	      ──────────────────────────────────────────────

	      entry_number	 The entry selected

	      component_number	 The component	within	the
				 entry	the mouse was posi‐
				 tioned over when the entry
				 was selected

	      time		 Time  when  the  entry was
				 selected

	      entry_tag		 The value (previously	set
				 in  the  application  with
				 the   DXmSvnSetEntry	 or
				 DXmSvnSetEntryTag routine)
				 associated    with	the
				 entry_number field

	      ──────────────────────────────────────────────

	      ────────────────────────────────────────────────

	      Value		   Description

	      ────────────────────────────────────────────────

	      DXmSvnKnotFirst	   This	  is  not  the	first
				   selection  that  has	 been
				   made.

	      DXmSvnKfirstOfOne	   There  is  only one selec‐
				   tion being made.

	      DXmSvnKfirstOfMany   This is the first of	 many
				   selections being made.

	      ────────────────────────────────────────────────

	      This value (when treated as a Boolean function) is usually True.
	      It is False only when the user has made a	 range	selection  and
	      this is not the first DXmSvnNentrySelectedCallback.)

	      ─────────────────────────────────────────────────────

	      Field			Description

	      ─────────────────────────────────────────────────────

	      entry_level		The entry's level number

	      loc_cursor_entry_number	The  number  of	 the entry
					where the location  cursor
					is currently displayed

	      event			A  pointer  to	the XEvent
					that generated this  call‐
					back

	      ─────────────────────────────────────────────────────

	      The  default  is	Null.	Access is CSG.	Callback made when the
	      user clicks on MB2 without moving the mouse.

	      The callback reason is  DXmSvnCREntryTransfer.   Other  callback
	      fields are as follows:

	      ─────────────────────────────────────────────────────

	      Field			Description

	      ─────────────────────────────────────────────────────

	      loc_cursor_entry_number	The  number  of	 the entry
					where the location  cursor
					is currently displayed.

	      ─────────────────────────────────────────────────────

	      ────────────────────────────────────────────────────

	      Value		       Description

	      ────────────────────────────────────────────────────

	      DXmSvnKtransferUnknown   No  modifier was specified
				       with the MB2 click.

	      DXmSvnKtransferMove      The ALT modifier was spec‐
				       ified with the MB2 click.

	      DXmSvnKtransferCopy      The   Ctrl   modifier  was
				       specified  with	the   MB2
				       click.

	      event		       A  pointer  to the X event
				       structure  describing  the
				       event  that generated this
				       callback.

	      ────────────────────────────────────────────────────

	      The default is Null.  Access is CSG.   Callback  made  when  the
	      user cancels ("unselects") the selection of an entry.

	      The fields provided in the callback structure enable an applica‐
	      tion to obtain more information about the entry from its	source
	      module.

	      The  callback reason is DXmSvnCREntryUnselected.	Other callback
	      fields are as follows:

	      ─────────────────────────────────────────────────────

	      Field			Description

	      ─────────────────────────────────────────────────────

	      entry_number		The canceled entry

	      component_number		The component  within  the
					entry  the mouse was posi‐
					tioned over when the entry
					was canceled

	      time			Time  when  the	 selection
					was canceled

	      loc_cursor_entry_number	The number  of	the  entry
					where  the location cursor
					is currently displayed

	      event			A pointer to the  X  event
					structure  describing  the
					event that generated  this
					callback

	      ─────────────────────────────────────────────────────

	      The  default  is Null.  Access is CSG.  A Boolean resource that,
	      when True, creates a rectangle large  enough  to	highlight  the
	      entries.	 The  default is False.	 Access is CSG.	 Callback made
	      when the user double clicks MB1 with multiple entries  selected.
	      To  determine  which  entries are selected, the application must
	      call the DXmSvnGetNumSelections and the DXmSvnGetSelections rou‐
	      tines.

	      The  callback  reason  is DXmSvnCRExtendConfirm.	Other callback
	      fields are as follows:

	      ─────────────────────────────────────────────────────

	      Field			Description

	      ─────────────────────────────────────────────────────

	      entry_number		The entry selected

	      time			Time when the double click
					occurred

	      loc_cursor_entry_number	The  number  of	 the entry
					where the location  cursor
					is currently displayed

	      event			A  pointer  to the X event
					structure  describing  the
					event  that generated this
					callback

	      ─────────────────────────────────────────────────────

	      The default is Null.  Access is CSG.  A Boolean  resource	 that,
	      when  True, specifies that all entries, including the selectable
	      white space to the right of each entry, will be the same	width.
	      Fixed  width  entries  are the width of the display window.  The
	      default is True.	Access is CSG.	The default font when no level
	      font  is	specified.   The default is DXmDefaultFont.  Access is
	      CSG.  The default font  list  used  by  level  0	entries.   The
	      default  is Null.	 Access is CSG.	 The default font list used by
	      level 1 entries.	The default is	Null.	Access	is  CSG.   The
	      default font list used by level 2 entries.  The default is Null.
	      Access is CSG.  The default font list used by level  3  entries.
	      The default is Null.  Access is CSG.  The default font list used
	      by level 4 entries.  The default is Null.	  Access  is  CSG.   A
	      Boolean  resource that, when True, specifies that the SVN widget
	      generate the  DXmSvnNgetEntryCallback  callbacks	in  sequential
	      order  only.   The  default  is False.  Access is CSG.  Callback
	      made when the SVN widget requires information  about  an	entry.
	      The  application	should	respond	 by calling the DXmSvnSetEntry
	      routine.	Control should not be returned from the callback until
	      this  call  and subsequent calls are made to the DXmSvnSetCompo‐
	      nentPixmap , DXmSvnSetComponentText , or	DXmSvnSetComponentWid‐
	      get routines.

	      The  callback reason is DXmSvnCRGetEntry.	 Other callback fields
	      are as follows:

	      ─────────────────────────────────────────────────────

	      Field			Description

	      ─────────────────────────────────────────────────────

	      entry_number		The entry number required

	      entry_tag			The value (previously  set
					in  the	 application  with
					the   DXmSvnSetEntry	or
					DXmSvnAddEntries  routine)
					associated    with     the
					entry_number field

	      entry_level		The entry's level number

	      loc_cursor_entry_number	The  number  of	 the entry
					where the location  cursor
					is currently displayed

	      ─────────────────────────────────────────────────────

	      The  default  is Null.  Access is CSG.  The height of the pixmap
	      for a specific type of highlighted image, or "ghost", that  fol‐
	      lows the entries as they are dragged.  The default is 0.	Access
	      is CSG.  The pixmap for a	 specific type of  highlighted	image,
	      or  "ghost",  that follows the entries as they are dragged.  The
	      default is Null.	Access is CSG.	The width of the pixmap for  a
	      specific type of highlighted image, or "ghost", that follows the
	      entries as they are dragged.  The default is 0.  Access is  CSG.
	      Relative	x position on the screen where the dragging "ghost" (a
	      specific type of highlighted image that follows the  entries  as
	      they  are dragged) is attached to the cursor.  The default is 0.
	      Access is CSG.  Relative y position  on  the  screen  where  the
	      dragging "ghost" (a specific type of highlighted image that fol‐
	      lows the entries as they are dragged) is attached to the cursor.
	      The  default  is 0.  Access is CSG.  Callback made when the user
	      requests help.  The callback  reason  is	DXmSvnCRHelpRequested.
	      Other callback fields are as follows:

	      ─────────────────────────────────────────────────────

	      Field			Description

	      ─────────────────────────────────────────────────────

	      component_number		The    component    number
					within the entry on  which
					help was requested

	      time			The  time  when	 the  user
					requested help

	      entry_number		The entry number for which
					help was requested

	      entry_tag			The  value (previously set
					in  the	 application  with
					the   DXmSvnSetEntry  rou‐
					tine) associated with  the
					entry_number field

	      entry_level		The  level  number  of the
					entry

	      loc_cursor_entry_number	The number  of	the  entry
					where  the location cursor
					is currently displayed

	      event			A pointer to the  X  event
					structure  describing  the
					event that generated  this
					callback

	      ─────────────────────────────────────────────────────

	      Note   that   the	 values	 for  the  entry_number	 and  loc_cur‐
	      sor_entry_number fields vary depending on how the user  requests
	      help, as follows: The user presses the Help key on the keyboard.

	      In this instance, the SVN widget returns a valid entry number in
	      the loc_cursor_entry_number field and then invokes SVN help  for
	      the  corresponding  entry.   The	user invokes context-sensitive
	      help and then clicks on MB1.

	      In this instance, the application	 uses  context-sensitive  help
	      (which   you  include  in	 the  application  by  specifying  the
	      DXmHelpOnContext routine) to invoke help for an  SVN  subwidget.
	      A	 negative  value  in the entry_number field indicates which of
	      the following subwidgets the user	 has  clicked  on  to  request
	      help:

	      ─────────────────────────────

	      Subwidget		     Value

	      ─────────────────────────────

	      DXmSvnKHelpScroll	     -1

	      DXmSvnKHelpNavButton   -2

	      DXmSvnKNavWindow	     -3

	      ─────────────────────────────

	      The  default is Null.  Access is CSG.  The number of pixels each
	      entry level should be  indented.	 The  default  is  16  pixels.
	      Access  is  CSG.	 A  Boolean  resource  that, when True, allows
	      scrolling in outline and column display mode, but	 not  in  tree
	      mode.  If an application uses the existing index window instead,
	      this resource must be  set  to  False.   The  default  is	 True.
	      Access  is CSG.  The percentage of the display window that is in
	      the primary side of the column view.  The default is 50 percent.
	      Access is CSG.  The identifier (widget ID) of the primary window
	      widget in the SVN display.  The default is Null.	 Access	 is  G
	      (read-only).   A	Boolean	 resource  that, when True, allows the
	      user to specify  multiple	 selections.   The  default  is	 True.
	      Access  is  CSG.	The title for a pop-up navigation window.  The
	      default is Null.	Access is CSG.	The number  of	entries.   The
	      value  increases	or  decreases  as  entries  are changed by the
	      DXmSvnAddEntries and DXmSvnDeleteEntries routines.  Access is  G
	      (read-only).  The identifier (widget ID) of the primary horizon‐
	      tal scroll bar.  The default is Null.  Access is G  (read-only).
	      The  identifier  (widget ID) of the pane widget.	The default is
	      Null.  Access is G (read-only).	Callback  made	after  an  MB3
	      click  that  notifies  the application to generate a pop-up menu
	      for this entry.

	      The callback reason is DXmSvnCRPopupMenu.	 Other callback fields
	      are as follows:

	      ─────────────────────────────────────────────────────

	      Field			Description

	      ─────────────────────────────────────────────────────

	      loc_cursor_entry_number	The  number  of	 the entry
					where the location  cursor
					is currently displayed

	      event			A  pointer  to the X event
					structure  describing  the
					event  that generated this
					callback

	      ─────────────────────────────────────────────────────

	      The default is Null.  Access is CSG.  The base x position of the
	      secondary	 window in the column view.  The default is 0.	Access
	      is CSG.  A Boolean resource that, when True, specifies that sec‐
	      ondary  components  still exist even though they are not visible
	      in the column view.  The default is False.  Access is CSG.   The
	      identifier  (widget  ID) of the secondary widget in the SVN dis‐
	      play.  The default is Null.  Access is G (read-only).   Callback
	      made when the user double clicks MB1 on a single entry, indicat‐
	      ing that the user wants to expand	 or  collapse  (contract)  the
	      entry.   The  application	 can  determine	 which	entry has been
	      selected by either examining the entry_number and component_num‐
	      ber  fields  of  the  callback  data structure or by calling the
	      DXmSvnGetSelections routine.

	      This callback is also called when all  three  of	the  following
	      conditions  exist: The DXmSvnNMultipleSelections resource is set
	      to True.	There is no  DXmSvnNExtendConfirm  callback  supplied.
	      The  user	 has  double  clicked  to terminate the selection of a
	      range of entries.

	      In such an instance, the individual calls are from  the  highest
	      entry number selected through the lowest entry number selected.

	      The  callback reason is DXmSvnCRSelectAndConfirm. Other callback
	      fields are as follows:

	      ─────────────────────────────────────────────────────

	      Field			Description

	      ─────────────────────────────────────────────────────

	      component_number		The  component	number	on
					which  the mouse was posi‐
					tioned

	      time			When the second	 click	of
					the double click occurred

	      entry_number		The  entry  number  of the
					selected entry

	      entry_tag			The value (previously  set
					in  the	 application  with
					the   DXmSvnSetEntry	or
					DXmSvnAddEntries  routine)
					associated    with     the
					entry_number field

	      entry_level		The  level  number  of the
					entry

	      loc_cursor_entry_number	The number  of	the  entry
					where  the location cursor
					is currently displayed

	      event			A pointer to the  X  event
					structure  describing  the
					event that generated  this
					callback

	      ─────────────────────────────────────────────────────

	      The  default  is	Null.  Access is CSG.  Specifies what is to be
	      selected.	 The selection mode, which is used by the column view,
	      is indicated by one of the following values:

	      ─────────────────────────────────────────────────────────

	      Value			    Description

	      ─────────────────────────────────────────────────────────

	      DXmSvnKselectEntry	    Selects the entire entry.

	      DXmSvnKselectComp		    Selects  only  the	compo‐
					    nent.

	      DXmSvnKselectCompAndPrimary   Selects the current compo‐
					    nent  and  the entire pri‐
					    mary side  of  the	column
					    view.

	      DXmSvnKselectEntryOrComp	    Selects  either the entire
					    entry (if the selection is
					    made  on the primary side)
					    or only the component  (if
					    the	 selection  is made on
					    the secondary side of  the
					    display window).

	      ─────────────────────────────────────────────────────────

	      The default is DXmSvnKselectEntry.  Access is CSG.  The user has
	      used MB2 to drag selected entries	 to  another  location.	  Note
	      that  the	 use  of this resource is valid only when application-
	      controlled dragging has not been set (with the  DXmSvnNdragging‐
	      Callback and DXmSvnNdraggingEndCallback callbacks).

	      The  callback  reason is DXmSvnCRSelectionsDragged.  Other call‐
	      back fields are as follows:

	      ─────────────────────────────────────────────────────

	      Field			Description

	      ─────────────────────────────────────────────────────

	      component_number		The  component	number	on
					which the mouse button was
					released

	      x				The x  position	 at  which
					the   mouse   button   was
					released

	      y				The y  position	 at  which
					the   mouse   button   was
					released

	      entry_number		The entry number on  which
					the   mouse   button   was
					released

	      entry_tag			The value (previously  set
					in  the	 application  with
					the  DXmSvnSetEntry   rou‐
					tine)  associated with the
					entry_number field

	      entry_level		The entry's level number

	      loc_cursor_entry_number	The number  of	the  entry
					where  the location cursor
					is currently displayed

	      event			A pointer to the  X  event
					structure  describing  the
					event that generated  this
					callback

	      ─────────────────────────────────────────────────────

	      The  default  is Null (dragging will not occur).	Access is CSG.
	      A Boolean resource that, when True, shows the path to the	 root,
	      which  is	 the first entry level in the display (level 0).  This
	      path is represented by a horizontal line over which the  hierar‐
	      chy  of  entry levels (each indented) is displayed.  The default
	      is True.	Access is CSG.	 The  number  of  the  component  that
	      begins  the secondary column.  The default is 0, which indicates
	      that no components should be displayed in the secondary  column.
	      Access  is  CSG.	 Allows	 the  application to specify the entry
	      where the location cursor will be displayed when the SVN	widget
	      is  first	 activated.   You can set this resource only at widget
	      creation time; it cannot be  changed  thereafter.	  The  default
	      position of the location cursor is entry number 1.  Access is C.
	      Callback made when the user has released MB1 following an
	      application-controlled drag operation.

	      The callback reason is DXmSvnCRTransitionsDone.  Other  callback
	      fields are as follows:

	      ─────────────────────────────────────────────────────

	      Field			Description

	      ─────────────────────────────────────────────────────

	      loc_cursor_entry_number	The  number  of	 the entry
					where the location  cursor
					is currently displayed

	      event			A  pointer  to the X event
					structure  describing  the
					event  that generated this
					callback

	      ─────────────────────────────────────────────────────

	      The default is Null.  Access is CSG.  The width for the  arc  of
	      the  outline that delineates the boundary between each tree dis‐
	      play mode entry.	The default is 15 pixels.  Access is  CSG.   A
	      Boolean  resource that, when True, centers components vertically
	      within an entry.	The SVN widget automatically alters  the  size
	      of  the  entries to fit the centered components.	The default is
	      False.  Access is CSG.  A Boolean resource that, when True, dis‐
	      plays an outline around tree mode entries.  The default is True.
	      Access is CSG.  A Boolean resource that, when True, adds shadow‐
	      ing  to  the outline surrounding tree mode entries.  The default
	      is True.	Access is CSG.	A Boolean resource  that,  when	 True,
	      specifies	 that all tree mode entries appear in the index window
	      when the user is scrolling.  The default	is  True.   Access  is
	      CSG.   Specifies	how  much  space, in pixels, to insert between
	      tree levels.  The default is 5 pixels.  Access is CSG.  A	 Bool‐
	      ean  resource  that,  when True, specifies that lines connecting
	      the entries in tree mode are perpendicular instead of  diagonal.
	      The  default  is	True.  Specifies how much space, in pixels, to
	      insert between sibling tree mode entries.	 The default is 5 pix‐
	      els.   Access  is	 CSG.	Specifies the style (format) of a tree
	      display, as indicated by one of the following values:

	      ────────────────────────────────────────────────────

	      Value		       Description

	      ────────────────────────────────────────────────────

	      DXmSvnKtopTree	       A  vertical  tree   format
				       (oriented from the top).

	      DXmSvnKhorizontalTree    A  horizontal  tree format
				       (oriented from the left).

	      DXmSvnKoutlineTree       Oriented in outline form.

	      DXmSvnKuserDefinedTree   Oriented	 in  an	 applica‐
				       tion-defined  format.  The
				       SVN widget uses the x  and
				       y  coordinate  values  you
				       specify for  an	entry  to
				       determine    the	  entry's
				       position in the tree.

	      ────────────────────────────────────────────────────

	      The default is DXmSvnKoutlineTree.  Access is  CSG.   A  Boolean
	      resource	that,  when  True, truncates text that is too long for
	      the display.  The default is False.  Access is CSG.   A  Boolean
	      resource	that, when True, creates outer arrows on a scroll bar,
	      which the user can click on to move the display.	The default is
	      True.  Access is CSG.

   Resources
       typedef struct
	   {
	      int	 reason;
	      int	 entry_number;
	      int	 component_number;
	      int	 first_selection;
	      int	 x;
	      int	 y;
	      XtPointer	 entry_tag;
	      Time	 time;
	      int	 entry_level;
	      int	 loc_cursor_entry_number;
	      int	 transfer_mode;
	      int	 dragged_entry_number;
	      XEvent	 *event;
	    } DXmSvnCallbackStruct;

	      Callback Field Descriptions

	      Note  that all callbacks do not use all the fields listed except
	      reason, which is common to all.  An integer set to the  callback
	      reason.	The  identifier	 of  the entry.	 The identifier of the
	      component.  One of the following values:

	      ────────────────────────────────────────────────

	      Value		   Description

	      ────────────────────────────────────────────────

	      DXmSvnKnotFirst	   This	 is  not  the	first
				   selection  that  has	 been
				   made.

	      DXmSvnKfirstOfOne	   There is only  one  selec‐
				   tion being made.

	      DXmSvnKfirstOfMany   This	 is the first of many
				   selections being made.

	      ────────────────────────────────────────────────

	      This value (when treated as a Boolean function) is usually True.
	      It  is  False  only when the user has made a range selection and
	      this is not the first DXmSvnNentrySelectedCallback.  The x posi‐
	      tion  at	which the event occurred.  The y position at which the
	      event occurred.  The  value  associated  with  the  entry_number
	      field.   You can set this value in your application using a rou‐
	      tine that is appropriate for the particular  callback,  as  fol‐
	      lows:

	      ─────────────────────────────────────────────────────

	      Callback				 Routine

	      ─────────────────────────────────────────────────────

	      DXmSvnNentrySelectedCallback	 DXmSvnSetEntry
						 DXmSvnSetEntryTag

	      DXmSvnNgetEntryCallback		 DXmSvnSetEntry
						 DXmSvnAddEntries

	      DXmSvnNhelpRequestedCallback	 DXmSvnSetEntry

	      DXmSvnNselectAndConfirmCallback	 DXmSvnSetEntry
						 DXmSvnAddEntries

	      DXmSvnNselectionsDraggedCallback	 DXmSvnSetEntry

	      ─────────────────────────────────────────────────────
	      The  time	 when  the  event occurred.  The current entry number.
	      The number of the entry that currently has the location  cursor.
	      A	 constant  specifying the transfer operation that should occur
	      after an MB2 click with no mouse movement.  Contains the	number
	      of  the  entry  currently	 being	dragged	 with  MB2 pressed.  A
	      pointer to the X event structure describing the event that  gen‐
	      erated this callback.

   Callback Reasons
       The following table lists the reasons and the valid callback fields for
       each:

	      ───────────────────────────────────────────────────────

	      Reason			  Valid Fields

	      ───────────────────────────────────────────────────────

	      DXmSvnCRAttachToSource	  reason

	      DXmSvnCRDetachFromSource	  reason

	      DXmSvnCRDisplayChanged	  reason

	      DXmSvnCRDragging		  reason,    x,	  y,   time,
					  loc_cursor_entry_number,
					  dragged_entry_number,
					  event

	      DXmSvnCRDraggingEnd	  reason,    x,	  y,   time,
					  loc_cursor_entry_number,
					  event

	      DXmSvnCREntrySelected	  reason,      entry_number,
					  component_number,
					  first_selection,
					  entry_tag, time,  loc_cur‐
					  sor_entry_number, event

	      DXmSvnCREntryTransfer	  reason,	    loc_cur‐
					  sor_entry_number,   trans‐
					  fer_mode, event

	      DXmSvnCREntryUnselected	  reason, entry_number, com‐
					  ponent_number,       time,
					  loc_cursor_entry_number

	      DXmSvnCRExtendConfirm	  reason,      entry_number,
					  time,		    loc_cur‐
					  sor_entry_number, event

	      DXmSvnCRGetEntry		  reason,      entry_number,
					  entry_tag,	entry_level,
					  loc_cursor_entry_number

	      DXmSvnCRHelpRequested	  reason, entry_number, com‐
					  ponent_number,  entry_tag,
					  time,		entry_level,
					  loc_cursor_entry_number,
					  event

	      DXmSvnCRPopupMenu		  reason,	    loc_cur‐
					  sor_entry_number, event

	      DXmSvnCRSelectAndConfirm	  reason, entry_number, com‐
					  ponent_number,  entry_tag,
					  time,		entry_level,
					  loc_cursor_entry_number,
					  event

	      DXmSvnCRSelectionsDragged	  reason, entry_number, com‐
					  ponent_number,    x,	  y,
					  entry_tag,	entry_level,
					  loc_cursor_entry_number,
					  event

	      DXmSvnCRTransitionsDone	  reason, event

	      ───────────────────────────────────────────────────────

   Keyboard Bindings
       The following table describes how specific keys function within the SVN
       environment.   The  table  also lists the Motif virtual key symbols and
       its associated SVN function.

       ──────────────────────────────────────────────

       Motif Key Symbol	  SVN Function

       ──────────────────────────────────────────────

       KActivate	  Selects and  confirms	 the
			  current entry.  Equivalent
			  to a double MB1  click  on
			  the mouse.

       KBeginData	  Scrolls to the first entry
			  in   the   SVN    display;
			  selects   and	  moves	 the
			  location  cursor  to	that
			  entry.

       KBeginLine	  Scrolls   to	the  extreme
			  left of the display.

       KDown		  Selects  and	 moves	 the
			  location   cursor  to	 the
			  next	entry  in   display,
			  scrolling the display down
			  if necessary.

       KEndData		  Scrolls to the last  entry
			  in	the   SVN   display;
			  selects  and	 moves	 the
			  location  cursor  to	that
			  entry.

       KEndLine		  Scrolls  to  the   extreme
			  right of the display.

       KExtendDown	  Adds the next entry to the
			  extended	  selection.
			  Selects   and	  moves	 the
			  location  cursor  to	 the
			  next entry.

       KExtendUp	  Adds the previous entry to
			  the  extended	  selection.
			  Selects   and	  moves	 the
			  location  cursor  to	 the
			  previous entry.

       KHelp		  Reports  the help callback
			  to  the   application	  if
			  specified.

       KLeft		  Scrolls  the	display	 one
			  character to the left.

       KMenu		  Reports the DXmNpopupMenu‐
			  Callback  to	the applica‐
			  tion if specified for	 the
			  entry	 with  the  location
			  cursor.

       KNextColumn	  Selects  the	next  column
			  component to the right.

       KNextPara	  Scrolls  to  the bottom of
			  the display.

       KPageDown	  Scrolls the display to the
			  next	screen	of  entries.
			  Selects  and	 moves	 the
			  location   cursor  to	 the
			  entry located at the	same
			  relative  position  on the
			  next screen.

       KPageLeft	  Scrolls  the	display	 one
			  screen to the left.

       KPageRight	  Scrolls  the	display	 one
			  screen to the right.

       KPageUp		  Scrolls the display to the
			  previous     screen	  of
			  entries.    Selects	 and
			  moves	 the location cursor
			  to the  entry	 located  at
			  the same relative position
			  on the previous screen.

       KPrevColumn	  Selects the previous	col‐
			  umn component to the left.

       KPrevPara	  Scrolls  to the top of the
			  display.

       KRight		  Scrolls  the	display	 one
			  character to the right.

       KSelect		  Selects  the current entry
			  and  cancels	 all   other
			  selected entries.

       KSelectAll	  Selects  all entries known
			  to SVN.

       KUp		  Selects  and	 moves	 the
			  location   cursor  to	 the
			  previous entry in the dis‐
			  play,	 scrolling  the dis‐
			  play if necessary.

       ──────────────────────────────────────────────

   Translation Table
       ───────────────────────────────────────────────────

       Event		 Action Routine

       ───────────────────────────────────────────────────

       BSelectPress:	 svn_button1_down

       BSelectRelease:	 svn_button1_up

       BSelectDrag:	 svn_button1_motion

       BExtendPress:	 svn_shiftbutton1_down

       BExtendRelease:	 svn_button1_up

       BExtendDrag:	 svn_button1_motion

       BTogglePress:	 svn_ctrlbutton1_down

       BToggleRelease:	 svn_button1_up

       BToggleDrag:	 svn_button1_motion

       BDragPress:	 svn_button2_down

       BDragRelease:	 svn_button2_up

       BDragDrag:	 svn_button2_motion

       BDragToggle:	 (MB2-ctrl-click)svn_button2_down

       BDrag:		 (MB2-Alt-click)svn_button2_down

       BMenu:		 svn_button3_down

       BFocusIn:	 svn_focus_in

       BFocusOut:	 svn_focus_out

       BHelp:		 svnhelp

       ───────────────────────────────────────────────────

   Keyboard Syntax
       ────────────────────────────────────────────

       Event		   Action Routine

       -

       KMenu:		   svn_f4_menu

       KDown:		   svn_arrow_down

       KUp:		   svn_arrow_up

       KPageDown:	   svn_page_down

       KPageUp:		   svn_page_up

       KEndData:	   svn_scroll_to_top

       KBeginData:	   svn_scroll_to_bottom

       KExtendUp:	   svn_extend_up

       KExtendDown:	   svn_extend_down

       MShiftKPageUp:	   svn_extend_pageup

       MShiftKPageDown:	   svn_extend_pagedown

       MShiftKBeginData:   svn_extend_to_top

       MShiftKEndData:	   svn_extend_to_bottom

       KLeft:		   svn_arrow_left

       KRight:		   svn_arrow_right

       KBeginLine:	   svn_scroll_to_left

       KEndLine:	   svn_scroll_to_right

       KPageLeft:	   svn_page_left

       KPageUp:		   svn_page_right

       KActivate:	   svn_activate_entry

       MCtrlKActivate:	   svn_activate_entry

       KSpace:		   svn_activate_entry

       MCtrlKSpace:	   svn_activate_entry

       KSelect:		   svn_activate_entry

       KHelp:		   svnhelp

       KSelectAll:	   svn_select_all

       KDeSelectAll:	   svn_deselect_all

       KNextColumn:	   svn_next_column

       KPrevColumn:	   svn_prev_column

       MShiftKTab:	   LclTraversePrevTabGroup

       KTab:		   LclTraverseNextTabGroup

       MCtrlKTab:	   LclTraversePrevTabGroup

       KCancel:		   svn_cancel

       KNextPara:	   svn_next_level

       KPrevPara:	   svn_prev_level

       ────────────────────────────────────────────

   Action Routines
       ─────────────────────────────────────────────────────

       Routine			 Description

       ─────────────────────────────────────────────────────

       svn_button1_down		 Selects  and	moves	the
				 location   cursor  to	the
				 current  entry.  Deselects
				 all other entries.
       svn_button1_up		 Completes	  selection
				 started  by  the   button1
				 press.	     Reports	the
				 DXmSvnNentrySelectedCall‐
				 back to the application if
				 specified.  If this  BtnUp
				 was a completion of a dou‐
				 ble   MB1    click,	the
				 DXmSvnNselectAndConfirm‐
				 Callback will be  reported
				 to   the   application	 if
				 specified.

       svn_button1_motion	 Extends    selection	 to
				 include  entries  that are
				 passed over with the mouse
				 motion.  If the Ctrl modi‐
				 fier was pressed with this
				 MB1  motion,  all  entries
				 passed over with the mouse
				 selection  state  are tog‐
				 gled.
       svn_shiftbutton1_down	 Extends    selection	 to
				 include     all    entries
				 between the last  selected
				 entry	 and  this  current
				 entry.	 Moves the location
				 cursor	  to  this  current
				 entry.
       svn_ctrlbutton1_down	 Toggles   the	  selection
				 state of the current entry
				 and  moves  the   location
				 cursor to this entry.
       svn_button2_down		 Initiates  a  drag  opera‐
				 tion. If MB2  was  pressed
				 on  a	selected entry then
				 all selected  entries	are
				 dragged.    If	  MB2	was
				 pressed  on  a	 unselected
				 entry then only that entry
				 will be dragged.   If	the
				 application has set appli‐
				 cation dragging,  via	the
				 DXmSvnSetApplDragging rou‐
				 tine, the DXmSvnNdragging‐
				 Callback  will be reported
				 if specified.
       svn_button2_up		 Completes the drag  opera‐
				 tion.	 The  DXmSvnNselec‐
				 tionsDragged callback will
				 be  reported to the appli‐
				 cation if  specified,	and
				 the entries were selected.
				 If the application has set
				 application  dragging, via
				 the  DXmSvnSetApplDragging
				 routine,  the DXmSvnNdrag‐
				 gingEndCallback  will	 be
				 reported if specified.	 If
				 the  MB2  click  has  been
				 made without mouse motion,
				 the  DXmSvnNentryTransfer‐
				 Callback  will be reported
				 to  the   application	 if
				 specified.
       svn_button2_motion	 A  ghost  object  will	 be
				 created  and  will  follow
				 the mouse with MB2 motion.
       svn_button3_down		 Reports   DXmSvnNpopupMenu
				 callback to  the  applica‐
				 tion if specified for this
				 entry.
       svn_focus_in		 Sets focus to the SVN wid‐
				 get. Moves location cursor
				 to last selected entry	 in
				 display.

       svn_focus_out		 Removes focus from the SVN
				 widget.    Also    removes
				 location  cursor from last
				 selected entry.
       svnhelp			 Reports the help  callback
				 DXmSvnNhelpCallback to the
				 application if specified.
       svn_f4_menu		 Reports the DXmNpopupMenu‐
				 Callback  to  the applica‐
				 tion if specified for	the
				 entry	with  the  location
				 cursor.
       svn_arrow_down		 Selects  and	moves	the
				 location   cursor  to	the
				 next entry in the display,
				 scrolling the display down
				 if necessary.
       svn_arrow_up		 Selects  and	moves	the
				 location   cursor  to	the
				 previous entry in the dis‐
				 play,	scrolling  the dis‐
				 play up if necessary.
       svn_page_down		 Scrolls the display to the
				 next  screen  of  entries.
				 Selects  and	moves	the
				 location   cursor  to	the
				 entry located at the  same
				 relative  position  on the
				 next screen.
       svn_page_up		 Scrolls the display to the
				 previous     screen	 of
				 entries.    Selects	and
				 moves	the location cursor
				 to the	 entry	located	 at
				 the same relative position
				 on the previous screen.
       svn_scroll_to_top	 Scrolls to the last  entry
				 in    the   SVN   display;
				 selects  and	moves	the
				 location  cursor  to  that
				 entry.
       svn_scroll_to_bottom	 Scrolls to the first entry
				 in    the   SVN   display;
				 selects  and	moves	the
				 location  cursor  to  that
				 entry.
       svn_extend_up		 Adds the previous entry to
				 the   extended	 selection.
				 Selects  and	moves	the
				 location   cursor  to	the
				 previous entry,  scrolling
				 the display if necessary.
       svn_extend_down		 Adds the next entry to the
				 extended	 selection.
				 Selects   and	 moves	the
				 location  cursor  to  that
				 next  entry, scrolling the
				 display if necessary.
       svn_extend_pageup	 Extends the  selection	 to
				 include all entries in the
				 next  screen.	 Moves	the
				 location   cursor  to	the
				 entry located at the  same
				 relative  position  on the
				 previous screen.

       svn_extend_pagedown	 Extends the  selection	 to
				 include all entries in the
				 previous  screen.    Moves
				 the location cursor to the
				 entry located at the  same
				 relative  position  on the
				 previous screen.
       svn_extend_to_top	 Extends selection from the
				 currently  selected  entry
				 to the top entry known	 to
				 SVN.	Moves  the location
				 cursor to that top entry.
       svn_extend_to_bottom	 Extends selection from the
				 currently  selected  entry
				 to the bottom entry  known
				 to  SVN.   Moves the loca‐
				 tion cursor to that bottom
				 entry.
       svn_arrow_left		 Scrolls  the  display	one
				 character to the left.
       svn_arrow_right		 Scrolls  the  display	one
				 character to the right.
       svn_scroll_to_left	 Scrolls   to  the  extreme
				 left of the display.
       svn_scroll_to_right	 Scrolls  to  the   extreme
				 right of the display.
       svn_page_left		 Scrolls  the display hori‐
				 zontally one screen  width
				 to the left.
       svn_page_right		 Scrolls  the display hori‐
				 zontally one screen  width
				 to the right.
       svn_activate_entry	 Selects  and  confirms the
				 current entry.	 Equivalent
				 to  a	double MB1 click on
				 the mouse.
       svn_select_all		 Selects all entries  known
				 to SVN.
       svn_deselect_all		 Deselects    all   entries
				 known to SVN.
       svn_next_column		 Selects  the  next  column
				 component to the right.
       svn_prev_column		 Selects  the previous col‐
				 umn component to the left.
       LclTraversePrevTabGroup	 Moves the location  cursor
				 (focus)  to  the  next Tab
				 group.	 In SVN, there is a
				 primary and secondary win‐
				 dow which are both  scrol‐
				 lable,	 and  which  are in
				 separate TAB groups.  This
				 function  will	 allow	the
				 focus	to  move  to  other
				 window in SVN.
       LclTraverseNextTabGroup	 Moves	the location cursor
				 to the previous Tab group.
				 In SVN, there is a primary
				 and secondary window which
				 are both scrollable, which
				 are   in   separate	TAB
				 groups.    This   function
				 will allow  the  focus	 to
				 move  to  other  window in
				 SVN.

       svn_cancel		 Cancels any dragging oper‐
				 ation	or  extended selec‐
				 tion in  progress.   Moves
				 the location cursor to the
				 previous entry that it was
				 on  before  the  operation
				 was started.
       svn_next_level		 Scrolls to  the  entry	 at
				 the  next level in the SVN
				 hierarchy.
       svn_prev_level		 Scrolls to  the  entry	 at
				 the  previous level in the
				 SVN hierarchy.

       ─────────────────────────────────────────────────────

   Inherited Resources
       DXmCreateSvn inherits behaviour and resources from the following super‐
       classes:

       Core Resource Set Composite Resource Set Constraint Resource Set XmMan‐
       ager Resource Set DXmSvn Resource Set

RETURN VALUES
       The identifier (widget ID) of the created SVN widget.

RELATED INFORMATION
       DXmSvnAddEntries(3X),  DXmSvnAutoScrollCheck(3X),  DXmSvnAutoScrollDis‐
       play(3X),     DXmSvnClearHighlight(3X),	  DXmSvnClearHighlighting(3X),
       DXmSvnClearSelection(3X),  DXmSvnClearSelections(3X),   DXmSvnDeleteEn‐
       tries(3X),  DXmSvnDisableDisplay(3X),  DXmSvnEnableDisplay(3X), DXmSvn‐
       FlushEntry(3X),	  DXmSvnGetComponentNumber(3X),	   DXmSvnGetComponent‐
       Tag(3X),	   DXmSvnGetComponentText(3X),	  DXmSvnGetComponentWidth(3X),
       DXmSvnGetDisplayed(3X),	 DXmSvnGetEntryLevel(3X),   DXmSvnGetEntryNum‐
       ber(3X),	  DXmSvnGetEntryPosition(3X),	DXmSvnGetEntrySensitivity(3X),
       DXmSvnGetEntryTag(3X),	 DXmSvnGetHighlighted(3X),    DXmSvnGetNumDis‐
       played(3X),   DXmSvnGetNumHighlighted(3X),  DXmSvnGetNumSelections(3X),
       DXmSvnGetPrimaryWorkWidget(3X),	     DXmSvnGetSecondaryWorkWidget(3X),
       DXmSvnGetSelections(3X),	  DXmSvnGetTreePosition(3X),   DXmSvnHideHigh‐
       lighting(3X), DXmSvnHideSelections(3X), DXmSvnHighlightAll(3X), DXmSvn‐
       HighlightEntry(3X),    DXmSvnInsertComponent(3X),   DXmSvnInvalidateEn‐
       try(3X),	 DXmSvnMapPosition(3X),	 DXmSvnPositionDisplay(3X),  DXmSvnRe‐
       moveComponent(3X),    DXmSvnSelectAll(3X),   DXmSvnSelectComponent(3X),
       DXmSvnSelectEntry(3X),  DXmSvnSetApplDragging(3X),   DXmSvnSetComponen‐
       tHidden(3X),  DXmSvnSetComponentPixmap(3X),  DXmSvnSetComponentTag(3X),
       DXmSvnSetComponentText(3X), DXmSvnSetComponentWidget(3X), DXmSvnSetCom‐
       ponentWidth(3X),	  DXmSvnSetEntry(3X),	DXmSvnSetEntryIndexWindow(3X),
       DXmSvnSetEntryNumComponents(3X), DXmSvnSetEntryPosition(3X),  DXmSvnSe‐
       tEntrySensitivity(3X),	  DXmSvnSetEntryTag(3X),    DXmSvnSetTreePosi‐
       tion(3X), DXmSvnShowHighlighting(3X), DXmSvnShowSelections(3X), DXmSvn‐
       ValidateAll(3X)

							      DXmCreateSvn(3X)
[top]

List of man pages available for Ultrix

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net