|
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