> The doc source is available at https://github.com/kicad/kicad-doc > > It takes quite some time to build with asciidoc, so you might want to > fetch the precompiled docs from http://docs.kicad-pcb.org/
Thanks, Nick. I'm not strongly familiar with the DFSG rules concerning documentation, but I would assume that the main concern is that documentation needs to be available in "source" form. Building the documentation from its sources upon packaging would guarantee that, and it's a do-once process so time is not a concern. More importantly, how do all these sub-packages tie into the build process? I assume that the main kicad CMakeFiles will only build kicad itself, and not pick up additional subdirectories like kicad-i18n, kicad-doc, kicad-library or library-repos. The current Debian packaging scripts will simply copy the appropriate files out of doc/ and library/ to form the various packages. This process will need to be changed if sub-repositories like the documentation require their own build process. Alternatively, the documentation could be moved out-of-tree and built with the help of separate dpkg scripts. The important parts that form the kicad and kicad-common packages are in kicad, kicad-i18n, kicad-library and the *.pretty repositories if I'm not mistaken. On another note, Nick, I think the _*.kiface plugins should be moved to <prefix>/lib/kicad/kiface or something. <prefix>/bin is not an appropriate place for them, as they are not executables. Should I file a bug on Launchpad for that?