home *** CD-ROM | disk | FTP | other *** search
/ PC Direkt 1998 #11 / PCDIREKT_1198.bin / data / Util / ntsh / README.TXT < prev    next >
Encoding:
Text File  |  1997-10-05  |  7.9 KB  |  252 lines
  1. . _______________________________________ .
  2.  /                                       \
  3. |  New Technology Shell                   |
  4. |  by Martin Waitz                        |
  5. |                                         |
  6. |  ALPHA TEST VERSION                     |
  7. .\_______________________________________/.
  8.  
  9.  
  10.       |o-                       -o|
  11.       >  PLEASE READ THIS FIRST!  <
  12.       |o-                       -o|
  13.  
  14.  
  15.  ______________________________________
  16. (o About New Technology Shell
  17.  
  18. The New Technology Shell (ntsh) is a commandline based shell for Windows.
  19. It offers much features common to Unix users  which haven't ever
  20. been seen in the Windows world before.
  21. It is a very nice shell for users who want to get the most out of their
  22. system, but don't want to give up the convenience of Windows.
  23.  
  24. New Technology Shell is a multithreaded Win32 Console app with GUI support...
  25. (oh yep, that's possible. I've thrown everything into it... ;)
  26. It WON'T work with Win31 or plain DOS. It is designed to run under Windows NT,
  27. but should be able to run under Win95, too.
  28.  
  29.  
  30. PLEASE NOTE:
  31. this is an alpha version.
  32. many things haven't even been implemented and many things will change
  33. in future versions. However, it is already quite stable and can be used
  34. in daily work.
  35. PLEASE REPORT ALL BUGS YOU FIND TO "mnwaitz@cip.informatik.uni-erlangen.de"
  36. (I'm sure you'll find some...).
  37.  
  38. Note: this program is designed to work under WinNT and has not been tested
  39.       with Windows 95. Especially Scrollback may not work under Win95.
  40.  
  41.  
  42.  
  43.  ______________________________________
  44. (o Features
  45.  
  46.  
  47. Features include:
  48.  
  49.   *  Unix-like commands
  50.  
  51.   *  use of normal slash (/) as a directory seperator,
  52.      instead of the backslash (\)
  53.      (like in all non-MS operating systems...)
  54.   
  55.   *  powerful commandline with history, aliases and more...
  56.  
  57.   *  AutoComplete
  58.      (look for completion of the current word and apply it
  59.       when TAB is pressed)
  60.  
  61.   *  Ansi color support in internal commands
  62.  
  63.   *  and many more...
  64.  
  65.  
  66. Things to do:
  67.  
  68.   *  more scripting support
  69.  
  70.   *  "mounting" drives in the directory tree
  71.  
  72.   *  support for Ansi color output
  73.  
  74.   *  right-click context-menu to allow dialog-based access to 
  75.      aliases, environment, running jobs,...
  76.  
  77.   *  better documentation
  78.      (thinking of html files and a real man-cmd displaying them)
  79.  
  80.   *  and many more...
  81.  
  82.  
  83. there are always some more features not wanted... <eg>
  84. again... please report them to me, thanx.
  85.  
  86.  
  87.  
  88.  ______________________________________
  89. (o Installation
  90.  
  91.  
  92. well, not too complicated...
  93. Simply unzip all the files to a directory of your choice.
  94. If you don't already have msvcrt40.dll, mfc40.dll & ShellLink.ocx,
  95. you have to get 'ntsh-alpha2-runtime.zip' and unzip it to your 
  96. windows system directory.
  97.  
  98. You should have these files:
  99.  
  100.   -  ntsh.exe        // the executable shell
  101.   -  setup.cmd       // setup script
  102.   -  ntshrc.cfg      // main configuration file, will be executed at startup
  103.   -  aliases.cfg     // file containing the standard aliases
  104.   -  readme.txt      // this readme
  105.  
  106. When you first start ntsh.exe, it will automatically invoke setup.cmd
  107. and set all the defaults needed to run ntsh in the future.
  108.  
  109. If you are working in an multi-user environment, each user can
  110. have an additional config and alias file in his home directory.
  111. (the '~/.aliases.cfg' & '~/.ntshrc.cfg' files, note the dots at the beginning)
  112. These names can be changed in ntshrc.cfg.
  113.  
  114. Yep, that's it!
  115.  
  116.  
  117. Uninstall, if ever wanted:
  118. remove the directory you copied ntsh to.
  119. Note: configuration data will still remain in registry.
  120.  
  121. simple enough???
  122.  
  123.  
  124.  ______________________________________
  125. (o first steps
  126.  
  127.  
  128. First of all, most commands known from DOS also work in ntsh.
  129. Some have been changed, in order to find a compromisse between
  130. DOS and Unix-style.
  131.  
  132. These internal commands are supported:
  133.   *  alias      - set an alias to another command
  134.   *  builtins   - show them all
  135.   *  cd         - change the working directory
  136.   *  cat        - print the contents of a file
  137.   *  cp         - copy a file
  138.   *  echo       - display some text
  139.   *  exit       - exit the shell
  140.   *  errorlevel - test for errorlevel
  141.   *  exist      - test for existence of a file
  142.   *  if         - execute command only if a condition is true
  143.   *  ls         - list contents of directory
  144.   *  md         - make new directory
  145.   *  mv         - move/rename a file
  146.   *  not        - inverts a condition
  147.   *  pwd        - prints working directory
  148.   *  rm         - remove a file
  149.   *  setenv     - set environment variable
  150.   *  scrollback - set scrollback buffer
  151.   *  source     - execute commands in a file
  152.   *  title      - sets/get the window title
  153.  
  154. Most Dos commands are implemented with aliases.
  155. To get information about a command, use 'man <command>' or '<command> -h'.
  156. Don't forget that aliases and internal commands are case sensitiv in ntsh.
  157.  
  158. If you have a scrollback buffer (as enabled by default), you can scroll
  159. up/down with the PgUp/PgDown keys.
  160. Use ArrowUp/ArrowDown to cycle through your previosly typed commands.
  161. You can complete filenames/commands/directories/environment vars by hitting TAB
  162.  
  163. Note for Alpha versions:
  164. to start .com or .bat files, you have to specify the extension
  165. only .exe files don't need the extension
  166.  
  167.  
  168.  ______________________________________
  169. (o some notes on cmdline parsing
  170.  
  171. quoted text ("") is treated as one word, i.e. blanks are ignored
  172. text in '' is not parsed at all
  173. backslash (\) escapes the next character
  174. subsitutions:
  175.    ~, ~user       -> (user's) home directory
  176.    %var% , $(var) -> environment variable
  177.    $(config)      -> configuration setting
  178.    $x             -> special:
  179.     _: new line; ?: last errorlevel; d,D: date; e: escape char (0x1b); 
  180.     n: cmd count; p,P: path; t,T: time; v.V: version;
  181.  
  182.    cmd1 ; cmd2    -> execute both cmd1 and cmd2
  183.    cmd1 && cmd2   -> execute cmd2 if cmd1 returned succesful (errorlevel 0)
  184.    cmd1 || cmd2   -> execute cmd2 if cmd1 failed (errorlevel >0)
  185.  
  186.  
  187.  
  188.  ______________________________________
  189. (o legal stuff
  190.  
  191. (absolutely capital-free... ;)
  192. new technology shell is copyright (c) 1997 by martin waitz
  193. this ntsh prerelease is freeware. (future versions will be, too)
  194. this means that you can download/use/give away it free of charge.
  195. this also means, that i can't give any support and
  196. won't be liable for anything.
  197. however, you can always contact me via e-mail (see below).
  198.  
  199. I think, that's enough.
  200. Go use and enjoy it, don't hassle with legal stuff!
  201.  
  202.  
  203.  ______________________________________
  204. (o the Author
  205.  
  206. well, yes, that's me... Martin Waitz
  207.  
  208. I'm currently studying computer science in Erlangen, Germany.
  209. (when not coding on ntsh...)
  210.  
  211. Please don't miss to visit my web-page:
  212. http://wwwcip.informatik.uni-erlangen.de/user/mnwaitz (in German)
  213.  
  214. If you have any questions not answered here, comments or suggestions,
  215. feel free to write an e-mail to me
  216. (mnwaitz@cip.informatik.uni-erlangen.de)
  217.  
  218.  
  219.  ______________________________________
  220. (o where to get it
  221.  
  222.  
  223. World Wide Web (WWW):
  224.  
  225.   *  at the New Technology Shell homepage   (http://ntsh.home.pages.de)
  226.   *  at my private homepage (in German):    (http://taliesin.home.pages.de)
  227.   *  there are also links to these download places in some shareware sites
  228.      (www.windows95.com, www.32bit.com, www.freeware.com...)
  229.  
  230. Bulletin Boards (BBS):
  231.  
  232.   *  Zagy's Mehlbox (Christian Zagrodnick)
  233.      V34,X75 +49-9561-20996 , fido 2:2490/3245
  234.      http://zagy.home.pages.de
  235.      Coburg, Germany
  236.   
  237.   *  I'll Try That Once! (Mark Taylor)
  238.      V34+ +44-1453-765378, fido 2:253/35
  239.      Stroud, UK
  240.  
  241. if you want your Site to become an official ntsh dist.site, (http, ftp or bbs)
  242. please mailto:mnwaitz@cip.informatik.uni-erlangen.de
  243.  
  244.  
  245.  
  246. so, that's it...
  247.  
  248. nothing more here for now...
  249.  
  250.  
  251.                                                         ____________________
  252.                                                            by Martin Waitz o)