                                          ##      ###     #####   # #     #   # ##                 
                                          #  #   #   #    #       #  #    #   # #  #              
                                          #   #  #   #    #       #   #   #   # #  #                 
                                          #   #  #   #    #####   #    #  ##### ##        
                                          #   #  #   #        #   #   #   #   # #                        
                                          #  #   #   #        #   #  #    #   # #                
                                          ##      ###     #####   # #     #   # #


                                             AN UTILITIES LIBRARY FOR THE HP48

                                                       Version 4.02


                                                (c) 1997-99 by Marc Poty


1. ACKNOWLEDGEMENTS, COPYRIGHT & DISCLAIMER OF WARRANTY
=======================================================

All the files of the DOSHP library are copyrighted (c) by 
Marc Poty

DOSHP is distributed in the hope that it will be useful, but the
COPYRIGHT HOLDERS PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. IN NO EVENT WILL THE COPYRIGHT HOLDERS BE LIABLE TO YOU FOR
DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM.

This version of DOSHP is a GiftWare release. You may use it as long as
you like, but only for non-commercial purposes and only as a private
person. Permission to copy the whole, unmodified, DOSHP library is
granted provided that the copies are not made or distributed for resale
(excepting nominal copying fees) and provided that you conspicuously and
appropriately include on each copy this copyright notice and disclaimer
of warranty.


2. OVERVIEW
===========

DOSHP is an utility which provides commands like DOS's commands:
COPY,MOVE,REN,DEL,MD,DIR,TREE,*.* and also FIND


3. INSTALLATION
===============

DOSHP is a regular auto-attaching library (library number 1610). To
install it on your HP48 download the file onto your calculator (in BINARY
mode), put the content of the created variable in the stack, store it
the port of your choice and power-cycle the calculator.


4. USE
======

Here is a description of each of these programs with some examples:


*COPY
-----

syntax:
(in the stack)

2:Destination path (a list or a name)
1:File(s) to copy (a list or a name) 

example:

2:{HOME HP48}
1:{PPAR EQ CST IOPAR}

then you type COPY or run the program in the library.
If the destination path don't exist it will be automatically created.

*MOVE
-----

Same syntax
(You can't have the message 'out of memory' because it purges the files, before
to copy it in another directory)


*DEL
----

syntax:

1:A name of file, directory or library; or a list with the names of files, directories
or libraries

example:

1:xxxx or 1:yyyy or 1:zzzz

xxxx:a file
yyyy:a directory
zzzz:a library

and then type DEL


another example:

1:{xxxx yyyy xxxx' zzzz' yyyy' zzzz}

xxxx':another file
yyyy':another directory
zzzz':another library

and then type DEL

If the library has the number 1458 for example you can type :0:1458 (if the port is 0)
to delete it or 1458 (only for port 0).


*MD
---

(To create a directory)

syntax:

1:A name or a list of names

example:

1:'HP'

and then type MD.

another example:

1:{ 'hp' 'dos' }

and then type MD.
Two directories are created: the first 'hp' and in 'hp', 'dos' the second is created


You can also create directories with forbidden names like numbers or other characters:

example:

1:123456

and then type MD.
The directory with the name '123456' is created.
To delete it see EXTRACT.


*DI
---

(Something like DIR (DOS's command))

Its name is not DIR, because if you type DIR it creates DIR in the stack
                                                        END

DI provides the HP48' version, the free memory, the number of files and directories in the
current directory (with the memory used) and the number of libraries (in HOME).
If you run it in HOME it indicates an additional directory: the hidden directory in HOME where
you can go if you type HIDDEN.
!!!!!!!!Very important!!!!!!!!
Don't type ORDER in this directory and don't delete the files 'Alarms' 'UserKeys' and 'UserKeys.CRC'

Then it shows the number of bytes of each var.

DI has also others options that you type before DI:

N:it sorts the files by name 
NR:it sorts the files by name in reverse order
SZ:it sorts the files by size
SZR:it sorts the files by size in reverse order
TP::it sorts the files by type
TPR:it sorts the files by type in reverse order
TPSZ:it sorts the files by type then by size
TPSZR:it sorts the files by type then by size and reverses the order
TPNR:it sorts the files by type then by name and reverses the order
NSZ:it sorts the files by name and then by size
NSZR:it sorts the files by name and then by size and reverses the order
NTP: it sorts the files by name and then by type
LB: it shows the libraries
LBN: it sorts the libraries by name
LBNR: it sorts the libraries by name in reverse order
LBSZ:it sorts the libraries by size
LBSZR:it sorts the libraries by size in reverse order

(There is no distinction between capital and small letters.)

*FIND
-----

It finds a file or a directory in all the tree structure of the calculator.

syntax:

1:name to search
and type FIND.
Then if the file exists it indicates where he is else the message 'FILE NOT FOUND' appears.
If the file is in several directories the paths are indicated in a list with 'FOUND IN' before.
IF you evaluate this list all the paths will be in the stack and you will be able to evaluate
each list to go in the paths.


*REN
----

It renames a file or a directory and this one keeps the same place.

syntax:

2:old name
1:new name

The new name can be a forbidden name.To delete it or rename it after see EXTRACT.


*TREE
-----

TREE shows all the directories of the HP like a tree structure.


*HIDDEN
-------

It provides an access to the hidden directory of the calculator.
You can't copy or move a file from the hidden directory to another directory
for the moment.
If you want to copy or move a file from the hidden directory to another like HOME
you must type it.For example don't use right shift + the key ' to indicate the HOME's path
for an error will occur.So you must type HOME.


*VERS
-----

It shows the DOSHP's version and executes a sweep in memory to eliminate "garbage"


*EXTRACT
--------

Useful with forbidden names.

syntax:

1:Position of the file or directory in the VAR menu
Or a list with several positions.

example:

1:1
and then type EXTRACT
The first name in the VAR menu is in stack.
(If you type 0 instead of 1 it's the same result)

You can put an interval of numbers

example:

1:{ 1 {2 5} 6}

It will extract the first var then the second to the fifth and the sixth.

It very useful with forbidden names for it is impossible to select them with a list or with ' '.
Indeed the name if it is a number will be considered like a number or if it is with forbidden characters
the result will be an error.
So if you want to delete it or rename it you must use EXTRACT.


* '*.*'
-------

If you type this you will have all the files even the hidden files in the directory
(like HIDDEN in HOME)


*GN
---

It convert anything in a global name.

syntax:

1:something 
then type GN.


5. CONTACT
==========

Gifts :), bug reports, and constructive comments and suggestions 
can be addressed to

  Poty Marc
  38 Route de Dole
  39120 LE DESCHAUX
  (in France)

  e-mail: marcous_p@yahoo.com

Please if somebody can convert COPY, MOVE, MD, DI, FIND, EXTRACT in SysRpl
it will be very cool to send me this conversion.
Thank You.
