NAME

	xgroups - A program manager for X

SYNOPSIS

	xgroups
	xgroups_boot
	xgroups_newg [-d|-g|-p] input_file.grp group_name [item_name]
	xgroups_exec cmdline
	xgroups_config path1 path2 ...

AUTHOR

	Giuseppe Zanetti
	via Vergani, 11
	35031 Abano Terme (Padova) - ITALIA

	e-mail: beppe@maya.dei.unipd.it


WHAT IS XGROUPS

	This  is  Xgroups,  a  simple  program  that  emulate  the
	functions  of  the  Win**ws  Program Manager. I wrote this
	program  in  2  days  and  i  think there are some bugs. I
	include  a  modified version of xqtk2 but i don't remember
	the  author  of it.  If you want Xgroups, you need libXpxm
	installed.

INSTALLATION

	for a simple installation do:

		make install

	If you install correctly the software, some files are cre-
	ated in the /usr/local/lib/xgroups directory, but not  the
	icons.lst,  that contents the file names of the icons. You
	can configure this with

		xgroups_config xpm_dir1 xpm_dir2 ... xbm_dir1 ...

	where path1 path2 ... are the directory in  that  are  the
	icons (xpm or xbm). For example:

		xgroups_config /usr/Icons-0.1/xpm

	Now  you  can  insert xgroups_boot in yours .xinit file or
	execute  it by hand to execute some nice programs that are
	in the "boot.grp" group.

	You  can also create (manually or with the command find) a
	file called $HOME/.xgroups/icons/lst with the icons set of
	every user. I think that in a next release you will create
	it with xgroups_config.

EXAMPLE OF INSTALLATION

	I have my icons in /usr/Icons-0.1/xpm and in /usr/bitmaps:
	First i log on as root and compile xgroups:

		cd /usr/local/src/xgroups
		make install

	Now i configure the program for my setup:

		xgroups_config /usr/Icons-0.1/xpm /usr/bitmaps

	Last i can start the program manually:

		xgroups

	or use it as a session manager

		vi .xinit
		insert xgroups_boot in .xinit

USAGE

	A  group is a file that contains programs or other groups.
	A  group  can  reside both in the xgroup system  directory
	/usr/local/lib/xgroups   or   in   a   personal  directory
	$HOME/.xgroups and is simply a file with extension .grp
	that contains lines in this format:

	I="icon path"  N="name" C="command line"

	or, if the entry is a group:

	I="icon path"  N="name" G="command line"

	where the command line for a group entry is:

	xgroups name

	that means that another xgroup process will started.

	xgroups  search  a  name.grp  file  first in the directory
	/usr/local/lib/xgroups and than in the personal directory.

	The   groups   that   a   user  modify  are  stored in the
	directory  $HOME/.xgroups  and are found first than a file
	with the same name in the system directory.

	If you run xgroups, it starts the default group "start" in
	yours X display and wait for a action.

	You can navigate trough the groups  with  the  left  mouse
	button:  if  you  double  click  a program icon or a group
	icon, the appropriate program will be executed or a  group
	will  be  opened.  First you are in the group "start", but
	you can open another group. If you start the program  with
	xgroups_boot,  it  works  as a session manager and execute
	the contents of the group "boot" (programs and/or groups)

	You can  put xgroups_boot in your .xinit script or execute
	it  by hand: it works as a session manager and execute the
	programs  specified in boot.grp

	You  have  two  menus  (or  3,  because  if there are some
	subgroups a "Groups" menu will created.

	With the first menu you can see my face or exit xgroups.

	With  the  "Options" menu you can add a new group or a new
	program or delete a selected entry. You can also select or
	unselect all the icons.

FILES

	/usr/local/lib/xgroups/*.grp		groups of programs
	/usr/local/lib/xgroups/*.xpm		system icons
	/usr/local/lib/xgroups/*.icon.lst	icons database
	$HOME/.xgroups						personal directory
	$HOME/.xgroups/*.grp				personal groups
	$HOME/.xgroups/icons.lst			personal icons database
	*.xbm								icons (bitmaps)
	*.xpm								colors icons (pixmaps)

BUGS

	my english is VERY BAD !!!
	the manual is VERY BAD !!!
	please report if there are bugs.
	please port xgroup on every machine :-)

