Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 335600

Summary: Photran Developer's Guide - Changes to make
Product: [Tools] PTP Reporter: Jeffrey Overbey <com-eclipse-dot-org>
Component: Photran.DocumentationAssignee: Photran Inbox <photran-inbox>
Status: NEW --- QA Contact:
Severity: normal    
Priority: P4 CC: marianomendez
Version: 6.0   
Target Milestone: ---   
Hardware: All   
OS: All   
Whiteboard:

Description Jeffrey Overbey CLA 2011-01-27 13:37:09 EST
1. Several missing references, e.g., Part I, Chapter 2: "see Chapter ??" (page 6), "more detail in Chapter ??" (page 8); Appendix C: "in Appendix ??" (page 12)

2. Part I, Section 2.5: Discussion under org.eclipse.photran.core.vpg.tests is out of date: TESTING no longer required.  Refer reader to the appendix for details.

3. Part I, Section 2.8: Remove "and a spreadsheet mapping..."

4. In Part II, explain: Refactorings cannot fail in #doCreateChange, so if they need to be able to (i.e., throw a PreconditionFailure), they can do the transformation in #doCheckFinal instead

=====
Also, notes on Fortran tutorial slides:

- "Subroutines: 2/2" -- "however, () must be there" is not true for subroutines

- "Arrays as Arguments: 3/4" -- According to Abhishek, assume-shape arrays can only be passed to subprograms in modules

- "The ALLOCATE Statement: 3/3"

    * "In general, an array allocated in a subprogram is a local entity, and is automatically deallocated when the subprogram returns" -- Not true; must be local to the subprogram (p. 103).  Consider allocation in a derived type.
Comment 1 Jeffrey Overbey CLA 2011-01-27 13:37:50 EST
5. Describe UI annotations
Comment 2 Jeffrey Overbey CLA 2011-05-25 12:46:39 EDT
6. The CVS instructions need to be updated for Photran 7.  Notable, an API baseline has to be set for CDT to compile without errors.