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