Re: [gnugo-devel] doc patch

[Arend Bayer]

Dan wrote:

> Arend wrote:
>
> > - I still think we should kill the lists of functions, that only
> >   reproduce the comments from the source code. Or is anyone using them
> >   now?
>
> Gunnar wrote:
>
> > Agreed. For my part I have never used them and I find them annoying
> > since they make the docs so much longer and they are a pain to update.
>
> Arend wrote:
>
> > arend_3_23.7. I haven't killed all of them, though. Not sure what to do
> > with the "Utility Functions" chapter. (I killed all the trivial
> > functions from the printutils section.)
>
> I updated the Utility Functions section of utils.texi.
>
> I think there are still functions such as approxlib and its
> allies, chainlinks and anything called from the autohelper
> macros which definitely need to be described in the
> documentation. I can work on this.

Maybe everything that can be invoked from pattern constraints would be
a useful candidate for documenting (i.e. oplay_connetc(),...), as these
are often unavailable via ctags/probably also emacs tags?

I.e., the list in mkpat.c of autohelpers.

Arend