From owner-svn-doc-head@freebsd.org Tue Oct 13 22:33:11 2015 Return-Path: Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 3ADA6A138A1; Tue, 13 Oct 2015 22:33:11 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id EDC12DBD; Tue, 13 Oct 2015 22:33:10 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id t9DMXAld094423; Tue, 13 Oct 2015 22:33:10 GMT (envelope-from wblock@FreeBSD.org) Received: (from wblock@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id t9DMXAdh094422; Tue, 13 Oct 2015 22:33:10 GMT (envelope-from wblock@FreeBSD.org) Message-Id: <201510132233.t9DMXAdh094422@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: wblock set sender to wblock@FreeBSD.org using -f From: Warren Block Date: Tue, 13 Oct 2015 22:33:09 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r47549 - head/en_US.ISO8859-1/books/fdp-primer/po-translations X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 13 Oct 2015 22:33:11 -0000 Author: wblock Date: Tue Oct 13 22:33:09 2015 New Revision: 47549 URL: https://svnweb.freebsd.org/changeset/doc/47549 Log: Add a section documenting how to submit new translations. Modified: head/en_US.ISO8859-1/books/fdp-primer/po-translations/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/po-translations/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/po-translations/chapter.xml Tue Oct 13 21:45:26 2015 (r47548) +++ head/en_US.ISO8859-1/books/fdp-primer/po-translations/chapter.xml Tue Oct 13 22:33:09 2015 (r47549) @@ -758,4 +758,66 @@ DOC_PREFIX?= ${.CURDIR}/../../.. + + + Submitting the New Translation + + Prepare the new translation files for submission. This + example shows a new Spanish translation of the NanoBSD + article in + ~/doc/es_ES.ISO8859-1/articles/nanobsd. + + + + The PO file must contain a &os; + version string comment on the first line: + + #$FreeBSD$ + + + + The Makefile, the + PO file, and the generated + XML translation must all be added to + version control: + + &prompt.user; cd ~/doc/es_ES.ISO8859-1/articles/nanobsd/ +&prompt.user; ls +Makefile article.xml es_ES.po +&prompt.user; svn add Makefile article.xml es_ES.po +A Makefile +A article.xml +A es_ES.po + + + + These files must also have the + Subversion + svn:keywords property set to + FreeBSD=%H: + + &prompt.user; svn propset svn:keywords FreeBSD=%H Makefile article.xml es_ES.po +property 'svn:keywords' set on 'Makefile' +property 'svn:keywords' set on 'article.xml' +property 'svn:keywords' set on 'es_ES.po' + + + + A diff of these new files is created from the + ~/doc/ base directory so the full path + is shown with the filenames. This helps committers identify + the target language directory. + + &prompt.user; cd ~/doc +svn diff es_ES.ISO8859-1/articles/nanobsd/ > /tmp/es_nanobsd.diff + + The diff file is now ready for attachment to a + documentation + bug report or code + review. + + +