This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: [PATCH, Fortran] documentation for FTELL, GETLOG, HOSTNM instrinsics
- From: Steve Kargl <sgk at troutmask dot apl dot washington dot edu>
- To: Brooks Moses <bmoses at stanford dot edu>
- Cc: fortran at gcc dot gnu dot org, gcc-patches at gcc dot gnu dot org
- Date: Mon, 23 Oct 2006 14:04:01 -0700
- Subject: Re: [PATCH, Fortran] documentation for FTELL, GETLOG, HOSTNM instrinsics
- References: <453895B9.8040308@stanford.edu>
On Fri, Oct 20, 2006 at 02:24:09AM -0700, Brooks Moses wrote:
>
> In general, are example programs like the ones I included here actually
> considered useful? In these cases, I'm not sure they actually add
> anything to what's already covered in the Syntax section, but it was
> trivial to cut-and-paste in the test programs I was using to make sure I
> was documenting the actual behavior.
>
When I first started to document the intrinsic procedures,
I included example programs because I was documenting
one of the more difficult to grasp intrinsics (ISTR it
was ASSOCIATED). Whether the programs are useful is
probably a debatable question. I do however think that
these examples allow us to encourage Good Programming
Practices.
--
Steve