Subversion Repositories SvarDOS

Rev

Rev 521 | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 521 Rev 525
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
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"
11
complete yet. SvarCOM version 2021.0 must be considered as a "preview"
12
version.
12
version.
13
 
13
 
14
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.
15
Why replacing FreeCOM, you ask? See FREECOM.TXT for details.
15
Why replacing FreeCOM, you ask? See FREECOM.TXT for details.
16
 
16
 
17
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:
18
 - pipes (cmd.exe | more) and stdin redirections (cmd.exe < file)
18
 - pipes (cmd.exe | more) and stdin redirections (cmd.exe < file)
19
 - advanced batch constructs (conditionals, errorlevels...)
19
 - advanced batch constructs (conditionals, errorlevels...)
20
 - a few internal commands missing: CALL, CTTY, GOTO, IF, LH
20
 - a few internal commands missing: CALL, CTTY, GOTO, IF, LH
21
 - DIR misses a few switches (/S, /O, /A)
21
 - DIR misses a few switches (/S, /O, /A)
22
 - ... (see TODO.TXT for more details)
22
 - ... (see TODO.TXT for more details)
23
 
23
 
24
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
25
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.
26
 
26
 
27
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.
28
 
28
 
29
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
30
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
31
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
32
%LANG% environment variable. NOTE: at this time translations aren't available
32
%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.
33
yet, with the proof-of-concept exceptions of the 'PAUSE' and 'SHIFT' commands.
34
 
34
 
35
Latest version available here: http://svardos.osdn.io/svarcom
35
Latest version available here: http://svardos.osdn.io/svarcom
36
 
36
 
37
 
37
 
38
=== INTERNAL COMMANDS ========================================================
38
=== INTERNAL COMMANDS ========================================================
39
 
39
 
40
SvarCOM implements the following internal commands. For help on each command,
40
SvarCOM implements the following internal commands. For help on each command,
41
run it with a "/?" argument.
41
run it with a "/?" argument.
42
 
42
 
43
BREAK       - sets or clears extended CTRL+C checking
43
BREAK       - sets or clears extended CTRL+C checking
44
CD/CHDIR    - displays the name of or changes the current directory
44
CD/CHDIR    - displays the name of or changes the current directory
45
CHCP        - displays or sets the active code page number
45
CHCP        - displays or sets the active code page number
46
CLS         - clears the screen
46
CLS         - clears the screen
47
COPY        - copies one or more files to another location
47
COPY        - copies one or more files to another location
48
DATE        - displays or sets the system date
48
DATE        - displays or sets the system date
49
DEL/ERASE   - deletes one or more files
49
DEL/ERASE   - deletes one or more files
50
DIR         - displays a list of files and subdirectories in a directory
50
DIR         - displays a list of files and subdirectories in a directory
51
ECHO        - displays messages, or turns command-echoing on or off
51
ECHO        - displays messages, or turns command-echoing on or off
52
EXIT        - quits the command.com program (command interpreter)
52
EXIT        - quits the command.com program (command interpreter)
53
MD/MKDIR    - creates a directory
53
MD/MKDIR    - creates a directory
54
PATH        - displays or sets a search path for executable files
54
PATH        - displays or sets a search path for executable files
55
PAUSE       - suspends processing of a batch program
55
PAUSE       - suspends processing of a batch program
56
PROMPT      - changes the DOS command prompt
56
PROMPT      - changes the DOS command prompt
57
REM         - records comments (remarks) in a batch file or CONFIG.SYS
57
REM         - records comments (remarks) in a batch file or CONFIG.SYS
58
REN/RENAME  - renames a file or files
58
REN/RENAME  - renames a file or files
59
RMDIR       - removes (deletes) a directory
59
RMDIR       - removes (deletes) a directory
60
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
61
SHIFT       - changes the position of arguments in a batch file
62
TIME        - displays or sets the system time
62
TIME        - displays or sets the system time
63
TYPE        - displays the contents of a text file
63
TYPE        - displays the contents of a text file
64
VER         - displays the DOS version
64
VER         - displays the DOS version
65
VERIFY      - tells DOS whether to verify that files are written correctly
65
VERIFY      - tells DOS whether to verify that files are written correctly
66
VOL         - displays the disk volume label and serial number
66
VOL         - displays the disk volume label and serial number
67
 
67
 
68
 
68
 
69
=== LICENSE ==================================================================
69
=== LICENSE ==================================================================
70
 
70
 
71
SvarCOM is published under the terms of the MIT license.
71
SvarCOM is published under the terms of the MIT license.
72
 
72
 
73
Copyright (C) 2021 Mateusz Viste
73
Copyright (C) 2021 Mateusz Viste
74
 
74
 
75
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
76
of this software and associated documentation files (the "Software"), to deal
76
of this software and associated documentation files (the "Software"), to deal
77
in the Software without restriction, including without limitation the rights
77
in the Software without restriction, including without limitation the rights
78
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
78
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
79
copies of the Software, and to permit persons to whom the Software is
80
furnished to do so, subject to the following conditions:
80
furnished to do so, subject to the following conditions:
81
 
81
 
82
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
83
copies or substantial portions of the Software.
83
copies or substantial portions of the Software.
84
 
84
 
85
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
86
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
86
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
87
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
88
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
89
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,
90
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
91
SOFTWARE.
91
SOFTWARE.
92
 
92
 
93
 
93
 
94
====================================================================== EOF ===
94
====================================================================== EOF ===
95
 
95