Bug 213

Summary: libuser missing the html/txt doc files
Product: [Build System, Metadata & Runtime] Meta-yocto Reporter: Edwin Zhai <edwin.zhai>
Component: meta-yoctoAssignee: Scott Garman <scott.a.garman>
Status: RESOLVED FIXED QA Contact:
Severity: enhancement    
Priority: Low CC: jessica.zhang, julie.n.fleischer, kevin.tian, poky.bs.watcher, poky.watcher, richard.purdie, sgw
Version: 0.9   
Target Milestone: 1.0 M4   
Hardware: x86   
OS: Multiple   
Whiteboard:
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: ---

Description Edwin Zhai 2010-08-16 22:29:42 UTC
The libuser package (meta-lsb/packages/libuser/libuser_0.56.16.bb), will translate *.sgml to *.[html|txt] by sgml2html, which belongs to linuxdoc-tools. Linuxdoc-tools in turn depends on many other packages: openjade, opensp, perl, gawk, groff, texinfo...

It's not good to add so many native packages just for getting a help file, given that we already has other help files like man.

So a patch is added to bypass this translation, as follows:
Index: libuser-0.56.16/docs/Makefile.am
===================================================================
--- libuser-0.56.16.orig/docs/Makefile.am      2010-08-12 13:29:43.000000000 +0800
+++ libuser-0.56.16/docs/Makefile.am   2010-08-12 13:29:51.000000000 +0800
@@ -14,8 +14,8 @@

 sgml/libuser.txt: $(srcdir)/sgml/libuser.sgml
       [ -d sgml ] || mkdir sgml
-      cd sgml; sgml2txt ../$(srcdir)/sgml/libuser.sgml
+#     cd sgml; sgml2txt ../$(srcdir)/sgml/libuser.sgml

 sgml/libuser.html: $(srcdir)/sgml/libuser.sgml
       [ -d sgml ] || mkdir sgml
-      cd sgml; sgml2html ../$(srcdir)/sgml/libuser.sgml
+#     cd sgml; sgml2html ../$(srcdir)/sgml/libuser.sgml

In future, we can revisit this issue and add linuxdoc-tools.