


              NewCLI(V1.3 in C:) (v 2x/3x internal)



     NAME
            NewCLI - Start a new interactive CLI on the system 
        display.

     SYNOPSIS
		1.3:
	NewCLI [AUX: or CON:hpos/vpos/width/height/windowtitle] 
           [From filename] [CLI] [STACK]

		2.x/3.x:
    NewCLI [AUX: or CON:hpos/vpos/width/height/windowtitle/options]
           [From filename]

     DESCRIPTION
          

            This window support the same gadgets of a regular 
        everyday Workbench window (that is a drag gadget, 
        back/front gadget, sizing and under 2.x/3.x a zoom and 
        close gadget). It can be started with this command as 
        well as by double-clicking on the Workbench icon 'CLI' 
        found in your Systems drawer. Once started, the CLI 
        becomes the active window on the Workbench. It immediatly 
        takes on current directory from which it was started 
        from.

            You can open as many CLI windows as your memory 
        allows under 2.x/3.x.  1.3 limits you to 20. Each window 
        will operate completely seperatly from anyother and will 
        be complete with its own environment.

            If you do not change the CLI attributes during CLI 
        startup, then it will be named 'New CLI' under 1.3 and 
        'AmigaShellj' in 2.x/3.x.  The task number of the CLI 
        will also be shown.

            Each and every CLI will have its own unique task 
        number, just as every application run on the Amiga will 
        be assigned its own task number. It will be numbered 
        according to how many programs are running at the time 
        you open it. For instance, if you have absolutly NO other 
        applications running it will be task number 1, if there 
        are two other applications running it will be task number 
        3, etc. 

            Unless you specify during the start of the CLI 
        process, each CLI will open at the top left corner of the 
        screen and extend 640 pixels accross and 100 pixels down 
        the screen. So, as you open each new CLI, it will cover 
        up the old one unless you manually drag it out of the 
        way.

            The advantage of being able to run multiple CLIs on 
        the Amiga is one of the many attributes that sets it 
        apart from other operating systems.  You can open as many 
        CLIs as you could ever use, with each running its own 
        application or holding information which you may need to 
        reference.  If you take a few minutes to master the CLI, 
        you will be able to run rings around anything that an IBM 
        compatible can spew out.


	KEYWORDS

		[AUX: or CON:hpos/vpos/width/height/windowtitle/options]
		[FROM filename]

            Using CON: lets you chose the size, postion, and the 
        name of the new CLI window. (NEWCON: was added under 1.3 
        which has advanced functions which may replace CON:) If 
        you want to change the size, postion, or name of the CLI, 
        the CON: (or NEWCON:) keyword must be used.

		-hpos:

            The horizontal position of the top left corner of 
        your CLI. It is defaulted to 0.

		-vpos: 

            The verticle postion of the top left corner of your 
        CLI. It is defaulted to 0.

		-width:
		-height:

            These two keywords have no defaults and must be 
        included for the CON: keyword to work. The CLI must be at 
        least 90x25 pixels, but has a maximum of 640x200 pixels. 
        You can also use the sizing gadget on your CLI to change 
        the window size at any time.

		-windowtitle:
            This one is completely optional. This lets you chose 
        the name of the CLI as shown in the titlebar. If you 
        don't enter a window title the title space will be blank. 
        Even though you don't have to supply a name, you must 
        include the last slash following the height keyword.

		-options: 

            2.x/3.x only. These options were added to make the 
        CLI more flexible.  You can add as many or as few options 
        as you desire:

            AUTO: The CLI opens immediatly only when the program 
        that started it requres it.

            CLOSE: This is on by default. This lets you add the 
        Close gadget in the top left corner of the CLI.

            BACKDROP: This lets forces the CLI to open up behind 
        all other windows and cannot be moved, resized, or 
        changed in any way except through using the zoom gadget.

            NOBORDER: There are no visible lines surrounding the 
        window. The zoom and size gadgets will still be there, 
        but if you zoom the window to full size, the CLI will 
        dominate your environment and the only way to make it 
        smaller is by closing it.

            NODRAG: The window will not let you drag it. The 
        position will remain in the same place always.

            NOSIZE: The zoom, close, and size gadgets will 
        disappear when the CLI is started. There will only be a 
        depth gadget.

            SCREENname: The CLI will open on a screen with the 
        name you give it.  For instance, if you use the 
        'SCREENveronica' option, the CLI will open up on the 
        public screen named 'veronica'. If 'veronica' does not 
        exist, then this option won't work.

            SIMPLE: Allows the text to fill up the CLI window 
        when expanded. This lets you see more information than 
        before. The default is on.

            SMART: When the CLI widow is expanded, this option 
        does not allow the old information to be seen. It is the 
        opposite of SIMPLE.
				
            WAIT: The CLI won't close when the program that 
        created it is closed.  To close the CLI using this 
        option, you must select the close gadget or use the 
        Ctrl-\ key combination.


            If you direct the output and input of a CLI to the 
        AUX: device if you desire.  By routing the commands 
        through AUX: you are actually sending commands out the 
        serial port. This kind of CLI will not be able to cancel 
        requestors and only allow you to run text-based programs. 
        Sorry, no GUI here. Of course, you must mount the AUX: 
        device before you can utilize this.

		[FROM filename] 
            This lets you open a CLI with the specifications set 
        in a script file located in your s directory. Normally, 
        NewCLI uses the s:CLI-startup script.  But, you can write 
        any script and reference it with this keyword.

            Check out s:CLI-startup to get an idea how to set 
        this up.


    EXAMPLES

            1. To create a new CLI that uses the serial port for 
        input and output:

			NEWCLI AUX: 

    	(remember: this only works if AUX: is mounted)



            2. To create a 150x150 CLI in the upper left corner 
        of your screen named 'Debox':

			NEWCLI CON://150/150/Debox

            3. To create the default CLI (that is, with the upper 
        left corner of a 200x100 window titled 'New CLI':

			NEWCLI
