

		EDIT (1.3, 2.x, 3.x) (Located in the C: Directory)

	SYNOPSIS
		An AmigaDOS line editor.

	FORMAT
            EDIT [FROM] fromname [TO] toname [WITH] withname 
        [VER] vername [OPT W chars or WIDTH chars] [OPT P lines 
        or PREVIOUS lines]



	EXPLANATION 

            Unless you grew up with UNIX and really dig line 
        editors you should really try a different program (even 
        Ed) before you dive into Edit. 


            What does set Edit apart from Ed (and most other text 
        editors) is that it is able to edit binary files and it 
        can execute a predefined list of line editor commands.

            Please note that starting with version 2 of Ed you 
        can do the same thing, so there is really no need to keep 
        both of these programs hanging around on your system 
        disk.

	
	KEYWORDS

		FROM
            EDIT requires the FROM keyword. This will tell EDIT 
        which file to edit. This filename must exist. EDIT will 
        not create the file for you like Ed will.

		TO
            This will tell edit where to save the file to once 
        you decide to finish. If this is the second command in 
        your arguement, you do not need the TO keyword.
	
            EDIT is limited in the fact that it will not 
        overwrite a file that already exists. If the TO filename 
        is the same as the FROM filename then instead of 
        overwriting the FROM filename it will be save the 
        original as :t/edit.backup. The file you are working on 
        then gets named and saved as the FROM filename.

		WITH
            This specifies a file which will be used as input to 
        EDIT's command options. The contents of WITH must be a 
        series of valid options for it to work.  If WITH is the 
        third argument in an EDIT command line, the keyword is 
        optional. If you don't use this keyword you must manually 
        input your parameters.

            Due to the huge scope of available commands you 
        should consult your Amiga System manual on how to 
        configure EDIT. 

            If there is enough of an interest I will write a full 
        tutorial on how to configure EDIT.

		VER
            This lets you specify where to send the output of 
        EDIT to. You can send the output to any logical device 
        including PRT: to print it.

		OPT W  or WIDTH
		OPT P  or PREVIOUS
            This lets you set the actual physical size of EDIT. 
        WIDTH lets you set the actual line length.  PREVIOUS lets 
        you designate how many lines will be kept in EDIT's 
        history buffer. 

            The default for line length is 120 characters and the 
        default history buffer is 40 lines. If you multiply the 
        WIDTH by the PREVIOUS you will get the exact amount of 
        RAM you need to reserve as a work buffer. This amount can 
        be set with the STACK command. 

            If you set the OPT W and OPT P options, you must use 
        the OPT keyword with the W or P letters.



	EXAMPLES

            1. To edit a file called MyText in the default 
        directory:

		EDIT MyText

            2. To edit a file called MyText and to save it under 
        a file called YourText that is 5000 lines long:

		EDIT FROM MyText TO YourText OPT P5000

            3. To edit a file called MyText and to use the editor 
        commands located in the edit.prefs file (which you 
        created earlier). The data will then be saved as 
        YourText. And, to send all the messages and verifications 
        from EDIT to your printer while setting the number of 
        lines to 50 and a line width as 175:

		EDIT FROM MyText TO YourText WITH edit.prefs VER
			PRT: OPT W175 OPT P50



		See also:

		STACK
		
