Re: PATCH wwwdocs: mention Sun make problems, offer egcstensionspatch

[Gerald Pfeifer <pfeifer at dbai dot tuwien dot ac dot at>]

On Mon, 30 Aug 1999, Hans-Peter Nilsson wrote:
>> (I rewrote your patch to improve markup, and because, for example, I don't
>> think we want to recommend srcdir == objdir in our documentation, as this
>> is unsupported, as far as I understand.)
> The level of unsupport is not really well-defined here.

You are right. I was following our install docs and what I had read on
the lists, but perhaps someone can shed light on this?

>>> compliant, for a <i>srcdir</i> != <i>objdir</i> setup.</p>
> Not really happy with those changes.  I actually prefer the
> original text (no surprise), perhaps recommending GNU make
> before srcdir == objdir and with improved markup of course.

Better now?

> Saying "srcdir == objdir" is "GCC tech speak", perhaps not
> "installer tech speak".

Well, it's the "speak" introduced and used in the installation
documentation, so I'd say those interested in the patch should
be aware of it.

> I would also prefer another wording and/or placement than "Contact:"
> as the first line, as it is not necessary to contact me for getting
> and applying the patch, which I think could be read into that.

Okay. Moved at the end.

> I believe putting the URL in clear text at the link text (not only as
> the href) is the way you have recommended at other places.

Yes, I suggested that a couple of times. I have now changed that in yet
another way so that the page becomes more consistent. I have not fully
convinced myself, though, that this is indeed better.

> All in all these are just nits, but you said nits were ok. ;-)

Indeed. ;-)

I installed the patch found below.

Gerald

> I cannot reach install/specific.html at the moment, so I'll check that
> later.

I haven't committed that yet, as I want to get some feedback concerning
the srcdir/objdir issue first...



Index: egcstensions.html
===================================================================
RCS file: /egcs/carton/cvsfiles/wwwdocs/htdocs/egcstensions.html,v
retrieving revision 1.8
diff -r1.8 egcstensions.html
26,27c26,27
< <h2><a name="sun-make">Patch to build elsewhere than in the source
< directory using Sun make</a></h2>
---
> <h2><a name="sun-make"><a href="ftp://ftp.axis.se/pub/users/hp/gcc/gcc-2.95.1-sun-make-patch1.txt">Patch
> to build elsewhere than in the source directory using Sun make</a></h2>
29,33c29,31
< <p>Contact: <a href="mailto:hp@axis.se">hp@axis.se</a></p>
< 
< <p>By means of a <a href="ftp://ftp.axis.se/pub/users/hp/gcc/gcc-2.95.1-sun-make-patch1.txt">patch for GCC 2.95.1</a> Sun make should be able to bootstrap
< the compiler even when using Sun make, which is not sufficiently standards
< compliant, for a <i>srcdir</i> != <i>objdir</i> setup.</p>
---
> <p>If, for some reason, you cannot use GNU make nor build in the
> <i>srcdir</i>, this patch for GCC 2.95.1 will allow you to build GCC
> using Sun make in a <i>srcdir</i> != <i>objdir</i> setup.</p>
41a40,41
> 
> <p>Contact: <a href="mailto:hp@axis.se">hp@axis.se</a></p>