From patchwork Wed Jun 30 01:55:28 2010
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: RFA: hook signture patches (1/11): Introduction
Date: Tue, 29 Jun 2010 15:55:28 -0000
From: Joern Rennecke <amylaar@spamcop.net>
X-Patchwork-Id: 57349
Message-Id: <20100629215528.1j64f9w5k4kg4c0w-nzlynne@webmail.spamcop.net>
To: gcc-patches@gcc.gnu.org

As discussed recently on the gcc mailing list, we think we can move
function declarations between GPLed code and GFDLed documentation without
requiring special license grants and/or permission fom the FSF.

If there was a discagreement regarding the type between code and documentation,
I've adjusted the latter.  With regards to names, I generally used the
majority used name in the hook implementation code; for exp / expr,
I used the majority of code in trunk/gcc/*.c in general.

In general, in tm.texi, there is no blank line between the function
declaration and the documentation block; a number of the hooks converted
had an extra blank, line, which I removed for consistency.

Bootstrapped & regression testing on i686-pc-linux-gnu in revision 161563.

2010-06-29  Joern Rennecke  <joern.rennecke@embecosm.com>

	* target.def: Remove comment about licensing problems of function
	declaration.


Index: target.def
===================================================================
--- target.def	(revision 161563)
+++ target.def	(working copy)
@@ -63,8 +63,8 @@ HOOK_VECTOR (TARGET_INITIALIZER, gcc_tar
    the paragraph with @end deftypefn / deftypevr as appropriate, and marking
    the next autogenerated hook with @hook <hookname>.
    In both these cases, leave the DOC string empty, i.e. "".
-   Sometimes, the function declaration itself is only available under the
-   GPL, and/or for some historic reason it has to be documented differently
+   Sometimes, for some historic reason the function declaration 
+   has to be documented differently
    than what it is.  In that case, use DEFHOOK_UNDOC to supress auto-generation
    of documentation.  DEFHOOK_UNDOC takes a DOC string which it ignores, so
    you can put GPLed documentation string there if you have hopes that you