-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
On 09/26/12 23:19, Stefan Roese wrote:
[snip]
BTW: I've done quite some Linux kernel work and never used this kernel-doc style so far. Its not mandatory in the Linux kernel. Not that this really matters in regards to U-Boot. But my personal feeling is, that we shouldn't make it much harder to push patches in U-Boot than in Linux.
Exactly. This gets at the point I was trying to make. It's not "make these comments, magically get documentation". It's "make these comments, write the rest of your documentation in the right XML markup, get {pdf,html,man,etc,etc,etc} output". So the DM work is a good reason / candidate to add the infrastructure (sine we already have design docs). And someone could take the kernel mtdnand template, update it with verbage about how we shim that in and also get good docs. Other subsystems or "big" things could also make use of this.
- -- Tom