Doc: CG: clarify convert-ly usage policy.

Doc: CG: clarify convert-ly usage policy.

[Graham Percival (old account), 2010-10-25 08:18:48]

Policy highlights:
- convert-ly will be the responsibility of the programmer, not the
doc+translation people.  (however, translators are still on the hook for the
current round of updates, as per issue 1358)
- easy copy&paste lines to run convert-ly

[Carl, 2010-10-25 12:45:38]

LGTM.

I'll make a script and put it in my ~/bin that will do the convert-ly.  Do we
want to put it in scripts/auxiliar?

Carl

[Graham Percival (old account), 2010-10-25 13:04:03]

On 2010/10/25 12:45:38, Carl wrote:
> I'll make a script and put it in my ~/bin that will do the convert-ly.  Do we
> want to put it in scripts/auxiliar?

Hmm.  Initially I was just expecting people to copy&paste the relevant
commands... but a shell script is even easier (and more reliable!).  The only
"iffy" bit is the build directory for out-of-build trees, but I can deal with
that.

ok, ignore this patch; I'll make an improved one tomorrow.

[Graham Percival (old account), 2010-10-26 07:11:38]

On 2010/10/25 13:04:03, Graham Percival wrote:
> ok, ignore this patch; I'll make an improved one tomorrow.

New patch uploaded; it's much easier, and the doc section is much smaller.

[Trevor Daniels, 2010-10-26 08:01:58]

Looks OK to me (i.e. it's clear enough for me to understand)

Trevor

[Carl, 2010-10-26 17:19:51]

L Great TM.

I would have done a much lower-quality script.

Thanks, Graham!

Carl

[Graham Percival (old account), 2010-10-28 03:13:19]

On 2010/10/26 17:19:51, Carl wrote:
> L Great TM.

this has now been pushed.