Subversion Repositories SvarDOS

Rev

Rev 521 | Rev 543 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 521 Rev 531
1
 
1
 
2
 
2
 
3
                               === SVARCOM ===
3
                               === SVARCOM ===
4
 
4
 
5
 
5
 
6
SvarCOM is the SvarDOS command line interpreter, known usually under the name
6
SvarCOM is the SvarDOS command line interpreter, known usually under the name
7
"COMMAND.COM". It is designed and maintained by Mateusz Viste, and distributed
7
"COMMAND.COM". It is designed and maintained by Mateusz Viste, and distributed
8
under the terms of the MIT license.
8
under the terms of the MIT license.
9
 
9
 
10
For the time being, it is a work-in-progress project that is not entirely
-
 
11
complete yet. SvarCOM version 2021.0 must be considered as a "preview"
-
 
12
version.
-
 
13
 
-
 
14
The goal is to make SvarCOM the default SvarDOS shell, replacing FreeCOM.
10
The goal is to make SvarCOM the default SvarDOS shell, replacing FreeCOM.
15
Why replacing FreeCOM, you ask? See FREECOM.TXT for details.
11
Why replacing FreeCOM, you ask? See FREECOM.TXT for details.
16
 
12
 
17
Since SvarCOM is a work-in-progress effort, it is missing a few things yet:
13
SvarCOM is a work-in-progress effort. As such, it still lacks a few things:
18
 - pipes (cmd.exe | more) and stdin redirections (cmd.exe < file)
14
 - pipes (cmd.exe | more) and stdin redirections (cmd.exe < file)
19
 - advanced batch constructs (conditionals, errorlevels...)
15
 - advanced batch constructs (conditionals, errorlevels...)
20
 - a few internal commands missing: CALL, CTTY, GOTO, IF, LH
16
 - a few internal commands missing: CALL, CTTY, GOTO, IF, LH
21
 - DIR misses a few switches (/S, /O, /A)
17
 - DIR misses a few switches (/S, /O, /A)
22
 - ... (see TODO.TXT for more details)
18
 - ... (see TODO.TXT for more details)
23
 
19
 
24
SvarCOM is minimalist and I'd like to keep it that way. It aims to be
20
SvarCOM is minimalist and I'd like to keep it that way. It aims to be
25
functionaly equivalent to COMMAND.COM from MS-DOS 5.x/6.x. No LFN support.
21
functionaly equivalent to COMMAND.COM from MS-DOS 5.x/6.x. No LFN support.
26
 
22
 
27
As of version 2021.0, SvarCOM's resident footprint is under 2 KiB.
23
As of version 2021.0, SvarCOM's resident footprint is under 2 KiB.
28
 
24
 
29
Translation strings are stored in the file SVARCOM.LNG, which should be
25
Translation strings are stored in the file SVARCOM.LNG, which should be
30
placed in a directory pointed at by %NLSPATH% for SvarCOM to be able to output
26
placed in a directory pointed at by %NLSPATH% for SvarCOM to be able to output
31
messages in non-english languages. SvarCOM's language is controlled by the
27
messages in non-english languages. SvarCOM's language is controlled by the
32
%LANG% environment variable. NOTE: at this time translations aren't available
28
%LANG% environment variable. NOTE: at this time translations aren't available
33
yet, with the proof-of-concept exceptions of the 'PAUSE' and 'SHIFT' commands.
29
yet, with the proof-of-concept exceptions of the 'PAUSE' and 'SHIFT' commands.
34
 
30
 
35
Latest version available here: http://svardos.osdn.io/svarcom
31
Latest version available here: http://svardos.osdn.io/svarcom
36
 
32
 
37
 
33
 
38
=== INTERNAL COMMANDS ========================================================
34
=== INTERNAL COMMANDS ========================================================
39
 
35
 
40
SvarCOM implements the following internal commands. For help on each command,
36
SvarCOM implements the following internal commands. For help on each command,
41
run it with a "/?" argument.
37
run it with a "/?" argument.
42
 
38
 
43
BREAK       - sets or clears extended CTRL+C checking
39
BREAK       - sets or clears extended CTRL+C checking
44
CD/CHDIR    - displays the name of or changes the current directory
40
CD/CHDIR    - displays the name of or changes the current directory
45
CHCP        - displays or sets the active code page number
41
CHCP        - displays or sets the active code page number
46
CLS         - clears the screen
42
CLS         - clears the screen
47
COPY        - copies one or more files to another location
43
COPY        - copies one or more files to another location
48
DATE        - displays or sets the system date
44
DATE        - displays or sets the system date
49
DEL/ERASE   - deletes one or more files
45
DEL/ERASE   - deletes one or more files
50
DIR         - displays a list of files and subdirectories in a directory
46
DIR         - displays a list of files and subdirectories in a directory
51
ECHO        - displays messages, or turns command-echoing on or off
47
ECHO        - displays messages, or turns command-echoing on or off
52
EXIT        - quits the command.com program (command interpreter)
48
EXIT        - quits the command.com program (command interpreter)
53
MD/MKDIR    - creates a directory
49
MD/MKDIR    - creates a directory
54
PATH        - displays or sets a search path for executable files
50
PATH        - displays or sets a search path for executable files
55
PAUSE       - suspends processing of a batch program
51
PAUSE       - suspends processing of a batch program
56
PROMPT      - changes the DOS command prompt
52
PROMPT      - changes the DOS command prompt
57
REM         - records comments (remarks) in a batch file or CONFIG.SYS
53
REM         - records comments (remarks) in a batch file or CONFIG.SYS
58
REN/RENAME  - renames a file or files
54
REN/RENAME  - renames a file or files
59
RMDIR       - removes (deletes) a directory
55
RMDIR       - removes (deletes) a directory
60
SET         - displays, sets or removes DOS environment variables
56
SET         - displays, sets or removes DOS environment variables
61
SHIFT       - changes the position of arguments in a batch file
57
SHIFT       - changes the position of arguments in a batch file
62
TIME        - displays or sets the system time
58
TIME        - displays or sets the system time
63
TYPE        - displays the contents of a text file
59
TYPE        - displays the contents of a text file
64
VER         - displays the DOS version
60
VER         - displays the DOS version
65
VERIFY      - tells DOS whether to verify that files are written correctly
61
VERIFY      - tells DOS whether to verify that files are written correctly
66
VOL         - displays the disk volume label and serial number
62
VOL         - displays the disk volume label and serial number
67
 
63
 
68
 
64
 
69
=== LICENSE ==================================================================
65
=== LICENSE ==================================================================
70
 
66
 
71
SvarCOM is published under the terms of the MIT license.
67
SvarCOM is published under the terms of the MIT license.
72
 
68
 
73
Copyright (C) 2021 Mateusz Viste
69
Copyright (C) 2021 Mateusz Viste
74
 
70
 
75
Permission is hereby granted, free of charge, to any person obtaining a copy
71
Permission is hereby granted, free of charge, to any person obtaining a copy
76
of this software and associated documentation files (the "Software"), to deal
72
of this software and associated documentation files (the "Software"), to deal
77
in the Software without restriction, including without limitation the rights
73
in the Software without restriction, including without limitation the rights
78
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
74
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
79
copies of the Software, and to permit persons to whom the Software is
75
copies of the Software, and to permit persons to whom the Software is
80
furnished to do so, subject to the following conditions:
76
furnished to do so, subject to the following conditions:
81
 
77
 
82
The above copyright notice and this permission notice shall be included in all
78
The above copyright notice and this permission notice shall be included in all
83
copies or substantial portions of the Software.
79
copies or substantial portions of the Software.
84
 
80
 
85
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
81
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
86
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
82
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
87
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
83
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
88
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
84
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
89
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
85
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
90
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
86
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
91
SOFTWARE.
87
SOFTWARE.
92
 
88
 
93
 
89
 
94
====================================================================== EOF ===
90
====================================================================== EOF ===
95
 
91