DZ.TXT--
Copyright (C) 2017 Doszip Developers.

DOSZIP COMMANDER
Version 3.53

Welcome to Doszip Commander Version 3.53!
=========================================


<> Index

    <> Doszip Commander File List
    <> Command Line
    <> Compressed File Support
    <> Viewer Support
    <> Editor Support
    <> Extension and Filename Support
    <> Environment Variables
    <> Installing Commander under Windows
    <> Creating a user defined tools menu
    <> The File Search utility
    <> Compare Directories
    <> Create List File
    <> Operation Filter
    <> Shortcut keys
    <> Configuration Defaults
    <> Additional Resources
    <> Contributors


<> Doszip Commander File List

    DZBINXXX.ZIP: Program files

    DZ.EXE	- DZ Main Shell
    DZ.TXT	- DZ Help file (this file)
    LICENSE.TXT - GNU General Public License

    DZSRCXXX.ZIP: Source code

    LIB		- Library headers and source files are contained here
    HISTORY.TXT - Changelog file for Doszip

    The version of the source code and binary files is the date and
    time in the .ZIP file (1:00 == v1.00)

    The date format is (Norwegian) dd.mm.yy[yy]

    The first time you run DZ.EXE, it creates a default configuration
    file (DZ.INI).


<> Command Line

    Command	Description
    ---------	------------------------------------------------------
    /C<path>	Set Configuration PATH to <path>
    /N<count>	Maximum number of files in each panel
		Default is 5000.

      DZ <filename> command starts DZ and forces it to show <filename>
    contents if it is an archive or show folder contents if <filename>
    is a folder.


<> Compressed File Support

    Password protected Compressed files
    -----------------------------------

    While the Doszip Commander Compression Engine is compatible with
    PKZIP 1.x and PKZIP 2.x compress file formats, Commander only
    allows a single password for each compressed file to be active.

    The internal compression configuration is set by Ctrl-J


<> Viewer Support

    All viewers are defined in the file DZ.INI. You can modify the [View]
    section of DZ.INI file to associated 4 viewers:

    [View]
    F3	  = ; You can override the internal viewer by redefine F3
    Alt	  = ; Viewer for Alt+F3
    Ctrl  = ; Viewer for Ctrl+F3
    Shift = ; Viewer for Shift+F3

    Internal Viewer
    ---------------

    To launch the internal viewer contained within DZ.EXE, type F3. The
    macro %VIEW% may be used to associated files to the internal viewer
    in the DZ.INI file:

    [Filetype]
    txt = %view%


<> Editor Support

    All editors are defined in the file DZ.INI. You can modify the [Edit]
    section of DZ.INI file to associated 4 editors:

    [Edit]
    F4	  = ; You can override the internal editor by redefine F4
    Alt	  = ; Editor for Alt+F4
    Ctrl  = ; Editor for Ctrl+F4
    Shift = ; Editor for Shift+F4


<> Internal Editor

    To launch the internal editor contained within DZ.EXE, type F4. The
    macro %EDIT% may be used to associated files to the internal editor
    in the DZ.INI file:

    [Tools]
    0 = &Add tool, %edit% %dz%\dz.ini

    Keyboard
    --------

    F1			Help
    F2			Save
    F3			Search
    F4			Replace
    F5			New
    F6			Toggle files
    F7			Zoom to panel
    F8			Save session
    F9			Load session
    F11 (Ctrl-M)	Toggle menus
    Esc			Exit the editor and leave files open
    Shift-F1..9		External comands [ShiftF1..9]
    Alt-F1		Load configuration file (DZ.INI)
    Alt-F2..6		External comands [AltF2..6]
    Alt-F7		Prev error
    Alt-F8		Next error
    Alt-F9		External comands [AltF9]
    Alt-0		Window list
    Alt-L		Goto line number
    Alt-S		Word search
    Alt-X		Close all files and exit
    Ctrl-F2		Save file as...
    Ctrl-F9		Options
    Ctrl-Up		Scroll up one line
    Ctrl-Down		Scroll down one line
    Ctrl-PgUp		Top of file
    Ctrl-PgDn		Bottom of file
    Ctrl-Home		Top of window
    Ctrl-End		Bottom of window
    Ctrl-A		Select All
    Ctrl-C		Transfer to program dialog
    Ctrl-F		Toggle Optimal fill (Use Tabs)
    Ctrl-I		Toggle Autoindent mode
    Ctrl-L		Search again
    Ctrl-M (F11)	Toggle Menus
    Ctrl-O		User screen
    Ctrl-R		Reload current file
    Ctrl-S		Toggle Style
    Ctrl-T		Toggle Show Tabs
    Ctrl-X		Close current file and continue (if more files)


    External comands
    ----------------

    You can modify the [ShiftF1..9], [AltF2..6], and [AltF9] sections
    of the DZ.INI file to associate external comands:

    [ShiftF3]
    asm	 = ASMC -I%dzinc%
    c	 = WCC -ml

    The syntax is equal to the section [Filetype]. The sections
    [Shift/Alt-FX] parse a ".err" file if exist.


    Syntax highlighting
    -------------------

    Style codes:

    1. Attrib	A - Set background and forground color
    2. Control	O - Set color of CONTROL characters
    3. Quote	Q - Set color of quoted text
    4. Digit	D - Set color of numbers
    5. Char	C - Set color of chars
    6. String	S - Set color of string
    7. Begin	B - Set color from start of string
    8. Word	W - Set color of words
    9. Nested	N - Set color of nested strings

    The code have the following syntax:

    [<name>]
    0 = <attrib>[ <string>][ <string2>]...
    1 = ...

    Attrib: Color and character, or color (default is space (20h))
    0=A 07 FA

    Control: Color
    0=O 4X

    Quote: Color
    0=Q XB

    Digit: Color
    0=D XB

    Char: Color and char(s)
    0=C XF $%()

    String: Color and string
    0=S 4X Error

    Begin: Color and string(s)
    0=B X6 # include

    Word: Color and word(s)
    0=W X4 ax bx cx dx al bl cl dl
    1=ds es cs ss

    Nested: Color, string1 and string2
    0=N X8 /* */

    File type definition
    --------------------

    Code for syntax is located in the DZ.INI file, and file types
    must be defined under the section [Style]

    [Style]
    asm = style_asm
    inc = style_asm

    .ASM and .INC files will now use the section [style_asm]

    The editor reads this section which have the following syntax:

    [<section_name>]
    <Id>=<section> | [<section>] | [#<file>]
    [<section>]
    <code>


<> Hex Editor

    To launch the internal hex editor contained within DZ.EXE, type Ctrl-F4.

    Keyboard
    --------

    F1			Help
    F2			Save
    F3			Search
    F4			Goto offset
    F5			Toggle Class/Hex edit
    F6			Toggle offset type
    F8			Save class
    F9			Load class
    F10, Esc, Alt-X	Exit the editor
    F11			Toggle menus
    Ctrl-L		Search again
    Ctrl-M		Toggle menusline
    Ctrl-B, Alt-F5	User screen
    Ctrl-S		Toggle statusline

    Class edit
    ----------
    Enter		Select type
    Ctrl-Home		Top of file
    Ctrl-End		End of file


<> Extension and Filename Support

    Defining Filetypes
    ------------------
    You can modify the [Filetype] section to associated files in the format
    as follows:

    <ext>  = <command> !.! ; filetype
    <name> = <command>	   ; filename (no ext)

    File macros:

    !!		!
    !:		Drive + ':'
    !\		Long path
    !		Long file name
    .!		Long extension
    !~\		Short path
    ~!		Short file name
    .!~		Short extension

    Default (no macro used):

    'Long_Name.foo' --> '<command> Long_Name.foo'
    'Long Name.foo' --> '<command> "Long Name.foo"'

    Quotations are not added if macros are used:

    - Short: txt=edit ~!.!~
    - Long:  txt=notepad "!:!\\!.!"

    Multiple commands are parsed to a batch file. Use the ", " to separate
    the commands.

    Example: README.TXT

    [Filetype]
    TXT=echo !, echo .!, echo !.!

    Expands to a batch file:

    @echo off
    echo README
    echo .TXT
    echo README.TXT


<> Doszip Commander Environment Variables

    Doszip searches your environment for the following environment
    variables: COMSPEC, PATH, TEMP and DZ.

    The %DZ% variable may be used on the command line or in the .INI file.
    It is the path on your hard disk where the documents and configuration
    files are stored. The %DOSZIP% variable is the path where the commander
    is located.

    The value of %DZ% may be set in the environment (SET DZ=<path>), or on
    the command line (/C<path>). Command line overwrites environment.
    The default value is equal to %DOSZIP%.

    The variable COMSPEC will be overwritten by the [Comspec] value if
    defined:

    [Comspec]
    0=C:\WINDOWS\SYSTEM32\CMD.EXE
    1=/C

    This will force Doszip to use CMD.EXE insted of COMMAND.COM
    To define a single-line program, just exclude the 1= value:

    [Comspec]
    0=D:\CYGWIN\BIN\BASH.EXE

    The use of the .INI setting is controlled by the [x] Use NT Prompt
    in the System Options dialog. If set this will be used to execute
    commands except from the following:

      - execution of .BAT files
      - commands including '<' or '>'
      - some special 16-bit executables

    In that case the %COMSPEC% variable will be used.

    Edit Environment
    ----------------

    To launch the internal editor contained within DZ.EXE, type Shift-F5.

    Keyboard
    --------

    F2	Add a new environment string
    F3	Load environment from a file
    F4	Edit environment string
    F5	Save environment to a file
    F8	Delete environment string


<> Installing Commander under Windows

    Right click your desktop, select New->Shortcut.
    Type in the full path name of the DZ.EXE file, e.g. C:\DZ\DZ.EXE,
    or use the browse button if you are not sure of the path.

    Select the OK button.

    The Doszip Commander is now installed on your desktop.


<> Creating a tools menu

    It is possible to add a user defined Tools Menu to the Doszip
    Commander's main menu.

    All Tool-items are defined in the file DZ.INI. You can modify the
    [Tools] section of DZ.INI to associated 20 Tool-items: [00..19]

    To define a Menu item use the following format:

    X = <> ; Insert a line
    X = Menu_Item_Name, Command_to_be_invoked_when_selected
    X = Menu_Item_Name, [Menu_to_be_invoked_when_selected]

    Macros that can be used in 'Command' expand as follows:

    %EDIT%  [Edit] --> F4=<> | Internal editor
    %VIEW%  [View] --> F3=<> | Internal viewer
    %FIND%  Internal File Search(command)

    These must be the first command on the line.
    The macro %DOSZIP% and %DZ% may appear any place in the command line.

    You can insert commands into a sub-menu in the same way described above.

    For example a simple Tools Menu may look like:

    [Tools]
    0 = &Add tool,%EDIT% %DZ%\DZ.INI
    1 = <>
    2 = &Doszip directory,[Doszip]

    [Doszip]
    0 = Doszip &Command Line, %DOSZIP%\DZ.EXE -?
    1 = View &DZ.INI, %VIEW% %DZ%\DZ.INI
    2 = View &DOSZIP.TXT, %VIEW% %DZ%\DOSZIP.TXT
    3 = Search &Source Directory, %FIND% %DOSZIP%\src\*.*
    4 = Search &Include Directory, %FIND% %DOSZIP%\inc\*.*
    5 = <>
    6 = &Previous Menu..,[Tools]


<> The File Search utility

    The File Search utility use the short keys Ctrl-S or Shift-Tab, but
    from the command line or configuration file you can use the macro:

    %find% <directory> <file_mask(s)> <text_to_find_in_files>

    Example: %find% %doszip% *.h *.inc *.c *.asm ?

    Shortkeys
    ---------

    F2	 - Save result to list file.
    F3	 - View current file - same as Enter.
    F4	 - Edit current file - exit and execute external editor.
    F5	 - Launch the Operation Filter dialog.
    F6	 - Toggle ascii/hex search string.
    F7	 - Start a new search.
    F8	 - Delete file from list.
    F9	 - Load predefined file mask from .INI file.
    F10	 - Toggle output format
    Esc	 - Exit program.


<> Compare Directories

    The Compare Directories utility use the short key Shift-F5

    It compares Modification Time, Size, and File Name. The result
    is a list from the Target directory found in Source. The default
    Target is Panel-A and the default Source directory is Panel-B.

    Multiple directories may be used as Target: ["C:\my dir" E: F:\doc]

    Shortkeys
    ---------
    F2	    - Save result to list file.
    F3	    - View current file - same as Enter.
    F4	    - Edit current file - exit and execute external editor.
    F5	    - Launch the Operation Filter dialog.
    F6	    - Copy Panel directories to Source/Target.
    F7	    - Start a new search.
    F8	    - Delete file from list.
    F9	    - Load predefined file mask from .INI file.
    F10	    - Advanced settings.
    Esc	    - Exit program.
    Ctrl-W  - Swap Panels and reload.


<> Create List File

    The Create List File utility use the short key Alt-L, or drag and drop
    selected files to the command line. Use F2 in File Search to save list.

    Output format string:

    \\	   \
    \%	   %
    \t	   09
    \n	   0D 0A
    %id	   Index

    %ext   .asm
    %n	   cmmklist
    %p	   /doszip/src/dzmain
    %f	   /doszip/src/dzmain/cmmklist.asm

    %s	   Search string
    %o	   Offset from File Search
    %cd	   Current directory
    %dz	   Doszip directory

    Use F3 to load pre-defined formats from DZ.INI. You may add formats to
    the section [MKList] like a tool menu:

    [MKList]
    0 = <Menu_Item_Name>, [list_file@]<format_string>
    ...
    0 = Delete Files, del %f\n
    1 = <>
    2 = Default &List, filelist.bat@%f\n


<> Operation Filter

    Choosing the Filters button (available on many of the file operation
    panels - such as copy or move) displays the Operation Filters dialog box.

    The filters allow the users to specify file selection based on file name,
    date, size and attributes. The definitions for the Operation Filters used
    are stored in the DZ.CFG file.

    You can modify the [Filter] section of DZ.INI file to add pre-defined
    filters for use in commonly performed searches.

    Use F3 to load pre-defined filters to [Include] and [Exlcude].
    Use F4 to load date from the calendar to [File date].


<> Shortcut keys

    F1			Help
    F2			Rename
    F3			View
    F4			Edit
    F5			Copy
    F6			Move
    F7			Make Directory
    F8			Delete
    F9			Activate Edit
    F10			Exit
    F11			Toggle Panel size
    F12			Toggle Vertical/Horizontal/Fullscreen Panels
    Esc			Clear command line (or User screen)

    Alt-[afesthb]	Activate Menus
    Ctrl		Activate Ctrl-Statusline
    Ctrl-Alt		Activate Quick Search
    Up			If panels off: Prev Command (Doskey-Up)
    Down		If panels off: Next Command (Doskey-Down)
    Alt-Up/Down		Resize Panels
    Alt-Left		History: Prev Directory
    Alt-Right		History: Next Directory

    Alt-F1		Select Disk Panel-A
    Alt-F2		Select Disk Panel-B
    Alt-F3		View file --> DZ.INI
    Alt-F4		Edit file --> DZ.INI
    Alt-F5		Compress
    Alt-F6		Decompress
    Alt-F7		File search
    Alt-F8		History: list of the last commands
    Alt-F9		Toggle full screen / 25 lines
    Alt-0		Window list
    Alt-[1..9]		Run Tool nr. [1..9]
    Alt-C		Toggle Command Line
    Alt-L		Create List File
    Alt-M		Memory Information
    Alt-P		Load Directory
    Alt-W		Toggle wide view in current Panel
    Alt-X		Quit
    Alt-Z		Resize console

    Ctrl-Up		History: Prev Command (Doskey-Up)
    Ctrl-Down		History: Next Command (Doskey-Down)
    Ctrl-Home		Goto root directory
    Ctrl-PgUp		Enter Updir
    Ctrl-Enter		Past current file to command line
    Ctrl-Tab		File search (Ctrl-S)

    Ctrl-F1		Toggle Panel-A
    Ctrl-F2		Toggle Panel-B
    Ctrl-F3		View file --> DZ.INI
    Ctrl-F4		HexEdit or Edit file --> DZ.INI
    Ctrl-F5		Sort current panel by Name
    Ctrl-F6		Editor options
    Ctrl-F7		Screen options (Mouse-click upper right: Time)
    Ctrl-F8		System options
    Ctrl-F9		Configuration

    Ctrl-[0..7]		Load Directory defined in section [Directory]
    Ctrl-8		Past Panel-A directory to command line
    Ctrl-9		Past Panel-B directory to command line
    Ctrl-A		File Attributes
    Ctrl-B		User Screen
    Ctrl-C		Compare Panels
    Ctrl-D		Sort current panel by Date
    Ctrl-E		Sort current panel by Type
    Ctrl-F		Confirmation
    Ctrl-G		Activates the Calendar (Mouse-click upper right: Date)
     - Navigate:	Home, (Pg)Up, (Pg)Down, Left, Right, Ctrl-PgUp, Ctrl-PgDn
    Ctrl-H		Toggle Show Hidden in current Panel
    Ctrl-I		Directory information
    Ctrl-J		Compress Options
    Ctrl-K		Toggle Status Line
    Ctrl-L		Toggle Long filenames in current Panel
    Ctrl-M		Toggle Ministatus in current Panel
    Ctrl-N		Sort current panel by Name
    Ctrl-O		Toggle Panels on/off
    Ctrl-P		Panel Options
    Ctrl-Q		Quick Search
    Ctrl-R		Reread current Panel
    Ctrl-S		File search
    Ctrl-T		Toggle Show Detail in current Panel
    Ctrl-U		Unsorted
    Ctrl-V		Toggle Show Volume Information in current Panel
    Ctrl-W		Swap Panels
    Ctrl-X		Toggle Menus Line
    Ctrl-Z		Sort current panel by Size

    Shift-F2		Copy file (- to a new name in current directory)
    Shift-F3		View file --> DZ.INI
    Shift-F4		Edit file --> DZ.INI
    Shift-F5		Compare Directories
    Shift-F6		Edit Environment
    Shift-F7		Create .ZIP archive
    Shift-F9		Save configuration
    Shift-F10		Activate the last menu you used with the last
			item you selected highlighted

    Insert		Select file
    Keypad+		Select files
    Keypad-		Deselect files
    Keypad*		Invert

    Edit text
    ---------

    Ctrl-X		Cut (Shift-Del)
    Ctrl-C		Copy
    Ctrl-V		Paste (Shift-Ins)
    Ctrl-Ins		Copy (use Cut+Paste in the command line)
    Ctrl-Left		Goto previous word
    Ctrl-Right		Goto next word


<> Configuration Defaults


   <> Configuration

	[x] Auto save setup


   <> System Options

      System

	[ ] Use Beep
	    - on edit text and IO-error
	[x] Use Mouse
	[ ] Use Short File Names
	[x] Use System Clipboard
	[ ] Use Ascii Symbols
	    - for system fonts
	[x] Use NT Prompt
	    - Use [Comspec] if set
	    - runs assosiated programs on Enter if set
	[ ] CMD Compatible Mode
	    - use .BAT and .CMD as extensions to DZ if set
	      - share environment and current directory
	      - enable command SET

      Startup
	[x] Restore Screen Mode
	    - restore screen size (80x25 / full screen)

      Exit
	[ ] Auto Delete History
	    - delete configuration file (dz.cfg) on exit

      Keyboard
	[x] Esc for user screen


   <> Screen Options

	[x] Menu Bar  long version
	    [ ] Date  [ ] YYYY.MM.DD
	    [x] Time  [ ] HH:MM:SS
		- this control clock-update: sec/minute
	[x] Command Line
	[x] Key Bar


   <> Panel Options

	[x] Insert moves down
	[ ] Select Directories
	[ ] Sort Directories
	[ ] Clear read only from CD
	[x] Visual update on copy


   <> Editor Options

	[x] Use menus
	[x] Optimal fill
	[x] Overwrite block
	[x] Autoindent mode
	[x] Syntax highlighting
	[x] Use tab character
	[x] Create backup files
	[x] New line: 0D 0A or 0A


   <> Confirmations

	[x] Copy
	[x] Move
	[x] Delete
	[x] Delete Directory
	[x] Delete System
	[x] Delete Hidden
	[x] Exit Program


   <> Compression

	(*) maximum compression
	[ ] Add directory information to archive


<> Additional Resources

   For more information about DOSZIP, visit the Web site at:
   http://sourceforge.net/projects/doszip/

   Open Watcom is a project of the open source community to maintain
   and enhance the Watcom C, C++, and Fortran cross compilers and tools.
   http://www.openwatcom.org/

   7ZA.EXE is a standalone command line version of 7-Zip.
   Supported formats: 7z, xz, ZIP, GZIP, BZIP2 and TAR
   http://sourceforge.net/projects/sevenzip/files/


<> Contributors

   These people contributed to Doszip (additions, bugfixes, bug reports):

   Hjort Nidudsson, Japheth, Michael Kennedy, Robert Riebisch, Rugxulo,
   Yury

