From owner-p4-projects@FreeBSD.ORG Fri Jan 23 16:08:50 2009 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 0F14F106567D; Fri, 23 Jan 2009 16:08:50 +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 9F4F51065693 for ; Fri, 23 Jan 2009 16:08:49 +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 8B1748FC29 for ; Fri, 23 Jan 2009 16:08:49 +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 n0NG8nNC054024 for ; Fri, 23 Jan 2009 16:08:49 GMT (envelope-from rene@FreeBSD.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.14.3/8.14.3/Submit) id n0NG8nYu054022 for perforce@freebsd.org; Fri, 23 Jan 2009 16:08:49 GMT (envelope-from rene@FreeBSD.org) Date: Fri, 23 Jan 2009 16:08:49 GMT Message-Id: <200901231608.n0NG8nYu054022@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 156566 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: Fri, 23 Jan 2009 16:08:51 -0000 http://perforce.freebsd.org/chv.cgi?CH=156566 Change 156566 by rene@rene_self on 2009/01/23 16:08:08 IFC Affected files ... .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/book.sgml#4 integrate .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/examples/appendix.sgml#2 integrate .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/psgml-mode/chapter.sgml#2 integrate .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/see-also/chapter.sgml#2 integrate .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/structure/chapter.sgml#3 integrate .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml#4 integrate .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.sgml#2 integrate .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml#10 integrate .. //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/eresources/chapter.sgml#12 integrate .. //depot/projects/docproj_nl/en_US.ISO8859-1/share/sgml/mailing-lists.ent#10 integrate .. //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/ports/chapter.sgml#15 integrate .. //depot/projects/docproj_nl/share/pgpkeys/beech.key#3 integrate Differences ... ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/book.sgml#4 (text+ko) ==== @@ -27,7 +27,7 @@ ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/book.sgml,v 1.32 2008/12/07 22:03:48 pgj Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/book.sgml,v 1.33 2009/01/21 23:52:53 pgj Exp $ --> 2006 2007 2008 + 2009 DocEng - $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/book.sgml,v 1.32 2008/12/07 22:03:48 pgj Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/book.sgml,v 1.33 2009/01/21 23:52:53 pgj Exp $ - $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/book.sgml,v 1.32 2008/12/07 22:03:48 pgj Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/book.sgml,v 1.33 2009/01/21 23:52:53 pgj Exp $ &bookinfo.legalnotice; ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/examples/appendix.sgml#2 (text+ko) ==== @@ -27,7 +27,7 @@ ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/examples/appendix.sgml,v 1.17 2006/01/05 20:03:35 delphij Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/examples/appendix.sgml,v 1.18 2009/01/21 23:38:07 pgj Exp $ --> @@ -90,12 +90,12 @@ - My first chapter + My First Chapter This is the first chapter in my book. - My first section + My First Section This is the first section in my book. @@ -114,7 +114,7 @@
- An example article + An Example Article Your first name @@ -135,12 +135,12 @@ - My first section + My First Section This is the first section in my article. - My first sub-section + My First Sub-Section This is the first sub-section in my article. @@ -150,7 +150,7 @@ - Producing formatted output + Producing Formatted Output This section assumes that you have installed the software listed in the textproc/docproj port, either by hand, or by @@ -171,37 +171,37 @@ -c /usr/local/share/sgml/docbook/catalog \ -c /usr/local/share/sgml/jade/catalog \ -d /usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl \ - -t sgml file.sgml > file.html + -t sgml file.sgml > file.html Specifies the nochunks parameter to the stylesheets, forcing all output to be written to - STDOUT (using Norm Walsh's stylesheets). + the standard output (using Norm Walsh's stylesheets). - Specifies the catalogs that Jade will need to process. + Specifies the catalogs that Jade will need to process. Three catalogs are required. The first is a catalog that contains information about the DSSSL stylesheets. The second contains information about the DocBook DTD. The third contains - information specific to Jade. + information specific to Jade. - Specifies the full path to the DSSSL stylesheet that Jade + Specifies the full path to the DSSSL stylesheet that Jade will use when processing the document. - Instructs Jade to perform a + Instructs Jade to perform a transformation from one DTD to another. In this case, the input is being transformed from the DocBook DTD to the HTML DTD. - Specifies the file that Jade should process, and redirects + Specifies the file that Jade should process, and redirects output to the specified .html file. @@ -219,7 +219,7 @@ - Specifies the catalogs that Jade will need to process. + Specifies the catalogs that Jade will need to process. Three catalogs are required. The first is a catalog that contains information about the DSSSL stylesheets. The second contains information about the DocBook DTD. The third contains @@ -227,19 +227,19 @@ - Specifies the full path to the DSSSL stylesheet that Jade + Specifies the full path to the DSSSL stylesheet that Jade will use when processing the document. - Instructs Jade to perform a + Instructs Jade to perform a transformation from one DTD to another. In this case, the input is being transformed from the DocBook DTD to the HTML DTD. - Specifies the file that Jade should process. The + Specifies the file that Jade should process. The stylesheets determine how the individual HTML files will be named, and the name of the root file (i.e., the one that contains the start of the document. @@ -256,7 +256,7 @@ The source SGML file must be converted to a &tex; file. - &prompt.user; jade -Vtex-backend \ + &prompt.user; jade -V tex-backend \ -c /usr/local/share/sgml/docbook/dsssl/modular/catalog \ -c /usr/local/share/sgml/docbook/catalog \ -c /usr/local/share/sgml/jade/catalog \ @@ -270,7 +270,7 @@ - Specifies the catalogs that Jade will need to process. Three + Specifies the catalogs that Jade will need to process. Three catalogs are required. The first is a catalog that contains information about the DSSSL stylesheets. The second contains information about the DocBook DTD. The third contains @@ -279,11 +279,11 @@ Specifies the full path to the DSSSL stylesheet that - Jade will use when processing the document. + Jade will use when processing the document. - Instructs Jade to convert the output to &tex;. + Instructs Jade to convert the output to &tex;. @@ -300,8 +300,8 @@ on. Do not be alarmed if you see warning messages such as - LaTeX Warning: Reference `136' on page 5 undefined on input - line 728. at this point. + LaTeX Warning: Reference `136' on page 5 undefined on input + line 728. at this point. The second run reprocesses the document now that certain pieces of information are known (such as the document's page length). This @@ -328,7 +328,7 @@ linkend="examples-docbook-postscript">). When the .tex file has been generated you - run pdfTeX. However, use the &pdfjadetex macro package + run pdfTeX. However, use the &pdfjadetex macro package instead. &prompt.user; pdftex "&pdfjadetex" file.tex ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/psgml-mode/chapter.sgml#2 (text+ko) ==== @@ -27,15 +27,15 @@ ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/psgml-mode/chapter.sgml,v 1.10 2005/09/24 23:15:42 keramida Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/psgml-mode/chapter.sgml,v 1.11 2009/01/21 23:41:25 pgj Exp $ --> Using <literal>sgml-mode</literal> with <application>Emacs</application> - Recent versions of Emacs or XEmacs (available from the ports - collection) contain a very useful package called PSGML. Automatically + Recent versions of Emacs or XEmacs (available from the Ports + Collection) contain a very useful package called PSGML (can be installed from editors/psgml). Automatically invoked when a file with the .sgml extension is loaded, or by typing M-x sgml-mode, it is a major mode for dealing with SGML files, elements and attributes. @@ -48,9 +48,9 @@ C-c C-e - Runs sgml-insert-element. You will be + Runs sgml-insert-element. You will be prompted for the name of the element to insert at the current point. - You can use the TAB key to complete the element. Elements that are + You can use the Tab key to complete the element. Elements that are not valid at the current point will be disallowed. The start and end tags for the element will be inserted. If the @@ -63,7 +63,7 @@ C-c = - Runs sgml-change-element-name. Place the + Runs sgml-change-element-name. Place the point within an element and run this command. You will be prompted for the name of the element to change to. Both the start and end tags of the current element will be changed to the new @@ -75,8 +75,8 @@ C-c C-r - Runs sgml-tag-region. Select some text (move - to start of text, C-space, move to end of text, C-space) and then + Runs sgml-tag-region. Select some text (move + to start of text, C-space, move to end of text, C-space) and then run this command. You will be prompted for the element to use. This element will then be inserted immediately before and after your marked region. @@ -87,7 +87,7 @@ C-c - - Runs sgml-untag-element. Place the point + Runs sgml-untag-element. Place the point within the start or end tag of an element you want to remove, and run this command. The element's start and end tags will be removed. @@ -98,7 +98,7 @@ C-c C-q - Runs sgml-fill-element. Will recursively fill + Runs sgml-fill-element. Will recursively fill (i.e., reformat) content from the current element in. The filling will affect content in which whitespace is significant, such as within programlisting @@ -110,9 +110,9 @@ C-c C-a - Runs sgml-edit-attributes. Opens a second + Runs sgml-edit-attributes. Opens a second buffer containing a list of all the attributes for the closest - enclosing element, and their current values. Use TAB to navigate + enclosing element, and their current values. Use Tab to navigate between attributes, C-k to remove an existing value and replace it with a new one, C-c C-c to close this buffer and return to the main document. @@ -123,7 +123,7 @@ C-c C-v - Runs sgml-validate. Prompts you to save the + Runs sgml-validate. Prompts you to save the current document (if necessary) and then runs an SGML validator. The output from the validator is captured into a new buffer, and you can then navigate from one troublespot to the next, fixing markup errors @@ -135,7 +135,7 @@ C-c / - Runs sgml-insert-end-tag. Inserts the + Runs sgml-insert-end-tag. Inserts the end tag for the current open element. ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/see-also/chapter.sgml#2 (text+ko) ==== @@ -27,7 +27,7 @@ ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/see-also/chapter.sgml,v 1.13 2004/08/05 10:04:29 den Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/see-also/chapter.sgml,v 1.15 2009/01/22 12:08:03 pgj Exp $ --> @@ -64,7 +64,7 @@ Gentle introduction to SGML + url="http://www-sul.stanford.edu/tools/tutorials/html2.0/gentle.html">Gentle introduction to SGML @@ -97,14 +97,14 @@ DocBook: The Definitive Guide, the online documentation for the DocBook - DTD. + DTD The DocBook Open Repository contains DSSSL stylesheets and other resources - for people using DocBook. + for people using DocBook @@ -114,7 +114,7 @@ - The Linux Documentation + The Linux Documentation Project web pages ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/structure/chapter.sgml#3 (text+ko) ==== @@ -27,7 +27,7 @@ ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/structure/chapter.sgml,v 1.18 2008/12/07 02:05:09 pgj Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/structure/chapter.sgml,v 1.19 2009/01/21 23:44:40 pgj Exp $ --> @@ -238,13 +238,13 @@ In earlier versions of the Handbook the files were stored in the same directory as book.sgml, and named after the value of the id attribute on the - file's chapter element. Moving them into - separate directories prepares for future plans for the Handbook. - Specifically, it will soon be possible to include images in each - chapter. It makes more sense for each image to be stored in a - directory with the text for the chapter than to try to keep the - text for all the chapters, and all the images, in one large - directory. Namespace collisions would be inevitable, and it is + file's chapter element. + Now, it is possible to include images in each + chapter. Images for each Handbook chapter are stored within + share/images/books/handbook. + Note that localized version of these images should be placed in the same + directory as the SGML sources for each chapter. + Namespace collisions would be inevitable, and it is easier to work with several directories with a few files in them than it is to work with one directory that has many files in it. ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml#4 (text+ko) ==== @@ -27,7 +27,7 @@ ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml,v 1.26 2008/08/06 22:03:49 pgj Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.sgml,v 1.27 2009/01/21 23:46:32 pgj Exp $ --> @@ -86,7 +86,7 @@ - Simple method: Using <command>csup</command> + Simple Method: Using <command>csup</command> The csup command is part of the base system and already used extensively by most people for updating the @@ -145,8 +145,8 @@ - Advanced method: Maintaining a local - <application>CVS</application> doc/www repository + Advanced Method: Maintaining a Local + <application>CVS</application> doc/www Repository This method will give you more advanced options, but will require you to install the @@ -245,7 +245,7 @@ - Build the web pages from scratch + Build the Web Pages from Scratch Having completed either of the two methods, you will be ready to start the website build. In our example, the build directory is @@ -273,7 +273,7 @@ - Install the web pages into your web server + Install the Web Pages into Your Web Server @@ -305,7 +305,7 @@ - Environment variables + Environment Variables @@ -349,8 +349,8 @@ WEB_ONLY - If set and not empty, the makefiles will build and install - only the HTML pages from the www directory. All documents from + If set and not empty, the Makefiles will build and install + only the HTML pages from the www directory. All documents from the doc directory (Handbook, FAQ, Tutorials) will be ignored. E.g.: @@ -359,18 +359,31 @@ + WEB_LANG + + + If set, the Makefiles will build and install only for + the languages specified by this variable inside the + www directory. All + other languages except English will be ignored. E.g.: + + &prompt.root; make WEB_LANG="el es hu nl" all install + + + + NOPORTSCVS - If set, the makefiles will not checkout files from the ports - cvs repository. Instead, it will copy the files from + If set, the Makefiles will not checkout files from the ports + CVS repository. Instead, it will copy the files from /usr/ports (or where the variable PORTSBASE points to). - WEB_ONLY, ENGLISH_ONLY and + WEB_ONLY, WEB_LANG, ENGLISH_ONLY and NOPORTSCVS are make variables. You can set the variables in /etc/make.conf, Makefile.inc, as environment variables on the ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.sgml#2 (text+ko) ==== @@ -27,11 +27,11 @@ ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.sgml,v 1.48 2005/09/12 16:47:36 yar Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.sgml,v 1.49 2009/01/21 23:49:33 pgj Exp $ --> - Writing style + Writing Style In order to promote consistency between the myriad authors of the FreeBSD documentation, some guidelines have been drawn up for authors to @@ -39,7 +39,7 @@ - Use American English spelling + Use American English Spelling There are several variants of English, with different spellings @@ -166,16 +166,16 @@ Style, by William Strunk. - Style guide + Style Guide - To keep the source for the Handbook consistent when many different + To keep the source for the documentation consistent when many different people are editing it, please follow these style conventions. - Letter case + Letter Case - Tags are entered in lower case, <para>, - not <PARA>. + Tags are entered in lower case, para, + not PARA. Text that appears in SGML contexts is generally written in upper case, <!ENTITY…>, and @@ -188,16 +188,16 @@ Acronyms Acronyms should generally be spelled out the first time - they appear in a book, as in: "Network Time Protocol (NTP)." After the + they appear in a document, as in: Network Time Protocol (NTP). After the acronym has been defined, you should generally use the acronym only (not the whole term, unless it makes more sense contextually to use the whole term). Usually, acronyms are - defined only one per book. But if you prefer, you can also + defined only one per document. But if you prefer, you can also define them the first time they appear in each chapter. The first three uses of an acronym should be enclosed in - <acronym> tags, with a role attribute + acronym tags, with a role attribute with the full term defined. This allows a link to the glossary to be created, and for mouseovers to be rendered with the fully expanded term. @@ -263,10 +263,10 @@ - Tag style + Tag Style - Tag spacing + Tag Spacing Tags that start at the same indent as a previous tag should be separated by a blank line, and those that are not @@ -302,7 +302,7 @@ - Separating tags + Separating Tags Tags like itemizedlist which will always have further tags inside them, and in fact do not take @@ -332,13 +332,13 @@ - White space changes + White Space Changes When committing changes, do not commit changes to the content at the same time as changes to the formatting. - This is so that the teams that convert the Handbook to other + This is so that the teams that convert the documentation to other languages can quickly see what content has actually changed in your commit, without having to decide whether a line has changed because of the content, or just because it has been refilled. @@ -352,7 +352,7 @@ - Nonbreaking space + Non-Breaking Space Avoid line breaks in places where they look ugly or make it difficult to follow a sentence. Line breaks depend @@ -364,7 +364,7 @@ GB. Hardware compression … The general entity &nbsp; prohibits - line breaks between parts belonging together. Use nonbreaking + line breaks between parts belonging together. Use non-breaking spaces in the following places: @@ -389,7 +389,7 @@ - Word list + Word List The following is a small list of words spelled the way they should be used in the FreeBSD Documentation Project. If the ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml#10 (text+ko) ==== @@ -1,7 +1,7 @@ @@ -899,6 +899,16 @@ server to use when updating. + + + DOCDIR + + + Where to install the documentation. It defaults to + /usr/share/doc. + + For more make variables supported as system-wide options in ==== //depot/projects/docproj_nl/en_US.ISO8859-1/books/handbook/eresources/chapter.sgml#12 (text+ko) ==== @@ -1,7 +1,7 @@ @@ -376,6 +376,11 @@ + &a.mono.name; + Mono and C# applications on FreeBSD + + + &a.mozilla.name; Porting Mozilla to FreeBSD @@ -1343,6 +1348,23 @@ + &a.mono.name; + + + Mono and C# applications on + FreeBSD + + This is a list for discussions related to the Mono + development framework on &os;. This is a technical + mailing list. It is for individuals actively working on + porting Mono or C# applications to &os;, to bring up + problems or discuss alternative solutions. Individuals + interested in following the technical discussion are also + welcome. + + + + &a.openoffice.name; ==== //depot/projects/docproj_nl/en_US.ISO8859-1/share/sgml/mailing-lists.ent#10 (text+ko) ==== @@ -1,7 +1,7 @@ @@ -263,6 +263,10 @@ FreeBSD laptop computer mailing list"> freebsd-mobile"> + +Mono and C# applications on FreeBSD"> +freebsd-mono"> + FreeBSD port of the Mozilla browser mailing list"> freebsd-mozilla"> ==== //depot/projects/docproj_nl/nl_NL.ISO8859-1/books/handbook/ports/chapter.sgml#15 (text+ko) ==== @@ -1,7 +1,7 @@ + -sub 1024g/5D7681A3 2007-06-08 +sub 2048g/9F3B61BF 2009-01-23 ]]>