| 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 |
- a few internal commands missing: CALL, CTTY, GOTO, LH
|
14 |
- a few internal commands missing: CALL, CTTY, GOTO, LH
|
| 15 |
- DIR misses two switches: /S, /O
|
15 |
- DIR misses two switches: /S, /O
|
| 16 |
|
16 |
|
| 17 |
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
|
| 18 |
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.
|
| 19 |
|
19 |
|
| 20 |
As of version 2022.0, SvarCOM's resident footprint is under 2 KiB.
|
20 |
As of version 2022.0, SvarCOM's resident footprint is under 2 KiB.
|
| 21 |
|
21 |
|
| 22 |
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
|
| 23 |
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
|
| 24 |
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
|
| 25 |
%LANG% environment variable. NOTE: at this time translations aren't available
|
25 |
%LANG% environment variable. NOTE: at this time translations aren't available
|
| 26 |
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.
|
| 27 |
|
27 |
|
| 28 |
Latest version available here: http://svardos.osdn.io/svarcom
|
28 |
Latest version available here: http://svardos.osdn.io/svarcom
|
| 29 |
|
29 |
|
| 30 |
|
30 |
|
| 31 |
=== INTERNAL COMMANDS ========================================================
|
31 |
=== INTERNAL COMMANDS ========================================================
|
| 32 |
|
32 |
|
| 33 |
SvarCOM implements the following internal commands. For help on each command,
|
33 |
SvarCOM implements the following internal commands. For help on each command,
|
| 34 |
run it with a "/?" argument.
|
34 |
run it with a "/?" argument.
|
| 35 |
|
35 |
|
| 36 |
BREAK - sets or clears extended CTRL+C checking
|
36 |
BREAK - sets or clears extended CTRL+C checking
|
| - |
|
37 |
CALL - calls a batch file from within another batch file
|
| 37 |
CD/CHDIR - displays the name of or changes the current directory
|
38 |
CD/CHDIR - displays the name of or changes the current directory
|
| 38 |
CHCP - displays or sets the active code page number
|
39 |
CHCP - displays or sets the active code page number
|
| 39 |
CLS - clears the screen
|
40 |
CLS - clears the screen
|
| 40 |
COPY - copies one or more files to another location
|
41 |
COPY - copies one or more files to another location
|
| 41 |
DATE - displays or sets the system date
|
42 |
DATE - displays or sets the system date
|
| 42 |
DEL/ERASE - deletes one or more files
|
43 |
DEL/ERASE - deletes one or more files
|
| 43 |
DIR - displays a list of files and subdirectories in a directory
|
44 |
DIR - displays a list of files and subdirectories in a directory
|
| 44 |
ECHO - displays messages, or turns command-echoing on or off
|
45 |
ECHO - displays messages, or turns command-echoing on or off
|
| 45 |
EXIT - quits the command.com program (command interpreter)
|
46 |
EXIT - quits the command.com program (command interpreter)
|
| - |
|
47 |
GOTO - directs batch processing to a labelled line in the batch program
|
| 46 |
IF - performs conditional processing in batch programs
|
48 |
IF - performs conditional processing in batch programs
|
| 47 |
LN - adds, deletes and displays global executable links
|
49 |
LN - adds, deletes and displays global executable links
|
| 48 |
MD/MKDIR - creates a directory
|
50 |
MD/MKDIR - creates a directory
|
| 49 |
PATH - displays or sets a search path for executable files
|
51 |
PATH - displays or sets a search path for executable files
|
| 50 |
PAUSE - suspends processing of a batch program
|
52 |
PAUSE - suspends processing of a batch program
|
| 51 |
PROMPT - changes the DOS command prompt
|
53 |
PROMPT - changes the DOS command prompt
|
| 52 |
RD/RMDIR - removes (deletes) a directory
|
54 |
RD/RMDIR - removes (deletes) a directory
|
| 53 |
REM - records comments (remarks) in a batch file or CONFIG.SYS
|
55 |
REM - records comments (remarks) in a batch file or CONFIG.SYS
|
| 54 |
REN/RENAME - renames a file or files
|
56 |
REN/RENAME - renames a file or files
|
| 55 |
SET - displays, sets or removes DOS environment variables
|
57 |
SET - displays, sets or removes DOS environment variables
|
| 56 |
SHIFT - changes the position of arguments in a batch file
|
58 |
SHIFT - changes the position of arguments in a batch file
|
| 57 |
TIME - displays or sets the system time
|
59 |
TIME - displays or sets the system time
|
| 58 |
TYPE - displays the contents of a text file
|
60 |
TYPE - displays the contents of a text file
|
| 59 |
VER - displays the DOS version
|
61 |
VER - displays the DOS version
|
| 60 |
VERIFY - tells DOS whether to verify that files are written correctly
|
62 |
VERIFY - tells DOS whether to verify that files are written correctly
|
| 61 |
VOL - displays the disk volume label and serial number
|
63 |
VOL - displays the disk volume label and serial number
|
| 62 |
|
64 |
|
| 63 |
|
65 |
|
| 64 |
=== INSTALLATION =============================================================
|
66 |
=== INSTALLATION =============================================================
|
| 65 |
|
67 |
|
| 66 |
Installing SvarCOM requires to either copy it to the root of your boot drive
|
68 |
Installing SvarCOM requires to either copy it to the root of your boot drive
|
| 67 |
replacing your current COMMAND.COM, or adding a SHELL directive to your
|
69 |
replacing your current COMMAND.COM, or adding a SHELL directive to your
|
| 68 |
CONFIG.SYS file to instruct DOS that it should load SvarCOM as its shell, eg.:
|
70 |
CONFIG.SYS file to instruct DOS that it should load SvarCOM as its shell, eg.:
|
| 69 |
|
71 |
|
| 70 |
SHELL=C:\SVARCOM\COMMAND.COM /P
|
72 |
SHELL=C:\SVARCOM\COMMAND.COM /P
|
| 71 |
|
73 |
|
| 72 |
Some DOSes support a SHELLHIGH directive that loads the shell in high memory.
|
74 |
Some DOSes support a SHELLHIGH directive that loads the shell in high memory.
|
| 73 |
It is pointless to use it to load SvarCOM. SvarCOM will load its resident part
|
75 |
It is pointless to use it to load SvarCOM. SvarCOM will load its resident part
|
| 74 |
as high as possible on its own, enforcing this through SHELLHIGH could even
|
76 |
as high as possible on its own, enforcing this through SHELLHIGH could even
|
| 75 |
be harmful since SvarCOM wouldn't be able to relocate to the highest address
|
77 |
be harmful since SvarCOM wouldn't be able to relocate to the highest address
|
| 76 |
as it would be allocated by SHELLHIGH already.
|
78 |
as it would be allocated by SHELLHIGH already.
|
| 77 |
|
79 |
|
| 78 |
SvarCOM supports multiple languages. To enable SvarCOM using them it is
|
80 |
SvarCOM supports multiple languages. To enable SvarCOM using them it is
|
| 79 |
necessary to define an NLSPATH environment variable that would point to a
|
81 |
necessary to define an NLSPATH environment variable that would point to a
|
| 80 |
directory and copy the SVARCOM.LNG file there. Once done, SvarCOM will try
|
82 |
directory and copy the SVARCOM.LNG file there. Once done, SvarCOM will try
|
| 81 |
loading whatever language is being set up in the LANG environment variable.
|
83 |
loading whatever language is being set up in the LANG environment variable.
|
| 82 |
|
84 |
|
| 83 |
|
85 |
|
| 84 |
=== LICENSE ==================================================================
|
86 |
=== LICENSE ==================================================================
|
| 85 |
|
87 |
|
| 86 |
SvarCOM is published under the terms of the MIT license.
|
88 |
SvarCOM is published under the terms of the MIT license.
|
| 87 |
|
89 |
|
| 88 |
Copyright (C) 2021-2022 Mateusz Viste
|
90 |
Copyright (C) 2021-2022 Mateusz Viste
|
| 89 |
|
91 |
|
| 90 |
Permission is hereby granted, free of charge, to any person obtaining a copy
|
92 |
Permission is hereby granted, free of charge, to any person obtaining a copy
|
| 91 |
of this software and associated documentation files (the "Software"), to deal
|
93 |
of this software and associated documentation files (the "Software"), to deal
|
| 92 |
in the Software without restriction, including without limitation the rights
|
94 |
in the Software without restriction, including without limitation the rights
|
| 93 |
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
95 |
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
| 94 |
copies of the Software, and to permit persons to whom the Software is
|
96 |
copies of the Software, and to permit persons to whom the Software is
|
| 95 |
furnished to do so, subject to the following conditions:
|
97 |
furnished to do so, subject to the following conditions:
|
| 96 |
|
98 |
|
| 97 |
The above copyright notice and this permission notice shall be included in all
|
99 |
The above copyright notice and this permission notice shall be included in all
|
| 98 |
copies or substantial portions of the Software.
|
100 |
copies or substantial portions of the Software.
|
| 99 |
|
101 |
|
| 100 |
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
102 |
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
| 101 |
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
103 |
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
| 102 |
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
104 |
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
| 103 |
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
105 |
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
| 104 |
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
106 |
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
| 105 |
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
107 |
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
| 106 |
SOFTWARE.
|
108 |
SOFTWARE.
|
| 107 |
|
109 |
|
| 108 |
|
110 |
|
| 109 |
====================================================================== EOF ===
|
111 |
====================================================================== EOF ===
|
| 110 |
|
112 |
|