[Grok-dev] the grok reference

Uli Fouquet uli at gnufix.de
Wed Aug 29 09:36:23 EDT 2007


Hi there,

Am Mittwoch, den 29.08.2007, 13:44 +0200 schrieb Martijn Faassen:

> A recent discussion made again the point that we should have a Grok 
> reference.
> 
> I don't think such a reference should be auto-generated. The reference 
> should be carefully written, though auto-generation might in some cases 
> help create a skeleton.

After doing some work with the reference, I agree. There are too many
special things, a generator can not include.

> I know both Uli and Jan-Wijbrand worked on a reference in the past, but 
> the effort seems to be stuck.

Sorry, the last three weeks I was completely busy with nasty, self-made
admin-UI bugs. Just checked in some more directive-descriptions. So,
this chicken is not dead ;-)

> Any ideas how to un-stick it?

Well, you just did it.

As Baiju mentioned the the LaTeX-or-reST-problem: I would be glad to try
to port the reference to reST (already suggested that some time ago).
This would be done in a separate branch until it works as we like. Any
objections?

Kind regards,

-- 
Uli





More information about the Grok-dev mailing list