Re: A GNU Binutils wiki

[Joel Brobecker <brobecker@adacore.com>]

> > Sorry to be negative. I like the "control" in source code control
> > and a wiki is lacking there.
> 
> That's fine.  It is good to have an opinion and I am glad that you
> are willing to express it.  My counter would be - what can we do instead ?
> 
> I know that most of the information intended for the wiki can be found
> by digging through the sources, but that will not work for people who
> are not already deeply familiar with the binutils.  So I wanted to create
> a place where people with at least some experience with other part(s) of
> the GNU toolchain would expect to be able to find information on the
> binutils.
> 
> Plus I wanted to provide a location for binutils users and contributor to
> be able to provide their own content.  Descriptions of the problems that
> they encountered whilst porting the binutils; advice for users of small
> devices that need custom linker scripts in order to work properly and so
> on.
> 
> Plus a location with responses to frequently asked questions(tm) which we
> can use when answering those I-have-found-a-name-mangling-bug and
> why-doesn't-the-assembler-auto-correct-my-bugs type questions on the
> mailing list.

To have perfect documentation, we'd need someone willing to act as
its curator, and that's a big job, no matter what technology you use.

FWIW I do feel that the wiki has been a positive addition for GDB.
While it hasn't been perfect, it has has lowered the barrier for
contributing changes to this part of the project's documentation.
We have had contributions from users who normally do not contribute
to the GDB project itself as well.

-- 
Joel