477 lines
17 KiB
Plaintext
477 lines
17 KiB
Plaintext
|
||
|
||
|
||
|
||
|
||
|
||
|
||
44
|
||
44 III
|
||
44 DDDDDDD ZZZZZZZZZZZZZ
|
||
44 DDDDDDDD III ZZZZZZZZZZZZZZ
|
||
44 44 DD DD III ZZZ
|
||
44 44 DD DD III ZZZ
|
||
44 44 DD DD III ZZZ
|
||
444444444 DD DD III ZZZ
|
||
44444444 DD DD III ZZZ
|
||
44 DD DD III ZZZ
|
||
44 DDDDDDDD III ZZZZZZZZZZZZZ
|
||
44 DDDDDDD III ZZZZZZZZZZZZZ
|
||
|
||
|
||
|
||
|
||
|
||
|
||
Version 1.8
|
||
|
||
|
||
|
||
4DIZcribe for 4DOS
|
||
Documentation
|
||
|
||
|
||
|
||
|
||
Developed By
|
||
Mathijs de Weerdt
|
||
|
||
Documentation By
|
||
Mathijs de Weerdt
|
||
|
||
|
||
|
||
Published By
|
||
|
||
Mathijs de Weerdt
|
||
|
||
e-mail: mmweerdt@cs.ruu.nl
|
||
Holland
|
||
|
||
|
||
|
||
|
||
CONTENTS
|
||
-------------------------------------------------------------------
|
||
|
||
|
||
|
||
CONTENTS
|
||
|
||
|
||
Introduction...............................................1
|
||
|
||
Chapter 1 / Installation...................................2
|
||
|
||
Chapter 2 / Configuration..................................3
|
||
|
||
Chapter 3 / Example .INI file..............................4
|
||
|
||
Chapter 4 / Changes since last version.....................5
|
||
|
||
Chapter 5 / The author.....................................6
|
||
|
||
Chapter 6 / Where to get new versions......................8
|
||
|
||
Chapter 7 / Copyrights and disclaimer......................9
|
||
|
||
|
||
|
||
|
||
-------------------------------------------------------------------
|
||
1 INTRODUCTION
|
||
|
||
|
||
Since a few years I've been using, testing and (re)viewing archive
|
||
files. As you all probably know, 4DOS gives us a lot of easy and fast
|
||
extensions to the standard COMMAND.COM (read MS-DOS) features (i.e.
|
||
descriptions which are shown with the DIR commando). So when I first saw
|
||
4DOS, I got addicted at once.
|
||
In the archives (mostly .ZIP and some .ARJ) used to be a short
|
||
description of the stored files, FILE_ID.DIZ. Then I ran into a short batch
|
||
file from Donald Clancy (and I've seen many variants after that one). This
|
||
.BTM-file extracted the FILE_ID.DIZ and pushed it into the 4DOS's
|
||
DESCRIPT.ION file. So when executing the DIR command this short description
|
||
was shown. There was only one real problem: the thing was quite slow.
|
||
To be short, after some experimenting I decided to write such a program
|
||
(in C). And here it is:
|
||
|
||
* FILE_ID.DIZ's of every length can be imported
|
||
* DESC.SDI's used when FILE_ID.DIZ's not found
|
||
* up to 3000 file-descriptions supported in one dir
|
||
* descriptions up to 12 lines (=12*40=480 chars)
|
||
(limited by 4DOS)
|
||
* FILE_ID.DIZ's/DESC.SDI's can be converted:
|
||
v truncating lines (take only the first 40 characters of every line)
|
||
v excluding lines with less than /c alphanumericals
|
||
v excluding @X?? codes (used by PCB or so)
|
||
v describing sets of archives (FILE_ID.DIZ is distributed over all files
|
||
or only the first one is described)
|
||
v maximum lines per file support
|
||
v recurse into subdirectory's
|
||
* new option: only files without a description will be converted
|
||
* quiet option: less output (to screen)
|
||
* different extractor names supported (ARJ.exe and PKUNZIP.exe by default)
|
||
* very colorfull output screen: with (nearly) all the information you want
|
||
(option /d)
|
||
* handy 4DIZ.INI file
|
||
* nice helpscreen
|
||
|
||
|
||
-------------------------------------------------------------------
|
||
2 INSTALLATION
|
||
|
||
|
||
|
||
FAST installation: (assuming 4DOS is installed )
|
||
1) Put 4DIZ.EXE, 4DHELP.TXT and 4DIZ.INI in a directory.
|
||
I'll assume here you call it C:\4DIZ\, but you may substitute
|
||
this by any directory you'd like.
|
||
2) Add SET 4DIZ_PATH=C:\4DIZ to your AUTOEXEC.BAT.
|
||
3) Do one of the following:
|
||
1) make an alias 4DIZ=C:\4DIZ\4DIZ
|
||
a) by adding "4DIZ C:\4DIZ\4DIZ" to your ALIAS.LST
|
||
b) by adding "ALIAS 4DIZ=C:\4DIZ\4DIZ" to your AUTOEXEC.BAT
|
||
2) add C:\4DIZ to your PATH statement in AUTOEXEC.BAT
|
||
4) Edit 4DIZ.INI and change the options to your needs.
|
||
You should at least change the "prog" settings.
|
||
(The paths of these archivers probably aren't correct.)
|
||
5) Reboot.
|
||
|
||
Now you've only to type 4DIZ *.* to describe all the files in the
|
||
current directory.
|
||
|
||
If you like this util, you could use your whole holiday to add
|
||
DESCRIPTIONMAX=480 to your 4DOS.INI and to change the 4DIZ.INI file
|
||
to your likings.
|
||
|
||
|
||
-------------------------------------------------------------------
|
||
3 CONFIGURATION
|
||
|
||
To be short: try all options, see what they do and put the ones you like in
|
||
your ALIAS.
|
||
|
||
Remember: Using the 4DIZ.INI file is much more easier.
|
||
These options override the options in the 4DIZ.INI file.
|
||
|
||
Usage: 4DIZ [options] filename ...
|
||
where options is a combination of:
|
||
/q quiet mode (absolutely no text display)
|
||
gives in combination with /d: no archive info
|
||
/t truncate lines
|
||
/f fill in short lines with blanks
|
||
/s smart describing: only the first one from a serie
|
||
/v very smart describing: the first description is
|
||
divided over the whole family
|
||
/n describe ALL files (not just those without any description)
|
||
/e exclude lines with less than /c alphanumerical characters (def. 4)
|
||
and exclude the "@X**"-codes
|
||
/c followed by the minimum amount of alphanumerical characters
|
||
in a line
|
||
/m followed by the maximum amount of lines of description per file
|
||
/r recurse into subdirectory's
|
||
/b (blanks) disable space convert to 255 (space is converted to ascii 255
|
||
because 4dos otherwise wraps the lines at the last space character
|
||
and not at the 40th character)
|
||
/d colorfull display with lots of useless/usefull information
|
||
/p pause just before returning to DOS with the /d isplay option
|
||
/h or /? this screen
|
||
and filename ... is a list of filenames or wildcards (or both).
|
||
|
||
It's possible to use other than the default extraction program.
|
||
(PKUNZIP -- -+ -) -o for .ZIP files) Therefore you MUST change
|
||
the .INI file options starting with "ext", "prog" and "opt".
|
||
|
||
There is a limit to the amount of parameters: this program
|
||
checks only the first 127 characters or so.
|
||
(that's because of this *&#%^$! compiler)
|
||
|
||
And there's also a limit to the amount of files to describe. When you
|
||
are describing more than 2000 files an (m)allocation error will occur.
|
||
|
||
It's possible to use a 4DIZ.INI file. If the file isn't in the current
|
||
path, the environment variable 4DIZ_INI will be used to find it.
|
||
(i.e. SET 4DIZ_PATH=c:\4diz\). 4DIZ.INI can be used in addition
|
||
to the command line options. Command-line options will overwrite the
|
||
options from the INI-file. An example 4DIZ.INI is included in this
|
||
package. See also the next chapter.
|
||
|
||
My favourite command-line is: 4diz /t /v /m4 /c5 /d /q *.*
|
||
this could be an alias: alias 4d = 4diz /t /v /m4 /c5 /d /q *.*
|
||
But it can also be edited in an INI-file.
|
||
Another nice try is: 4diz /b /e *.*.
|
||
Now I only have to type 4d.....and all the files in my directory
|
||
are described !!!
|
||
|
||
-------------------------------------------------------------------
|
||
4 EXAMPLE 4DIZ.INI
|
||
|
||
;4DIZ.INI
|
||
;
|
||
;Empty lines, lines starting with a ; and lines without a = are ignored.
|
||
;Please don't use spaces in the option-lines.
|
||
;No,nO,NO,Yes,yEs,yeS,YEs,YeS,yES and YES are not recognized:
|
||
;Please use only yes and no (lower-case)
|
||
|
||
;Archivers:
|
||
;ext1,ext2,...,ext9:
|
||
; extentions for the archives (to detect what program to use)
|
||
; without points, a digit indicates any digit
|
||
;prog1,prog2,...,prog9:
|
||
; path and program names
|
||
;opt1,opt2,...,opt9:
|
||
; options to use
|
||
|
||
ext1=ARJ,A00,000
|
||
ext2=ZIP
|
||
ext3=UC2
|
||
ext4=RAR
|
||
ext5=CRU
|
||
ext6=DWC
|
||
ext7=LZH
|
||
ext8=ARC
|
||
|
||
prog1=f:\program\pak\arj\arj.exe
|
||
prog2=f:\program\pak\infozip\unzip\unzip386.exe
|
||
prog3=f:\program\pak\uc2\uuc.exe
|
||
;remember to start 4diz with "US 4DIZ [options] filename"
|
||
prog4=f:\program\pak\rar\rar.exe
|
||
prog5=f:\program\pak\crush\uncrush.exe
|
||
prog6=f:\program\pak\dwc\dwc.exe
|
||
prog7=f:\program\pak\lha\lha.exe
|
||
prog8=f:\program\pak\arc\arc.exe
|
||
|
||
opt1=x -y -v -ja1
|
||
opt2=-C -o
|
||
opt3=e
|
||
opt4=e -y -c-
|
||
opt5=-q -e
|
||
opt6=e!
|
||
opt7=e
|
||
opt8=e
|
||
|
||
DestinationFile=DESCRIPT.ION
|
||
;Destination for descriptions. Default=DESCRIPT.ION.
|
||
;This file is hidden by default.
|
||
|
||
DescriptionFiles=FILE_ID.DIZ,DESC.SDI
|
||
;Files to extract from the archives and to use to make the descript.ion.
|
||
;Default=FILE_ID.DIZ,DESC.SDI
|
||
|
||
NoDesText=<3D>
|
||
;Text to use when no description is found. Default=<3D>.
|
||
|
||
Quiet=no
|
||
;Very little text-display. Default is no.
|
||
|
||
Display=yes
|
||
;Colorfull output-screen. Default is no.
|
||
|
||
Truncate=yes
|
||
;Truncate lines that are too long too fit on the screen. Default is no.
|
||
|
||
FillLines=yes
|
||
;Fill half empty lines up to the end with blanks
|
||
|
||
Blanks=no
|
||
;If yes, blanks are 'normal' space-characters (#20). If no,
|
||
;Ascii 255 is used. Default is no.
|
||
|
||
Mode=VerySmart
|
||
;Archive-family mode: Stupid( = default), Smart or VerySmart
|
||
|
||
OnlyNewFiles=yes
|
||
;Describe only the undescribed files in the directory. Default is yes.
|
||
|
||
ExcludeNonInfo=yes
|
||
;Exclude the lines with too little information. Default is no.
|
||
|
||
CharactersNeeded=5
|
||
;At least so many characters are needed to let a line be info. Default is 4.
|
||
|
||
MaximumLines=4
|
||
;The maximum amount of lines per file-description. Default is 12.
|
||
;Maximum is 100.
|
||
|
||
RecurseSubdirs=no
|
||
;Recurse into subdirectory's. Default is no.
|
||
|
||
Pause=no
|
||
;Pause after display mode. Default is no.
|
||
|
||
|
||
-------------------------------------------------------------------
|
||
5 CHANGES
|
||
|
||
Changes since last distributed version (v1.7):
|
||
1) extended maximumlines from 12 to 100 (by user request)
|
||
2) bug fixed: extensions with a number other than zero weren't
|
||
detected (i.e. UC2)
|
||
|
||
v1.6 was not distributed
|
||
|
||
Changes v1.5:
|
||
1) added "Max Line": a brown line which indicates where the description
|
||
is truncated; no line is displayed when the description is shorter
|
||
than maxlines lines and when maxlines >= 12
|
||
2) /q /d combination gives now "no archive info"
|
||
3) display bug fixed: after trying to describe a non-archive file
|
||
some text was displayed on the lower half of the screen in stead of
|
||
the upper half
|
||
4) added 4DIZ.INI file support with much extra options:
|
||
* destination file can be chosen (in stead of descript.ion)
|
||
* description files can be chosen (in stead of or in addition to
|
||
FILE_ID.DIZ and DESC.SDI)
|
||
* nodescription option: chose the description to add when the program
|
||
can't find any description
|
||
* added self-define archives: up to 9 archivers support
|
||
5) reversed working of /n option: if /n is used, all files will be
|
||
described and if /n is omitted only files without a description
|
||
will be described
|
||
I did this because one user forgot to use /n and lost 20 descriptions.
|
||
6) improved /? /d combination (better help)
|
||
7) removed memory allocation bug
|
||
8) changed quiet option: this is really quiet now, but two times slower
|
||
|
||
Changes since v1.4:
|
||
1) added /b : disable "space to ascii 255 convert" (per request)
|
||
2) added /d : nice colorfull output screen
|
||
3) added /p : pause before leaving display screen
|
||
4) added DESC.SDI support ( when FILE_ID.DIZ can't be found )
|
||
5) improved "same family" recoginizing with /v and /s
|
||
6) breaking the 100 files barrier ! It's now possible to describe
|
||
directory's with about 3000 files !
|
||
7) improved truncating options: try /t and /f (and /b)
|
||
/w option removed
|
||
|
||
v1.3 was not distributed
|
||
|
||
Changes since v1.2:
|
||
1) finally got .arj multi-volume support right
|
||
2) added environment-variable usage:
|
||
4DIZ_UNZIP for unzipping program
|
||
4DIZ_UNZIP_OPT for unzipping program options
|
||
4DIZ_ARJ for arj extracting program
|
||
4DIZ_ARJ_OPT for arj extracting program options
|
||
"old" options /z and /a will be removed in the near future
|
||
this fixes the following "bug":
|
||
a) lower case file_id.diz not found (just upper case)
|
||
when using case-sensitive archives
|
||
3) added "recurse into subdirectory" option (/r)
|
||
|
||
v1.1 was not distributed
|
||
|
||
Changes since v1.0:
|
||
1) better error report
|
||
2) debug mode removed -> less code
|
||
3) bugs fixed: a) with long FILE_ID.DIZ's (near 8K)
|
||
b) sort function didn't work (for multiple volume)
|
||
c) /a and /z options didn't work as they should
|
||
4) added /c : minimum amount of characters per line (now default 4)
|
||
5) added /m : maximum amount of lines per file
|
||
6) added /n : only new files
|
||
|
||
Things to do, but which probably will never be implemented:
|
||
1) /l : remove lines with words out of list-file
|
||
2) /c : edit every description
|
||
3) define exit-codes
|
||
|
||
Known bugs (I'll try to fix them as soon as possible, please mail me
|
||
to report these or other bugs) :
|
||
1) sometimes the error: "Null pointer assignment" is displayed along
|
||
with some junk, maybe only when trying to describe all files, but
|
||
only one file doesn't have a description
|
||
|
||
|
||
-------------------------------------------------------------------
|
||
6 THE AUTHOR
|
||
|
||
|
||
|
||
Author: This util is made by Mathijs de Weerdt. (Yeah, that's me !)
|
||
I'm born in Holland in 1976. And now I'm studying in Utrecht.
|
||
(That's also in the Netherlands.)
|
||
I'd like to hear what you think of my program. I'll fix all
|
||
bugs (when reported) as soon as possible. Please mail me your
|
||
suggestions etc. I'll be happy to code them and send you the
|
||
new version.....
|
||
|
||
My adress (e-mail): mmweerdt@cs.ruu.nl
|
||
|
||
MAIL ME !
|
||
|
||
Happy dizcribing !
|
||
|
||
|
||
-------------------------------------------------------------------
|
||
7 WHERE
|
||
|
||
You can get the newest version from the following URL (this can be accessed
|
||
by almost every WWW-client) (preferrably using Netscape):
|
||
http://huizen.dds.nl/~mmweerdt
|
||
It can also be found at Cyber City BBS (see below for more info).
|
||
At least every half version (1.0, 1.5, 2.0, etc.) will be uploaded to SimTel.
|
||
So 4DIZ can be ftp'ed at every SimTel mirror. Ask a cyberpunk for your
|
||
nearest SimTel mirror. I'll put it online as "4diz??.zip" with
|
||
??=versionnumber (i.e. 17 for v1.7). So this version can be found under
|
||
"4diz17.zip".
|
||
|
||
|
||
-------------------------------------------------------------------
|
||
8 COPYRIGHTS AND DISCLAIMER
|
||
|
||
Copyrights
|
||
|
||
* This program is not in the public domain. You are hereby
|
||
granted a limited right to copy the program and pass it on to
|
||
friends and upload it to any bulletin board system, provided
|
||
no fee is charged other than a nominal disk fee. You may use
|
||
the program for up to YOUR WHOLE LIVE without registering it.
|
||
If you use it for more than this, please register. Site
|
||
licenses are available for corporate use. Contact the author
|
||
for more information.
|
||
|
||
|
||
Disclaimer
|
||
|
||
* 4DIZ is distributed without warranty, expressed or implied,
|
||
including without limitation the warranties of merchanta-
|
||
bility and of fitness for a particular purpose. You, the
|
||
user, assume full responsibility for the selection and use of
|
||
4DIZ to achieve your desired results.
|
||
|
||
|
||
Another Introduction
|
||
|
||
* 4DOS, the outstanding COMMAND.COM replacement created by
|
||
J.P. Software, allows a file description of up to 512
|
||
characters to be created. The 4DOS file commands such as
|
||
copy, move and delete cause the description to follow the
|
||
file. In other words, if you copy a file with a description
|
||
from the c: drive to the a: drive, the description will be
|
||
added to the a: drive file automatically. The DIR command
|
||
then displays the descriptions next to the files similar
|
||
to the file lists on many BBS's. 4DOS provides a simple,
|
||
command line editor for the descriptions.
|
||
4DIZ does not, however, require 4DOS. You may use it with or
|
||
without 4DOS to create descriptions for disk catalog programs
|
||
that support 4DOS style descriptions, such as 4Cat v. 1.40.
|
||
|
||
|
||
* 4DOS is a trademark of J. P. Software
|
||
* This last Chapter was copied from the documentation of FDE,
|
||
an editor for 4DOS-descriptions, thanks Earl R. Davidson !
|
||
|
||
* Cyber City BBS is Located in Malaysia:
|
||
-----------------------------------------------------------------------------
|
||
+60-3-758-7400 (8 lines) 24 hrs * PCBoard 15.22M/100 * 2400-28.8k (V34/VFC)
|
||
Dist. Site for Morgul Player * Inertia Player * Terminate * GameBase
|
||
Software Creations BBS #1810 * Critical Apps. Dist. List (CWSApps)
|
||
M'sian BBSes List (MBBS) * Jojo's Top 100 Games Chart * Electric Storm Soft.
|
||
TBH-Softworx * Ashrella/TXDS Doors * CommNet/Win/Win95
|
||
========== Sales site for modems/peripherals, PCBoard BBS software =========
|
||
Email SysOp@cyberhq.po.my john-lim@cyberhq.po.my (CoSys) * FidoNet 6:609/73
|
||
-----------------------------------------------------------------------------
|
||
|