This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: [PATCH] Symbol Separation
- From: Gerald Pfeifer <gerald at pfeifer dot com>
- To: Devang Patel <dpatel at apple dot com>
- Cc: gcc-patches at gcc dot gnu dot org
- Date: Sat, 12 Jul 2003 12:13:06 +0200 (CEST)
- Subject: Re: [PATCH] Symbol Separation
- References: <834B36E5-B3F4-11D7-8F1A-000393A91CAA@apple.com>
On Fri, 11 Jul 2003, Devang Patel wrote:
> 2003-07-11 Devang Patel <dpatel@apple.com>
>
> doc
> * invoke.texi: Document -fsave-repository and -grepository
This is not proper English, but I don't understand the patch well enough
to completely fix it. Perhaps Geoff or Mike could have a look?
Also, this is absolutely not sufficient for users to understand what
this enhancement is all about. That is, the big picture is missing:
Why would one want to use these options?
+ @item -grepository
+ @opindex grepository
+ Instructs compiler to use separate symbol repository with debugging
+ symbols. Compiler search for such repositories in include paths.
+ [...]
+ @item -fsave-repository=@var{location}
+ @opindex fsave-repository
+ Creates separate symbol repository at @var{location} for given input
+ header file. Separate repository contains only debugging symbols.
It seems you need to add "a"s and "the"s, as in "a separate symbol
repository" or "The repository" instead of "Separate repository".
"The compiler will then search for..."
Where/how is the header file given?
Even if the code patch is approved, I would like to have a look at a
revised version of the documentation before it is committed.
Thanks,
Gerald