scoedit(X) 19 June 1992 scoedit(X) Name scoedit - graphical editor for Open Desktop Command syntax scoedit [-r] filename Desktop syntax Double-click mouse button 1 on the Editor icon and select a file with the Open option on the Edit menu. The default location of the Editor is the Desktop. Or drag a file icon from either the Desktop or a directory and drop it on the Editor icon or in the open Editor window. Or double-click on a file icon. Description scoedit is the default editor that provides editing tools such as cut, paste, search, and replace operations. Cut, copy, and paste operations move regions of text within a single file or between several files. See the Edit menu. Search and replace operations can be performed on an entire file from the cursor location to the end of the file. See the Search menu. You can undo unwanted changes to your text. See the Edit menu. You can drag an open file out of an Editor window and load it into another application by dropping it on that application's icon or into the application's window. These features are described in more detail throughout this manual page. Command options -r starts the Editor in read-only mode. This means no one else has permission to edit the file while you are editing it. See the Options menu. filename is the name of the file you want to edit. If you do not give the full path name, scoedit looks for the file in you home directory. Desktop options scoedit commands are available from the pull-down menus that are located in the menu bar at the top of the Editor window. Run scoedit commands in one of the following ways: + Click on the menu, position the pointer on the menu option and click mouse button 1. As a shortcut, type a mnemonic key, instead of click- ing on the menu option. The mnemonic is the underlined character in the option name. For example, you would type N to access the New option from the File menu. + Some commands have accelerators, which involves pressing two keys simultaneously. To access the Cut command, press both <Shift> and <Del> at the same time. You do not need to access the menus for the accelerator to work. When you select menu options, some options may be grayed out, indicating they cannot be selected. scoedit makes some options inactive if it does not make sense to use them during the current operation. For example, Find Next, an option that searches for additional iterations of a string, is inactive until the Find option locates the first string. Several menu options display a dialog box when selected. This helps further define the exact nature of the operation you wish to perform. For example, if you select the Replace option, you see a dialog box prompting you to select either an interactive or global replace opera- tion. To select a dialog box option, position the mouse cursor on the desired option and click mouse button 1. Many of the settings you specify from menus and menu dialog boxes are stored in a scoedit preferences file, $HOME/.odtpref/scoedit, where $HOME is your home directory. The following sections describe the five scoedit menus. Each option name is followed by its mnemonic, for example, Open (O). If applicable, the accelerator key sequence is given after the description. File menu The File menu provides the following options: New (N) This option opens a blank window for editing. You can begin typing text immediately. Accelerator: <Alt>N Open (O) This option opens an existing file for editing. Dis- plays a file selection dialog box that lists the files in your current directory. Use the mouse to select the file you want to edit. You can use the Filter button to change directories by clicking mouse button 1 on a directory name and then clicking on the Filter button. When you open a file for editing, it is automatically locked until you edit another file or end your editing session. While the file is locked, other users can still access the file, but in read-only mode only. Because scoedit uses advisory locking, the file is only write- access protected from remote users in programs that check for advisory locks on the file. For example, if you create the file with a word-processing program that does not use advisory locks, a user who has opened the file after you have could save changes made during that session. Accelerator: <Alt>O Save (S) This command saves your file under the current filename without ending your editing session. If the file has no name or is in read-only mode, scoedit performs the SaveAs command. Files are saved in your home directory unless otherwise specified. Accelerator: <Alt>S SaveAs (A) This option saves your file under a new filename. A dia- log box displays the previous version of the file which can be overwritten if you are using the same filename, or enter the new filename. Print (P) This command sends the file to the default printer. Print Setup (u) This option allows you to specify the print command you want to use. By default, scoedit uses the lp command, but you may substitute another print command. See your UNIX system administrator's guide for details. A dialog box is displayed in which you can enter the desired print command. The default string in the Print Command field is ``(lp)'', indicating that lp is the current print script being used. Include File (I) This option imports a file into the file you are editing at the current cursor location. When you select this option, scoedit displays a dialog box, prompting you to specify the file you want to insert. Exit (E) This command ends your editing session, closing the scoedit window. Displays a dialog box, prompting you to save any changes you may have made to the current file. You have four options: Save saves changes made to the current file and then closes the scoedit window Discard ignores the changes made to the current file and then closes the scoedit window Cancel returns you to your current editing session Help provides you with help text about exiting scoedit. Note that online help is not avail- able in the SCO Developer's Kit version of scoedit. Edit menu Most Edit menu commands require that you first highlight the text you want to edit. To highlight an area of text, click and hold mouse button 1 while dragging the mouse cursor over the desired text, then release the mouse button. Click mouse button 1 to de-select the text. See the table, ``Highlighting text regions,'' in the section ``Moving around in the editor.'' The Edit menu options, with the exception of the Delete and Undo options, use the clipboard. Text that is cut or copied is stored in a clipboard. The clipboard only stores text from one operation; when you select an option using the clipboard, you overwrite the previously stored text. The Edit menu provides the following options: Undo/Redo (U) This command toggles between the Undo and the Redo com- mands. Undo reverses the effects of the most recent change to your current file. Redo reverses the effects of the most recent Undo operation. Accelerator: <Alt><Bksp> Cut (t) This command removes highlighted text from your file and stores it in the clipboard. Accelerator: <Shift><Del> Copy (C) This command copies highlighted text from your file to the clipboard. Accelerator: <Ctrl><Ins> Paste (P) This command copies the current contents of the clip- board to the cursor location in your file. Accelerator: <Shift><Ins> Delete (D) This command removes highlighted text from your file without storing it in the clipboard. The remaining text in your file is automatically reformatted. Accelerator: <Del> Search menu The Search menu provides the following options: Find (F) This command allows you to search for a specified text string. If the search string has leading or trailing spaces, this option only locates strings that contain the same number of leading or trailing spaces as the search string. When you select this command, you see a dialog box with the following options: Case Sensitive Search, Whole Word Search, and Do Not Wrap Search. These options are described later in this section. If no matching strings are located, scoedit displays a dialog box reporting no match. To use this option to locate the next iteration of a desired string, move the cursor at least one character to the right of the current cursor location. Otherwise, the next search operation locates the current match again. If you want to locate the next iteration of the desired string without moving the cursor, use the Find Next option. Find Next (N) This option locates the next iteration of the specified string after at least one match has been located. This option is available only after a text string has first been located with the Find option. If no matching strings are located, scoedit displays a dialog box reporting no match. Accelerator: <F3> Replace (R) This command allows you to replace a specified string with new text. If the search string has leading or trail- ing spaces, this option only locates strings that contain the same number of leading or trailing spaces as the search string. When you select this command, a dialog box appears with the following options: Case Sensitive Search, Whole Word Search, Do Not Wrap Search, Interactive Replacement, and Global Replacement. These options are described later. Go to Line (G) This option moves the cursor to a specified line in the file. When you select either the Find or Replace options, scoedit displays a dialog box containing options that define the nature of the operation you want to perform. To activate or deactivate these options, click mouse button 1 anywhere on the field of the desired option. Note that the selections you make in the dialog box remain in effect until you change them. The following options are displayed when you select Find or Replace: Case Sensitive Search This option specifies that strings must match the exact case of all characters in the search string. By default, a search operation recognizes both upper and lower case letters as the same charac- ters. For example, if you specify the search pat- tern ``main'' without selecting this option, the search operation could locate the strings ``MAIN,'' ``mAin,'' or ``Maine,'' as well as ``main.'' If you select this option, the search operation locates ``main'' only. Whole Word Search This option specifies that the search operation should only identify text that matches the entire search string. By default, a search operation does not use Whole Word Search. For example, if you specify the search pattern ``India'' without selecting this option, the search could locate ``Indian,'' ``Indiana,'' and ``Indianapolis,'' as well as ``India.'' If you select this option, the search operation only locates ``India.'' Do Not Wrap Search This option limits file wrapping so the file is only scanned from the current cursor position to the end of the file. By default, the search operation starts at the current cursor position, scans to the bottom of the file, then moves to the top of the file, and continues to the character before the starting location of the search. The following dialog box options are available if you select the Replace command: Interactive Replacement This option allows you to evaluate each occur- rence of the text string for which you are searching to determine if that occurrence should be replaced with the new text. Search opera- tions use this option by default. With this option, scoedit highlights each occur- rence of the text and displays a dialog box with the following prompt: Replace with "Replace String"? You can respond to this prompt in one of five ways: OK replaces the highlighted string with the new text Skip ignores the occurrence of the string and continues scanning for the next occurrence Cancel ends the Replace operation, leaving the cursor at the first character of the last highlighted text string Replace All automatically replaces all remaining strings with the new replacement text Help provides help on replacing text interactively. Note that online help is not available with the SCO Devel- oper's Kit version of scoedit. Global Replacement This option automatically replaces all occurren- ces of the search string with the replacement text. If this operation locates more than 25 occurrences of the specified string, scoedit au- tomatically switches to Interactive Replacement and displays the Interactive Replacement dialog box. The Case Sensitive Search, Whole Word Search, and Do Not Wrap Search options are switched on and off by clicking mouse button 1 anywhere on the fields of the desired options. The Interactive Replacement and Global Replacement options, however, are interdependent. Selecting one option automatically turns off the other option. For example, to deactivate the Interactive Replacement mode, select the Global Replacement option. Options menu The Options menu provides the following choices: Stats (t) This option provides a read-only dialog box that dis- plays the data on the current file, including: + name of the file you are editing, including the com- plete path of the file + access permission for this file, indicating whether the current file is available in read-only mode, or read and write mode. In read-only mode, changes can be written out only to a different filename. Also indicates whether the file is executable. + who owns the file, indicated by the login name of the person who owns the file + current position of the cursor, indicating both the line and column number of the current cursor location + number of lines in the file + date and time of last modification, including the day of the week, date, and time when the file was last edited Read Only (R) This option activates read-only mode for the current file. The file can still be edited, but changes can only be written to a different filename. The SaveAs dialog box is automatically displayed if you try to perform a Save command on a read-only file. You can edit a file without worrying that another user might edit the same file during your editing session. scoedit automatically locks files when they are opened for editing. This means that you can edit a file without being concerned that another user might access it. Other users can still view locked files, but in read-only mode only. Other users can also edit locked files, but the changes must be saved to a different filename. Auto Indent (A) This option automatically indents text to the left mar- gin position of the previous line of text in the file. For example, if you indent a line with several tabs, the following line is automatically indented with the same number of tab spaces. Save Backups (B) This option activates the file backup process that saves a copy of a file when it is saved. Because the file is copied before you save it, you can easily return to the original version, if desired. The backup file uses the name of the original file with a .bak extension. The Options menu selections you make remain in effect until you change them. Help menu The Help menu provides online help for the menus and commands available in scoedit. On Context allows you to point to anything with the question-mark cur- sor and get help. On Window is a general description of the active window. On Help tells you about the help menu. On Version tells you the version of the accessory, control, or applica- tion. Moving around in the editor There are several ways in which you can move around in files in scoedit, including methods that use mouse and keyboard input. Several methods are also available for highlighting regions of text on which you want to perform an editing operation. These methods are described in the follow- ing tables. These tables provide the various keystroke and mouse button sequences for moving around scoedit. For example, a table entry that says to press <Shift>, MB1 and Drag means that you should move the mouse over desired text while simultaneously holding down the <Shift> key and mouse button 1. The following table shows how to move through a file using scroll bars and a mouse. A scroll bar consists of two arrows pointing in opposite directions at each end of a small rectangle. Generally, you see both a horizontal and vertical scrollbar when you use scoedit. The table contains the following terms: + arrow refers to the triangular objects located at opposite ends of the scroll bar + scroll region is the rectangle between the two arrows + slider is the rectangle within the scroll region Using the scoedit scroll bar _________________________________________________________________________ Scroll Bar Mouse User Object Button Action Result _________________________________________________________________________ Arrow MB1 Click Scrolls up or down one line at a time, or scrolls left or right one column at a time. Repeats the movement multiple times if you hold down the button. <Ctrl>MB1 Click Scrolls to the top or bottom of the file, or scrolls to the right or left edge of the file. Scroll region MB1 Click Scrolls up or down one screenful at a time, or scrolls left or right one screen- ful at a time. Repeats the movement multiple times if you hold down the button. <Ctrl>MB1 Click Scrolls to the top or bottom of the file, or scrolls to the right or left edge of the file. Middle Click Moves the slider to the mouse cursor's location in the scroll region. Middle Drag Moves the slider to the mouse cursor's position in the scroll region, from where you can move the slider up or down, or left or right. Slider MB1 or MB2 Drag Moves the slider within the scroll region. When you use the scoedit scroll bar, notice that the color and/or texture of the slider contrasts with the scroll region to distinguish the two objects. The ratio of the slider size to the scroll region size corre- sponds to the percentage of the entire file that can be displayed at one time in the scoedit window. For example, if one half of the entire file fits in the window, the slider occupies half the space in the scroll region. The following table shows how to move the cursor within a file, using the keyboard. Moving the cursor _________________________________________________________________________ Keystroke sequence Result _________________________________________________________________________ <PgUp> Scrolls up a screenful at a time <PgDn> Scrolls down a screenful at a time <Ctrl><PgUp> Scrolls left a screenful at a time <Ctrl><PgDn> Scrolls right a screenful at a time <Up Arrow> Moves cursor up one line <Down Arrow> Moves cursor down one line <Right Arrow> Moves cursor right one character <Left Arrow> Moves cursor left one character <Ctrl><Right Arrow> Moves cursor forward one word <Ctrl><Left Arrow> Moves cursor back one word <Ctrl><Down Arrow> Moves cursor to next paragraph <Ctrl><Up Arrow> Moves cursor to previous paragraph <Home> Moves cursor to beginning of line <End> Moves cursor to end of line You can also move the cursor anywhere within a file by moving the cursor to the desired location and clicking mouse button 1. The following table shows the keystrokes you can use to delete different regions of text. Text deletion keystrokes _________________________________________________________________________ Keystroke sequence Result _________________________________________________________________________ <Ctrl>w Deletes next word <Ctrl>l Deletes from cursor position to end of line You can also delete text by highlighting the desired region and selecting the Cut option from the Edit menu. See the following table for details on highlighting text. The following table shows the keyboard and mouse sequences you can use to highlight regions of text. Highlighting text regions _________________________________________________________________________ Keystroke and/or User Mouse Sequence Action Result _________________________________________________________________________ MB1 Drag Highlights a range of text MB1 Double-click Highlights the word on which the cursor is positioned MB1 Triple-click Highlights the line of text on which the cursor is positioned <Shift>MB1 Drag or Click Continues highlight- ing without de- selecting previously highlighted text <Shift><Right Arrow> Extends existing highlight one char- acter to the right <Shift><Left Arrow> Extends existing highlight one char- acter to the left <Shift><Down Arrow> Extends existing highlight to incor- porate the rest of the current line and the line below the currently selected text <Shift><Up Arrow> Extends existing highlight to incor- porate the rest of the current line above the currently selected text <Ctrl><Shift><Down Arrow> Extends existing highlight to incor- porate the paragraph below the currently selected text <Ctrl><Shift><Up Arrow> Extends existing highlight to incor- porate the paragraph above the currently selected text <Ctrl>/ Highlights all text in the file <Ctrl>\ De-selects all highlighted text in the file _________________________________________________________________________ NOTE If the cursor moves over currently highlighted text when using any of the <Shift> and arrow key combinations, the highlight is removed from that text. _________________________________________________________________________ Dragging a file out of the scoedit window To drag an open file out of the scoedit window and onto an application icon, place the mouse cursor over the filename in the filename bar and press and hold mouse button 1. Notice that the mouse cursor changes shape to a small rectangle with three lines intersecting it. Drag the mouse cursor out of the scoedit window onto the Desktop and drop the file onto the desired application icon or into the window of a run- ning application. If you drop the file on an application icon, the application is immediately started, using the file as input. If you drop the file on a running application, the file is automatically loaded, replacing any other file that was currently open. When you drag a file out of scoedit and load it into another application, you are opening that file a second time, as opposed to creating a copy of it. Because of this, the file may only be available to some applications in read-only mode. _________________________________________________________________________ NOTE This feature only works with applications that have been designed to make use of this drag and drop functionality. If you drag a file out of a scoedit window and drop it on an application without this capability, you see an error message. _________________________________________________________________________ Resources You can customize some characteristics of scoedit by editing your own personal X resource file; this file contains user preferences for all of the X clients. If the file does not already exist, create it with the full pathname: $HOME/.Xdefaults-hostname where $HOME represents your home directory and hostname is the name of the machine. For a more complete list of resources and guidelines on how to modify resources, refer to the Desktop Administrator's Guide. Files $HOME/.odtpref/ScoEdit /usr/bin/X11/scoedit /usr/lib/X11/app-defaults/ScoEdit $HOME/.Xdefaults-hostname/ScoEdit