@database DePack!

DePack! Documentation in Amigaguide Hypertext format

Copyright (c) 1993 Laserdance Productions / T$B
All Rights Reserved

@node main "DePack! interactive hypertext documentation - Main-Menu"

»...a little blue-green planet whose ape-descended life formas
are so amazingly primitive that they still think digital watches
are pretty neat idea.«
					Douglas Adams

@{b}Introductory Information@{ub}

@{"     Introduction    " link about} About the program
@{"   Getting started   " link easystart} A quick introduction
@{"      Installing     " link install} Installing the program
@{"    StartUp-Errors   " link starterrors} Startup-errors


@{b}Using DePack!@{ub}

@{"      The Menus      " link menus} The menus and their usage
@{"    Keyboard usage   " link keys} Cursor controls and selecting files
@{" The DePack! Process " link processing} Processing the files
@{"     Preferences     " link aboutprefs} The preferences system


@{b}Tech Talk@{ub}
 
@{"  Dirfile Structure  " link dirfilestruct} How the dirfile is built
@{"      Known bugs     " link bugs} Erm ...
@{"    Technical info   " link tech} Some programmer's information
@{"       History       " link history} What's new ?
@{"    Terminology      " link terminology} Explanation of some expressions


@{b}Addendum@{ub}

@{" Demo/Final  Version " link big} Differences betweed demo and final version
@{" System requirements " link requirements} System requirements to run the program
@{"  PD and Shareware   " link shareware} A comment on the PD scene
@{"Copyrights/Disclaimer" link copyright} Legal stuff
@{" Credits and hellos  " link greetings} Some messages to the world outside
@{"      Smalltalk      " link blah} Chitchatting with no great use
@{"    Contacting us    " link contact} Laserdance Productions and Illusion Software
@{"    Soon to come     " link tocome} Soon coming from Laserdance Productions
@{"  Some advertising   " link addies} Some merchandise

@endnode



@node bugs "Known bugs"
DePack!   was  written,  compiled  and  linked  on  a Amiga 4000/040
platform  (Yeeeah...   that is speed).  It has been carefully tested
on  many  systens  without  showing  up any problems.  Of course the
author  can  give no guarantee for this program running on all Amiga
platforms  and  configuration  with ROM version 37 or higher and the
required programs installed.

The  program was developed on a PAL system, and has been tested with
the  Hardware  set to NTSC in the bootmenu.  The screen that will be
opened  is  always  256  lines  high.   In  NTSC  the screen has the
AUTOSCROLL  and  OSCAN_TEXT  flags  set,  so  it  will  open  in you
preferences-overscan  textsize  and  you  can  scoll around with the
mouse.

There  are  no  known  bugs  to  the author, except that the display
routines  sometimes  mess  up  the  display  a bit (in 0.01 % of all
cases).  The enforcer hits of the older versions seem to be gone.

If you notice any bugs, or have problems with the program please send
a detailed bug report to the author.

See also : @{" Contacting the author " link contact}


Zum Thema Bugs noch ein Kommentar von Kurt (FSR) :

'Unten  wo  der Gammel regiert, ne, da liecht alles voller abgeflexter
Raucherbeine  und  Geschwuere.   ...  Is mir schlecht ...  Guergen ...
Hilfe ...  der Gammel will mich in sein Reich entfuehren ...'

					© Oliver Kalkofe, FFN
@endnode



@node big "What are the differences between demo and final version ??"
If  you  obtain the registerized version of the package, you'll will
receive a version with no restrictions left in it !  The loading and
saving  of  preferences  is enabled, and the program will try to get
your  favourite  preferences from the ENVARC:  directory on startup.
@endnode

@node keys "The magic is below your hands ..."
DePack!   is  controlled  by  keyboard  with  support  of  intuition
elements  like  menus  or file-requesters.  Here is how the keys are
assigned :

	Return/Enter	-	Mark Entry below cursor
	Cursor Up	-	Move cursor one line up
	Cursor Down	-	Move cursor one line down
	Numeric CrsrUp	-	Move cursor one line up
	Numeric CrsrDw	-	Move cursor one line down (u guessed it!)
	Shift+CrsrUp	-	Move cursor one page up
	Shift+CrsrDw	-	Move cursor one page down
	Shift+NumCrsrUp	-	Move cursor one page up
	Shift+NumCrsrDw	-	Move cursor one page down
	Numeric Home	-	Move cursor to line #1
	Numeric	End	-	Move cursor to last line
	Numeric PgUp	-	Move cursor one page up
	Numeric PgDw	-	Move cursor one page down
@endnode


@node tech "Technical information"
This  chapter  of  the  manuals  provides  information for all those
freaks out there who want to know about the coder-side of DePack!

DePack!   opens a public screen (name :  'DePack!'), so you can open
any other program with public screen support on DePack!'s screen.

DePack!   in  todays  form was developed in 8 months of more or less
intensive work (5 months of intensive work, 3 were lazy business) on
a  Amiga  500  with  a  52MB  harddisk  and  4  MB  of  memory (well
unaccelerated  ;)  and  in  later stages of the program written on a
Amiga   4000/40,   210  MB  SCSI-hd  and  10  MB  or  RAM:   (wow...
unfortunatly  this  is not my computer ;-).  The sourcecode is split
into 15 modules to be linked after compilation and is ca. 130 KBytes
long.
@endnode

@node dirfilestruct "The inner core"
Depack!   uses  several layout conventions of the @{"Dirfile" link terminology} which must
be obeyed if you load files for use as Depack!-directory-files.

· The maximum line length is limited to 100 characters.
· The maximum amount of total lines is limited to 32000

The @{"Dirfile" link terminology} is a textfile with the following structure :

	Entry 1
	Entry 2
	  ·
	  ·
	  ·
	Entry n			( 0 < n < 32000)




An entry is defined as :

	Startline
	Descriptionline 1
	Descriptionline 2
	  ·
	  ·
	  ·
	Descriptionline n	(Desciptionlines optional 0 < n < 8)



Startline :

XXXXXXXXXXX ..............................................................

filename    (rest of line not referenced)
(up to 30 chars)




Descriptionline :
 .........................................................................

First character must be <Space> or <Tab> ! The rest is not referenced.




Example :
---------

PARTY93.DMS  P 110835  09-01-93  ·+­­­­­­!­­­­­­­­­­­­­­­­­­­­­­­­­­­­­+·
                                  |  _  _:____  ________________/\ [Hb]| 
                                  |      ¡\ __\/_/ / __/_  / __/  \    | 
                                  |    _  _\ \/ / /___/ / / /\/ /\/    | 
                                  |     _/___/ /\__/_/\_\_\/\  /       | 
                                  |          \/              \/        | 
                                 ·+­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­+·
                                  `   INVITATION  FOR  THE PARTY III   '
is a valid entry.

its_sm.dms                645771 ----rwed 05-Oct-93 17:27:25
jhh.lc!.txt                43613 ----rwed 05-Oct-93 17:55:48
JSM-NBA1.DMS              710036 ----rwed 17-Oct-93 22:16:59
JSM-NBA2.DMS              751952 ----rwed 17-Oct-93 22:10:33
JSM-NBA3.DMS              688716 ----rwed 17-Oct-93 22:09:42
JSM-NWBL.DMS              569952 ----rwed 17-Oct-93 22:32:21

is also valid. This is the output of a 'list' command


S_ST3.1.DMS  P 390871  09-01-93     __________ ______ ______ ________________
                                  _/  _____ I \\__ _ \\____ \\__ _____  ____/
                                  \___  \/     \/ _j  \/  |  \/  _>__\___  \ 
                                  /  !   \  T   \ l_   \  !   \  !~ \~  !   \
GREATPROGRAM                     /    ___/__l___/__l___/______/_____/___    /
                                 \____j-----------------------------sctl___/
                                      SHADESTRACKER 3.1 - LATEST UPDATE
                                                                   [-SlAyER-]

is  not  valid because the string "GREATPROGRAM" at the beginning of
the  5th  is  no  filename and deserves a <Space> or <Tab> appearing
before to belong to the description.

A  @{"Dirfile" link terminology}  can  contain  many subsequent entries.  If you select an
item  by  pressing  <Return> or <Enter> anywhere between the 1st and
8th line of an entry it will get marked !
@endnode



@node easystart "Easy start ..."
Well, I included a textfile on the disk that gives you a tutorial-like
step-by-step introduction in the most important functions of DePack!
You'll find it in the Main drawer its called '@{b}EasyStart.txt@{ub}'
@endnode


@endnode

@node about "About DePack!"
DePack! is an easy to use tool for /X sysops and traders who like to
DePack! their software stored and cramped into packed files produced
by archivers like 'lha', 'zoo', diskmashed with 'dms' or simply read
the newest textfiles available in their BBS-directories.

The  basic  idea  is  that  you  select a couple of files from an /X
directory  simply  by  marking  them  with a cursor and then perform
certain  operations  e.g.   copy  them to an other directory, delete
them  or  (and  that is the main thing behind DePack!) call external
commands  (in  form  of  AmigaDos executables) depending on the file
type.   This  means that e.g.  if you select an DiskMasher-file, you
are  asked to enter a disk and then the 'dms'-command will be called
externally  and  the  data stored in the .dms-file will be written a
disk  in  df0:.   If  the  file  is  a IFF-ILBM file you can call an
external viewer and display the picture stored in the file.

This  whole  idea was born by some member(s) of the group 'D-TECT' a
long  time  ago.  They released 'D-Tect's Deluxe DePacker', but this
programm was so badly written (assembler hardcode) with so many bugs
and  a  bad GUI that I decided to reprogram the whole thing with the
following goals in my mind :  a) Written in C (as I started coding C
last  year)  b)  High-Quality  Graphical  User Interface c) Enhanced
functions and features.
@endnode

@node install "Installing DePack!"
To  install  DePack!   double click the Icon 'DePack!-Install'.  You
must   have   the   commodore   installer  tool  installed  in  your
c:-directory.   All  files  needed  will  be  copied to the path you
specify.

See Also : 

@{" Requirements " link requirements}
@endnode

@node requirements "Requirements"
DePack!   needs  some  additional  files  to  work, some of them are
essential to start the program, some of them are optional :

Required things :

- Operating System 2.0 or higher (starting with V37)
			- for the GadTools.library GUI

- diskfont.library (V37 or higher)
			- for the output routines

- reqtools.library (V38 or higher)
			- for the requesters


Optional things :

- amigaguide.library (any version will do)
			- for using the hypertext-help system

- fonts:p0t-noodle.font
  fonts:p0t-noodle/8
			- this is the default DePack! font, if it doesn't
			  find it it will switch to use the topaz/8 ROM-font
@endnode

@node starterrors "Error's while starting DePack!"
When  trying  to  start DePack, it probably prints out several error
codes  if  it  has  some  problems  while  finding free libraries or
memories.   Look  into  the list below how to find and fix the error
codes.

	@{" Error  1 " link error1}  Error opening disk libraries
	@{" Error  2 " link error2}  Error opening ROM libraries
	@{" Error  3 " link error3}  Error opening screen
	@{" Error  4 " link error4}  Error opening window
@endnode

@node error1 "Error 1 while starting DePack!"
DePack!   had  problems opening the required libraries.  Perhaps you
need a newer version of a library or the library is not installed in
the libs:  drawer

	Libraries Required		Versions Required

	diskfont.library		>=V37
	reqtools.library		>=V38
@endnode

@node error2 "Error 2 while starting DePack!"
DePack!   had  problems opening the required ROM libraries.  Perhaps
you  have  a wrong kickstart (V1.3 or lower).  DePack!  only runs on
V2.0 or a newer version of the operating system :

	Libraries Required		Versions Required

	gadtools.library		>=V37
	intuition.library		>=V37
	gfx.library			>=V37
@endnode

@node error3 "Error 3 opening screen"
DePack!  had problems opening the screen.  Perhaps you have too less
chip memory free.
@endnode

@node error4 "Error 4 opening window"
DePack!  had problems opening the window.  Perhaps you have too less
chip memory free.
@endnode

@node history "Depack! Version history"

V0.00	(08.03.1993)	Started coding

	Sweat. Pain. Agony. Headaches. Hangovers. Blood. Trips.
	Will this ever come to an end ???

V1.00ß	(22.07.1993)	First test version for the beta-testers

	With regards to the response of the betatesters I could
	find and manage a lot of bugs and add a lot of useful stuff

V1.01ß	(27.07.1993)	· Problem if too many files selected. Fixed
			· Line length checking
			· Requesters added
			· better Dir-memory-management
			· added option to process last file again

	My harddisk crashed so I was interrupted 1 month. Life's
	a bitch sometimes ...

V1.02ß	(12.09.93)	· added option to select other filetype
			· fixed "bug" in File-Recognition-routine that
			  recognised DMS-files as ASCII-files, if they
			  had Ansi-logos added to them
			· "Deselect Files"-confirmation requester now
			  appears only if files are selected
			· Added several asynchronous BusyRequesters
			· Added ResultWindow while DePack!ing, to make
			  process more transparent to the user
			· Quit/PrefsEdit didn't worked when hotkey
			  (Amiga-Q/E) was used. Fixed.
			· Partial deselection of processed files now
			  possible
			· Improved Manual

	Changed Version system to an autobumping system. So the next
	version/revision # after V1.02ß is 38.0

38.29	(02.10.1993)	· Version system changed to more intelligent thing.
			  Thanx to John Preston for the program.
			· Results are displayed after DePack!ing
			· More intelligent window system
			· Added some menus and help stuff
			· PatternMatching function added. All lines
			  that contain an entered string will be high-
			  lighted in color #3 
			· Dirreading much faster (3x)

	Two weeks peace ... a little break from coding

38.66	(28.10.1993)	· Added three new features : Jump to line/entry
			  and insert entry
			· Last line of @{"Dirfile" link terminology} wasn't read 100%. Fixed.
			· Added online Amigaguide-Hypertext (yell from
			  the audience)-help via amigaguide.library
			  (Can I get applause for that ?? If I go on
			  I'll even code an Arexx-port <Gnarf!>)

	Yeah ! V38.244 is the first sold/released version

38.244	(17.11.1993)	· Fixed displaybug while searching
			· Redesigned Preferences-Window, options are now
			  100% working
			· Custom Commands can be assigned with a name
			· Statuswindow while copying, depacking, deleting
			  added. This one finally presents a @{"Listview" link terminology}
			  with all filenames to the user
			· Function added : The @{"Dirfile" link terminology} can now be filtered.
			  That means you display only the files that
			  are currently in the three source dirs. All other
			  won't appear in the main dirdisplay
			· @{"Dirfiles" link terminology} can be saved. Useful after filtering
			· @{"Dirfiles" link terminology} can be loaded from the menu
			· Fixed another display bug
			· GUI improved. GasGauges-Progress-gadgets added.

	First public released demo version

38.410 (07.12.1993)	· Redisigned Status and Output windows
			· Improved Copy mode & routines
			· Filtering @{"Dirfiles" link terminology} now much faster (10-20x)
			· Screen wouldn't close with visitor windows in
			  it. Fixed.
			· System default font had to be 8 chars width,
			  non-prop to work. Fixed
			· Filenames are no longer limited to 12 characters
			  (/X-length). 30 chars are now possible
			· New function : Convert a directory into a @{"Dirfile" link terminology}
			· New function : Show files not noted in @{"Dirfile" link terminology}
			  and create a new dirfrom them.
			· Some small improvements
			· External format added
			· Some jokes added and nasties removed
			· Duplicate start check
			· "Invisible" 4th source-directory for function
			  'Read Directory" added
			· Now opens a autoscrolling screen in OSCAN_TEXT
			  width in NTSC mode (hello American Users !)

@endnode



@node aboutprefs "About the preferences"
DePack!   can  be configured via several preferences.  They concern a broad
variety of settings e.g.  the needed paths or if you want DePack!  to react
on diskchange-events while depacking the files.

The  preferences  can  be  changed  through two menu selections in the pre-
ferences window

	@{" Edit Preferences " link iprefs} puts up the main prefs window
	@{" Mode             " link mprefs} sets the mode of processing

	@{" Load             " link lprefs} loads new settings from disk
	@{" Save             " link sprefs} saves current settings as default
	@{" Save as          " link aprefs} saves current settings in file

You  can  save  those  settings like normal AmigaDos-preferences and
load them in an later session.  On startup DePack!  tries to use the
preferences  stored  in  a the file 'env:DePack!.prefs'.  If its not
there  the  program  switches back to its internal default settings.
@endnode

@node iprefs "Global Preferences"
A  window will open with many string gadgets in it :  you can change
the  preferences  here.  To understand this you should have read the
introduction of the {@"'DePack!-process'" link processing} before.

The  first  nine  boxes  on the left side build the interface to the
external  commands.   They will be used as follows.  If you selected
the  menu-item @{" Mode/DePack! " link mprefs} . DePack!   analyses  the files in the
source-directories  their  type.   In  95%  of all cases they can be
recognised  as  'DMS','LHa',  ...  all the other files that can't be
matched  need  to  be  specified  by you.  Here you can determine in
which  way  those  file  are  treated.   For  every file an external
command  according  to your preferences will be called.  So you have
to  enter  the  commandlines  (the  ones you'd normally enter in the
CLI/Shell)  and  replace  the source name by %s, and the destination
name  by  %d.   For  example  if  the  CLI  normal commandline you'd
normally use from the Shell would look like this :

	c:dms write bbs:conf1/upload/test.dms drive=df0:

the corresponding line in the preferences would be :

	c:dms write %s drive=%d

The letters %s and %d will be replaced by the correct paths later on
(see below).

In  the  three  uppermost  boxes  on  the  right  side  you have the
possibility  to  enter  one  or  more source-directories.  In one of
those  you  can  specify  where  the  files  to be processed reside.
DePack!  will scan them in the order 1, 2, 3.  NOTE :  If one of the
gadgets  contains  no  string  it  will be considered as the current
directory.   This  can  be  a little bit confusing when you scan for
files  not  denoted  (See also : @{" Files not denoted " link m_notden}.  So you better
set unneeded source-directory strings to NIL:

The  box  below  contains  the  destination  directory.  The %d (see
above) is to be replaced by this string or, if you are in copy mode.
The  files  will be copied to this destination-directory.  Warning :
If  you  use the directory-requester for this gadget and select e.g.
df0:  in the DirReq-window the reqtools.library will return the name
of the disk instead of df0:  (example Empty:).  This can be fatal if
you  need  to  change the disks in DePack!  or copy mode.  So if you
got  to  enter a DEVICE-name use the string gadget and NOT the 'Get'
button.

The  next string gadget determine the /X-directory file to be worked
on.   If  select  a  new  file,  it will be loaded after closing the
window with the close-gadget.

The last 5 gadgets can be easily operated by a file-requester if you
press the button labled 'Get' next to the boxes.

If  the  first  on/off-gadget called 'Detect Diskchange' is selected
DePack!        will       detect      diskchanges      when      the
'Process|...|Skip|Abort'-requester    is    on   screen   and   will
automagically  satisfy the requester if a disk is inserted in one of
the  drives.   (Be  careful  !) This feature doesn't know about your
destination ...  this can cause unwanted writes in certain cases but
normally this should be no problem.

The  one  labeled  'Skip  Unknown'  tells  DePack!   how to react on
unknown  filetypes.   If  it  is selected the program will skip this
ones  otherwise you will be asked to determine the file by yourself.

Number  three  called  'Output'  determines  if  the  output  of the
executed program is sent to a console window or to NIL:

When the last one named 'Immediate Start' is selected the processing
of the files will start immediatly after you selected the menu item,
so  you  needn't  to  press the 'Start/Stop'-gadget.  You don't need
this  option,  but  it  becomes  quit handy if you scan through some
textfiles etc. by selecting only one file a time.
@endnode

@node mprefs "Modes of operation"
DePack! can distinguish between 3 modes of operation :

Mode		Function


DePack		Uses external commands like lha etc. for unpacking
		the sourcefiles.

Copy		Copies the selected files to the destination directory

Delete		Deletes the stuff from the source directories
@endnode

@node lprefs "Load Preferences"
A  file  requester  pops  up  and  you can choose a previously saved
DePack!-preferences  file to load.  If you have selected entries you
need  to confirm that you are willing to load newprefs and thereby a
new AmiX-directory file

!!! MENU ONLY PRESENT IN REGISTERED VERSION !!!
@endnode

@node sprefs "Save Preferences as default"
Save  the  preferences  from  the  preferences  window  to  the file
'ENVARC:DePack!.prefs'.   This is the file DePack!  tries to open on
startup.  If it's found and valid, the program will use the settings
stored in there.

!!! MENU ONLY PRESENT IN REGISTERED VERSION !!!
@endnode

@node aprefs "Save Preferences into file"
A  file  requester  pops up and you are asked to enter a filename in
which  the actual preferences will be saved.  You can load this file
in  a  later  session  with  the  Preferences/@{"Load"  line lprefs}
command.   WARNING  :   This  will  only  save  the  contents of the
preferences  window!   Any  file  selection of yours won't be saved!

!!! MENU ONLY PRESENT IN REGISTERED VERSION !!!
@endnode

@node menus "The DePack! menus"

	@{b}Project@{ub}

		@{" Load dirfile ... " link m_dirload} load @{"Dirfile" link terminology}
		@{" Save dirfile ... " link m_dirsave} save @{"Dirfile" link terminology} to disk
		@{" Read directory ..." link m_dirread} convert a directory into a @{"Dirfile" link terminology}
		@{" About " link m_stupido} displays information on the program
		@{" Version " link m_stupido} displays additional infos
		@{" Quit " link m_quit} quits out


	@{b}Preferences@{ub}

		@{" Edit Preferences " link iprefs} edit saveable settings 
		@{" Mode " link mprefs} determines mode of processing
			DePack
			Copy
			Delete
		@{" Load ... " link lprefs} loads new settings from disk
		@{" Save " link sprefs} saves settings as default
		@{" Save as... " link aprefs} saves new settings to file


	@{b}DePack!@{ub}

		@{" DePack! " link m_depack} start processing
		@{" Untag items " link m_deletelist} unselects marked entries


	@{b}Dirfile@{ub}

		Search
			@{" forwards " link m_search} search for a custom string from top of dir
			@{" backwards " link m_search} search for a custom string from bottom of dir
		Continue Search
			@{" forwards " link m_csearch} search for a custom string from top of dir
			@{" backwards " link m_csearch} search for a custom string from bottom of dir
		@{" Enter highlight pattern " link m_highlon} highlight lines according to pattern
		@{" Turn highlight off " link m_highloff} turn highlighting off
		@{" Jump to entry " link m_jumpentry} move cursor to a selected item
		@{" Jump to line " link m_jumpline} move cursor to a certain line
		@{" Filter not existing files " link m_filter} modify @{"Dirfile" link terminology} to show only present files
		@{" Filter existing files " link m_filterex} modify @{"Dirfile" link terminology} to show only NOT present files
		@{" Show not denoted files " link m_notden} show files on HD but not in @{"Dirfile" link terminology}

	@{b}Information@{ub}

		@{" Key index " link m_keyindex}
		@{" General information " link m_generalhelp} General AmigaGuide help
		@{" Help on menus " link m_menuhelp} Menu explanation (AmigaGuide)
		@{" Program History " link m_historyhelp} What's new ? (AmigaGuide)
		@{" Copyrights " link m_copyrhelp} Legal stuff (AmigaGuide)

@endnode

@node m_stupido "????????????????"
You don't tell me you need help on an about requester, eh ???
@endnode


@node m_dirload "Load Dirfile"
This  function  loads  a @{"Dirfile" link terminology}.  Eventually marked entries will be
discarded  after  a confirmation requester.  This functions performs
the  same  operations  as  if  you  would  change the dirname in the
preferences requester.
@endnode


@node m_dirsave "Save Dirfile"
This  function  saves current @{"Dirfile" link terminology} to a file you specify.
@endnode

@node m_dirread "Save Dirfile"
This  routine  scans  a  directory  of  your  choice  and  builds  a
pseudo-@{"Dirfile" link terminology} from it.  Here is an example :

Filename		 Size	Filecomment

dir			 1233	Dir-Command
list			 2933	List-Command
test			38882	Text-file

On  selecting  the  menu item you are asked to determine a directory
via  the  dir-requester.   Afterward  you  can  enter  a pattern the
filenames  must match.  Example (#?.dms or #?amix#?) The dir will be
read  and  if  you  want  (and  you usually want to) you can add the
directory  to  the  search-path  list afterwards (It won't overwrite
your  path  settings.   An  invisible 4th source-directory-string is
used).
@endnode


@node m_quit "Quitting DePack!"
If  you  select this entry you will leave the program.  If there are
still  files  to  be  tagged  or  preferences  not saved you will be
warned.
@endnode

@node m_depack "Processing the files"
A  window  will  open  with  three @{"Listview" link terminology} gadgets and other useful
infos  at  the top.  All files you marked will be listed in the left
@{"Listview" link terminology}  gadget.  You can use the slider to scroll the list(s).  To
start  processing  press  the 'Start/Stop'-Gadget' (left side at the
bottom)  If  you  want  to  return  to the main window use the other
button called 'Close Window'.

@{b} Mode : DePack! @{ub}

All the entries in the @{"Dirfile" link terminology} selected by the user will be searched
in  the  three directories you specified in the @{"Preferences" link iprefs} section.
If they are found they will be interrogated and the program tries to
determine  their  type.  If DePack!  can't recognise the filetype of
the  file currently processed you as the user will have to enter the
type  manually  by satisfying the requester popping up with choosing
Option  '1'  up to '9' and thereby selecting the file-type, pressing
skip  to  process  the  next  file,  or  abort  to  cancel the whole
operation.  If the filetype has been determined (see chart below for
the  numbers  and  their  meaning  ...)  you have four options :  a)
process  the  file and call the according command you entered in the
@{"Preferences" link iprefs}  window  b) to skip the file and process the next one in
the  list  c)  to  re-process  the  last  file (without dropping the
current  file  of course !) d) change the type of treatment (this is
of  use  sometimes)  or  to  d)  Abort  the whole operation.  If you
selected   a)  Process  an  output  window  will  pop  up  and  your
commandline  will  be  called  with the output send to the mentioned
window.   This whole process is looped until the whole list of files
has been processed or you selected abort.  In either of the case you
have  the  option to untag your selections afterwards by reaction on
another requester.

The  current  file's  description  will be displayed in the @{"Listview" link terminology}
gadget  called  'Current  File'.  After processing a file the result
(e.g.   'File  X copied' or 'File X not found') will be added to the
@{"Listview" link terminology} entitled 'Results'.

@{b} Mode : Copy @{ub}

This mode will copy all files to the selected destination directory.
If  the destination-device is full you are asked to enter a new disk
or  to  format  a disk.  This will bring up a string requester, that
will ask you to enter a format commandline like you would use in the
shell.   (e.g.   format  device=rad:  name=stuff) This line is saved
with  the preferences and will not change until you modify it in the
string  gadget.   You  can  abort copying by pressing the start/stop
gadget.

@{b} Mode : Delete @{ub}

After  two  confirmation  requesters  this  function will delete all
files  that  were  found.   You  can abort this mode by pressing the
start/stop gadget.

When  all files have been processed you can look at the results etc.
or  press  the  'Close  Window' button to return to the main window.
@endnode

@node m_deletelist "Untag items"
Deletes all the file-selections you made (not the files themselves).
You have to satisfy to 'Are u sure ?'-requesters to confirm the
actions.
@endnode

@node m_search "Search for string forwards/backwards"
You are asked to enter a string to be searched for. The search will
be started from either the top (forwards) or the bottom (backwards)
of the @{"Dirfile" link terminology} loaded.
@endnode

@node m_csearch "Continue search for string forwards/backwards"
Continues to search for the string @{"you entered before" link m_search} (from the current
cursor position in the lower (forwards) or upper (backwards) direction.
@endnode

@node m_highlon "Turn highlight on"
This  function  highlights  every  line  that  contains a string you
entered   before.   This  is  very  useful  if  you  e.g.   want  to
concentrate  on  .dms-files  :   You  enter  :  '.dms' at the string
requester  and every line that contains '.dms' (which is used in the
filename) gets highlighted.
@endnode

@node m_highloff "Turn highlight off"
Well  ...   erm  ...  this turns highlighting off ...  Any questions
left ?
@endnode

@node m_jumpline "Jump to line"
This  function  asks  you  for  a  line number and then postions the
cursor in that line.
@endnode

@node m_jumpentry "Jump to entry"
This  function  asks  you  for an entry number and then postions the
cursor in that line with the entry number.
@endnode

@node m_filter "Filter non existant files"
This  function  will  scan  the three source directories for all the
filenames  in  the  @{"Dirfile" link terminology} and then remove all the entries from the
directory  that  are not present in the source-directories.  This is
useful  if  you  got  many  files not present and don't want them to
appear  in the directory-display.  You can save the @{"Dirfile" link terminology} with the
@{"Save dirfile" link m_dirsave} menu item.
@endnode

@node m_filterex "Filter existant files"
This  functions  does  nearly  the same as {@"Filter non existant files" link m_filter}
exept   that   it   will   only  leave  files  NOT  present  in  the
source-directories in the @{"Dirfile" link terminology}.
@endnode

@node m_notden "Show not denoted files"
This  function  will  scan the three sourcedirectories for any files
not  denoted  in  the  @{"Dirfile" link terminology}  and  will  display  a  list  of them
afterwards.
@endnode

@node m_keyindex "Key index"
This opens a requester displaying the key-controls of the program.

See also :

@{" Key index " link keys}
@endnode

@node m_generalhelp "General help"
This   item   provides   displays  this  hypertext-document  on  the
DePack!-screen.   This functions requires amigaguide-library present
in your libs:  directory.
@endnode

@node m_menuhelp "Help on menu system"
This   item   provides   displays   a   hypertext-document   on  the
DePack!-screen   providing   information   about  the  menus.   This
functions   requires   amigaguide-library   present  in  your  libs:
directory.
@endnode

@node m_historyhelp "What's new ?"
This   item   provides   displays   a   hypertext-document   on  the
DePack!-screen  telling  you  more about the history of the program.
This  functions  requires  amigaguide-library  present in your libs:
directory.
@endnode

@node m_menuhelp "Help on menu system"
This   item   provides   displays   a    hypertext-document  on  the
DePack!-screen g.   This functions requires amigaguide-library present
in your libs:  directory.
@endnode

@node m_copyrhelp "Legal stuff"
This   item   provides   displays   a   hypertext-document   on  the
DePack!-screen  giving information on the copyright situation.  This
functions   requires   amigaguide-library   present  in  your  libs:
directory.
@endnode

@node shareware "A word on shareware and public-domain"
I  considered a lot on the topic of releasing this piece of software
as  public-domain-stuff/shareware  or for hard cash.  But as I heard
of  many  PD/shareware  authors in Germany who got very little or no
response  to their releases, I came to the conclusion that it is the
best to release DePack!  as a semi-commercial product.

I spent approximately ...  well many (too much ?) months on DePack!,
a  time  in  which  I learned a lot about C-programming as well as a
whole  lotta  more  about the traps and back- doors of C-programming
;-).   So I think the best way that matches my efforts is to release
a  DePack!  demo version, so that you can check out the facility the
program  offers  you  and  give  you  the  possibility  to order the
complete  DePack!-package  for  20  DM  (Germany)  or 20$ (all other
countries).

The complete DePack!-package consists of :

         DePack! - full working version with no restraints
		  Full documentation and examples
               1 free update (will be mailed to you)

So do not hesitate ... @{"register" link contact} NOW !
@endnode

@node copyright "Copyrights & Everything"
DePack!  and the sources of this program are copyright © 1993 by Laserdance
Productions.   The  demo-version  is freely distributable as long as all of
its files are included int their original form without additions, deletions
or  modifications  of any kind, and only a nominal fee is charged for their
deistribution.   This  software is provided »AS IS« without any warranty of
any   kind,   either   expressed   or  implied.   By  using  the  'DePack!'
demo-version,  you accept the entire risk as to the quality and performance
of  the  program.   There  should be no bugs left, as the software supplied
herein  has  been  extemsivly  tested,  but  if  it destroys your grandma's
toaster or kills your cat (etc.) either due to programming bugs or improper
usage, it's not my problem ...

You  are  encouraged to copy the demo version freely as long as you include
all  the  files that came with the distribution archive.  To order the real
version    or    to    send    comments,    complaints   etc.    write   to
@{" Laserdance Productions " link contact}.  Thank you in advance.

- Amiga, AmigaGuide and AmigaOS are trademarks of Commodore-Amiga, Inc.

- Reqtools.library copyright Nico Françios.

- Graphical user interface designed with GadToolsBox copyright 1993 by
  Jaba Development.

- DePack! makes use of the P0t-NoODLE.font (size 8, non proportional)
  designed by P0t-NoODLE/Anthrox

- Well I stole some ASCII-logos from wildstyle/pgs^dsr. Hope he doesn't
  mind ...

@endnode

@node greetings "Greetings"
The author would like the following persons for their help during the
creation of DePack!

@{"  Carsten Bruehl   " link schorse}		ß-tester No. 1
	
Also I would like to greet the following people and persons for their
help & moral support :

@{"   Markus Klinge   " link count}
@{"   Markus Schmall  " link flake}
@{"    Joerg Wabbel   " link alloc}
@{"   Andreas Weyert  " link andy}
@{"  Michael Schaake  " link michael}
@{"  Alexander Kluth  " link alex}

@endnode

@node schorse "Schrecken aller Versicherer"
Hey  Carsten  ...   Eisern bleiben !  Und denk dran :  Willy Brandt ist tot
!!!   Thanx  for  Car-Hifi  support,  krist  nen  paar  Libraries dafuer !!
hohohoh
@endnode

@node andy "Kreisch & Blaeh"
Hallo Andreas ... Wie schautz !? 
@endnode

@node alloc "Einmal Polo ... immer Polo"
Na altes Toastbrot ! Was macht der neue Hi-score ... Naja Turrican III
kommt bestimmt hehehe Competition is none ! Viel Spass noch beim Bund ...
Wir sehn uns ! Karibik '94 ??????????
@endnode

@node count "Hast du noch mehr Modules ?"
Na alta Baer !?  Die Idee mit Carstens Auto und dem Rauchen ist genial
!   Gemeinsam  sind  wir  stark  !   Humm...  thanx fuer die Greets im
Thief.guide    (Hypertext    ruled    doch    !     Wie    waers   mit
Online-Amigaguide.library-help  im  Thief  !?!)  HAR HAR HAR ...  Kann
mann  doch  alles  machen  tun  getan haben.  Viel Spass dann noch bei
Hagemeyer und sieh zu daß du in die DOB kommst.
@endnode

@node flake "100% getestet & Virenfrei"
Yo  ...   thanx for REQTLS.LHA !?  Ohne das waere dieses Programm wohl
nie  fertig  geworden ...  Muss der Controller immer abschmieren, wenn
ich  am  programmieren bin ????  Gruess die Viren von mir.  Ach ja die
Releasedisks  teste  ich  mit  deinem VirusWorkshop ...  solltest noch
etwas am GUI feilen !
@endnode

@node michael "Cool !"
Tach Michael, alter Docsleser ... Sorry das ich Silvester nicht dabei
bin, aber hat nicht sollen sein. 1994 ist auch noch ein Jahr P-)
@endnode

@node alex "Er putzt sich Zaehne"
Yo bro, sieh zu das der gute Santana ('Sem Pa Ti') heile bleibt.
@endnode

@node blah "All the things you'd like to hear ..."
And the coder's favourised noise (in no order) :

Anne  Clark, Dire Straits, Metallica, Manowar, Front 242, Kraftwerk,
Depeche  Mode,  Klangwerk,  Antonio  Vivaldi,  Erasure, The Prodigy,
Midnight   Oil,   Carlos   Peron,  J.S.   Bach,  Beethoven,  Herbert
Groenemeyer,  The  Radio  FFN Frühstyxradio, That old magic from the
50ties until the 80ties, Pink Floyd, ...

Recommended Books read by me while coding DePack!

- Douglas Adams : The four books of the 'HGTTG'-Triology
- Alan Dean Foster : Aliens & Alien³
- Stephen King : Different Seasons
- Arthur C. Clarke : 2001 - A space odyssey
- a collection of novels by Ephraim Kishon

and many many more whose names I can't remember now ...
@endnode

@node contact "Oh Mr. Postman, bring me a letter ..."
If you want to contact Laserdance Productions write to :

                          laserdance productions
                               p.o. box 2006
                                32473 hille

                                  germany

                         phone # is +49-05703/5814

To order the complete DePack!-package write to the following address :
                             illusion software
                           z.hd. carsten bruehl
                               nelkenstr. 14
                             31655 stadthagen

                                  germany

                         phone # is +49-05721/5167
                          fax # is +49-05703/5136

If you want to order please fill out and print the application in
the file Order.txt and send it to the address above !
@endnode

@node tocome "My god... it's full of stars'
Soon coming from Laserdance Productions :

- DePack! Updates
	DePack! will be continously updated.

- LibraryShifter (worktitle)
	A  program  to  search  new  disks/directories/archives  for
	libraries etc. and updates your LIBS: accordingly. Hi Schorse.
@endnode


@node addies "This place offers space for your commercials - just contact us !"
@endnode

@node terminology
Here are some explanation for the most frequently used terms in
this docfile.

@{b} DirFile @{ub}
	A textfile that DePack!  uses as a map through your
	directory.   See  Directory-File-Structure for more
	information

@{b} Diskmasher @{ub}
	A  compressing  program that crunches a entire disk
	into a single file.  Used to send the contents of a
	disk over a modem connection. © SDS Software

@{b} Item @{ub}
	A file marked in the DirFile  by pressing <Return>.
	Also called : Tag, Selected file

@{b} Listview @{ub}
	A  box  with  some  items  listed  inside  it and a
	scroller right to it.  Used to display longer lists
	e.g.  of files.

@{b} Lha/Lharc @{ub}
	A  compressing  program  used  to crunch a bunch of
	files  into  one  single  so-called 'Archive'-file.
	Also used by modem-transfers.

@{b} Tag @{ub}
	A file marked in the DirFile  by pressing <Return>.
	Also called : Item, Selected file

@endnode








