[Bug 222322] parallel doc build

bugzilla-noreply at freebsd.org bugzilla-noreply at freebsd.org
Thu Sep 14 09:52:21 UTC 2017


https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=222322

            Bug ID: 222322
           Summary: parallel doc build
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Documentation
          Assignee: freebsd-doc at FreeBSD.org
          Reporter: wosch at FreeBSD.org

Created attachment 186370
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=186370&action=edit
patch

Hi,

the build in ./doc runs for 20-25minutes. Speeding it up with `make -j`' has no
effect. It would be great if we can build the documentation faster.


Looking at the makefiles in doc/share/mk this doesn't seems to be an easy task.

Also, most sub-directories contains only a single input file which means `make
-j' has no effect on a directory level. The workaround could be to run `make
-j' for the sub-directories in a given directory.

Attached is a simple workaround to run the sub-directories in parallel. It
works for the standard target ("all") only. I could run a build in 4 minutes
now (down from 20 minutes). I do not recommend this for production, but for
test & developing it makes a huge difference.


$ make p-all

-- 
You are receiving this mail because:
You are the assignee for the bug.


More information about the freebsd-doc mailing list