This is the mail archive of the gcc@gcc.gnu.org mailing list for the GCC 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: [RFC] Cleaning up the pass manager


Quoting Basile Starynkevitch <basile@starynkevitch.net>:

I believe that a structured comment could help. When - in many
years :-( - the powerful people (Steering Committee, FSF, RMS, ...)
would accept the idea of generating documentation from code [and
implement the legalese allowing it thru appropriate exceptions, or legal
notices, or licenses], we could even imagine have an automatically
generated chapter documenting the passes. We could also imagine a
Graphviz *.dot file describing the graph of all passes.

If you add the autogenerating feature first, before the source input of the document autogenerator, each contributor can provide the diffs of the autogenerated documentation long with a GFDL license when (s)he submits a patch.

While that is not as nice as being able to have source-only patches and
let anyone generate the documentation, it is something that we can do
now, and at the same time we can show more specifically how a licensing
change would benefit Free Software documentation, and is indeed necessary
to have truly Free software and documentation.
I really would like to see a new version of the GPL so that what RMS / the
FSF currently deems necessary to put in GFDL invariant sections can be put
in author's notices under extended version of the current GPL 7b provision,
so that we can have our code and documentation under single license.


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