Subversion Repositories SvarDOS

Rev

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

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