Bug 335600 - Photran Developer's Guide - Changes to make
Summary: Photran Developer's Guide - Changes to make
Status: NEW
Alias: None
Product: PTP
Classification: Tools
Component: Photran.Documentation (show other bugs)
Version: 6.0   Edit
Hardware: All All
: P4 normal (vote)
Target Milestone: ---   Edit
Assignee: Photran Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-01-27 13:37 EST by Jeffrey Overbey CLA
Modified: 2011-05-25 12:46 EDT (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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.