[Mpi-21] REVIEWERS - Draft Apr. 12, 2008

Sun Apr 13 10:28:44 CDT 2008

Dear reviewer,

if you find a bug, please write also the needed correction 
in your review. 
(If the correction is not obvious, it may be a MPI-2.2 problem).
Your reviews will be collected and have to go directly into the Forum
meeting and must be handled by the Forum.
Therefore, please use the format described below.

Best regards
Rolf

On Sun, 13 Apr 2008 00:05:37 +0200
 "Rolf Rabenseifner" <rabenseifner_at_[hidden]> wrote:
> Dear chapter author, dear reviewer,
> 
> This e-mail is the first preparation of the official reading.
> Please read carefully.
> 
> Again,we have a stable and consistent draft.
> It is SVN revision 108 and pdf and ps are on
>     http://www.hlrs.de/mpi/mpi21/doc/ 
> (username and password are mpi21)
> 
> Nearly all chapters have received an update by the chapters' authors.
> Not finished is - as far as I can see
>  - Point-to-point (may-be without MPI-1/2 problems] (Rich Graham)
>  - Datatypes [it was split from Point-to-point]     (Rich Graham)
> and full MPI-2 based chapters (maybe without need for updates)
>  - Terms (Tony Skjellum)
>  - External Interfaces (Bronis de Supinski)
>  - Profiling (Bronis de Supinski)
> Therefore, review can start in all chapters, except the datatype chapter.
> 
> IMPORTANT for authors:
> If you make further modifications, please be sure that you use
> the macros and that your modification (or at least an delete-anchor) 
> is printed **red**. (Details on using the macros, see below.)
> Please check red color in the resulting mpi-report.pdf before you 
> svn commit your changes.
> As far as I can see, all changes up to now may have no problem 
> for acceptance by the Forum.
> At this late stage, I would recommend to do only changes that do 
> not need intensive debates at the Forum meeting. Such things 
> would be MPI-2.2 modifications.
> 
> IMPORTANT for reviewers:
> - Please check very carefully all red or magenta changes.
>   Modifications are done by  the chapter's author (red) or 
>   by me (magenta).
>   You may be the first reviewer who read and check this text.
> - Please check carefully the cyan text.
>   Those modifications are proposed by a reviewer and have been
>   implemented by my
>   You may be the second reviewer for those modifications.
> - All green stuff should be fine, because it is based on
>   Forum's decisions (Ballot 1-4).
> - Original text is black (MPI-1.3) or blue (MPI-2.0).
> - Please make all comments in the format
> 
> ----------------------------------------------------------------------------------
> 1234567890123456789012345678901234567890123456789012345678901234567890123456789012
>           All references are based on MPI-2.1 Draft Apr. 12, 2008
> ww.a  __  pnnn.ll text   (with nnn=page number and ll=line number
>           text continued
>           ...
> ww.b  __  pnnn.ll text ... and so on (total line length <= 82 characters.)
> ----------------------------------------------------------------------------------
> 
> - Please send only review items that are in the category
>    -- ERROR, must be fixed.
> - If you want to send an item in the categories
>    -- Nice to have,
>    -- Editorial proposal (like move xxx to yyy),
>    -- Clarification which needs Forum decisions,
>    -- ...
>   then please substitute the __ by 22, because then it should be
>   handled in MPI-2.2. 
> 
> This format is used in 
> http://www.hlrs.de/mpi/mpi21/doc/MPI-2.1draft-2008-02-23-review.txt
> where all reviews are filed in.
> (I'll substitute your xx by the next number. If you have more than
> 26 items, then please continue with xx.a -- xx.z, yy.a - ...)
> 
> Please use this format. I'll have only a few minutes between two flights
> to put all reviews together. 
>  
> WORKPLAN:
> - The authors get back the write-token until Thursday, Apr. 17.
>   (If you need also Friday Apr. 18, then please inform me!!)
> - All stuff that is not done until that point, will be defered to MPI-2.2!
> - I'm on travel and may not be able to respond on e-mails this week.
> - On Friday, Apr. 18 (or Saturday, Apr. 19), I will make the
>   final version for all final reviews and for the official reading.
> - Version Apr. 17 together with all your review mails will be the
>   basis for the official reading. 
> - Reviews until Friday, Apr. 25. according the format above.
> - Saturday, Apr. 26:
>   I will put all reviews together to have unique numbers.
>    
> Best regards
> Rolf
>  
> 
> Annex: The rules for authors:
> 
> The goals of your work as chapter author:
> -----------------------------------------
> 
> - Remove references to MPI-1 and MPI-2.
> - Substitute by MPI.
> - Necessary modifications to achieve this goal.
> 
> With this, we should have a single MPI-2.1 standard that does 
> not "know" the MPI-1 or MPI-2 history of individual functions.
> 
> ** This should be mainly a task in the area of chapter-introductions.
> ** Please, never change the wording of function definitions.
> 
> Exceptions: 
> - There are routines that are deprecated and that are
>   already referenced in a consistent way.
>   My recommendation:
>    Current wording: 
>      There are *new* function, and existing are now deprecated.
>    Proposal: 
>      There are functions, and there exist also deprecated functions 
>      with (nearly) same functionality but deprecated due to some lack
>      in the bindings (or functionality)
> - There is history information in the frontmatter.
> - there is a change-log annex with limited memory (only previous version)
> 
> Technical editing rule:
> -----------------------
> 
> You must identify all of your changes:
> 
> a) new/modified wording - you are highlighting your new/modified wording with:
> 
> \mpiiidotiMergeNEWforSINGLEbegin% MPI-2.1 round-two - begin of modification
> .... your modified / new wording ....
> \mpiiidotiMergeNEWforSINGLEendI% MPI-2.1 round-two - end of modification
> 
> b) Moved paragraphs, sentences, ... - you are highlighting the first word
>    of the moved text with:
>     
> \mpiiidotiMergeNEWforSINGLEbegin% MPI-2.1 round-two - begin of text-move
> First-word
> \mpiiidotiMergeNEWforSINGLEendI%  MPI-2.1 round-two - ongoing text-move
> ... rest of the moved text....
> % MPI-2.1 round-two - end of text-move
> 
> c) If you want to delete text (i.e. not only a move to another location),
>    the please us
> 
> \mpiiidotiMergeNEWforSINGLEbegin% MPI-2.1 round-two - deleted-text-anchor
> Last word of the previous text
> \mpiiidotiMergeNEWforSINGLEendI%  MPI-2.1 round-two - end of anchor
> 
> % MPI-2.1 round-two - begin of deteted text - Draft Apr.1, 2008 page/line-page/line
> % the text you delete must be preceded with "% "
> % deprecated text
> % ...
> % deprecated text
> % MPI-2.1 round-two - end of deteted text
> 
>    Additionally, you must add this outcommented text to the end of
>    removed_source.tex 
> 
> Caution: These macros work only in black parts of the text.
> 
> In blue parts you must substitute 
>   \mpiiidotiMergeNEWforSINGLEendI%
> by
>   \mpiiidotiMergeNEWforSINGLEendII%
> 
> 
> The highlighting is done with red color.
> (There are only a few other sentences from me magenta.
>  Therefore red should be the best to highlight the round-two modifications.)
> 
> -----------------------------------------------------
> Using svn:
> Before you start to make changes:
>  
>   cd ....your_directory..../trunk/MPI-2.1/
>   svn update
> 
> to get the newest sources.
> 
> After you made changes, please call make and check mpi-report.pdf
> to guarantee that all your changes are really highlighted with *red* color.
> 
> When you make the first svn commit after you received a new username with
> write-permission, you must use the aditional option
> 
>   --username your_new_user_name
> 
> Please commit with 
> 
> svn commit chap-xxxx/xxxx.tex -m 'MPI-2.1 - your name - what you have done'
> 
> Please commit as soon as you finished the changes and after you have
> checked the red color.
> 
> --------------------------------------------------
> 
> Dr. Rolf Rabenseifner . . . . . . . . . .. email rabenseifner_at_[hidden]
> High Performance Computing Center (HLRS) . phone ++49(0)711/685-65530
> University of Stuttgart . . . . . . . . .. fax ++49(0)711 / 685-65832
> Head of Dpmt Parallel Computing . . . www.hlrs.de/people/rabenseifner
> Nobelstr. 19, D-70550 Stuttgart, Germany . (Office: Allmandring 30)
> _______________________________________________
> mpi-21 mailing list
> mpi-21_at_[hidden]
> http://lists.mpi-forum.org/mailman/listinfo.cgi/mpi-21

Dr. Rolf Rabenseifner . . . . . . . . . .. email rabenseifner_at_[hidden]
High Performance Computing Center (HLRS) . phone ++49(0)711/685-65530
University of Stuttgart . . . . . . . . .. fax ++49(0)711 / 685-65832
Head of Dpmt Parallel Computing . . . www.hlrs.de/people/rabenseifner
Nobelstr. 19, D-70550 Stuttgart, Germany . (Office: Allmandring 30)