From owner-p4-projects@FreeBSD.ORG Sun Jan 11 21:20:20 2009 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 8390F106568A; Sun, 11 Jan 2009 21:20:20 +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 439441065688 for ; Sun, 11 Jan 2009 21:20:20 +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 318408FC1F for ; Sun, 11 Jan 2009 21:20:20 +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 n0BLKKWI071089 for ; Sun, 11 Jan 2009 21:20:20 GMT (envelope-from rene@FreeBSD.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.14.3/8.14.3/Submit) id n0BLKKRU071087 for perforce@freebsd.org; Sun, 11 Jan 2009 21:20:20 GMT (envelope-from rene@FreeBSD.org) Date: Sun, 11 Jan 2009 21:20:20 GMT Message-Id: <200901112120.n0BLKKRU071087@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 155983 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: Sun, 11 Jan 2009 21:20:21 -0000 http://perforce.freebsd.org/chv.cgi?CH=155983 Change 155983 by rene@rene_self on 2009/01/11 21:20:14 MFen handbook/cutting-edge 1.235 -> 1.236 Mention myself only once as translator. Affected files ... .. //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.sgml#14 edit Differences ... ==== //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/cutting-edge/chapter.sgml#14 (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.235 + %SRCID% 1.236 --> @@ -53,6 +53,11 @@ Siebrand Mazeland + + + René + Ladan + @@ -96,6 +101,12 @@ + Hoe uw documentatie bijgewerkt te houden met + CVSup. + + + De verschillen tussen de ontwikkeltakken &os.stable; en &os.current;; @@ -149,17 +160,9 @@ Gebaseerd op notities aangeleverd door - - - - René - Ladan - Vertaald door - - - FreeBSD Update + &os; Update updaten en upgraden @@ -695,14 +698,6 @@ Gebaseerd op notities geleverd door - - - - René - Ladan - Vertaald door - - Portsnap: een updategereedschap voor de Portscollectie @@ -714,6 +709,7 @@ updaten en upgraden + Het basissysteem van &os; bevat ook een gereedschap om de Portscollectie bij te werken: het hulpmiddel &man.portsnap.8;. Wanneer het wordt uitgevoerd, zal het een verbinding maken met een @@ -773,6 +769,345 @@ &prompt.root; portsnap fetch update + + + De documentatie bijwerken + + updaten en upgraden + + + documentatie + + updaten en upgraden + + + Naast het basissysteem en de Portscollectie is documentatie + een integraal onderdeel van het besturingssysteem &os;. Hoewel + een actuele versie van de &os;-documentatie altijd beschikbaar is + op de &os; website, hebben + sommige gebruikers een langzame of helemaal geen permanente + netwerkverbinding. Gelukkig zijn er verschillende manieren om de + documentatie die bij elke uitgave wordt geleverd bij te werken + door een lokale kopie van de nieuwste &os;-documentatie bij te + houden. + + + CVSup gebruiken om de documentatie bij te werken + + De bronnen en de geïnstalleerde kopie van de + &os;-documentatie kunnen met CVSup + worden bijgewerkt, waarbij een mechanisme wordt gebruikt dat + lijkt op degene die voor de broncode van het basissysteem wordt + gebruikt (c.f. ). Deze sectie + beschrijft: + + + + Hoe de documentatiegereedschappen, de gereedschappen die + nodig zijn om de &os;-documentatie vanuit de broncode te + herbouwen, te installeren. + + + + Hoe een kopie van de documentatiebronnen in /usr/doc te downloaden door + CVSup te gebruiken. + + + + Hoe de &os;-documentatie vanuit de broncode te herbouwen + en onder /usr/share/doc te + installeren. + + + + Sommige bouwopties die door het bouwsysteem van de + documentatie ondersteund worden, i.e. de opties die slechts + enkele van de verschillende vertalingen van de documentatie + bouwen of de opties die een specifiek uitvoerformaat + selecteren. + + + + + + CVSup en de documentatiegereedschappen installeren + + Voor het herbouwen van de &os;-documentatie vanuit de + broncode is een aardig grote verzameling gereedschappen nodig. + Deze gereedschappen zijn geen deel van het basissysteem van &os; + omdat ze een grote hoeveelheid schijfruimte nodig hebben en niet + voor alle &os;-gebruikers nuttig zijn; ze zijn alleen nuttig + voor die gebruikers die actief nieuwe documentatie voor &os; + schrijven of regelmatig hun documentatie vanuit de broncode + bijwerken. + + Alle benodigde gereedschappen zijn beschikbaar als deel van + de Portscollectie. De port textproc/docproj is een meesterport + die door het &os; Documentatieproject is ontwikkeld om de + installatie en toekomstige updates van deze gereedschappen + makkelijker te maken. + + + Wanneer er geen &postscript;- of PDF-documentatie nodig + is, kan men overwegen om in plaats hiervan de port textproc/docproj-nojadetex te + installeren. Deze versie van de documentatiegereedschappen + bevat alles behalve de typesetting-engine + teTeX. + teTeX is een erg grote verzameling + van gereedschappen, dus kan het zinvol zijn om de installatie + ervan achterwege te laten als PDF-uitvoer niet echt nodig + is. + + + Bekijk CVSup gebruiken voor + meer informatie over het installeren en gebruiken van + CVSup. + + + + De documentatiebroncode bijwerken + + Het hulpmiddel CVSup kan een + schone kopie van de documentatiebroncode ophalen, door het + bestand + /usr/share/examples/cvsup/doc-supfile + als een configuratiesjabloon te gebruiken. Voor de standaard + update-host is in doc-supfile een nog in te + vullen waarde ingevuld, maar &man.cvsup.1; accepteert een + hostnaam via de opdrachtregel, dus kan de documentatiebroncode + van een van de CVSup-servers worden + opgehaald door het volgende te typen: + + &prompt.root; cvsup -h cvsup.FreeBSD.org -g -L 2 /usr/share/examples/cvsup/doc-supfile + + Verander cvsup.FreeBSD.org in de + dichtstbijzijnde CVSup-server. Zie + voor een complete lijst van + spiegelsites. + + De initiële download van de documentatiebroncode kan + een tijd duren. Laat het draaien totdat het voltooid is. + + Toekomstige updates van de documentatiebroncode kunnen + opgehaald worden door hetzelfde commando te draaien. Het + hulpmiddel CVSup downloadt en + kopieert alleen de updates sinds de laatste keer dat het + gedraaid werd, dus zou elke keer dat + CVSup gedraaid wordt na de eerste + complete keer redelijk snel moeten zijn. + + Nadat de broncode is uitgecheckt, wordt een alternatieve + manier om de documentatie bij te werken ondersteund door + Makefile van de map /usr/doc. Door + SUP_UPDATE, SUP_HOST, en + DOCSUPFILE in het bestand + /etc/make.conf in te stellen, is het + mogelijk om dit te draaien: + + &prompt.root; cd /usr/doc +&prompt.root; make update + + Een typische verzameling van deze &man.make.1;-opties voor + /etc/make.conf is: + + SUP_UPDATE= yes +SUPHOST?= cvsup.FreeBSD.org +DOCSUPFILE?= /usr/share/examples/cvsup/doc-supfile + + + Het instellen van de waardes SUPHOST en + DOCSUPFILE met ?= staat + toe dat ze in de opdrachtregel van make overschreven worden. + Dit is de aangeraden manier om opties aan + /etc/make.conf toe te voegen, om te + voorkomen dat het bestand telkens wanneer er een andere waarde + van de optie getest moet worden bewerkt moet worden. + + + + + Instelbare opties van de documentatiebroncode + + Het bijwerk- en bouwsysteem van de &os;-documentatie + ondersteunt enkele opties die het proces om de documentatie + alleen gedeeltelijk bij te werken, of om specifieke vertalingen + te bouwen, makkelijker maken. Deze opties kunnen of als + systeemwijde opties in het bestand + /etc/make.conf worden ingesteld, of als + opdrachtregelopties aan het hulpmiddel &man.make.1; worden + doorgegeven. + + De volgende opties zijn er enkelen van: + + + + DOC_LANG + + + De lijst van te bouwen en te installeren talen en + coderingen, bijvoorbeeld + en_US.ISO8859-1 voor alleen de Engelse + documentatie. + + + + + FORMATS + + + Een enkel formaat of een lijst van uitvoerformaten die + gebouwd moeten worden. Momenteel worden + html, html-split, + txt, ps, + pdf, en rtf + ondersteund. + + + + + SUPHOST + + + De hostnaam van de CVSup + server die gebruikt wordt tijdens het bijwerken. + + + + + Bekijk &man.make.conf.5; voor meer make-variabelen die als + systeemwijde opties in &os; worden ondersteund. + + Voor meer make-variabelen die die door het bouwsysteem van + de &os;-documentatie ondersteund worden, wordt naar het &os; Documentation + Project Primer for New Contributors verwezen. + + + + De &os;-documentatie vanuit de broncode installeren + + Wanneer er een actueel snapshot van de documentatiebroncode + is opgehaald in /usr/doc, + is alles gereed om de geïnstalleerde documentatie bij te + werken. + + Het volledig bijwerken van alle talen die in de + Makefile-optie DOC_LANG zijn gedefinieerd kan + worden gedaan door te typen: + + &prompt.root; cd /usr/doc +&prompt.root; make install clean + + Als make.conf is ingesteld met de + juiste opties voor DOCSUPFILE, + SUPHOST, en SUP_UPDATE, + dan kan de installatiestap worden gecombineerd met het bijwerken + van de documentatiebroncode door te typen: + + &prompt.root; cd /usr/doc +&prompt.root; make update install clean + + Als alleen het bijwerken van een specifieke taal gewenst is, + dan kan &man.make.1; worden aangeroepen in een taalspecifieke + submap van /usr/doc, + i.e.: + + &prompt.root; cd /usr/doc/en_US.ISO8859-1 +&prompt.root; make update install clean + + De te installeren uitvoerformaten kunnen worden + gespecificeerd door de make-variabele FORMATS + in te stellen, i.e.: + + &prompt.root; cd /usr/doc +&prompt.root; make FORMATS='html html-split' install clean + + + + + + + + Pav + Lucistnik + Gebaseerd op informatie geleverd door + + + + + Docsnap gebruiken + + updaten en upgraden + + + Docsnap + + updaten en upgraden + + + Docscnap is een + &man.rsync.1;-reservoir voor het bijwerken van + geïnstalleerde &os;-documentatie op een relatief + gemakkelijke en snelle manier. Een + Docsnap server volgt + de documentatiebroncode en bouwt ze elk uur in HTML-formaat. De + port textproc/docproj is + niet nodig met Docsnap aangezien er + alleen patches voor de gebouwde documentatie bestaan. + + De enige benodigdheid om deze techniek te gebruiken is de + port of het pakket net/rsync. Gebruik het volgende + commando om het toe te voegen: + + &prompt.root; pkg_add -r rsync + + + Docsnap is eigenlijk ontwikkeld + om de documentatie die in /usr/share/doc is + geïnstalleerd bij te werken, maar de volgende voorbeelden + kunnen ook voor andere mappen worden gebruikt. Voor + gebruikersmappen heeft het geen + root-rechten nodig. + + + Geef het volgende commando om de documentatie bij te + werken: + + &prompt.root; rsync -rltvz docsnap.sk.FreeBSD.org::docsnap /usr/share/doc + + + Er is momenteel slechts één + Docsnap-server; de bovengenoemde + host docsnap.sk.FreeBSD.org. + + + Gebruik hier niet de vlag omdat er + tijdens make installworld wat dingen in + /usr/share/doc worden + geïnstalleerd, die dan per ongeluk verwijderd zouden + worden. Gebruik in plaats daarvan dit commando om op te + ruimen: + + &prompt.root; rsync -rltvz --delete docsnap.sk.FreeBSD.org::docsnap/??_??\.\* /usr/share/doc + + Het volgende commando dient gebruikt te worden als er een + deelverzameling van de documentatie, bijvoorbeeld + alleen de Engelse documentatie, bijgewerkt moet worden: + + &prompt.root; rsync -rltvz docsnap.sk.FreeBSD.org::docsnap/en_US.ISO8859-1 /usr/share/doc + +]]> + + Een ontwikkelingstak volgen