From owner-p4-projects@FreeBSD.ORG Thu Apr 30 10:22:41 2009 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id A64391065670; Thu, 30 Apr 2009 10:22:41 +0000 (UTC) Delivered-To: perforce@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 65EBE106566B for ; Thu, 30 Apr 2009 10:22:41 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from repoman.freebsd.org (repoman.freebsd.org [IPv6:2001:4f8:fff6::29]) by mx1.freebsd.org (Postfix) with ESMTP id 52A4C8FC1D for ; Thu, 30 Apr 2009 10:22:41 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.14.3/8.14.3) with ESMTP id n3UAMf8F070302 for ; Thu, 30 Apr 2009 10:22:41 GMT (envelope-from rene@FreeBSD.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.14.3/8.14.3/Submit) id n3UAMe9U070300 for perforce@freebsd.org; Thu, 30 Apr 2009 10:22:40 GMT (envelope-from rene@FreeBSD.org) Date: Thu, 30 Apr 2009 10:22:40 GMT Message-Id: <200904301022.n3UAMe9U070300@repoman.freebsd.org> X-Authentication-Warning: repoman.freebsd.org: perforce set sender to rene@FreeBSD.org using -f From: Rene Ladan To: Perforce Change Reviews Cc: Subject: PERFORCE change 161374 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 30 Apr 2009 10:22:42 -0000 http://perforce.freebsd.org/chv.cgi?CH=161374 Change 161374 by rene@rene_self on 2009/04/30 10:21:48 MFen handbook/cutting-edge 1.240 -> 1.242 Affected files ... .. //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.sgml#22 edit Differences ... ==== //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.sgml#22 (text+ko) ==== @@ -5,7 +5,7 @@ $FreeBSDnl: doc/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v 1.47 2006/01/07 11:27:42 siebrand Exp $ %SOURCE% en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml - %SRCID% 1.240 + %SRCID% 1.242 --> @@ -102,7 +102,7 @@ Hoe uw documentatie bijgewerkt te houden met - CVSup. @@ -846,7 +846,7 @@ Alle benodigde gereedschappen zijn beschikbaar als deel van de Portscollectie. De port textproc/docproj is een meesterport + role="package">textproc/docproj is een meester-port die door het &os; Documentatieproject is ontwikkeld om de installatie en toekomstige updates van deze gereedschappen makkelijker te maken. @@ -1039,6 +1039,248 @@ &prompt.root; make FORMATS='html html-split' install clean + + + + + Marc + Fonvieille + Gebaseerd op het werk van + + + + + Documentatieports gebruiken + + Updaten en upgraden + + + documentatiepakket + + Updaten en upgraden + + + In de vorige sectie werd er een methode voor het bijwerken + van de &os;-documentatie vanaf de broncode gepresenteerd. Het + bijwerken gebaseerd op broncode is echter niet voor alle + &os;-systemen haalbaar of praktisch. Voor het bouwen van de + documentatiebronnen zijn een redelijk grote verzameling van + gereedschappen, de documentatie + gereedschapskist, een bepaald niveau van bekendheid + met CVS en checkouts van broncode + vanuit een reservoir nodig, en een aantal handmatige stappen om + de uitgecheckte broncode te bouwen. In deze sectie wordt een + alternatieve manier beschreven om de geïnstalleerde + kopiën van de &os;-documentatie bij te werken; een die de + Ports Collectie gebruikt en het mogelijk maakt om: + + + + Voorgebouwde versies van de documentatie te downloaden + en te installeren, zonder iets lokaal te hoeven bouwen (op + deze manier wordt de noodzaak voor een installatie van de + gehele documentatie-gereedschapskist voorkomen). + + + + De documentatiebronnen te bouwen en ze via het + ports-raamwerk te bouwen (de stappen van het uitchecken en + bouwen worden iets eenvoudiger gemaakt). + + + + Deze twee methoden om de &os;-documentatie bij te werken + worden ondersteund door een verzameling van + documentatie-ports die maandelijks door + het &a.doceng; worden bijgewerkt. Deze zijn vermeld in de &os; + Ports Collectie onder de virtuele categorie docs. + + + Documentatie-ports bouwen en installeren + + De documentatie-ports gebruiken het bouwraamwerk van de + ports om het bouwen van documentatie eenvoudiger te maken. Ze + automatiseren het proces van het uitchecken van de broncode + van de documentatie, het draaien van &man.make.1; met de + juiste omgevingsinstellingen en opdrachtregelopties, en ze + maken de installatie of deïnstallatie van documentatie + net zo eenvoudig als de installatie van elke andere &os;-port + of -pakket. + + + Als een extra eigenschap registreren de + documentatie-ports, wanneer ze lokaal zijn gebouwd, een + afhankelijkheid naar de ports van de + documentatie-gereedschapskist, zodat + de laatste ook automatisch is geïnstalleerd. + + + De organisatie van de documentatie-ports is als volgt: + + + + Er is een meester-port, misc/freebsd-doc-en, waar de + bestanden van de documentatie-ports gevonden kunnen worden. + Het is de basis van alle documentatie-ports. Standaard + bouwt het alleen de Engelstalige documentatie. + + + + Er is een alles-in-één + port, misc/freebsd-doc-all, en het + bouwt en installeert alle documentatie in alle beschikbare + talen. + + + + Ten slotte is er een slaaf-port voor + elke vertaling, b.v. misc/freebsd-doc-hu voor de + documenten in het Hongaars. Ze zijn allemaal afhankelijk + van de meester-port en installeren de vertaalde + documentatie van de respectievelijke taal. + + + + Gebruik de volgende commando's (als + root) om een documentatieport vanaf de + broncode te installeren: + + &prompt.root; cd /usr/ports/misc/freebsd-doc-en +&prompt.root; make install clean + + Dit zal de Engelstalige documentatie in gesplitst + HTML-formaat (hetzelfde als dat op wordt gebruikt) in de + map /usr/local/share/doc/freebsd + bouwen en installeren. + + + Algemene knoppen en opties + + Er zijn vele opties om het standaardgedrag van de + documentatie-ports aan te passen. Het volgende is slechts + een korte lijst: + + + + WITH_HTML + + + Staat bouwen van het HTML-formaat toe: een enkel + HTML-bestand per document. De opgemaakte documentatie + wordt naar gelang in een bestand genaamd + article.html, of + book.html, met afbeeldingen + opgeslagen. + + + + + WITH_PDF + + + Staat bouwen van het &adobe; Portable Document + Format toe, te gebruiken met &adobe; &acrobat.reader;, + Ghostscript, of andere + PDF-lezers. De opgemaakte documentatie wordt naar + gelang opgeslagen in een bestand genaamd + article.pdf of + book.pdf opgeslagen. + + + + + DOCBASE + + + Waar de documentatie te installeren. Standaard is + dit /usr/local/share/doc/freebsd. + + + Merk op dat de standaard doelmap afwijkt van de + map die door de CVSup-methode + wordt gebruikt. Dit komt omdat er een port wordt + geïnstalleerd, en ports worden normaliter onder + de map /usr/local + geïnstalleerd. Dit kan veranderd worden door + de variabele PREFIX toe te + voegen. + + + + + + Hier is een kort voorbeeld over hoe de bovengenoemde + variabelen te gebruiken om de Hongaarse documentatie in + Portable Document Format te installeren: + + &prompt.root; cd /usr/ports/misc/freebsd-doc-hu +&prompt.root; make -DWITH_PDF DOCBASE=share/doc/freebsd/hu install clean + + + + + Documentatiepakketten gebruiken + + Voor het bouwen van de documentatie-ports vanaf broncode, + zoals beschreven in de vorige sectie, is een lokale + installatie van de documentatie-gereedschapskist en wat + schijfruimte voor het bouwen van de ports nodig. Wanneer de + bronnen voor het installeren van de documentatie-gereedschapskist + niet aanwezig zijn, of wanneer het bouwen vanaf broncode te + veel schijfruimte in beslag neemt, is het nog steeds mogelijk + om de vooraf gebouwde versies van de documentatie-ports te + installeren. + + Het &a.doceng; bereidt maandelijkse versies van de &os; + documentatiepakketten voor. Deze binaire pakketten kunnen met + elk van de meegeleverde pakketgereedschappen, zoals + &man.pkg.add.1;, &man.pkg.delete.1;, enzovoorts gebruikt + worden. + + + Wanneer binaire pakketten worden gebruikt, zal de &os; + documentatie in alle beschikbare + formaten voor de gegeven taal geïnstalleerd worden. + + + Het volgende commando bijvoorbeeld zal het nieuwste vooraf + gebouwde pakket van de Hongaarse documentatie installeren: + + &prompt.root; pkg_add -r hu-freebsd-doc + + + Pakketten hebben het volgende naamformaat welke afwijkt + van de naam van de overeenkomstige port: + taal-freebsd-doc. + Hier is taal het korte formaat + van de taalcode, i.e. hu voor Hongaars, + of zh_cn voor Vereenvoudigd Chinees. + + + + + Documentatieports bijwerken + + Voor het bijwerken van een eerder geïnstalleerde + documentatieport is elk gereedschap voor het bijwerken van + ports geschikt. Het volgende commando bijvoorbeeld werkt de + geïnstalleerde Hongaarse documentatie bij via het + gereedschap ports-mgmt/portupgrade door alleen + pakketten te gebruiken: + + &prompt.root; portupgrade -PP hu-freebsd-doc + + +