Subversion Repositories SvarDOS

Rev

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

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