This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: [patch 2/3] tm.texi documentation on macro PREFERRED_RENAME_CLASS
On Wed, 27 Oct 2010, Yao Qi wrote:
> On Thu, 2010-10-21 at 22:04 +0000, Joseph S. Myers wrote:
> > tm.texi is a generated file. You need to patch tm.texi.in and regenerate
> > tm.texi.
> >
> > In general new target macros should be avoided in favour of hooks (whose
> > documentation source should be in target.def with a minimal @hook
> > reference in tm.texi.in) unless one of the following applies:
>
> Joseph,
> It is patch 2 here, which adds target hook, doc and uses target hook.
> This patch (patch 2) is dependent on patch 1
> (http://gcc.gnu.org/ml/gcc-patches/2010-10/msg02197.html)
Please see what I said about putting the documentation in target.def.
tm.texi.in should *only* have the @hook line and not the rest of the
documentation. Using "" for documentation in DEFHOOK in target.def is a
deprecated transitional measure for cases where documentation uses
pre-existing GFDL-only text, unless and until the FSF works out viable
arrangements for us to be able to move and copy text bidirectionally
between code and manuals in whatever ways make technical sense.
--
Joseph S. Myers
joseph@codesourcery.com