Professional Documents
Culture Documents
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
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
-------------------------------------------------------------------
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:
-------------------------------------------------------------------
2 INSTALLATION
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.
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.
-------------------------------------------------------------------
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=�
;Text to use when no description is found. Default=�.
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 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
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
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
Disclaimer
Another Introduction