From: Lowell Gilbert on
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
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
% [...]