push 715329f5a8f1967d0599203de97483c8ca73ae2c
[wine/hacks.git] / programs / cmd / README
blobee1c542325ee85f39ec39354f5bdbcc9873104d5
1 CMD - A Command-Line Interface for WINE
2 Copyright (C) 1999 D Pickles (davep@nugate.demon.co.uk)
3 Open Source software published under the Wine Licence and Warranty.
5 This is an Alpha version and is very much "work in progress".
7 WHAT'S INCLUDED
8 - Sources
9 - A Makefile for compiling with LibWine. Build Wine with "-enable-dll" first.
10 - A Makefile for Borland C++ (needs editing for directories).
12 WHAT'S MISSING
13 - Command-line qualifiers for most builtin commands
14 - Wildcards and relative paths in COPY, MOVE and RENAME
15 - Set functionality in DATE, TIME, ATTRIB, LABEL
16 - Full internationalisation of the text (and commands?).
18 WHAT DOESN'T WORK
19 - The ATTRIB command reports all files having their Archive flag set, and the
20 READONLY setting depends on the Unix file permissions. All other flags are
21 always clear. The Wine attributes API calls map to the Unix stat() function
22 which cannot handle the other attributes available in DOS.
23 - Date/timestamps of files in the DIR listing are shown using the current
24 locale, which is set using the Unix LANG environment variable. By default the
25 US date-time format is used. Set eg "LANG=en_GB" for DD/MM/YY dates and 24-hour
26 times.
27 - Line editing and command recall doesn't work due to missing functionality in
28 Wine.
29 - DIR/S only works if no file specification is given, ie "DIR C:\TEMP /S" works
30 but "DIR C:\TEMP\*.C" doesn't work if a matching file exists in a lower
31 directory.
32 - Copy, rename, move, need the source and destination to be specified fully
33 with an absolute or relative path but no wildcards or partial filenames.
34 - Redirection is implemented as a command line is parsed. This means that ">"
35 and "<" symbols cannot appear in command arguments even within quotes.
36 - In many cases parsing and syntax checking is less rigorous than DOS. Thus an
37 existing DOS batch file will probably run unchanged under wine's cmd but the 
38 reverse may not be the case.
40 WINE OR WIN32 BINARY?
41 cmd can be built as a Wine binary, or (using a Win32 compiler) as a Win32 .EXE
42 image. The Wine binary is simpler to invoke from the U**x command line or from
43 a GUI such as KDE, however it is not possible to invoke a second shell using the
44 "CMD /C filename" syntax. Conversely a Win32 application can be invoked from a
45 Win32 GUI such as Program Manager but that needs starting under Wine first.