Prev: NYC LOCAL: Tuesday 2 February 2010 NYLUG Hack Workshop: Robert Menes on Smalltalk
Next: Hardwaresuggestions for ZFS Fileserver
From: Lowell Gilbert on 4 Feb 2010 10:49 Lowell Gilbert <lgusenet(a)be-well.ilk.org> writes: > Tim Daneliuk <tundra(a)tundraware.com> writes: >> - Do I have to issue an explicit 'make install' to get the stuff I built >> in /usr/doc to /usr/share/doc? > > Yes. > >> - Does a buildworld invoke this documentation build process automatically? >> (I'm guessing not). > > Correct. A number of ports are required to build the doc tree, so it > can't be built on a bare system like a buildworld has to be capable of. I forgot to mention that it's easier to download the docs from the FTP servers instead of pulling down the sources. I don't actually recommend building them yourself unless you're going to either make changes or want to produce some unsupported format. -- Lowell Gilbert, embedded/networking software engineer http://be-well.ilk.org/~lowell/
From: Giorgos Keramidas on 5 Feb 2010 03:06
On Thu, 04 Feb 2010 08:43:40 -0600, Tim Daneliuk <tundra(a)tundraware.com> wrote: >On 2/3/2010 6:41 PM, Giorgos Keramidas wrote about the build of the doc/ tree: >> >> $ cd /home/keramida/work/freebsd/doc >> $ make FORMATS="html html-split" >> $ sudo make FORMATS='html html-split' DOCDIR='/usr/doc' install > > Thanks Giorgos, that's most helpful. The one thing I've not been able > to determine (and I admit spending only an hour or so on this so far) > is if I just do "make install" without the FORMATS variable defined, > what actually gets produced? You are welcome Tim. The install target will only install the 'default output format', which is 'html' for most of the articles and 'html-split' for the books. Some are even built as *both* output formats by default (e.g. the dev-model book; see below). You can see what the default output format is for each document by grepping for 'FORMATS[[:space:]]*?=' in the 'Makefile' files: % keramida(a)kobe:/ws/bsd/doc$ find . -name Makefile \ % -exec grep 'FORMATS[[:space:]]*?=' {} + | more % ./en_US.ISO8859-1/books/bibliography/Makefile:FORMATS?= html % ./en_US.ISO8859-1/books/handbook/Makefile:FORMATS?= html-split % ./en_US.ISO8859-1/books/dev-model/Makefile:FORMATS?= html-split html % [...] |