[PATCH] Hookize ASM_OUTPUT_SOURCE_FILENAME

[Joseph S. Myers]

On Fri, 16 Jul 2010, Richard Henderson wrote:

> On 07/16/2010 01:59 PM, Anatoly Sokolov wrote:
> > Index: gcc/doc/tm.texi.in
> > ===================================================================
> > --- gcc/doc/tm.texi.in  (revision 162265)
> > +++ gcc/doc/tm.texi.in  (working copy)
> > @@ -7287,6 +7287,15 @@
> >  for the file format in use is appropriate.
> >  @end defmac
> >  
> > +@hook TARGET_ASM_OUTPUT_SOURCE_FILENAME
> > +Output COFF information or DWARF debugging information which indicates
> > +that filename @var{name} is the current source file to the stdio
> > +stream @var{file}.
> > +
> > +This target hook need not be defined if the standard form of output
> > +for the file format in use is appropriate.
> > +@end deftypefn
> 
> This text goes ....

> > +DEFHOOK
> > +(output_source_filename,
> > + "",
> 
> ... here.

This only applies for new hook documentation text written from scratch, 
not text based on existing target macro documentation.  For text based on 
old target macro documentation (under the GFDL), FSF approval is needed 
for licensing it under the GPL.  RMS can be quite efficient about 
approving relicensing for existing text, so I encourage producing such 
patches and seeking the relicensing, but they do need to go by RMS.  (The 
same applies to all the existing hooks with documentation not in 
target.def: I encourage producing concrete patches for RMS's attention 
showing the specific text that should be relicensed.)

-- 
Joseph S. Myers
joseph@codesourcery.com