|
DataMuseum.dkPresents historical artifacts from the history of: Rational R1000/400 |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about Rational R1000/400 Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - download
Length: 15137 (0x3b21) Types: TextFile Notes: R1k Text-file segment
└─⟦8527c1e9b⟧ Bits:30000544 8mm tape, Rational 1000, Arrival backup of disks in PAM's R1000 └─ ⟦5a81ac88f⟧ »Space Info Vol 1« └─⟦08efb1c69⟧ └─⟦this⟧
%!PS-Adobe-2.0 %%Title: !TOOLKIT.ANALYSIS.ADA_ANALYSIS.REV1_WORKING.DOCUMENTATION.ANALYSIS_ROAD_MAP'V(15) %%Creator: COMPOSE 10.7.7 %%CreationDate: April 29, 1990 at 11:48:00 PM %%For: MPR %%Pages: (atend) %%DocumentFonts: (atend) %%EndComments /SelectFont {findfont exch dup neg 0 0 3 -1 roll 0 0 MAT astore makefont setfont} bind def /BeginPage {/State save def /INITIAL-MATRIX matrix currentmatrix def 1 -1 scale 0.5 setlinewidth} bind def /PositionPage {{-90 rotate pop} {0 exch neg translate} ifelse} bind def /EndPage {State restore showpage} def /WS {0 32 4 -1 roll widthshow} bind def /MX {0 rmoveto} bind def /LTAB {gsave exch (.) stringwidth pop sub exch {dup 2 div dup 0 rmoveto (.) show 0 rmoveto} repeat pop grestore} bind def /MAT matrix def /FINDSCALE {gsave newpath 0 0 moveto (X) false charpath flattenpath pathbbox /CAPHEIGHT exch def pop pop pop newpath 0 0 moveto (x) false charpath flattenpath pathbbox /XHEIGHT exch def pop pop pop grestore XHEIGHT CAPHEIGHT XHEIGHT sub 3 div add CAPHEIGHT div } bind def /CAP-ENCODING [ StandardEncoding aload pop ] def 8#141 1 8#172 {CAP-ENCODING exch dup 1 string dup 0 4 -1 roll 8#40 sub put cvn put} for /COPYFONT {dup length dict /TMPDICT exch def {1 index /FID ne {TMPDICT 3 1 roll put} {pop pop} ifelse } forall TMPDICT }bind def /SYM {save exch /newfont currentfont maxlength dict def currentfont {exch dup /FID ne {dup /Encoding eq {exch dup length array copy newfont 3 1 roll put} {exch newfont 3 1 roll put} ifelse } {pop pop} ifelse} forall newfont /Encoding get 8#377 3 -1 roll put /NEWFONT newfont definefont setfont (\377) show restore} bind def %%EndProlog %%Page: 1 1 BeginPage 792 false PositionPage 72 76 moveto 14 /Times-Bold SelectFont (1. Overview) show 72 100 moveto 10 /Times-Roman SelectFont (Interfaces in this subsystem can be used to analyze Ada units in a variety of ways. A user may want to perform the) show 72 112 moveto (following kinds of analysis:) show 72 136 moveto (1.) show 10 /Times-Bold SelectFont 16.500 MX (General Analysis) show 10 /Times-Roman SelectFont ( - Analysis to collect and condense all areas of the code that exhibit a particular trait so that) show 96 148 moveto (an overall picture of the code may emerge.) show 72 172 moveto (2.) show 10 /Times-Bold SelectFont 16.500 MX (Performance) show 10 /Times-Roman SelectFont ( - Analysis to illuminate areas of the code that have potentially high impact on performance.) show 72 196 moveto (3.) show 10 /Times-Bold SelectFont 16.500 MX (Code Correctness) show 10 /Times-Roman SelectFont ( - Analysis to illuminate areas of the code that have a high likelihood for errors given their) show 96 208 moveto (complexity.) show 72 232 moveto (4.) show 10 /Times-Bold SelectFont 16.500 MX (Style) show 10 /Times-Roman SelectFont ( - Analysis to verify that coding standards are not violated and that the code maintains consistent usage) show 96 244 moveto (patterns.) show 72 284 moveto 14 /Times-Bold SelectFont (2. Analysis Descriptions) show 72 322 moveto 12 /Times-Bold SelectFont (2.1. General Analysis) show 72 359 moveto 11 /Times-Bold SelectFont (2.1.1. Counting Ada Constructs) show 72 383 moveto 10 /Times-Roman SelectFont (The package Ada_Construct analysis provides two interfaces for counting the instances of Ada constructs in a) show 72 395 moveto (collection of units. This can be used to find instances of Ada constructs which are prohibited and high) show 72 407 moveto (concentrations of usages which may indicate a problem or may indicate a positive attribute of the code.) show 72 431 moveto (The first procedure \050Display_By_Unit\051 provides a list of ada constructs on a unit-by-unit basis, separating the counts) show 72 443 moveto (for each unit into a separate table.) show 72 467 moveto (A second procedure is available to compare the counts for all procedures in a single table. A total for all procedures) show 72 479 moveto (is also provided.) show 72 503 moveto (Each procedure has a set of summary tables which provide totals and average counts per unit.) show 72 540 moveto 11 /Times-Bold SelectFont (2.1.2. Analyze_Types) show 72 564 moveto 10 /Times-Roman SelectFont (Provides an analysis of all type declarations in a set of Ada units. Declarations are sorted by kind so that redundant) show 72 576 moveto (or similar declarations can be found.) show 72 613 moveto 11 /Times-Bold SelectFont (2.1.3. Analyze_Record_Types) show 72 637 moveto 10 /Times-Roman SelectFont (Displays all record declarations and their components located in a set of Ada units. Each unique record component) show 72 649 moveto (type is uniquely numbered. The display is sorted to expose records that have high degree of commonality among) show 72 661 moveto (component types. These records may be candidates for discrimination.) show 72 698 moveto 11 /Times-Bold SelectFont (2.1.4. Find_Exceptions) show 72 722 moveto 10 /Times-Roman SelectFont (Displays all exceptions, where they are explicitly raised, and where they are explicitly handled.) show EndPage %%Page: 2 2 BeginPage 792 false PositionPage 72 73 moveto 11 /Times-Bold SelectFont (2.1.5. Find_Generics) show 72 97 moveto 10 /Times-Roman SelectFont (Displays all generic program units and their instantiations. The actual parameters to the instantiation are listed to) show 72 109 moveto (expose commonality.) show 72 146 moveto 11 /Times-Bold SelectFont (2.1.6. Find_Objects) show 72 170 moveto 10 /Times-Roman SelectFont (Displays all object declarations, their type, their target size in bytes, whether they are a constant or a variable, and) show 72 182 moveto (how many times they are set and used.) show 72 219 moveto 11 /Times-Bold SelectFont (2.1.7. Find_Pragmas) show 72 243 moveto 10 /Times-Roman SelectFont (Display all pragma used and their parameters within a set of Ada units.) show 72 280 moveto 11 /Times-Bold SelectFont (2.1.8. Find_Tasks) show 72 304 moveto 10 /Times-Roman SelectFont (Displays all tasks, each entry of the task, where each entry is accepted within the task, and where it is called from) show 72 316 moveto (external units.) show 72 353 moveto 11 /Times-Bold SelectFont (2.1.9. Type_Display) show 72 377 moveto 10 /Times-Roman SelectFont (Recursively expands any type declaration to expose all subcomponents. Each entry has the name of the component,) show 72 389 moveto (its ground type, and its size in target bytes.) show 72 426 moveto 11 /Times-Bold SelectFont (2.1.10. Glance) show 72 450 moveto 10 /Times-Roman SelectFont (Provides a filtered display of all selected declarations removing unwanted information such as comments, pragmas,) show 72 462 moveto (etc.) show 72 499 moveto 11 /Times-Bold SelectFont (2.1.11. Call_Tree_Analysis) show 72 523 moveto 10 /Times-Roman SelectFont (Displays an analysis of procedure calls within a main unit. The user may follow up or down the call chain.) show 72 561 moveto 12 /Times-Bold SelectFont (2.2. Performance) show 72 598 moveto 11 /Times-Bold SelectFont (2.2.1. Find_Allocators) show 72 622 moveto 10 /Times-Roman SelectFont (Locates all allocators \050new operators\051, anticipating that the management of dynamic memory is a performance issue.) show 72 659 moveto 11 /Times-Bold SelectFont (2.2.2. Find_Exceptions) show 72 683 moveto 10 /Times-Roman SelectFont (Finds all exception usage anticipating that the use of exceptions for error reporting may positively or negatively) show 72 695 moveto (impact performance. See description in 2.1.4 above for additional detail.) show EndPage %%Page: 3 3 BeginPage 792 false PositionPage 72 73 moveto 11 /Times-Bold SelectFont (2.2.3. Find_Inline_Candidates) show 72 97 moveto 10 /Times-Roman SelectFont (Finds all subprogram that have the following characteristics:) show 72 121 moveto (1.) show 16.500 MX (A small number of statements) show 72 145 moveto (2.) show 16.500 MX (A small number of declarations that require elaboration) show 72 169 moveto (3.) show 16.500 MX (A small number of call sites) show 72 193 moveto (The objective is to locate subprograms that will have low code expansion that may be suitable for inlining. Each of) show 72 205 moveto (the above characteristics is a parameter of the interface.) show 72 242 moveto 11 /Times-Bold SelectFont (2.2.4. Find_Literals) show 72 266 moveto 10 /Times-Roman SelectFont (Locates all literals. Excessive use of string literals may be inefficient.) show 72 303 moveto 11 /Times-Bold SelectFont (2.2.5. Find_Objects) show 72 327 moveto 10 /Times-Roman SelectFont (Locates all objects and sorts them by their size. Large objects may impact performance. See text in 2.1.6 for) show 72 339 moveto (additional detail.) show 72 376 moveto 11 /Times-Bold SelectFont (2.2.6. Find_Overhead_Functions) show 72 400 moveto 10 /Times-Roman SelectFont (Locate functions that simply return a visible global variable or constant.) show 72 437 moveto 11 /Times-Bold SelectFont (2.2.7. Find_Pragmas) show 72 461 moveto 10 /Times-Roman SelectFont (Finds all pragmas anticipating that the use \050of non-use\051 of certain pragmas may impact performance. See 2.1.7 for) show 72 473 moveto (additional detail.) show 72 510 moveto 11 /Times-Bold SelectFont (2.2.8. Find_Tasks) show 72 534 moveto 10 /Times-Roman SelectFont (Tasking may have an impact on performance. See 2.1.8 for additional details.) show 72 571 moveto 11 /Times-Bold SelectFont (2.2.9. Find_Unused_Declarations) show 72 595 moveto 10 /Times-Roman SelectFont (Locate all unused declarations and un-referenced record components. These may be eliminated to reduce code and) show 72 607 moveto (elaboration time.) show 72 644 moveto 11 /Times-Bold SelectFont (2.2.10. Find_Unused_Withs) show 72 668 moveto 10 /Times-Roman SelectFont (Finds all unused with clauses or with clauses that are only used by a rename or use clause. Eliminating these may) show 72 680 moveto (improve overall compile time.) show EndPage %%Page: 4 4 BeginPage 792 false PositionPage 72 73 moveto 11 /Times-Bold SelectFont (2.2.11. Find_Use_Clauses) show 72 97 moveto 10 /Times-Roman SelectFont (Find all use clauses both on and internal to compilation units. Use of use clauses may reduce compilation) show 72 109 moveto (performance.) show 72 147 moveto 12 /Times-Bold SelectFont (2.3. Code Correctness) show 72 184 moveto 11 /Times-Bold SelectFont (2.3.1. Find_Exceptions) show 72 208 moveto 10 /Times-Roman SelectFont (Exceptions are often a potential problem. See 2.1.4 above for additional details.) show 72 245 moveto 11 /Times-Bold SelectFont (2.3.2. Find_Objects) show 72 269 moveto 10 /Times-Roman SelectFont (Lists whether an object is set or used. The lack of sets or usages may indicate a problem. See 2.1.6 for additional) show 72 281 moveto (detail.) show 72 318 moveto 11 /Times-Bold SelectFont (2.3.3. Find_Others_Clauses) show 72 342 moveto 10 /Times-Roman SelectFont (Finds all "others" clauses in case statements, exception handlers, aggregates. Use of these construct may cause) show 72 354 moveto (subtle errors.) show 72 392 moveto 12 /Times-Bold SelectFont (2.4. Style) show 72 429 moveto 11 /Times-Bold SelectFont (2.4.1. Counting Ada Constructs) show 72 453 moveto 10 /Times-Roman SelectFont (Interfances are provided for counting the occurance of specific Ada constructs within an Ada unit. The existance of) show 72 465 moveto (ada constructs may violate or support sytle guidelines. See for additional detail.) show 72 502 moveto 11 /Times-Bold SelectFont (2.4.2. Find_Renames) show 72 526 moveto 10 /Times-Roman SelectFont (Finds all renaming declarations and display the new name introduced by the rename. This can be used to discover) show 72 538 moveto (inconsistencies in the name space introduced by renames.) show 72 575 moveto 11 /Times-Bold SelectFont (2.4.3. Find_Use_Clauses) show 72 599 moveto 10 /Times-Roman SelectFont (Use of use clauses can reduce the readability of code. See 2.2.11 for additional details.) show 72 636 moveto 11 /Times-Bold SelectFont (2.4.4. Find_Visible_Types) show 72 660 moveto 10 /Times-Roman SelectFont (Use of non-private type declarations may reduce the information hiding within a program. This interface finds all) show 72 672 moveto (non-private types declared in the visible part of packages.) show EndPage %%Page: i 5 BeginPage 792 false PositionPage 254.284 72 moveto 14 /Times-Roman SelectFont (Table Of Contents) show 72 108 moveto 12 /Times-Roman SelectFont (1. Overview) show 399.684 MX (1) show 72 122 moveto (2. Analysis Descriptions) show 341.340 MX (1) show 93.600 135 moveto 11 /Times-Roman SelectFont (2.1. General Analysis) show 342.835 MX (1) show 115.200 147 moveto 10 /Times-Roman SelectFont (2.1.1. Counting Ada Constructs) show 290.630 MX (1) show 115.200 159 moveto (2.1.2. Analyze_Types) show 329.540 MX (1) show 115.200 171 moveto (2.1.3. Analyze_Record_Types) show 295.660 MX (1) show 115.200 183 moveto (2.1.4. Find_Exceptions) show 324.520 MX (1) show 115.200 195 moveto (2.1.5. Find_Generics) show 333.420 MX (2) show 115.200 207 moveto (2.1.6. Find_Objects) show 338.410 MX (2) show 115.200 219 moveto (2.1.7. Find_Pragmas) show 334.520 MX (2) show 115.200 231 moveto (2.1.8. Find_Tasks) show 345.630 MX (2) show 115.200 243 moveto (2.1.9. Type_Display) show 335.640 MX (2) show 115.200 255 moveto (2.1.10. Glance) show 358.980 MX (2) show 115.200 267 moveto (2.1.11. Call_Tree_Analysis) show 307.310 MX (2) show 93.600 280 moveto 11 /Times-Roman SelectFont (2.2. Performance) show 362.701 MX (2) show 115.200 292 moveto 10 /Times-Roman SelectFont (2.2.1. Find_Allocators) show 327.300 MX (2) show 115.200 304 moveto (2.2.2. Find_Exceptions) show 324.520 MX (2) show 115.200 316 moveto (2.2.3. Find_Inline_Candidates) show 296.190 MX (3) show 115.200 328 moveto (2.2.4. Find_Literals) show 338.410 MX (3) show 115.200 340 moveto (2.2.5. Find_Objects) show 338.410 MX (3) show 115.200 352 moveto (2.2.6. Find_Overhead_Functions) show 285.640 MX (3) show 115.200 364 moveto (2.2.7. Find_Pragmas) show 334.520 MX (3) show 115.200 376 moveto (2.2.8. Find_Tasks) show 345.630 MX (3) show 115.200 388 moveto (2.2.9. Find_Unused_Declarations) show 282.870 MX (3) show 115.200 400 moveto (2.2.10. Find_Unused_Withs) show 304.520 MX (3) show 115.200 412 moveto (2.2.11. Find_Use_Clauses) show 312.300 MX (4) show 93.600 425 moveto 11 /Times-Roman SelectFont (2.3. Code Correctness) show 340.998 MX (4) show 115.200 437 moveto 10 /Times-Roman SelectFont (2.3.1. Find_Exceptions) show 324.520 MX (4) show 115.200 449 moveto (2.3.2. Find_Objects) show 338.410 MX (4) show 115.200 461 moveto (2.3.3. Find_Others_Clauses) show 306.190 MX (4) show 93.600 474 moveto 11 /Times-Roman SelectFont (2.4. Style) show 396.284 MX (4) show 115.200 486 moveto 10 /Times-Roman SelectFont (2.4.1. Counting Ada Constructs) show 290.630 MX (4) show 115.200 498 moveto (2.4.2. Find_Renames) show 332.300 MX (4) show 115.200 510 moveto (2.4.3. Find_Use_Clauses) show 317.300 MX (4) show 115.200 522 moveto (2.4.4. Find_Visible_Types) show 310.630 MX (4) show EndPage %%Trailer %%Pages: 5 1 %%DocumentFonts: Times-Roman Times-Bold