Subversion Repositories SvarDOS

Rev

Rev 638 | Rev 990 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

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