Broken link to articles/problem-reports/pr-writing.html in porters-handbook
Johann Kois
jkois at FreeBSD.org
Thu Aug 18 06:51:06 UTC 2011
On 08/17/2011 18:46, Jason Helfman wrote:
> On Wed, Aug 17, 2011 at 07:54:25AM -0500, Mark Linimon thus spake:
>> On Wed, Aug 17, 2011 at 11:50:11AM +0200, Johann Kois wrote:
>>> For example if you build the local handbook you will get no
>>> book.html. If you build a local article you will get only
>>> article.html, but no "split-html".
>>
>> I usually test by e.g. 'make book.html' instead of just 'make'. I find
>> it easier to search for things on the single output. Either way works.
>>
>> mcl
>
> I build the entire site @work, and get both split and one page (book), and
> haven't had any issues yet with it.
Well, the "problem" is you should not get both versions. ;-)
For example:
* Makefile for the fdp-primer:
FORMATS?= html html-split (so you get both formats, both locally and on
FreeBSD.org)
* Makefile for the handbook:
FORMATS?= html-split (so no book.html when built locally, although it
is there on www.FreeBSD.org).
* Makefile for all the articles:
FORMATS?= html (so only article.html when built locally, but also
"html-split files" when built on FreeBSD.org).
This happens when you build the documentation from within the doc tree
(so for example started from a checked out doc/en_US.ISO8859-1 dir). So
something is done differently when you create a full copy of FreeBSD
www/doc. At least that is how it looks to me.
jkois
--
Johann Kois
jkois(at)FreeBSD.org
FreeBSD Documentation Project
FreeBSD German Documentation Project - https://doc.bsdgroup.de
More information about the freebsd-doc
mailing list