ACTIONS User's Guide Reference: pp. 4-11 - 4-28 The ACTIONS menu allows you to select which type of diagram is to be produced, where the output is to be directed, and to specify various parameters for hardcopy and file output, or screen display. Press <Cr> or <A> to activate the menu. Once a file has been selected and functions have been markedfor action, you MUST go through the Set Diagram Type and Output Device options in this menu before selecting Go. All the other items in the menu are optional. Use the Page Preview option prior to generating a diagram to make sure that all the parameters are set according to your intent. C VERSION FILE User's Guide Reference: pp. 4-4, 5-3 - 5-6 The FILE menu allows you to select a source code file for actions, mark functions in it for CLEAR diagrams, specify the directory for file operations, and rename, delete and list filesin working directory. Press <Cr> or <F> to activate the menu. Remember that the very first step in operating CLEAR is to specify a .C or .L file for CLEAR actions. Use the List Directory option in this menu to quickly review the contents of the working directory. Use the Rename and Delete options in this menu to perform corresponding DOS file operations without leaving CLEAR. GLOBAL User's Guide Reference: pp. 6-3 - 6-11 The GLOBAL menu allows you to change the hardware and environment configurations, select the current language, preprocessor, and flow chart dictionary, and save the current parameters and settings as default values for future CLEAR sessions. Press <Cr> or <G> to activate the menu. The Modify Dictionary utility is one of the most important options of the GLOBAL menu. You can edit the current flow chartdictionary for key word content and symbol assignment which gives you great control over CLEAR flow chart generation. The GLOBAL menu is used in conjunction with the Reconfigure utility. QUIT/RUN User's Guide Reference: p. 2-21 The QUIT/RUN menu allows you to exit to System, execute the Reconfiguration utility, run external Text Editor, Application, or Publisher, and leave CLEAR and exit to DOS. Press <Cr>, or <Q>, or <R> to activate the menu. You MUST specify the directory and program file for your external programs prior to directly calling them from CLEAR. Remember that running an external program or reconfiguration utility constitutes only a temporary exit; you always return to CLEAR after you complete the external run. CLEAR will remember all the current settings, including the selected file. DIAGRAM TYPE User's Guide Reference: pp. 4-13 - 4-14 This option activates a submenu which allows you to select flow chart, tree chart, source print, function cross reference, or prototype file as the current CLEAR action(s). Any combina- tion of the three may be specified if the Output Device is set to printer or PRINT file. Press <Cr> or <D> to activate the submenu with Diagram Type options. Except for Prototype File option, CLEAR processes only thosefunctions which are marked with a letter corresponding to your selection of active diagram type(s) in the [F9] display. Screendisplay is supported ONLY for flow charts and tree charts. OUTPUT DEVICE User's Guide Reference: pp. 4-14- 4-17 This option activates a corresponding submenu which allows you to select printer, PRINT, PCX, and PIC file, or screen as Output Device for CLEAR actions. Press <Cr> or <O> to activate the submenu with Output Device options. If you selected Source Print, Crossreference, or Prototype File for CLEAR actions, remember that printer and PRINT file are the only two valid output options. Direct output to PRINT File if you plan to use the DOS background printing capability. You should direct output to PIC or PCX File if you wish to export flow or tree charts to publishing or paint programs. FLOW CHART OPTIONS User's Guide Reference: pp. 4-17 - 4-19 This option activates a submenu which allows you to specify the mode (full, control, logic only, or compressed), character size, comments, FlowStyle, and diagram size settings for flow chart generation. Press <Cr> or <F> to activate the submenu with Flow Chart options. A flow chart in Full Mode differs from a flow chart in Control, Logic Only, and Compressed Mode in the number of state-ments that are shown with independent symbols. Thus, changing flow chart mode as well as using small characters and reduced diagram size can lead to decreasing the size of the drawing. TREE CHART OPTIONS User's Guide Reference: pp. 4-19 - 4-22 This option activates a submenu which allows you to specify the maximum number of levels, comments, 3-dimensional shading, external functions, box rotation, and diagram size settings for tree chart generation. Press <Cr> or <T> to activate a submenu with Tree Chart options. In a tree chart, the number of horizontal levels reflects the control hierarchy of functions in your application. The maximum number of levels allowed by CLEAR is 8. CLEAR assumes shading for tree charts unless you instruct it otherwise. Any comments marked for inclusion appear inside module boxes. SOURCE PRINT OPTIONS User's Guide Reference: p. 4-22 This option activates a submenu which allows you to select logic block lines, comment only, number of characters per line, left page margin, and line numbers settings for formatted sourcelistings (source prints) of your code. Press <Cr> or <S> to activate the submenu with Source Print options. Logic lines graphically delineate beginnings and ends of logical blocks on formatted source listings of your programs. If you deactivate the logic lines, all the logical blocks (such as WHILE-{-CONTINUE-}) within your source code are set out only by indentation. CUSTOM TITLES User's Guide Reference: pp. 4-24 - 4-25 This option activates a submenu which allows you to define various titles and specify the title arrangement for hardcopy output. Press <Cr> or <C> to activate a submenu with Custom Titles options. CLEAR enables you to customize the diagrams according to your standards by allowing you to define up to five of your own titles and specify whether or not those titles are to be printed. You can always use the Page Preview option (ACTIONS menu) for a quick review of the current title arrangement. HARDCOPY SETUP User's Guide Reference: pp. 4-25 - 4-27 This option activates a submenu which allows you to specify various parameters for hardcopy output. You can select page orientation and how many copies you wish to print, and choose whether or not the diagrams are to be paged, the legend and borders are to be printed, and the diagrams are to be printed inhigh resolution mode. Press <Cr> or <H> to activate the submenuwith Hardcopy Setup options. Always remember to make sure that CLEAR is correctly configured to your PC's environment. Most importantly, verify Printer, Port, and Paper Size to assure successful hardcopy. PAGE PREVIEW User's Guide Reference: p. 4-27 This option allows you to review most of the current settings, including those specified for CLEAR hardcopy and file output. Press <Cr> or <P> to activate this option. The Page Preview screen displays show you the current outputformat settings (including legend, title arrangement, number of copies, flow chart, tree chart, and source print options, horizontal paging), the output destination, the active file, andthe diagram types selected for action(s). For your convenience,the Page Preview templates also appear when you select Go or press [F10] to start printing. GO User's Guide Reference: p. 4-28 Press <Cr> or <G> to activate the CLEAR diagram processor and perform the specified action(s). You can always interrupt diagram generation process by pressing the <Ctrl> and <Break> keys simultaneously. You can abort printing by pressing the <Esc> key. WARNING: Do not try to interrupt diagram generation while CLEAR is writing to or reading from the disk. SELECT FILE User's Guide Reference: p. 4-4 - 4-6 This option allows you to select a source code or list file for CLEAR actions. Press <Cr> or <S> to activate this option. You MUST select a file prior to generating a diagram. Once the file has been selected, use the [F9] key to review the list of functions and mark them for CLEAR actions. Remember that a LIST file (.L) has to be created if your C application consists of several .C files. A list file is an ASCII file listing all the .C files which get compiled together. Once a .L file is made, CLEAR works with functions contained in all the .C files. MARK FUNCTIONS User's Guide Reference: pp. 4-7 - 4-11 This option allows you to select functions contained in yourC application for CLEAR diagrams. You MUST select this option prior to hitting Go for all output types, except for Prototype File. Press <Cr> or <M> to activate this option. Once you select this option, CLEAR reads the selected file (or group of files, if you are working with an .L file) and displays all the functions in alphabetical order. Type <T>, <F>, <S>, or <C> (for tree chart, flow chart, source print, or cross reference respectively) next to the functions you want to process. The same can be accomplished by pressing the [F9] key. CHANGE DIRECTORY User's Guide Reference: pp. 5-4 This option allows you to specify the working directory and "FILES TO LIST" for file operations. Press <Cr> or <C> to activate this option. Unless instructed otherwise at the start, CLEAR assumes the *.* file setting in the directory from which it was invoked to be the working specification. Use the Save Current Settings option in the GLOBAL menu to save the new working directory and "FILES TO LIST" as the default values. IMPORTANT: In order to invoke CLEAR with the previously saved default directory setting, type "CCLEAR /O" LIST DIRECTORY User's Guide Reference: p. 5-5 This option allows you to review the list of files in the working directory. Press <Cr> or <L> to activate this option. The List Directory option is equivalent to the DOS DIR command which is executed from within CLEAR. If you have selected anything other than *.* as "FILES TO LIST" in the working directory specifications, List Directory will display only the corresponding subset of files. RENAME FILE User's Guide Reference: p. 5-6 This option allows you to rename a file in the current working directory. Press <Cr> or <R> to activate this option. The Rename File option is equivalent to the DOS RENAME command which is executed from within CLEAR. Remember that once you rename a file, the new name is displayed in the directory and the old name is discarded. DELETE FILE User's Guide Reference: p. 5-6 This option allows you to erase a file from the current working directory. Press <Cr> or <D> to activate this option. The Delete File option is equivalent to the DOS DELETE command which is executed from within CLEAR. Remember that once you delete a file, it is permanently erased from the working directory. CONFIGURATION User's Guide Reference: pp. 6-4 - 6-6 This option activates a submenu which allows you to configure CLEAR to your PC's environment. You can select the printer, output port, paper size, Data, Graphics, and File buffers from a number of pre-defined choices. Press <Cr> or <C>to activate the submenu with Configuration options. Please note that if you want to change definitions of some of the choices available in the Configuration menu (e.g. if you wish to use a printer or buffer different from those specified during the installation procedure) you MUST run the Reconfigure utility in the QUIT/RUN menu. SELECT LANGUAGE User's Guide Reference: p. 6-6 This option activates a submenu which allows you to select the current language (Microsoft C, Turbo C, or Generic C). Press <Cr> or <L> to activate the submenu with Language options. Remember that when you change the current language, the new language is invoked with its default flow chart dictionary and preprocessor setting. If you wish to choose a different flow chart dictionary for the current language, select the Dictionaryoption in the GLOBAL menu. You can then save the new Language-Dictionary-Preprocessor combination as the default language environment. SELECT PREPROCESSOR User's Guide Reference: p. 6-6 This option allows you to select the preprocessor setting for CLEAR file and diagram processing. Press <Cr> or <P> to activate the submenu with Preprocessor options. The preprocessor selection determines the amount of symbol redefinition that takes place before CLEAR processes the source.Using No preprocessor or Internal preprocessor is quicker than invoking the Language preprocessor that comes with a specific version of C. Since some preprocessors do not pass comment lines, the specially marked comments will be lost. Conditional compilation directives require active preprocessor for parsing. SELECT DICTIONARY User's Guide Reference: p. 6-6 This option allows you to select the current flow chart key word dictionary from the list. Press <Cr> or <D> to activate this option. Once this option is selected, CLEAR reads the System directory and displays all the flow chart dictionary files in it. These files always have extension ".WRD". When a new dictionary is selected, it is used by CLEAR as a reference for symbol assignment during flow chart generation. Use the Save Current Settings option of the GLOBAL menu to save the new language-dictionary-preprocessor environment as a default. MODIFY DICTIONARY User's Guide Reference: p. 6-8 - 6-11 This option allows you to edit the current flow chart dictionary for symbol assignment and key word content. Press <Cr> or <M> to activate this option. One this option is selected, CLEAR executes a utility that allows you to include or exclude certain key words (or valid C identifiers) for the flow charts in Compressed and Logic modes as well as redefine linear symbols for all the flow chart modes.It also allows you to predefine words as though they have been #defined in the source or on the command line for Internal preprocessor's evaluation of conditional compilation directives. SAVE CURRENT SETTINGS User's Guide Reference: pp. 6-11 - 6-13 This option activates a submenu which allows you to save the current CLEAR parameters and settings as the default values for later CLEAR sessions. You can either save individual settings or all of them at the same time. Press <Cr> or <S> to activate the submenu with Save Current Settings options. Always remember to use this submenu if you have made some global changes to CLEAR environment that you wish to carry over to the next CLEAR session. If you forget to do so and exit, youcan loose a considerable amount of time spent on customizing CLEAR according to your preferences or formatting requirements. EXIT TO SYSTEM User's Guide Reference: p. 2-21 This option directs CLEAR to jump to DOS without loosing any of the currently selected settings. Press <Cr> or <S> to activate this option. The same can be accomplished by using the <Ctrl>-[F5] key combination from any place in the CLEAR menu hierarchy. When you finish working with DOS, type "EXIT" to return to CLEAR and resume your CLEAR session. RECONFIGURE User's Guide Reference: p. 6-13 - 6-19 This option directs CLEAR to run a utility which allows you to re-configure CLEAR's environment. You can specify different graphics card, primary and secondary printers, CR & LF settings,paper size table, buffers, external systems, argument for pre- processor, and set the bell and on-line help ON or OFF. Press <Cr> or <R> to activate the submenu with Reconfigure options. The Reconfigure utility allows you to modify CLEAR default environment settings as well as those specified during the installation procedure. Some of the parameters defined using this utility then appear as choices in the Configuration menu. RUN TEXT EDITOR User's Guide Reference: p. 7-22 This option directs CLEAR to run the program specified as Text Editor in the External Systems option of the Reconfigure utility. Press <Cr> or <T> to activate this option. The same can be accomplished by using the <Ctrl>-[F1] key combination from any point in the CLEAR menu system as well as from the diagram display. When you exit the Text Editor, CLEAR remembers all the previous selections, except for the [F9] choices. Don't forget to use the External Systems submenu (Reconfigure utility) to specify the directory and program filesfor the Text Editor prior to selecting this option. RUN APPLICATION User's Guide Reference: p. 7-22 This option directs CLEAR to run the program specified as Application in the External Systems option of the Reconfigure utility. The Application can be a C compiler or any other executable program. Press <Cr> or <A> to activate this option. The same can be accomplished by using the <Ctrl>-[F2] key combination. When you exit the Application, CLEAR remembers allthe previous selections, except for the [F9] choices. Don't forget to use the External Systems submenu (Reconfigure utility)to specify the directory and program files for your Application prior to selecting this option. RUN PUBLISHER User's Guide Reference: p. 7-22 This option directs CLEAR to run the program specified as Publisher in the External Systems option of the Reconfigure utility. The Publisher can be Ventura, or PaintBrush, or any other desk-top publishing or screen-paint program that can inputPIC or PCX format. Press <Cr> or <P> to activate this option. The same can be accomplished by using the <Ctrl>-[F3] key combination. When you exit the Publisher, CLEAR remembers all the previous selections, except for the [F9] choices. Don't forget to use the External Systems submenu to specify the directory and program files for your Publisher. QUIT TO DOS User's Guide Reference: p. 2-21 This option closes all active files, permanently leaves CLEAR and exits to DOS. Press <Cr> or <Q> to activate this option. Remember that choosing this option results in the loss of all the current parameters and settings which have not been saved. Use the Save Current Settings submenu (GLOBAL menu) to prevent this from happening. FLOW CHART User's Guide Reference: pp. 4-13 - 4-14 This option allows you to choose whether or not a flow chart is to be generated. Press <Cr> or <F> to toggle flow chart ON or OFF. You MUST set flow chart ON if you wish to generate a flow chart of your program. If the Output Device is set to screen, remember to set all the other diagram types OFF; CLEAR allows you to display only one diagram type at a time. In addition to setting flow chart ON, you MUST also mark the desired functions for flow chart generation with the letter "F" using the [F9] display or the Mark Functions option of the FILE menu. S3HELPCHOICES TREE CHART User's Guide Reference: pp. 4-13 - 4-14 This option allows you to choose whether or not a tree chart is to be generated. Press <Cr> or <T> to toggle tree chart ON or OFF. You MUST set tree chart ON if you wish to generate a tree chart of your program. If the Output Device is set to screen, remember to set all the other diagram types OFF; CLEAR allows to display only one diagram type at a time. In addition to setting tree chart ON, you MUST also mark the desired functions for tree chart generation with the letter "T" using the [F9] display or the Mark Functions option of the FILE menu. SOURCE PRINT User's Guide Reference: pp. 4-13 - 4-14 This option allows you to choose whether or not formatted source listing (CLEAR source print) is to be generated. Press <Cr> or <S> to toggle source print ON or OFF. You MUST set source print ON if you wish to generate a formatted source listing of your code. Remember that the OutputDevice MUST be set to printer or PRINT file. In addition to setting source print ON, you should also mark the desired functions for source print generation with the letter "S" using the [F9] display. If you wish to generate the source print of the complete file(s), don't put anything in the [F9] display. CROSS REFERENCE User's Guide Reference: pp. 4-13 - 4-14 This option allows you to choose whether or not a function cross reference is to be generated. Press <Cr> or <C> to toggle cross reference ON or OFF. You MUST set cross reference ON if you wish to generate a cross reference of your program. Remember that the Output Device must be set to printer or PRINT file. In addition to setting cross reference ON, you MUST also mark the desired functions for cross reference generation with the letter "C" using the [F9] display or the Mark Functions option of the FILE menu. PROTOTYPE FILE User's Guide Reference: pp. 4-13 - 4-14 This option allows you to choose whether or not a function prototype file is to be generated. Press <Cr> or <P> to toggleprototype file ON or OFF. You MUST set prototype file ON if you wish to generate a prototype file of your program. Remember that the Output Device must be set to printer or PRINT file. The .PRO file thatCLEAR generates can then be #included in your .C files to help you make sure the functions are used according to their definitions. In addition, some modern compilers will report an error if a function is not used as defined in its prototype. FLOW CHART MODE User's Guide Reference: pp. 4-17 - 4-19 This option allows you to specify the mode (or the level of detail) for the flow chart to be generated. Press <Cr> or <M> to toggle Full, Control, Compressed, and Logic flow chart mode. In control mode, flow charts show all the function calls in addition to logical statements. When a flow chart is compressed,CLEAR groups several non-logical statements and treats them as one step in the program, displaying the corresponding line number range next to the flow chart symbol. A flow chart in logic mode, naturally, shows only the logical statements (with few exceptions) and ignores all the others). CHARACTER SIZE User's Guide Reference: pp. 4-17 - 4-19 This option allows you to specify the size of characters for flow chart generation. Press <Cr> or <C> to toggle small or standard font size. Small characters make the flow charts more compact horizontally. Consequently, you can see larger parts of diagrams on the screen (without scrolling) and on one page of printouts. Flow charts using small font size usually require less memory and buffer space for successful generation. However, standard size characters are more visible and make the diagram presentation considerably clearer. FLOW CHART COMMENTS User's Guide Reference: pp. 4-17 - 4-19 This option allows you to specify whether or not the specialCLEAR comments are to be included on the flow charts. Press <Cr> or <*> to toggle flow chart comments ON or OFF. CLEAR comments are the regular C comment lines marked by the"$" character (next to the /* command) for CLEAR's flow chart generation. These comment lines are assigned a special flow chart symbol on the diagrams and the text (up to 80 characters) is shown next to that symbol. Although it makes the diagrams somewhat bigger, inclusion of the special flow chart comments improves the clarity of code representation. FLOWSTYLE User's Guide Reference: pp. 4-17 - 4-19 This option allows you to select the "FlowStyle" for flow chart generation. Press <Cr> or <F> to toggle between the threedifferent FlowStyles. The concept of a FlowStyle is introduced by CLEAR to denote the style of the visual representation of the program's flow. When representing the SAME program in three different FlowStylesCLEAR uses the SAME logic flow analysis procedures but DIFFERENTplacement and routing procedures. Please remember that, though drawings of a program executed in three FlowStyles might look totally different, the flow they represent is exactly the same. DIAGRAM SIZE User's Guide Reference: pp. 4-17 - 4-19 This option allows you to specify whether the flow chart is to be generated in normal or reduced size. Press <Cr> or <S> totoggle between the two size options. There are a few advantages to "reducing" the size of a flow chart: diagram becomes 4 times smaller, so you can see larger portions of it on the screen and on printouts; generation of a drawing requires less buffer space; outputting to a file requires less disk space, etc. Naturally, there is a certain loss in readability and clarity of presentation. You can togglereduced and normal size by hitting <S> when viewing flow charts. NUMBER OF LEVELS User's Guide Reference: pp. 4-19 - 4-22 This option allows you to specify the number of hierarchy levels for tree chart generation. Press <Cr>, <N>, <+>, or <-> to toggle the number of tree chart levels or type in a number between 1 and 8. In a tree chart, the number of horizontal levels reflects the degrees of control hierarchy nested in the structure of yourapplication. The maximum number of levels allowed by CLEAR is 8. In order to produce a tree chart of one function, you need only 2 levels. However, to show the hierarchy of the system as a whole, CLEAR needs to work with higher number of levels. THREE-D SHADING User's Guide Reference: pp. 4-19 - 4-22 This option allows you to specify whether or not box shadingis to be used in tree chart generation. Press <Cr> or <T> to toggle shading ON or OFF. Shading makes the tree chart boxes appear three-dimensional which improves the quality of the drawings as presentation materials. You can set shading ON or OFF depending on your preference or documentation standards. EXTERNAL FUNCTIONS User's Guide Reference: pp. 4-19 - 4-22 This option allows you to specify whether or not missing andlibrary function calls are to be represented on the tree charts.Press <Cr> or <E> to toggle External function calls ON or OFF. If your C application makes heavy use of library functions and you choose to include external function calls on the tree chart, the diagram will most probably become overcrowded (the external function tree chart boxes will have the upper left corner filled). If you wish to analyze the complete system hierarchy, you should include the library source file(s) in the current .L file. TREE CHART COMMENTS User's Guide Reference: pp. 4-19 - 4-22 This option allows you to specify whether or not the specialCLEAR comments are to be included on the tree charts. Press <Cr> or <*> to toggle tree chart comments ON or OFF. CLEAR comments are the regular C comment lines marked by the"&" character (next to the /* command) for CLEAR's tree chart generation. These comment lines should provide essential information (up to 80 characters) on the components (functions) of the system. The special tree chart comments appear inside the boxes with function names and enhance the clarity of the diagram's representation of the system hierarchy. BOX ROTATION User's Guide Reference: pp. 4-19 - 4-22 This option allows you to specify whether or not the tree chart boxes are to be rotated, and if yes, starting from which level. Press <Cr>, <B>, <+>, or <-> to toggle NONE, AUTO, or starting level number, or type in a number between 2 and 8. Box rotation makes the diagram smaller in the horizontal direction. If AUTO box rotation is selected, CLEAR begins rotating at the level containing the maximum number of boxes. Please remember that once you activate box rotation (by choosingAUTO or any level number), the rotated boxes will have neither file names nor comments and will be shown in reduced size. DIAGRAM SIZE User's Guide Reference: pp. 4-19 - 4-22 This option allows you to specify whether the tree chart is to be generated in normal or reduced size. Press <Cr> or <S> totoggle between the two diagram size options. There are a few advantages to "reducing" the size of a tree chart: diagram becomes considerably smaller, so you can see larger portions of it on the screen and on printouts; generationof a drawing requires less buffer and file space. The disadvan-tages include omission of comments and file names from the boxesand certain loss in readability. Note that when you select Reduced diagram size, CLEAR automatically sets comments OFF. BLOCK LINES User's Guide Reference: pp. 4-22 - 4-24 This option allows you to specify whether or not the logic block connection lines are to be printed and to choose the type of block lines for on formatted source listings (CLEAR source prints) of your programs. Press <Cr> or <B> to toggle IBM set, ASCII set, Letters, or OFF block lines settings. Logic block lines graphically delineate beginnings and ends of logical blocks on formatted source listings of your programs.If you deactivate the block lines, all the logical blocks (such as DO-CONTINUE-WHILE) within your source code are set out only by indentation. COMMENTS ONLY User's Guide Reference: pp. 4-22 - 4-24 This option allows you to specify whether or not CLEAR formatted source listings (source prints) are to include ONLY comments. Press <Cr> or * to toggle Comments Only ON or OFF. Comments Only should be set to OFF at most times to assure normal program printing. However, in certain situations, it might be convenient to print comments only, especially when the program is extremely long and you wish to find out whether it iswell documented or not. LINE NUMBERS User's Guide Reference: pp. 4-22 - 4-24 This option allows you to specify whether or not the programline numbers are to be printed on formatted source listings (CLEAR source prints) of your programs. Press <Cr> or <L> to toggle line numbers ON or OFF. The line numbers that appear on CLEAR source prints should be used as a reference when looking at CLEAR flow charts: the numbers displayed inside the flow chart symbols correspond to the line numbers printed on the source prints. If you turn OFF line numbers, block lines, and paging, and output to PRINT file,you will have a formatted version of your source code file. CHARACTERS PER LINE User's Guide Reference: pp. 4-22 - 4-24 This option allows you to specify the number of characters per line for formatted source listings (CLEAR source prints) of your programs. Press <Cr>, <Tab>, or <C> to enter the new number of characters. You can select up to 160 of characters to be printed on a single line on source prints. Any text found on the same line beyond the specified number of characters shall be wrapped around to the next line. This option allows you to fully utilize your printer's printing options (e.g. compressed mode printing). LEFT MARGIN User's Guide Reference: pp. 4-22 - 4-24 This option allows you to specify the size of the left margin for formatted source listings (CLEAR source prints) of your programs. Press <Cr>, <M>, <+>, or <-> to toggle between the available options or enter a number from 0 to 9. By controlling the left margin, you have the flexibility to make CLEAR source prints adhere better to your reporting requirements. If you select zero margin, the first character will be printed in the first position. USER TITLE User's Guide Reference: p. 4-24 This option allows you to define or change the user title, and to specify whether or not it is to be printed. Press <Cr> or <U> to toggle the user title ON or OFF. Press <Tab> to modify the existing title. If you activate the user title, it automatically replaces the name of the procedure on the top of each page of your diagrams. The user title can be up to 30 characters long; it isprinted in large characters between the time and date stamp and page number. Use the Page Preview option of the ACTIONS menu totake a quick look at the page layout. DESCRIPTIVE COMMENT User's Guide Reference: p. 4-24 This option allows you to define or change the descriptive comment title, and to specify whether or not it is to be printed. Press <Cr> or <D> to toggle the descriptive comment ON or OFF. Press <Tab> to modify the existing title. If you activate the description comment, it is printed in the lower-left corner of the last page of each diagram. The descriptive comment can be up to 30 characters long and may be used for various purposes, including copyright notice, name of the client, and other important information. Use the Page Preview option to take a quick look at the page layout. PROJECT NAME User's Guide Reference: p. 4-24 This option allows you to define or change the project name title and to specify whether or not it is to be printed. Press <Cr> or <P> to toggle the project name ON or OFF. Press <Tab> to modify the existing title. If you activate the project name, it is printed in the lower-left corner of the last page of each diagram. The projectname can be up to 30 characters long. Use the Page Preview option of the ACTIONS menu to take a quick look at the page layout. NAME OF PROGRAMMER User's Guide Reference: p. 4-24 This option allows you to define or change the name of programmer title, and to specify whether or not it is to be printed. Press <Cr> or <N> to toggle the programmer name ON or OFF. Press <Tab> to modify the existing title. If you activate the programmer's name, it is printed in the lower-left corner of the last page of each diagram. The name of programmer can be up to 30 characters long. Use the Page Preview option of the ACTIONS menu to take a quick look at the page layout. COMPANY NAME User's Guide Reference: p. 4-24 This option allows you to define or change the company name title, and to specify whether or not it is to be printed. Press<Cr> or <C> to toggle the company name ON or OFF. Press <Tab> to modify the existing title. If you activate the company name, it is printed in the lower-left corner of the last page of each diagram. The name of company can be up to 30 characters long. Use the Page Preview option of the ACTIONS menu to take a quick look at the page layout. TIME & DATE STAMP User's Guide Reference: p. 4-24 This option allows you to specify whether or not the time and date title is to be printed. Press <Cr> or <T> to toggle the time & date stamp ON and OFF. If you activate the time & date stamp, it is printed in the upper left corner on each page of each diagram. The stamp shows the current date and time ("Printed") and the date and time when the program was last modified ("Updated"). Use the Page Preview option of the ACTIONS menu to take a quick look at the page layout. PAGING User's Guide Reference: pp. 4-25 - 4-27 This option allows you to specify whether or not CLEAR diagrams are to be paged. Press <Cr> or <P> to toggle paging ON or OFF. Flow chart and tree charts larger than the size of paper fedinto your printer can be drawn only sequentially, one section after another. Paging enables you to key the pages to each other using matching labels at the edges. If you don't select paging: the flow charts and tree charts are printed unformatted,to be cut-and-pasted after printing has completed; the source prints are printed continuously over the lines of perforation. BORDERS User's Guide Reference: pp. 4-25 - 4-27 This option allows you to specify whether or not CLEAR tree charts and flow charts are to be printed with borders. Press <Cr> or <B> to toggle borders ON or OFF. Unless de-activated, the border is printed on each page of flow charts and tree charts. Often, the drawing itself occupiesonly the center of the page, so printing the borders greatly slows down printing of the complete page. Similarly, when outputting to a file (PRINT, PIC, or PCX), borders make the sizeof the file considerably bigger. Please turn borders OFF, if you don't think they are worth the extra time and space. ORIENTATION User's Guide Reference: pp. 4-25 - 4-27 This option allows you to specify the page orientation for flow chart and tree chart printouts. Press <Cr> or <O> to toggle landscape and portrait page orientation. Depending on the shape of the drawing, some tree charts and flow charts are more space efficient when printed in portrait mode and some when printed in landscape. Unless you have specific reporting requirements, you should experiment with the two page orientations to find out which one is best. If you select box rotation for the tree charts, it is probably a good idea to choose portrait page orientation versus landscape. LEGEND User's Guide Reference: pp. 4-25 - 4-27 This option allows you to specify whether or not the symbol legend is to be printed with flow charts and tree charts. Press<Cr> or <L> to toggle legend ON and OFF. The legend provides definitions of the symbols used by CLEARin generating the chart. It is printed on a separate page, at the end of the drawing, for flow charts, and on the last page, for tree charts. Please note, that you can display the legend on the screen while viewing tree charts by pressing <Alt> and [F1] keys simultaneously. NUMBER OF COPIES User's Guide Reference: pp. 4-25 - 4-27 This option allows you to specify the number of copies to beprinted. Press <Cr>, <N>, or <+> and <-> to toggle the number of copies, or type in a number from 1 to 9. If you choose to print more than one copy, remember that all the hardcopy output will be affected, i.e. CLEAR produces multiple copies of flow charts, tree charts, source prints, cross references, and prototype files of all the selected files and functions. This can be very time consuming is you are printing on a slow printer and/or if CLEAR processes complex functions. NON-FUNCTIONAL
