<< Click here to display Table of Contents >> Console notebook:

Source code

Contents

•	Click the Console notebook button on the Tool-bar and select the Source tab or select Source... from the 'View' menu or key-in Ctrl S.

The Source page of the Console notebook displays a searchable listing of the source code for a PCL or IDF document shown in the EscapeE window – a boon for PCL specialists and IDF enthusiasts.

The Source files for a PCL document are usually many pages long: options are provided so that only the information relevant to the task are shown.

1.	Choose how much of the file you would like to be on show:

o	This page shows the current page only.

o	Up to here shows all the pages up to and including the current page.

o	Whole file shows all the pages in the file.

2.	Check the information to be displayed from the Options:

o	Omit graphics and character downloads: the default, or

o	Omit text and binary data: to show just the commands, or

o	Show all, including binary: to show everything, including binary data such as graphics in hex.

•	Check Show command usage statistics as well to append a summary showing the number of times a command is used.

3.	Aids to finding and copying source information may be accessed by right-clicking the code window to show the pop-up menu:

o	Copy (or press Ctrl Ins)

o	Select all (Ctrl A)

Find (F3) to display the Find dialog.
You may search all of the code (the default) or just a selected (highlighted) segment of code for text or by line number.

Tip: clicking the Top button sets the current location of the cursor to the first character of the first line, deselecting any highlighted segment of code.

An existing IDF document may be modified using the 'Source' page's IDF tools and also by using 'drag and drop':

1.	Open an existing IDF document in the EscapeE window.

2.	Sweep out an area containing the item (or group of items) to be moved.

3.	Hold down the Ctrl key, click-down and drag the item to its new position then release the mouse button (the item shown in red). Behind the scenes, EscapeE generates the control file needed to create the altered document.

4.	Display the Source page of the Console notebook to see the control file that generated the original document listed.

5.	Click Modified IDF: the control file needed to generate the altered document is shown. This modified document may be saved with the original document's name or as a new document with a new name, see below.

An existing IDF file may be altered by editing the code shown in the Source page of the Console notebook. Existing source code may also be selected and copied to new IDF files.

•	Right-click the Source code window to show the pop-up editing options:

o	Copy (or press Ctrl Ins)

o	Select all (Ctrl A)

Find (F3) to display the 'Find' dialog.
You may search all of the code (the default) or just a selected (highlighted) segment of code for text or by line number.

Tip: clicking the Top button sets the current location of the cursor to the first character of the first line, deselecting any highlighted segment of code.

o	Find page on view to highlight the <PAGE> statement for the page of the document on view in the EscapeE window.

•	Modified IDF displays the source code for the edited version of the document.

•	Original IDF displays the source code for the original document, i.e. the existing saved document, before editing.

•	Click Save to update the original file with the current modifications.

•	Click Save as... to make a new IDF file.

•	Click Help to display the Help file. If the mouse was last clicked in a tag, the Help file opens with the topic related to that element on view.

See also Editing an IDF document.

Select statement(s) by sweeping over them with the mouse button held down.
Hold down:	then click:
Ctrl Ctrl	Enter or J	to select statement for the current page.
Ctrl Ctrl	PageDown or N	to move to next page and select its statement.
Tip: clicking on an element tag in the window then clicking Help displays the Help topic for that element.

1.	Display the 'Find' dialog: click the Find... button or choose Find from the right-click pop-up menu or press F3 key.

2.	Enter the string into the Find edit-box or, if you have made previous searches, choose one from the drop-down list.

3.	These check-boxes may ticked to narrow the search:

o	Case sensitive

o	Whole words only

o	Wildcards * and ?

o	Selected text only

4.	To replace the "found" string, enter the new replacement string in the Replace with box. Clear the box to delete the "found" string.

Click:

o	Find to highlight the first instance in the code window or

o	Replace or Replace All.

6.	The 'Find' dialog closes to show the found string highlighted in the code window and a vestigial search panel added above the Source tools.

o	A warning note sounds and the dialog remains open when the string is not found. Tip: hovering the mouse over the search panel shows a hint containing the 'Find' string.

7.	You may now choose to click:

o	New Search to display the 'Find' dialog again.

o	Find next to repeat the search.

o	Replace to change "found" string to the "new" string.

o	& Next to repeat the search and replace the string.

o	All to change all instances of the "found" string to the "new" string.

Tip: you may undo "find and replace" action(s) by displaying the 'Find' dialog and clicking Undo.

1.	Display the 'Find' dialog by clicking the Find... button or choosing Find from the right-click pop-up menu or pressing the F3 key. The current location ('Line' and 'Column') of the cursor is shown above the edit box.

2.	Enter the line-number into the Find edit-box or, if you have made previous searches, choose one from the drop-down list.

3.	Click 'Go to' Line button. The code window adjusts its display to show the part of the code containing the specified line. The 'Find' dialog remains open.

o	To make it easy to return to this line again in future searches, you may annotate the line number: Click Remember line and enter a string into the 'Description' box, then click OK.

Tip: Ctrl G may be used to call the Find Text (Go to page...) dialog for selecting the appropriate block of IDF statements for a page instead.

Links

IDF coding

Editing an IDF document

IDF editing tips