[fortran,doc,committed] New "unimplemented extensions" section

[FX Coudert <fxcoudert at gmail dot com>]

With branching approaching, it's documentation time! I've committed  
the attached patch with the following ChangeLog after a successful  
"make info pdf html". The main thing it does is to divide the  
"Extensions" chapter into two sections, one for implemented  
extensions (doc for them was already there) and one for extensions  
that aren't in gfortran, with advice on how to migrate them to  
standard or GNU Fortran code and examples. I've written doc for  
STRUCTURE/RECORD, and pasted g77 doc for ENCODE/DECODE.

Here is one comments and a question:

  -- I've removed the "smaller projects" list, because its content  
was non up-to-date (init exprs, emacs-parsable error messages),  
unclear (correct rounding?) or simply not small projects (implement  
F). I feel that this is something the wiki is good for, because it  
can change fast, and we don't especially want it in our doc.

  -- I feel that we should remove the list of "Proposed extensions"  
too. Some of them are already implemented if I read them correctly  
("Compile flag to generate code for array conformance checking",  
isn't that -fbounds-check? "Flag to force local variables onto  
stack", don't we have that already? "). Others are... well, there  
just isn't a consensus as to whether they're desirable (like all  
environment variables... I think the current consensus is that we  
should try to avoid this as much as possible). I haven't removed that  
list yet, because I wanted to hear other's opinion about it... so,  
please step in!

Thanks,
FX

--
François-Xavier Coudert
http://www.homepages.ucl.ac.uk/~uccafco/



> 2008-02-16  Francois-Xavier Coudert  <fxcoudert@gcc.gnu.org>
>
>         * gfortran.texi: Create new section for unimplemented  
> extensions.
>         Add "STRUCTURE and RECORD" and "ENCODE and DECODE statements".
>         Remove "smaller projects" list. Fix a few typos.

Attachment: doc2.diff
Description: Binary data