Bug 34528 - Document internal structure of arrays
Summary: Document internal structure of arrays
Status: NEW
Alias: None
Product: gcc
Classification: Unclassified
Component: fortran (show other bugs)
Version: 4.3.0
: P3 enhancement
Target Milestone: ---
Assignee: Not yet assigned to anyone
URL:
Keywords: documentation
Depends on: 37577
Blocks:
  Show dependency treegraph
 
Reported: 2007-12-19 00:19 UTC by Tobias Burnus
Modified: 2020-11-30 00:01 UTC (History)
3 users (show)

See Also:
Host:
Target:
Build:
Known to work:
Known to fail:
Last reconfirmed: 2007-12-19 18:52:07


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Tobias Burnus 2007-12-19 00:19:56 UTC
http://groups.google.com/group/comp.lang.fortran/browse_thread/thread/80093a381db184c6/

This interface is needed if one wants pass an array descriptor to C; other vendors have such a documentation as well. It should come with a note that the interface may change between versions.

Other compilers have this as well, e.g,
http://www.intel.com/software/products/compilers/docs/flin/main_for/mergedProjects/bldaps_for/common/bldaps_hndl_arrdesc.htm

If not for the gfortran documentation, one could add it to gfortran-internal.
Comment 1 Francois-Xavier Coudert 2008-01-29 10:26:35 UTC
PR34742 is also related to documentation of our ABI/calling conventions (whatever the correct term is). I agree we should document them, as well as some other gfortran-specific non-portable stuff like "how do kinds related to integer and floating-point types", and maybe a section expanding on the -ff2c conventions. I think all this would go into a new top-level section of the documentation.
Comment 2 Jürgen Reuter 2019-01-20 23:29:17 UTC
Is this still the same interface nowadays then it was back then? And is a possible new one now maybe documented?
Comment 3 Eric Gallager 2019-07-22 05:20:30 UTC
(In reply to Tobias Burnus from comment #0)
> http://groups.google.com/group/comp.lang.fortran/browse_thread/thread/
> 80093a381db184c6/
> 
> This interface is needed if one wants pass an array descriptor to C; other
> vendors have such a documentation as well. It should come with a note that
> the interface may change between versions.
> 
> Other compilers have this as well, e.g,
> http://www.intel.com/software/products/compilers/docs/flin/main_for/
> mergedProjects/bldaps_for/common/bldaps_hndl_arrdesc.htm

Link is dead; here is an archive dot org saved copy of it: 
http://web.archive.org/web/20100129054945/http://www.intel.com/software/products/compilers/docs/flin/main_for/mergedProjects/bldaps_for/common/bldaps_hndl_arrdesc.htm

> 
> If not for the gfortran documentation, one could add it to gfortran-internal.