This is the mail archive of the fortran@gcc.gnu.org mailing list for the GNU Fortran project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [fortran, docs] Add embryonic gfc-internals.texi manual.


Tobias Schlüter wrote:

Brooks Moses wrote:

------------------------------------------------------------------------
Because this is intended largely as a shared collection of notes for
GFortran developers, the approval process is informal compared to the
rest of GCC.  Anyone with write access to the repository is authorized
to add text to this manual, or to make minor changes or deletions,
without waiting for approval.  (Substantial deletions or rewrites should
go through the usual approval process for non-maintainers.)  All changes
that are committed under this rule should be tested with @command{make
info} and either @command{make dvi} or @command{make pdf}, and should
follow the formatting conventions of the rest of the manual.
------------------------------------------------------------------------

How about putting this into the wiki? I don't think it makes much sense to distribute this documentation to the user, nor does it make much sense to have different versions for different future versions / branches. Also the entry barrier with .texi is higher (well, IMO).

Why not considering it an equivalent for GNU Fortran as gcc/doc/gccint.texi is for GCC ? And as a corollary - why not use the standard approval rules for it ?


One thing I hope this text will enable is users looking at it and pondering: "I wonder if they really get this (my code) right."

Note that the .texi files get distributed - the Wiki is just for us.

Cheers,

--
Toon Moene - e-mail: toon@moene.indiv.nluug.nl - phone: +31 346 214290
Saturnushof 14, 3738 XG Maartensdijk, The Netherlands
At home: http://moene.indiv.nluug.nl/~toon/
Who's working on GNU Fortran: http://gcc.gnu.org/ml/gcc/2007-01/msg00059.html



Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]