Summary: | inconsistent documentation build description, bugs in .XML: can not build docs | ||
---|---|---|---|
Product: | Documentation | Reporter: | O. Hartmann <ohartmann> |
Component: | Books & Articles | Assignee: | freebsd-doc (Nobody) <doc> |
Status: | Closed Overcome By Events | ||
Severity: | Affects Some People | CC: | bjk, carlavilla |
Priority: | --- | ||
Version: | Latest | ||
Hardware: | Any | ||
OS: | Any |
Description
O. Hartmann
2018-12-18 09:12:48 UTC
The automated documentation build has not been running into an issue of this nature recently (though we did get some mail about failures that might be due to hardware issues or a full disk or similar, in the past couple days). It is unfortunately the case that the documentation build is both susceptible to stray artifacts in the build tree (which is also the source tree, at least by default), and does not offer a reliable clean target. But given the lack of other reports, my current best hypothesis is that there's a stray file in your local environment that is responsible for these issues. It may be simplest to try to checkout a fresh tree and building that, at least before trying to track down exactly what stray file would be responsible for the build issues. Please be more specific in the terminus "... susceptible to stray artifacts in the build tree ...". Does this include the ports installation pathas as well or do you refer only to /usr/doc? First thing I did, a long time ago and just now, delete the whole /usr/doc folder and check it out again; then check via "svn status" whether there is something strange. It is all clean. The only ones I remember running into involve files in /usr/doc . It might be helpful to post (whether here or on a pastebin-alike) a bit more of the end of your build log. My local build was successful, though it used a somewhat different invocation than yours. (I can't build html-split, for one, since I don't currently have fop installed.) But the builds that I can do, finish successfully. Since we moved to Hugo/AsciiDoc we can close this. Please try with the new documentation system. To get more information please check https://docs.freebsd.org/en/books/fdp-primer/overview/ |