there's generally no reason people should be generating locales by hand with localedef. they should list things in locale.gen and let `locale-gen` take care of creating things. and while `locale-gen` can be used in oneshot mode to generate a specific locale from the command line, this is still not something we should be showing to people as an intro. all in all, i say we just punt this sub section
It's in guide-localization.xml; the handbooks are okay. g-l.xml does indeed use the deprecated localedef command instead of locale-gen, so it needs updating.
Thanks for reporting; fixed in CVS.