From owner-freebsd-doc@FreeBSD.ORG Sun Aug 19 08:40:04 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8EB071065675 for ; Sun, 19 Aug 2012 08:40:04 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 4EC4F8FC16 for ; Sun, 19 Aug 2012 08:40:04 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q7J8e44s006015 for ; Sun, 19 Aug 2012 08:40:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q7J8e4rj006014; Sun, 19 Aug 2012 08:40:04 GMT (envelope-from gnats) Resent-Date: Sun, 19 Aug 2012 08:40:04 GMT Resent-Message-Id: <201208190840.q7J8e4rj006014@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Marcelo Araujo Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DC4AC1065670 for ; Sun, 19 Aug 2012 08:39:02 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id C7A1D8FC0C for ; Sun, 19 Aug 2012 08:39:02 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q7J8d2Tu035494 for ; Sun, 19 Aug 2012 08:39:02 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.4/8.14.4/Submit) id q7J8d2ko035493; Sun, 19 Aug 2012 08:39:02 GMT (envelope-from nobody) Message-Id: <201208190839.q7J8d2ko035493@red.freebsd.org> Date: Sun, 19 Aug 2012 08:39:02 GMT From: Marcelo Araujo To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/170764: [zfs] 2399 zfs manual page does not document use of "zfs diff" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 19 Aug 2012 08:40:04 -0000 >Number: 170764 >Category: docs >Synopsis: [zfs] 2399 zfs manual page does not document use of "zfs diff" >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Sun Aug 19 08:40:04 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Marcelo Araujo >Release: 10-CURRENT >Organization: FreeBSD >Environment: FreeBSD hostb 10.0-CURRENT FreeBSD 10.0-CURRENT #0 r233530: Tue Apr 3 02:11:40 UTC 2012 araujo@hostb:/usr/obj/usr/src/sys/HOSTB i386 >Description: - A small manpage update, just to document the use of "zfs diff". This patch os partially obtained from Illumos-gate, changeset: 00c2a08cf1bb >How-To-Repeat: >Fix: Patch attached with submission follows: Index: zfs.8 =================================================================== --- zfs.8 (revision 233530) +++ zfs.8 (working copy) @@ -3158,6 +3158,20 @@ group staff @pset,create,mount ------------------------------------------------------------- .Ed +.It Sy Example 22 Showing the differences between a snapshot and a ZFS Dataset +.Pp +The following example shows how to see what has changed between a prior +snapshot of a ZFS Dataset and its current state. The -F option is used +to indicate type information for the files affected. +.Bd -literal -offset 2n +.Li # Ic zfs diff -F tank/test@before tank/test + M / /tank/test/ + M F /tank/test/linked (+1) + R F /tank/test/oldname -> /tank/test/newname + - F /tank/test/deleted + + F /tank/test/created + M F /tank/test/modified +.Ed .El .Sh EXIT STATUS The following exit values are returned: >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sun Aug 19 08:41:23 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id C0F16106564A; Sun, 19 Aug 2012 08:41:23 +0000 (UTC) (envelope-from araujo@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 9511D8FC0C; Sun, 19 Aug 2012 08:41:23 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q7J8fNnE006128; Sun, 19 Aug 2012 08:41:23 GMT (envelope-from araujo@freefall.freebsd.org) Received: (from araujo@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q7J8fNcM006124; Sun, 19 Aug 2012 08:41:23 GMT (envelope-from araujo) Date: Sun, 19 Aug 2012 08:41:23 GMT Message-Id: <201208190841.q7J8fNcM006124@freefall.freebsd.org> To: araujo@FreeBSD.org, freebsd-doc@FreeBSD.org, mm@FreeBSD.org From: araujo@FreeBSD.org Cc: Subject: Re: docs/170764: [zfs] 2399 zfs manual page does not document use of "zfs diff" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 19 Aug 2012 08:41:23 -0000 Synopsis: [zfs] 2399 zfs manual page does not document use of "zfs diff" Responsible-Changed-From-To: freebsd-doc->mm Responsible-Changed-By: araujo Responsible-Changed-When: Sun Aug 19 08:41:23 UTC 2012 Responsible-Changed-Why: Maybe Martin, could have time to take care of this PR. http://www.freebsd.org/cgi/query-pr.cgi?pr=170764 From owner-freebsd-doc@FreeBSD.ORG Mon Aug 20 11:06:14 2012 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9AF2E106566C for ; Mon, 20 Aug 2012 11:06:14 +0000 (UTC) (envelope-from owner-bugmaster@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 848118FC14 for ; Mon, 20 Aug 2012 11:06:14 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q7KB6ECm045389 for ; Mon, 20 Aug 2012 11:06:14 GMT (envelope-from owner-bugmaster@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q7KB6DwU045373 for freebsd-doc@FreeBSD.org; Mon, 20 Aug 2012 11:06:13 GMT (envelope-from owner-bugmaster@FreeBSD.org) Date: Mon, 20 Aug 2012 11:06:13 GMT Message-Id: <201208201106.q7KB6DwU045373@freefall.freebsd.org> X-Authentication-Warning: freefall.freebsd.org: gnats set sender to owner-bugmaster@FreeBSD.org using -f From: FreeBSD bugmaster To: FreeBSD doc list Cc: Subject: Current unassigned doc problem reports X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Aug 2012 11:06:14 -0000 (Note: an HTML version of this report is available at http://www.freebsd.org/cgi/query-pr-summary.cgi?category=doc .) The following is a listing of current problems submitted by FreeBSD users. These represent problem reports covering all versions including experimental development code and obsolete releases. S Tracker Resp. Description -------------------------------------------------------------------------------- o docs/170710 doc New documentation: Brazilian Portuguese translation of o docs/170691 doc Difference between zfs manpages and reality o docs/170468 doc SGML Tag for QUOTE arent working in HTML conversion o docs/170119 doc at behaviour and man at inconsistency o docs/169712 doc [patch] porters-handbook zh_TW.Big5 apache section o docs/169711 doc [patch] porters-handbook zh_CN.GB2312 apache section o docs/169544 doc serial port console documentation changes o docs/169377 doc [patch] ipmon(8) man page refers to a different facili o docs/169158 doc [patch] iasl(8) man page is out of date o docs/168962 doc cp(1) & mv(1) pages don't mention ACLs or extended att o docs/168930 doc map_mincore(9) not up-to-date o docs/168915 doc size of integers used by test(1) and sh(1) is not docu o docs/168823 doc 404s in fr_FR French web pages o docs/168803 doc Remove outdated smp info o docs/167742 doc Update documentation for group 5, and newgrp 1 o docs/167741 doc group(5): Group Passwords do not work and are not docu o docs/166553 doc find(1): find -delete documentation is misleading o docs/166358 doc No networking in Jail build via: handbook/jail-tuning o conf/166330 doc [rc] [patch] Thin server configuration revision reques o docs/165657 doc Web site Features page aging o docs/165551 doc ipfw(8): no info in "ipfw pipe show" about ipv6 o docs/165249 doc Multibyte characters in manpages still not displaying o docs/164826 doc handbook ports page does not suggest config-recursive o docs/164803 doc Unclear manual page for mount_unionfs(8) o docs/164620 doc Raid 1 issues o docs/164099 doc gparm(8): man page for gparm set is incorrect and inco o docs/164034 doc acl(9) documentation lacking o docs/163879 doc [handbook] handbook does not say about how to force to o docs/163830 doc device smbios: missing documentation, no manpage o docs/163149 doc [patch] Red Hat Linux/i386 9 HTML format sudo man page o docs/162699 doc Handbook/Upgrading instructions: should mention delete o docs/162587 doc unclear/incomplete description of per-interface statis o docs/162419 doc [request] please document (new) zfs and zpool cmdline o docs/162404 doc [handbook] IPv6 link-local address compared with IPv4 o docs/162380 doc Documentation lacking for getfacl/setfacl o docs/161754 doc p4tcc(4), est(4) and qpi(4) are not documented o docs/161496 doc zfs(1): Please document that sysctl vfs.usermount must o docs/160460 doc [handbook] Network setup guide suggestion o docs/160446 doc [handbook] Handbook sound setup seems outdated o docs/160445 doc [handbook] Handbook does not mention ACL o docs/160399 doc Man page for re(4) missing jumbo frames info o docs/159307 doc [patch] lpd smm chapter unconditionally installed o docs/158388 doc Incorrect documentation of LOCAL_SCRIPT in release(7) o docs/158387 doc The tree(3) man should mention the RB_FOREACH_SAFE() A o docs/157908 doc [handbook] Description of post-install should include o docs/157049 doc FreeBSD Handbook: Chapter 14 (Security) Inaccuracy p docs/156955 doc bug in share/man/man2/setsockopt.2 o docs/156920 doc isspecial(3) is not helpful o docs/156815 doc chmod(1): manpage should describe that chmod kicks +t o docs/156689 doc stf(4) output-only documentation gives bad configurati f docs/156187 doc [handbook] [patch] Add bsnmpd to handbook o docs/156081 doc troff falls with troff.core with UTF-8 man with incorr o docs/155982 doc [handbook] reaper of the dead: remove reference to flo o docs/155773 doc dialog(1): dialog manpages not updated o docs/155149 doc [patch] don't encourage using xorg.conf outside of PRE o docs/154838 doc update cvs-tags information on releng_* to reflect sup o docs/153958 doc ksu man-page documented, but not installed a docs/153012 doc [patch] iostat(8) requires an argument to -c option o docs/151752 doc pw.conf(5) doesn't define format for file clearly o docs/150991 doc [patch] Install upgtfw using pkg_add as advised in upg o docs/150917 doc [patch] icmp.4, wrong description of icmplim and icmpl o docs/150877 doc ambiguity in newsyslog(8) man page about zfs with comp o docs/150255 doc dtrace description should mention makeoptions DEBUG=-g o docs/149574 doc [patch] update mi_switch(9) man page o docs/148987 doc [patch] {MD[245]|SHA_|SHA1_|SHA256_}{End|File|FileChun o docs/148984 doc [handbook] Mistake in section 16.15.4 of the handbook o docs/148680 doc [sysctl][patch] Document some sys/kern sysctls o docs/148071 doc Failover mode between wired and wireless interfaces o docs/147995 doc elf.5 man page has has missing reference o docs/146958 doc bad link to "XaQti XMAC II datasheet" in sk(4) manual o docs/146521 doc [handbook] Update IPv6 system handbook section to ment o docs/145719 doc [patch] 7.3 relnotes erroneously describes new getpage o docs/145699 doc hexdump(1) mutes all format qualifier output following o docs/145069 doc Dialup firewalling with FreeBSD article out dated. o docs/145066 doc Update for new uart dev names for serial port. s docs/144818 doc all mailinglist archives dated 19970101 contain traili o docs/144630 doc [patch] domainname(1) manpage contains old information o docs/144515 doc [handbook] Expand handbook Table of contents o docs/144488 doc share/examples/etc/make.conf: contains dangerous examp o docs/143850 doc procfs(5) manpage for status > controlling terminal is o docs/143416 doc [handbook] IPFW handbook page issues o docs/143408 doc man filedesc(9) is missing o docs/142168 doc [patch] ld(1): ldd(1) not mentioned in ld(1) manpage o docs/141032 doc misleading documentation for rtadvd.conf(5) raflags se s docs/140847 doc [request] add documentation on ECMP and new route args o docs/140444 doc [patch] New Traditional Chinese translation of custom- o docs/140375 doc [UPDATE] Updated zh_TW.Big5/articles/nanobsd o docs/139336 doc [request] ZFS documentation suggestion o docs/139165 doc gssapi.3 man page out of sync with between crypto and o docs/139018 doc translation of submitting.sgml from docproj/submitting o docs/138845 doc Exceeding kern.ipc.maxpipekva refers to tuning(7) whic o docs/138663 doc system(3) man page confuses users about "return value o docs/138485 doc bpf(4) and ip(4) man pages missing important corner ca o docs/136712 doc [handbook] [patch] draft new section on gmirror per pa o docs/136666 doc [handbook] Configure serial port for remote kernel deb o docs/136035 doc ftpchroot(5) omits an important option o docs/134123 doc The RUNQUEUE(9) man page is out of date o docs/132839 doc [patch] Fix example script in ldap-auth article o docs/132718 doc [handbook] Information about adding a new mirror is ou o docs/132260 doc dhcpd(8) pid not stored in documented location o docs/132190 doc EPERM explanation for send(2), sendto(2), and sendmsg( o docs/131918 doc [patch] Fixes for the BPF(4) man page o docs/131626 doc [patch] dump(8) "recommended" cache option confusing o docs/130238 doc nfs.lockd man page doesn't mention NFSLOCKD option or o docs/129671 doc New TCP chapter for Developer's Handbook (from rwatson o docs/129464 doc using packages system o docs/129095 doc ipfw(8): Can not check that packet originating/destine o docs/128356 doc [request] add Firefox plugin for FreeBSD manual pages s docs/127844 doc Example code skeleton_capture_n.c in meteor(4) manpage o docs/126590 doc [patch] Write routine called forever in Sample Echo Ps o docs/126484 doc libc function res-zonscut2 is not documented f docs/122052 doc minor update on handbook section 20.7.1 o docs/121952 doc Handbook chapter on Network Address Translation wrong o docs/121585 doc [handbook] Wrong multicast specification s docs/121541 doc [request] no man pages for wlan_scan_ap o docs/121312 doc RELNOTES_LANG breaks release if not en_US.ISO8859-1 o docs/121173 doc [patch] mq_getattr(2): mq_flags mistakenly described a s docs/120917 doc [request]: Man pages mising for thr_xxx syscalls o docs/120125 doc [patch] Installing FreeBSD 7.0 via serial console and o docs/120024 doc resolver(5) and hosts(5) need updated for IPv6 o docs/119545 doc books/arch-handbook/usb/chapter.sgml formatting o docs/118902 doc [patch] wrong signatures in d2i_RSAPublicKey man pages o docs/116080 doc PREFIX is documented, but not the more important LOCAL p docs/115065 doc [patch] sync ps.1 with p_flag and keywords o docs/114371 doc [patch] [ip6] rtadvd.con(5) should show how to adverti o docs/114139 doc mbuf(9) has misleading comments on M_DONTWAIT and M_TR o docs/113194 doc [patch] [request] crontab.5: handling of day-in-month o docs/111425 doc Missing chunks of text in historical manpages o docs/111265 doc [request] Clarify how to set common shell variables o docs/110999 doc carp(4) should document unsupported interface types o docs/110692 doc wi(4) man page doesn't say WPA is not supported o docs/110376 doc [patch] add some more explanations for the iwi/ipw fir o docs/110062 doc [patch] mount_nfs(8) fails to mention a failure condit p docs/110061 doc [patch] tuning(7) missing reference to vfs.read_max o docs/109981 doc No manual entry for post-grohtml o docs/109977 doc No manual entry for ksu o docs/109973 doc No manual entry for c++filt o docs/109972 doc No manual entry for zless/bzless f docs/109226 doc [request] No manual entry for sntp o docs/109201 doc [request]: manual for callbootd a docs/108980 doc list of missing man pages o docs/106135 doc [request] articles/vinum needs to be updated o docs/105608 doc fdc(4) debugging description staled o docs/104879 doc Howto: Listen to IMA ADPCM .wav files on FreeBSD box o docs/102719 doc [patch] ng_bpf(4) example leads to unneeded promiscuos o docs/100196 doc man login.conf does explain not "unlimited" o docs/99506 doc FreeBSD Handbook addition: IPv6 Server Settings o docs/98974 doc Missing tunables in loader(8) manpage o docs/98115 doc Missing parts after rendering handbook to RTF format o docs/96207 doc Comments of a sockaddr_un structure could confuse one o docs/94625 doc [patch] growfs man page -- document "panic: not enough o docs/92626 doc jail manpage should mention disabling some periodic sc o docs/91506 doc ndis(4) man page should be more specific about support o docs/91149 doc read(2) can return EINVAL for unaligned access to bloc o docs/88512 doc [patch] mount_ext2fs(8) man page has no details on lar o docs/87936 doc Handbook chapter on NIS/YP lacks good information on a o docs/87857 doc ifconfig(8) wireless options order matters o docs/85128 doc [patch] loader.conf(5) autoboot_delay incompletly desc o docs/84956 doc [patch] intro(5) manpage doesn't mention API coverage o docs/84932 doc new document: printing with an Epson ALC-3000N on Free o docs/84670 doc [patch] tput(1) manpage missing ENVIRONMENT section wi o docs/84317 doc fdp-primer doesn't show class=USERNAME distinctively o docs/84271 doc [patch] compress(1) doesn't warn about nasty link hand o docs/83820 doc getino(3) manpage not installed o docs/81611 doc [patch] natd runs with -same_ports by default o docs/78480 doc Networked printer setup unnecessarily complex in handb o docs/61605 doc [request] Improve documentation for i386 disk geometry o docs/61301 doc [patch] Manpage patch for aue(4) to enable HomePNA fun o docs/59835 doc ipfw(8) man page does not warn about accepted but mean o docs/59477 doc Outdated Info Documents at http://docs.freebsd.org/inf o docs/59044 doc [patch] doc.docbook.mk does not properly handle a sour o docs/57298 doc [patch] add using compact flash cards info to handbook s docs/54752 doc bus_dma explained in ISA section in Handbook: should b o docs/53751 doc bus_dma(9) incorrectly documents BUS_DMA_ALLOCNOW o docs/53596 doc Updates to mt(1) manual page o docs/53271 doc bus_dma(9) fails to document alignment restrictions o docs/51480 doc Multiple undefined references in the FreeBSD manual pa o docs/50211 doc [patch] doc.docbook.mk: fix textfile creation o docs/48101 doc [patch] Add documentation on the fixit disk o docs/43823 doc [patch] update to environ(7) manpage o docs/41089 doc pax(1) -B option does not mention interaction with -z o docs/40423 doc Keyboard(4)'s definition of parameters to GETFKEY/SETF o docs/38982 doc [patch] developers-handbook/Jail fix o docs/38556 doc EPS file of beastie, as addition to existing examples s docs/33589 doc [patch] to doc.docbook.mk to post process .tex files. o docs/27605 doc [patch] Cross-document references () o docs/26286 doc *printf(3) etc should gain format string warnings o docs/24786 doc missing FILES descriptions in sa(4) s docs/20028 doc ASCII docs should reflect tags in the sourc 189 problems total. From owner-freebsd-doc@FreeBSD.ORG Mon Aug 20 16:49:21 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A19BD1065672; Mon, 20 Aug 2012 16:49:21 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 1A0748FC17; Mon, 20 Aug 2012 16:49:20 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 5B66114E7F54; Mon, 20 Aug 2012 18:49:10 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id elUo7ql13rEn; Mon, 20 Aug 2012 18:48:56 +0200 (CEST) Received: from [192.168.1.101] (D94162B4.catv.pool.telekom.hu [217.65.98.180]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 8DD2714E7EFC; Mon, 20 Aug 2012 18:48:56 +0200 (CEST) Message-ID: <50326A70.5020009@FreeBSD.org> Date: Mon, 20 Aug 2012 18:48:48 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:13.0) Gecko/20120614 Thunderbird/13.0.1 MIME-Version: 1.0 To: doc@FreeBSD.org, www@FreeBSD.org X-Enigmail-Version: 1.4.3 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doceng@FreeBSD.org Subject: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Aug 2012 16:49:21 -0000 -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Dear Folks, I'm glad to announce that the first milestone of the XML migration is available for review in the projects/sgml2xml branch. To check it out, run the following: svn co http://svn.freebsd.org/doc/projects/sgml2xml sgml2xml The build process - from the end user perspective - works in the same way. In short, use make all at the proper place, to build only web, run make all WEB_ONLY=yes in the htdocs dir, etc. Then use make install with DESTDIR defined to install files to the proper place. A rendered version of the website is available here: http://people.freebsd.org/~gabor/xmlweb/data/ For the documentation, you can directly go to: http://people.freebsd.org/~gabor/xmlweb/data/doc/ This branch includes the following changes: - - Documentation is updated from DocBook 4.1/SGML to DocBook 4.2/XML - - Webpages are updated from HTML 4.01 Transitional to XHTML 1.0 Transitional - - Static webpages are now processed by XSLT behind the scenes - - Webpages are now built with less cycles; tidy has been removed and the date processing is now done by XSLT - - Generated webpages are now actually valid (they did not use to be) - - All XSLT stylesheets now pull in a main XSLT, which reduces duplicated markup - - Site map and index are converted to an XML format with an XSLT transformation that generates the output - - For docs, there is now only one entity set for both articles and books - - Some trademark/legalnotice entities have been merged to a cohesive single entity file - - Untranslated entity sets are now always pulled in from the English tree instead of redundant copies - - The base and enbase entities are already automatically generated so remove inline definitions from individual files - - Fetch the LEGAL file via http instead of depending on CVS - - Convert id names to lowercase to avoid mixing different styles and for better readability - - All PSGML comments are removed since they are mostly useless As it has been discussed, the character entities will be dropped. This is still in progress but it is already a good moment for the rest to be reviewed since it is a big change that needs proper review and testing. At the same time, this also means that it is not easy to maintain such a big changeset in a branch since merging so many files is really time-consuming so it would be beneficial not to spend more time with merging this back than necessary. I would like to ask you to review this changeset and let me know any type of problems you encounter or any type of doubts you have. It would be nice if all translator projects could check their translations to see if there is any locale-specific problem. Despite the big quantity of the changes, the modernization process of the doc tree is not complete with this change. First, we still use Jade and DSSSL to generate output, which is an SGML tool and works because of the fact that XML is a subset of SGML. But it does not really benefit of XML technologies and the DocBook DSSSL stylesheets are quite obsolete. In a second step, we should migrate to an XSL(T)-based toolset. Secondly, the DocBook 4.2 schema is quite old, the current DocBook version is 5.0. But 4.2 is the first XML version and it still works well with the old DSSSL stylesheets so this was a safe migration path that gives us more time for the migration and for QA. Once this branch is merged back, the migration of the toolset will be started in another branch. Thanks in advance for your review. Regards, Gabor (On behalf of doceng@) -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (MingW32) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/ iEYEARECAAYFAlAyanAACgkQkC3QTyNzprGWhACfVzoyEb/WvXkiFn3cGIaCdEdU GzIAoL9AUJzc8WtNPyxH6PZnNKbvwUXA =i60i -----END PGP SIGNATURE----- From owner-freebsd-doc@FreeBSD.ORG Mon Aug 20 21:24:44 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx2.freebsd.org (mx2.freebsd.org [69.147.83.53]) by hub.freebsd.org (Postfix) with ESMTP id 5F64A106564A; Mon, 20 Aug 2012 21:24:44 +0000 (UTC) (envelope-from dougb@FreeBSD.org) Received: from opti.dougb.net (hub.freebsd.org [IPv6:2001:4f8:fff6::36]) by mx2.freebsd.org (Postfix) with ESMTP id 79CF314F0D0; Mon, 20 Aug 2012 21:24:18 +0000 (UTC) Message-ID: <5032AB02.2040608@FreeBSD.org> Date: Mon, 20 Aug 2012 14:24:18 -0700 From: Doug Barton Organization: http://SupersetSolutions.com/ User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:14.0) Gecko/20120728 Thunderbird/14.0 MIME-Version: 1.0 To: Gabor Kovesdan References: <50326A70.5020009@FreeBSD.org> In-Reply-To: <50326A70.5020009@FreeBSD.org> X-Enigmail-Version: 1.4.3 OpenPGP: id=1A1ABC84 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Aug 2012 21:24:44 -0000 -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA256 Gabor, Thank you for doing this work, and thank you for your excellent project summary. I took a look at the pages rendered with the new system that I have either worked on or had problems with in the past, and it seems that there are some undesirable differences in the new stuff. 1. On http://people.freebsd.org/~gabor/xmlweb/data/ the vertical separators on the location bar extend down below the grey background. Not sure if this is a byproduct of my default font setting being larger than normal or not. 2. Comparing http://people.freebsd.org/~gabor/xmlweb/data/doc/en_US.ISO8859-1/books/porters-handbook/rc-scripts.html vs. http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/rc-scripts.html it seems that many elements are missing. The backgrounds for the code and notes, and the colored text for literals are what stand out most to me. 3. On http://people.freebsd.org/~gabor/xmlweb/data/doc/en_US.ISO8859-1/books/porters-handbook/security-notify.html vs. http://www.freebsd.org/doc/en/books/porters-handbook/security-notify.html I see those same problems. I also noticed that the red square for the Important: section is gone, and that the text following the callouts starts on a new line, instead of following the callout image directly. I hope that this feedback is useful. Doug - -- I am only one, but I am one. I cannot do everything, but I can do something. And I will not let what I cannot do interfere with what I can do. -- Edward Everett Hale, (1822 - 1909) -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.19 (FreeBSD) iQEcBAEBCAAGBQJQMqsCAAoJEFzGhvEaGryEfeMH/2MShHydRq05dEBdPnSZOam/ XY43mDiV7DiPYBOVmE3zC6Rj5MmbQQKp2EidSVDgaiu6SpPNxMizSBDBcVybUAGA LR0TGKEfOKv6puDD3QHsTDLhiJvbaOX/QJU2YjezrAiZBlQYSP67U9SW/mjvCyQp 4OfW3KFB8PdwJx5/9AlZEW/yowchAu4CeUSYG9aVU2100YXbZ1b+Tq2OpWAmRqAY SX0FBe65eazrLHbruYIW8uzK73f8b4bziKoEme3e6FF5wuPEaiPO3TSQpqgdGXqs mHYs5S8kT4xZTMqWfXi7XTuUkP0Gyec5inYZYu8GUM72qSIpBDP6LfUw8U4pUAE= =eWz6 -----END PGP SIGNATURE----- From owner-freebsd-doc@FreeBSD.ORG Mon Aug 20 21:48:02 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id A3FEC1065670; Mon, 20 Aug 2012 21:48:02 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 4EEE98FC0C; Mon, 20 Aug 2012 21:48:02 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id A7FBB14E7F65; Mon, 20 Aug 2012 23:48:00 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id C17tV1hLyk0i; Mon, 20 Aug 2012 23:47:56 +0200 (CEST) Received: from [192.168.1.101] (D94162B4.catv.pool.telekom.hu [217.65.98.180]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id A127614E7F61; Mon, 20 Aug 2012 23:47:56 +0200 (CEST) Message-ID: <5032B08B.8060706@FreeBSD.org> Date: Mon, 20 Aug 2012 23:47:55 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:13.0) Gecko/20120614 Thunderbird/13.0.1 MIME-Version: 1.0 To: Doug Barton References: <50326A70.5020009@FreeBSD.org> <5032AB02.2040608@FreeBSD.org> In-Reply-To: <5032AB02.2040608@FreeBSD.org> X-Enigmail-Version: 1.4.3 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Aug 2012 21:48:02 -0000 Em 20-08-2012 23:24, Doug Barton escreveu: > 1. On http://people.freebsd.org/~gabor/xmlweb/data/ the vertical > separators on the location bar extend down below the grey > background. Not sure if this is a byproduct of my default font > setting being larger than normal or not. I think so because I tried in two different browsers (Firefox and Opera) and it seems normal to me. But if I click on the Large text option, it renders badly. But interestingly, if I only keep pressing Ctrl-+ it never goes wrong. I think that nowadays it is possible in any modern browser to adjust text size, so maybe we should rely on that feature and remove the text size setting and the associated JavaScript code. This is something I thought of earlier but haven't yet raised it on the lists. I'll raise it up when going for the next step of refactoring. > 2. Comparing > http://people.freebsd.org/~gabor/xmlweb/data/doc/en_US.ISO8859-1/books/porters-handbook/rc-scripts.html > > vs. > http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/rc-scripts.html > > it seems that many elements are missing. The backgrounds for the code > and notes, and the colored text for literals are what stand out > most to me. > > 3. On > http://people.freebsd.org/~gabor/xmlweb/data/doc/en_US.ISO8859-1/books/porters-handbook/security-notify.html > > vs. > http://www.freebsd.org/doc/en/books/porters-handbook/security-notify.html > I see those same problems. I also noticed that the red square for > the Important: section is gone, and that the text following the > callouts starts on a new line, instead of following the callout > image directly. These both come from the fact that class names are now all in lower case. I don't know the exact reason since I only converted them to lower case in htdocs/ since these are generated with DSSSL. What I suspect is that whether they are generated upper or lower case has to do with tidy. It did such things like converting elements to upper case or messing up character sets, that's why I disabled it in the Hungarian translation from the beginning and now for the whole web. It is also planned to disable it entirely for all docs but the output that Jade generates isn't that fancy. I'll track this down. > I hope that this feedback is useful. Of course, it was very useful! I noticed that everything was readable but I didn't remember to visually compare the results. Thanks for the review! Gabor From owner-freebsd-doc@FreeBSD.ORG Mon Aug 20 21:54:36 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx2.freebsd.org (mx2.freebsd.org [IPv6:2001:4f8:fff6::35]) by hub.freebsd.org (Postfix) with ESMTP id C614C106566B; Mon, 20 Aug 2012 21:54:36 +0000 (UTC) (envelope-from dougb@FreeBSD.org) Received: from opti.dougb.net (hub.freebsd.org [IPv6:2001:4f8:fff6::36]) by mx2.freebsd.org (Postfix) with ESMTP id 98D37153CB2; Mon, 20 Aug 2012 21:54:36 +0000 (UTC) Message-ID: <5032B21C.2060504@FreeBSD.org> Date: Mon, 20 Aug 2012 14:54:36 -0700 From: Doug Barton Organization: http://SupersetSolutions.com/ User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:14.0) Gecko/20120728 Thunderbird/14.0 MIME-Version: 1.0 To: Gabor Kovesdan References: <50326A70.5020009@FreeBSD.org> <5032AB02.2040608@FreeBSD.org> <5032B08B.8060706@FreeBSD.org> In-Reply-To: <5032B08B.8060706@FreeBSD.org> X-Enigmail-Version: 1.4.3 OpenPGP: id=1A1ABC84 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Aug 2012 21:54:36 -0000 On 08/20/2012 14:47, Gabor Kovesdan wrote: > Em 20-08-2012 23:24, Doug Barton escreveu: >> 1. On http://people.freebsd.org/~gabor/xmlweb/data/ the vertical >> separators on the location bar extend down below the grey >> background. Not sure if this is a byproduct of my default font >> setting being larger than normal or not. > > I think so because I tried in two different browsers (Firefox and > Opera) and it seems normal to me. But if I click on the Large text > option, it renders badly. But interestingly, if I only keep pressing > Ctrl-+ it never goes wrong. Yes, my understanding is that that what I do (set the minimum default size) somehow works differently than what Ctrl-+ does. > I think that nowadays it is possible in > any modern browser to adjust text size, so maybe we should rely on > that feature and remove the text size setting and the associated > JavaScript code. This is something I thought of earlier but haven't > yet raised it on the lists. I'll raise it up when going for the next > step of refactoring. That location bar has traditionally been a thorn in my side because of the default font settings. If we could get the same utility with a different (and less fragile) back end construction that would be a fabulous result. :) [ examples snipped ] > These both come from the fact that class names are now all in lower > case. I don't know the exact reason since I only converted them to > lower case in htdocs/ since these are generated with DSSSL. What I > suspect is that whether they are generated upper or lower case has to > do with tidy. It did such things like converting elements to upper > case or messing up character sets, that's why I disabled it in the > Hungarian translation from the beginning and now for the whole web. It > is also planned to disable it entirely for all docs but the output > that Jade generates isn't that fancy. I'll track this down. Ok, I hope that this turns out to be an easy fix. >> I hope that this feedback is useful. > > Of course, it was very useful! I noticed that everything was readable > but I didn't remember to visually compare the results. Thanks for the > review! Glad to help. Doug -- I am only one, but I am one. I cannot do everything, but I can do something. And I will not let what I cannot do interfere with what I can do. -- Edward Everett Hale, (1822 - 1909) From owner-freebsd-doc@FreeBSD.ORG Mon Aug 20 22:46:09 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 337B6106566B; Mon, 20 Aug 2012 22:46:09 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id E66228FC08; Mon, 20 Aug 2012 22:46:08 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q7KMk8GI084815; Mon, 20 Aug 2012 16:46:08 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q7KMk7Y9084812; Mon, 20 Aug 2012 16:46:08 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Mon, 20 Aug 2012 16:46:07 -0600 (MDT) From: Warren Block To: Gabor Kovesdan In-Reply-To: <50326A70.5020009@FreeBSD.org> Message-ID: References: <50326A70.5020009@FreeBSD.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed Cc: doceng@freebsd.org, doc@freebsd.org, www@freebsd.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Aug 2012 22:46:09 -0000 On Mon, 20 Aug 2012, Gabor Kovesdan wrote: > I'm glad to announce that the first milestone of the XML migration is > available for review in the projects/sgml2xml branch. This is excellent work! First, a question: will the .sgml filenames be changed to .xml? Second, a note on related software: a couple of days ago, Steve Wills was gracious enough to make a port of Publican. Publican is the RedHat doc tool, which takes XML DocBook 4.5 and renders them to HTML or PDF or other formats. It has support for .po and .pot translation files. I have not given it a serious test, but it may be useful now that we have XML files. Thank you! From owner-freebsd-doc@FreeBSD.ORG Mon Aug 20 23:14:13 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 68496106564A; Mon, 20 Aug 2012 23:14:13 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 14D448FC0A; Mon, 20 Aug 2012 23:14:12 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id A4D9714E7F69; Tue, 21 Aug 2012 01:14:11 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id Ur77P1NUAQX5; Tue, 21 Aug 2012 01:14:07 +0200 (CEST) Received: from [192.168.1.101] (D94162B4.catv.pool.telekom.hu [217.65.98.180]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 7BF8D14E7F6B; Tue, 21 Aug 2012 01:14:07 +0200 (CEST) Message-ID: <5032C4BE.5080209@FreeBSD.org> Date: Tue, 21 Aug 2012 01:14:06 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:13.0) Gecko/20120614 Thunderbird/13.0.1 MIME-Version: 1.0 To: Warren Block References: <50326A70.5020009@FreeBSD.org> In-Reply-To: X-Enigmail-Version: 1.4.3 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doceng@freebsd.org, doc@freebsd.org, www@freebsd.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Aug 2012 23:14:13 -0000 Em 21-08-2012 00:46, Warren Block escreveu: > First, a question: will the .sgml filenames be changed to .xml? Yes but maintaining a branch with full of renamed files is more messy than later renaming them in head. Probably we'll lock the tree for a very short time and do a bunch rename. > Second, a note on related software: a couple of days ago, Steve Wills > was gracious enough to make a port of Publican. Publican is the RedHat > doc tool, which takes XML DocBook 4.5 and renders them to HTML or PDF or > other formats. It has support for .po and .pot translation files. I > have not given it a serious test, but it may be useful now that we have > XML files. What benefits does it give us over directly calling the underlying tools? I see it uses XSLT to render HTML and it relies on FOP for PDF. This can be done with slight modifications of our Makefiles. Is it worth adding one more layer? It would mean more vendor dependency and performance penalty. From the documentation, my first impression is that it also introduces lots of proprietary things: directory layout, config files, commands and command-line parameters. [1] I think you can achieve the same things by our simple Makefile macros and direct editing of the XML files, which is not a high expectation towards doc committers but requiring to learn a totally proprietary system may not be that welcome. The translation support would be interesting but first we should evaluate if such a method is appropriate for us (having a small demo would be nice with a sample source and a sample translation file) and if so, we can very well "extract" the way it is done in Publican without having to adopt the whole system with the complexities and lots of dependencies. [2] Anyway, FOP is the best free renderer out for PDF but it depends on Java. Publican also uses FOP. Personally, I think we should get a compromise and depend on Java or otherwise we never will have modern features and outlook in our PDF documents. But some people will object so if we want quality we will have to convince them whether we use Publican or not. [1] http://jfearn.fedorapeople.org/en-US/Publican/2.7/html/Users_Guide/chap-Users_Guide-Creating_a_document.html#sect-Users_Guide-Files_in_the_book_directory [2] https://fedorahosted.org/publican/wiki/Installing Gabor From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 00:16:33 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 6AFAB106564A; Tue, 21 Aug 2012 00:16:33 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 0DBC28FC0C; Tue, 21 Aug 2012 00:16:32 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q7L0GWn3085076; Mon, 20 Aug 2012 18:16:32 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q7L0GWdo085073; Mon, 20 Aug 2012 18:16:32 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Mon, 20 Aug 2012 18:16:32 -0600 (MDT) From: Warren Block To: Gabor Kovesdan In-Reply-To: <5032C4BE.5080209@FreeBSD.org> Message-ID: References: <50326A70.5020009@FreeBSD.org> <5032C4BE.5080209@FreeBSD.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 00:16:33 -0000 On Tue, 21 Aug 2012, Gabor Kovesdan wrote: > Em 21-08-2012 00:46, Warren Block escreveu: >> First, a question: will the .sgml filenames be changed to .xml? > > Yes but maintaining a branch with full of renamed files is more messy > than later renaming them in head. Probably we'll lock the tree for a > very short time and do a bunch rename. > >> Second, a note on related software: a couple of days ago, Steve Wills >> was gracious enough to make a port of Publican. Publican is the RedHat >> doc tool, which takes XML DocBook 4.5 and renders them to HTML or PDF or >> other formats. It has support for .po and .pot translation files. I >> have not given it a serious test, but it may be useful now that we have >> XML files. > > What benefits does it give us over directly calling the underlying > tools? I see it uses XSLT to render HTML and it relies on FOP for PDF. > This can be done with slight modifications of our Makefiles. Is it worth > adding one more layer? It would mean more vendor dependency and > performance penalty. From the documentation, my first impression is that > it also introduces lots of proprietary things: directory layout, config > files, commands and command-line parameters. [1] I think you can achieve > the same things by our simple Makefile macros and direct editing of the > XML files, which is not a high expectation towards doc committers but > requiring to learn a totally proprietary system may not be that welcome. Agreed. I think the primary benefit would be taking advantage of a toolchain that someone else maintains. I don't know how well it would work for us. The nice thing is that with DocBook XML, the choice becomes available. > Anyway, FOP is the best free renderer out for PDF but it depends on > Java. Publican also uses FOP. Personally, I think we should get a > compromise and depend on Java or otherwise we never will have modern > features and outlook in our PDF documents. With OpenJDK, Java is a lot less of a hassle than previously. > But some people will object so if we want quality we will have to > convince them whether we use Publican or not. > > [1] > http://jfearn.fedorapeople.org/en-US/Publican/2.7/html/Users_Guide/chap-Users_Guide-Creating_a_document.html#sect-Users_Guide-Files_in_the_book_directory > > [2] https://fedorahosted.org/publican/wiki/Installing > > Gabor > From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 08:57:01 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 7B145106566B; Tue, 21 Aug 2012 08:57:01 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 2B82C8FC0C; Tue, 21 Aug 2012 08:57:00 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 788F714E7F7E; Tue, 21 Aug 2012 10:56:59 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id ldTKmgGg1rn7; Tue, 21 Aug 2012 10:56:56 +0200 (CEST) Received: from [192.168.1.102] (D94162B4.catv.pool.telekom.hu [217.65.98.180]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 6346314E7F7C; Tue, 21 Aug 2012 10:56:56 +0200 (CEST) Message-ID: <50334D56.6020809@FreeBSD.org> Date: Tue, 21 Aug 2012 10:56:54 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:13.0) Gecko/20120614 Thunderbird/13.0.1 MIME-Version: 1.0 To: Warren Block References: <50326A70.5020009@FreeBSD.org> <5032C4BE.5080209@FreeBSD.org> In-Reply-To: X-Enigmail-Version: 1.4.3 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 08:57:01 -0000 Em 21-08-2012 02:16, Warren Block escreveu: > Agreed. I think the primary benefit would be taking advantage of a > toolchain that someone else maintains. I don't know how well it would > work for us. The nice thing is that with DocBook XML, the choice > becomes available. I'm not saying either that it is useless. It can be a good source of ideas, I just wouldn't adopt it as is. >> Anyway, FOP is the best free renderer out for PDF but it depends on >> Java. Publican also uses FOP. Personally, I think we should get a >> compromise and depend on Java or otherwise we never will have modern >> features and outlook in our PDF documents. > > With OpenJDK, Java is a lot less of a hassle than previously. I'm not following the OpenJDK development these days. Does it require any bootstrap JDK to build? And once built, can we distribute it freely as a normal package? Gabor From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 10:49:55 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 20793106566B; Tue, 21 Aug 2012 10:49:55 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id C8BDB8FC0A; Tue, 21 Aug 2012 10:49:54 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 1E10014E7F7C; Tue, 21 Aug 2012 12:49:42 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id cxJlvqLkQjUc; Tue, 21 Aug 2012 12:49:41 +0200 (CEST) Received: from [192.168.1.102] (D94162B4.catv.pool.telekom.hu [217.65.98.180]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 524DE14E7F71; Tue, 21 Aug 2012 12:49:41 +0200 (CEST) Message-ID: <503367C2.1030305@FreeBSD.org> Date: Tue, 21 Aug 2012 12:49:38 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:13.0) Gecko/20120614 Thunderbird/13.0.1 MIME-Version: 1.0 To: doc@FreeBSD.org, www@FreeBSD.org References: <50326A70.5020009@FreeBSD.org> In-Reply-To: <50326A70.5020009@FreeBSD.org> X-Enigmail-Version: 1.4.3 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doceng@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 10:49:55 -0000 Em 20-08-2012 18:48, Gabor Kovesdan escreveu: > I would like to ask you to review this changeset and let me know > any type of problems you encounter or any type of doubts you have. > It would be nice if all translator projects could check their > translations to see if there is any locale-specific problem. FYI, two reported bugs have been fixed: - Rendering of special characters, like ™ now seems correct. (Reported by: bcr) - CSS has been updated to match the now lower case class names so code snippets, important notices, etc. are now rendered correctly in HTML. (Reported by: dougb) The rendered docs are updated, as well. Also, please note that PDF versions are also available, you just have to edit the URL manually since there's an index.html in each directory. For articles, the pdf is called article.pdf and for books book.pdf. Gabor From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 12:56:21 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 0508C106566C for ; Tue, 21 Aug 2012 12:56:21 +0000 (UTC) (envelope-from www-data@wpc0390.host7x24.com) Received: from svr1.mvp.eu (wpc0390.host7x24.com [62.193.225.4]) by mx1.freebsd.org (Postfix) with ESMTP id BDE138FC0C for ; Tue, 21 Aug 2012 12:56:20 +0000 (UTC) Received: from svr1.mvp.eu (localhost.localdomain [127.0.0.1]) by svr1.mvp.eu (Postfix) with ESMTP id B9A44E0D8E1 for ; Tue, 21 Aug 2012 12:56:20 +0000 (UTC) Received: by svr1.mvp.eu (Postfix, from userid 33) id 32B57E0D8DF; Tue, 21 Aug 2012 12:56:14 +0000 (UTC) To: doc@FreeBSD.org From: BARR BEN DUKE MIME-Version: 1.0 Content-Type: text/plain Content-Transfer-Encoding: 8bit Message-Id: <20120821125620.32B57E0D8DF@svr1.mvp.eu> Date: Tue, 21 Aug 2012 12:56:14 +0000 (UTC) Cc: Subject: BMW X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: barr.benduke1@gmail.com List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 12:56:21 -0000 The Promotion Department BMW Cars 22 Garden Close, Stamford, Lincs, PE9 2YP, London United Kingdom +447045768755 This is to inform you that you have been selected for a cash prize of 1,000,000.00 GBP (one million pounds sterling) and a BMW X6 car from international programs held on 20 June 2012 in the UK. Contact the department for verification 1.Name in full. 2.Address in full. 3.Nationality & Country . 4.Age 5.Phone Fax / / Sex. Address 6.Email. Barrister Ben Duke. E-mail: barr.benduke1@gmail.com Once again, congratulations. Coordinator Online From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 13:50:16 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4EFB1106568B for ; Tue, 21 Aug 2012 13:50:16 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 27F978FC18 for ; Tue, 21 Aug 2012 13:50:16 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q7LDoFrP006682 for ; Tue, 21 Aug 2012 13:50:15 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q7LDoFZ6006681; Tue, 21 Aug 2012 13:50:15 GMT (envelope-from gnats) Resent-Date: Tue, 21 Aug 2012 13:50:15 GMT Resent-Message-Id: <201208211350.q7LDoFZ6006681@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Chris Rees Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CDA64106566C for ; Tue, 21 Aug 2012 13:47:56 +0000 (UTC) (envelope-from crees@bayofrum.net) Received: from mk-outboundfilter-1.mail.uk.tiscali.com (mk-outboundfilter-1.mail.uk.tiscali.com [212.74.114.37]) by mx1.freebsd.org (Postfix) with ESMTP id 5CD9D8FC19 for ; Tue, 21 Aug 2012 13:47:55 +0000 (UTC) Received: from host-2-102-104-46.as13285.net (HELO pegasus.bayofrum.net) ([2.102.104.46]) by smtp.pipex.tiscali.co.uk with ESMTP; 21 Aug 2012 14:14:02 +0100 Received: by pegasus.bayofrum.net (Postfix, from userid 1001) id DA064138A2; Tue, 21 Aug 2012 14:11:43 +0100 (BST) Message-Id: <20120821131143.DA064138A2@pegasus.bayofrum.net> Date: Tue, 21 Aug 2012 14:11:43 +0100 (BST) From: Chris Rees To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/170822: [PATCH] Committer's Guide; update add/rmport info X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Chris Rees List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 13:50:16 -0000 >Number: 170822 >Category: docs >Synopsis: [PATCH] Committer's Guide; update add/rmport info >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Tue Aug 21 13:50:15 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Chris Rees >Release: FreeBSD 9.0-RELEASE amd64 >Organization: >Environment: System: FreeBSD pegasus.bayofrum.net 9.0-RELEASE FreeBSD 9.0-RELEASE #0: Sun Apr 29 12:29:02 BST 2012 root@pegasus.bayofrum.net:/usr/obj/usr/src/sys/PEGASUS amd64 >Description: I am now the maintainer of addport and rmport, so update that While here, mention that addport will DTRT with readding ports >How-To-Repeat: >Fix: --- patch.txt begins here --- Index: article.sgml =================================================================== --- article.sgml (revision 39406) +++ article.sgml (working copy) @@ -3455,8 +3455,8 @@ from the port Makefile. It will also add an entry to the port's category Makefile. It was - written by &a.mharo; and &a.will;, and is currently maintained - by &a.garga;, so please send questions/patches about + written by &a.mharo;, &a.will;, and &a.garga;. It is currently + maintained by &a.crees;, so please send questions/patches about addport to him. @@ -3564,8 +3564,8 @@ Alternatively, you can use the rmport script, from ports/Tools/scripts. - This script has been written by &a.vd;, who is also its current - maintainer, so please send questions, patches or suggestions + This script was written by &a.vd;, and its current maintainer + is &a.crees;, so please send questions, patches or suggestions about rmport to him. @@ -3624,6 +3624,12 @@ one step. + + + addport now detects when the port to + add has previously existed, and should handle all except + the ports/LEGAL step automatically. + --- patch.txt ends here --- >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 15:21:02 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7F41A10657C1; Tue, 21 Aug 2012 15:21:02 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 3857B8FC12; Tue, 21 Aug 2012 15:21:01 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q7LFL1K7091302; Tue, 21 Aug 2012 09:21:01 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q7LFL1TK091299; Tue, 21 Aug 2012 09:21:01 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Tue, 21 Aug 2012 09:21:01 -0600 (MDT) From: Warren Block To: Gabor Kovesdan In-Reply-To: <50334D56.6020809@FreeBSD.org> Message-ID: References: <50326A70.5020009@FreeBSD.org> <5032C4BE.5080209@FreeBSD.org> <50334D56.6020809@FreeBSD.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Tue, 21 Aug 2012 09:21:01 -0600 (MDT) Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 15:21:02 -0000 On Tue, 21 Aug 2012, Gabor Kovesdan wrote: > Em 21-08-2012 02:16, Warren Block escreveu: >> Agreed. I think the primary benefit would be taking advantage of a >> toolchain that someone else maintains. I don't know how well it would >> work for us. The nice thing is that with DocBook XML, the choice >> becomes available. > > I'm not saying either that it is useless. It can be a good source of > ideas, I just wouldn't adopt it as is. > >>> Anyway, FOP is the best free renderer out for PDF but it depends on >>> Java. Publican also uses FOP. Personally, I think we should get a >>> compromise and depend on Java or otherwise we never will have modern >>> features and outlook in our PDF documents. >> >> With OpenJDK, Java is a lot less of a hassle than previously. > > I'm not following the OpenJDK development these days. Does it require > any bootstrap JDK to build? Apparently so. The java/openjdk6 port has a build dependency on diablo-jdk16. > And once built, can we distribute it freely as a normal package? >From http://openjdk.java.net/faq/ "GPL v2 for almost all of the virtual machine, and GPL v2 + the Classpath exception for the class libraries and those parts of the virtual machine that expose public APIs." From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 17:40:12 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 560131065672 for ; Tue, 21 Aug 2012 17:40:12 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 2FA248FC28 for ; Tue, 21 Aug 2012 17:40:12 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q7LHeBTf035370 for ; Tue, 21 Aug 2012 17:40:11 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q7LHeB82035369; Tue, 21 Aug 2012 17:40:11 GMT (envelope-from gnats) Resent-Date: Tue, 21 Aug 2012 17:40:11 GMT Resent-Message-Id: <201208211740.q7LHeB82035369@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Edson Brandi Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id F406B106566B for ; Tue, 21 Aug 2012 17:39:36 +0000 (UTC) (envelope-from ebrandi@server14.ebrandi.eti.br) Received: from server14.ebrandi.eti.br (forum.fug.com.br [65.254.42.220]) by mx1.freebsd.org (Postfix) with ESMTP id B69958FC18 for ; Tue, 21 Aug 2012 17:39:36 +0000 (UTC) Received: by server14.ebrandi.eti.br (Postfix, from userid 1001) id 2928C194BD1; Tue, 21 Aug 2012 14:39:30 -0300 (BRT) Message-Id: <20120821173930.2928C194BD1@server14.ebrandi.eti.br> Date: Tue, 21 Aug 2012 14:39:30 -0300 (BRT) From: Edson Brandi To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/170831: New documentation: Brazilian Portuguese translation of contributing-ports article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Edson Brandi List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 17:40:12 -0000 >Number: 170831 >Category: docs >Synopsis: New documentation: Brazilian Portuguese translation of contributing-ports article >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Tue Aug 21 17:40:11 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Edson Brandi >Release: FreeBSD 9.0-RELEASE-p3 i386 >Organization: The FreeBSD Brazilian Portuguese Documentation Project >Environment: System: FreeBSD server14.ebrandi.eti.br 9.0-RELEASE-p3 FreeBSD 9.0-RELEASE-p3 #0: Tue Jun 12 01:47:53 UTC 2012 root@i386-builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC i386 >Description: Hi, Im sending attached a Brazilian Portuguese version of contributing-ports article, translated by The FreeBSD Brazilian Portuguese Documentation Project (http://doc.fug.com.br) Attached file must be uncompressed inside head/pt_BR.ISO8859-1/articles directory, and mailing-lists.ent file must be moved to head/pt_BR.ISO8859-1/share/sgml directory. It's safe to replace file with same name that already exist in this directory, attached file is a updated version from our local repository. Thks Edson Brandi Ps: If you have problems to uudecode attached file, you can download tgz file from following url: http://server06.ebrandi.eti.br/articles/contributing-ports_pt_BR.ISO8859-1.tgz >How-To-Repeat: >Fix: begin 644 contributing-ports_pt_BR.ISO8859-1.tgz M'XL(`+V[,U```^U]>W,\D40N*3OQ MW=IR@=/@L*7NQKC134K:VN^^YX%GOZ8IC[*U=3F56.2P&S@`#@[.^9T'"I'E M6;F/'C_^.GGX]8.'C[]] M].2;K[]-'CQ\\OC1H]\E#[X`+9U/HVM1`2GRO!)EF@T^M^[O/)C$_?N_Y+/W MU7R^G>#GC2BD3M1%\D,EY?.SEPFRA$A2F:297C1:WQ5UEJ?RF=()S$12R5S4 M,DVTNJBO125WMKF=MY?2-?%2+9H"F`K>5&5R4JEWB4_`A@(>457= M+!NIY<"[_/)QE2VS4N1`Q%6FX>]/D^K1=]]]_0W_^0^FX3]LS^?[V]M[7QV^ M>7OT]N=$[!3`[H4H=W!L67FADCN7=;UZNKO+_&_>VU'5)TV5?_^GN]UNGOUI/YS51,OJ2E9[N_36_DC+.]3LA.;[O@W:#SL0 MZ95:B,7'Y,[@"MN5@>GZ?_`UB52O7\!W9WK=&Y;_S_!0NSM M\C/M45SHL0&DJDO["IBKA^Z#'\Z2E:B$8\=-#.1"3QE#MOCVPXGF_J=0FJ\NQ2;FVPV(9GP%(D3``X5(#K"'#0T+FYHRJ+)4 M3;F04^9?E):$%$RY,!):8O)%W8@\^R3N+A8R MS?)G_C5H]ZY@>GFP&Q@3T3IE3,WR'-1.68V>8'Y1H">99P4H/"GPOL:G5Y4Z MSZ%QG=QK;1+?>'NKW-_0*%T'TX8Z<9"L3UIVJS+%*Q@.-`:1YHV0E MO)CW2#H0XM0V'/"=/VYHP:C]28.L1I4MZ&U9-;!G%D`([&[HRN]Z>KF6H@@V M?["P&QE'-4456S15!1U,6*OYBQ]/3^&]#9''_4ZA\$J+/%^S)X!YM%C"?\PF M]_.,;.LG.7GQTQFNS$:F&O<%D#9A#"EHP$=>,XER4"T5'8@JGHR;)JR7^ MB%1LE#TL15.(EUJ?Q*TM$.G6Z69$?'%*+58LWF7"$(4RMF MF-3B,UV1LREN<<-0BPGTRZ+)&2SZ'&##O?UE#C77_(2!7&25O,[&1:4]#7Z` MY_Z1DD3E@ZII"\!HP)6,=JZ,Q%9'Y>J:X>>Y'E4G_$ M)SO*TF:9:Q)2LRQ5,6D]^'3^ZYOCUX<)C6^59PN_110_#TH\/;*9$1!Q$P9Q M*1;O^T62)ZN^*[GG10ET!P*ILT"FM2^DRIK6)XVJ2A%__EQUUK[?019D(H$W M5Z1E;4A3LGU-&59S/M5RTG,B(R!40W0\8_R2DAF63U5 M@90>-"TV-"2F=1-XJK,?9B]%+"TA92:_4E%6R@:`+=[\35J"?".]K*90,&3I'\WX.? M#C9#(?8]A40U+KMYQ66QJN02YA&1+Q*%;,"(SB`D4EW*2:XBW3"5)@VZ;`J3,04/7JGK?`PMO MR"2`#B:-Y_H\DY-49Q)3I;HBJ=OHQCN$-N7@-<1,)+N9IO"+EL_6(7=OY'7R MO-$>NOMM@P"2YD`3.W3/E:Y568DT4R.C0)T75=[-'"4#ZC2N3>F:FQ_!>/+- M+)"O4\ZJ M7QNI$4/5.TT%QFU?S-NN:]`^&T?7N:\[0751X\_^M#\*9P;HRTI6RP;]<,E2 MEA8]JQ`\L_%W-Y^?`9IW2H$HY!K".S,P$`=824%ZPO0@A`]`?$M^P1X'885- M;88/+%$3N$$O=#81X=#-N=?USUZ<'6V&6*1@"J%RT52PC29/M);HK2VMZ;$A MM="2<0.*YR4L]@7PLMDR4^0+_-6^U0-[(USY14<7DSQEK,4TI&Q.#VZ(V&(: MXJ6+2;%/Z,U%G7^^JA2B-`ZRUF!=&(E4@TC:$&('5$VA'<[$+WO(GIT5Q*.JQ?DD6WQ^]O;@^:L->7BXURF37HLR%54Z/;(,COU?FQZ4XZY8 M5F!3/X-93ZM@`[_X\Y\3F9PXA_R'$SM&K-4O@1>"&1-@=/$.U@052A0 M>OD!]\W`VW'LZ87*M](ZZTTN7XG#\_],9>E_VLX"=6V7G38U) MH#0!NQOOX\&#!]\^>3*4_\GYDC;_\]&#Q\F#A]\\>/#D=\F3C5/2\_G_//^S M9_U?B_<2HZ\VUL=X_B\PQ\.'M/Z/'C]Z^.AK7/]O'S_ZYC;_]U_Q^?WV[R=D M[/[^<]-UL7F?C8N_#:?NXE\/JCI;Y/(I:1:6+Y-:)770_PF=!B_@+(8NH(7M M[9?'+_[R/:AB]/+V]IOC7]X>O?SY^X]2;V__<'SZ^N#M&?S]LBYR^@^8>Z!G M;__CZ.W??CDX?7OTXM7A+V^IB9\/S[:WC]Z`[?;JU2\OCE^?G!Z>G1V^_,OW MRT_NZ^,WKWZ._K:]?7;ZXNS[+=/_CEX6^?;VCZ>O?CD]?`5/_7#TS[]\O[6S MLVO_A_3^XO[PA__<>?'CZNOA25W"W> M[Z9JL;/B6=XIWM_YW&.J9_^'P]@(CXWN_X=?/WGRS1,G_[]^_"AY\#46!;C= M__^*C\___Y_-V]_N3]P'UG_[\\FAW=K)R8_/7QV]2.[,=W?-H[N[+]\2P<^5 M>I_\]'CGX?PYF"EI]+9)3QX=GKF&[9"- M@-+)85DCI'LFZ]W=D[?/3T%5_&/8[+.POU+5.ZOF'&TFH.S.T5_?')\>PAO_ M`8JK>0GM*OLS*M+[-"-[T`G\S4K#K,10:H3!!,H_V6.`2R,>"5W#CZ%\;Y>; MXIG>`VI240# M7L4=&!92Q$/:]6,R8VSJ2\6HAQLF?[K_Q7^IIN*?GPE MKHU;S'YCV]FU#8VT^UI4[X<:SLJLP&R$T7;M;V8(_%TNER)'&'PADRS]_@X, M.07SMGJO[R05S&;TC6WW;EW,18U3OV/LH6?=ORQEB3/\S/0==$3LNQOQ+WX# M#(M>HZK8WUM5&?3X,>9E7&*5&)O3/K&WZU^C5C1(D(?1ACB"-E3:=/BBS>6X M]@?#6V6(@^S(#:`#7)K`E)V+_%*AOP\,7MCA:7R+F$[ M2?+&!J8B[\M*%@K+K<`/"UG9EP5\5RK8#KH#GS4(/ZV4SL(D67*O\ZNV#HMQ MRU4+F56*NDJT?">2"]O:(LL)G@/*LD^BFKF^3;(TXC<4\)G7`G"_$)FLE@X#!1 M+[P(8%EG7EFL7<9V>(%;0-,"2AOY82%S[)CIH9&^:U)1\:CW?FU4C043>!A[ MN_R[FZ1\:22PRVFAI77D9`42(7`JKM3"(&".-W1M5R$`V"LX,2LB9$4;*%OU M(*MN#LK:!HR4C9@EJDG$2I:"&`2$K;A`KLB`]#JSAP7^)1.NBD"//83E@$(W@R?DJE*-)$O"`^>8%@G3(^64=<"V01PP8S`2L MM%\6S&K'<$4WNSP2."`Z[Q&?$9O@?`.+EKCKH(<53%3!C&Y:"=ZJ,6T'YNP2 M?N?`SI1;QKW7U+A!"EFHH!1X7;NMS/,HJDQ4P0$&1P'+02<22;I? M7XIZ[M1X>2>2D\?M:22J>+?QWB+6[Q.;AV;S7@5U$A!^*T&NM`[Q5OL!JX;; MN,`1(U>Y!J\PI==+L,'SW$DF@4*E2,X5=.U[2;-^1_-%4U)8-2W\TY"#>9C0 M?)%]DBE"B?N>!EWC'_`LYGDH:2`H#Y>PD:R83>CP`WHL[`T])QCK1&V4[S'^ M_+TL88%`_0&UBHRK._N+*I.X'\US7FSYX>)/"DP:B:B?>>WN[GL1AHFGQ ML*,EFBTR<>5K"EGQJ=$F()QP9!H?8H=)8;2Z10+GWJ6AGI:S1%](E.VY`EFPJLU4P<_UQ+GZG"DZB_9%C1(S@=5! M:80R%3K''YMBI/=9CWSA`>%+;E!V6LRXC`1:51@-*,QF%$L0O23#MF*]P\_6 M;Q@K'-2H;07CQ=`@'+$Y?,BN4%5PAB`=E=VIJRQ^FZ1(ST@OL@]S$*;PRQT, M5T1KC]H\;Y8XJ:.3B8,'&SM5Z\?)O[>W[X!\C+9?9%3!8I>TQ!0$/,QB0[*1 M9LM8NPK$-_XIA1,IS?1*E?:4OI)Y*&JM)I`LF\Q.[QR.NY+T"L1I2E7]_YR[\=^<HR"P98!+1M`&+8LQ$K75LI/`[>YM+=1# MR8@$A9U^_95E]?86ZAN6R(+M":L6>N,A8'B)R!-2NO[P'SSX@=R1T4#K=P^# M60.N!M:T-**%L9658+\(B]W`@'H--CK4QU8M.&L:C>U6?%%AT5IGPJ$5>H,JJ@ M2E\":X,FD")&1EO+:H@[JX]_\;]]3\_^\?&#X/T[^VW^6M58F&ZOIBC M`/+<ZNSCXP)FL3DV(C[Q55@`?S9M1?/W4TL?1*17G5=LR8XVB_L-I%X9KF%GRN"!DL5FBSK&>+DE-E3AP)$7X(I.>?:0!.P8:W>X_;D1\L/LECE:A9N=NIE_EW8 MSWW8[,2%(_O<&U_=22*X'`:*"D>FVV9;<-Z0-]$E&L+LEH(DURKKRW"ED,\P M3K<]BGBN#HD]#083BF[$':$;L1*?J(Y`"M*;8K.KA!AK6)?:"M=4)Z,2$S>^ M17.&Y['E"3`*SK"V0X`668%C>Z1?H3FIP!C,*DSBJG#`,"UH_S(>%$X0K@`( M+#RC$='8(O'1,HE;UF-;1=*LHC:L=;5,1:#HK2C.O1:1RPR1RTB$CVO[5EL/ M]'0C6F&N@C&^!08LE>JFD4,*'F$L)'@[,#M4B";DG9#(%R78>!_J(4Y MGMG>8LP/`_1,7R,BO2V2$!NLO'$`^CVLIK)J9G#8;V\9ZW=$K1W6($K8(84R MB>,%#0IK:KP3J#D^%QQ[>0&J$70.LS:J5QAL&4YJM!?,R;Q"J)\B%$'NH5J: M,5>>G";WVD=X>(+?9QD%U('IZ6-2@:HSG/VAP3(TP,H#^^0&!`7(:"T#+($0 MC3)E]]R@?3KK0`D&)C4#0^8`/B'$%[@M+BEV.A+#P$L_*N00X1?%#0OD7%MLV+:XP>4I\'M6<4QSR+)Z>5I`2X:&I^#"?.+G[08,`X\H/`BKN5 M(VN6('H3O1[724S'^!3FXP(C'PHV,N7B,FAZA]4`](U?R4_X--IO#@YBQW@J M"_+.D*\->?*>H!:3-0P-ZE9T!`1:0<=?H^_W'Y.#H$3K<(I<#]I"B7Q`^].) MD94VZ-]:W%[839-CK:I#JC8C>F M@5"VP)-X7*$HT!WL0AM#-X"['163E!3KIJ`U,*Z>CW.:<5!\P)ZZTU)93FXP M-N2HFZ$T+ZIL5!5*(D`%)D5>&$`;0PU*]-UH$`ZV-T6/N:+ZF/L.O`\[P60F M5R2$1B1=C.R$OFM\$7TV6=G`T2>LI$-W`]I)$EZ!7T*0O449Z1V#`M@'`""N M&3/V]E;7%Z*=,V06;CZ.>M&)]:+A/($J3Q:G($\PV10H(3C)UL3]8(9L;\DT M8ZV!.?1.DG4_:OP&IE$E/H5DY>SUCU#/D2/`^C$P"7%@R@*P#4YS='>0WQ7/ M"Q1VK!6BUYDLUC"0`6U%&\E@QM_RSI)4=XYO88RA/.C2&+ICVR(#(PI,>%X& M"ZGY^!3WW@767,8J)Y'8W]ZZ<8`)G92]6-;9(QX/HL4J"N1 MV36HDB7&5!``AZ<\9MIFQLW,DOAIN_G8B;(5NHXX):@0N3'^`TGS1EW1656U MLL&=<9!"?#."0?8L#!Q"P3YE'UV MV-Q&(Z$@=:_SCJP5NGND,69#0YW.C@R1+VB?8%UA7_T<7KG("OMZ MZB>#>#K8+41O=IY98!FZMF_!IO8H#I[FT>$3IKGQ_SX/$.R,(?)X`(8+'.X5(MK1QI' M;J?K81`?99=306=..(RPT,@2AJN'Y)!V48UDI9(4-_@0OQJ>V9M>-BQ(U(=3 M>RK:L7VS/K*23G7P_J4[L9J"BU#LZ)W>2@/NK@BN,!*S(<0GCF"3`W">?8EB M%MWFM&TD)C:4]\X]M&5@/SD9?"X=RUQ1Y&<<'Z=6-5OI"4RQND\.X_[>"1)W M89.A$@?"CVN3FR>'^<'N;#34'<]Q.J\;I&9GR>C60HBGH/E:H'12VKUN;/Q- ML]8+X><=W0F4Q-C+%3\.Z^G.I4,BQ`1^N(.B,Q&P;FQ+X=PM+]FAKTFY#G&SA>7H$-!]^7GG]_V1;\+,[2&6/_]EYT9 MI>C4&I/!J+(2=-LY3&?5U"88=<1([6&XXX70I'D7'!J-&XC-APX[V3Y-!')J M=7MGIXT=0XY1$WIMHA7*J\8PB<++S/`-F@3F>!7;`>RQ,TU(\Q1=R2Y$LF8E3".=N+=)[JS3`73J=>`S M:J$^V,PCI(&_YRS!8[#48GDL4"@+A3#SD56N+D5T;N[$YWF%$ M%0YH\C9V2%,$7UUE@4A98@NPTU^+C#$>D@JX3#U\8NL?!L%\X90,A<.,J+J1 M.Z+'*"U9H@95#M:X]/#I8;=>.#DXAK2I).]\V,.K>,__D+&G`(6<3TT+U*!! ML[U7")@8#YR^2/7E=FM5D)8?!-MZRY]*L6!IYE[5FVJ2=8&%V7HZ9W1_5N45 MWG[DH572S'GQ+!["MM1+G5S+"(?.BZY]X\[2,)'"Z($F M':)F^RB,4':5%=UI:K1"-68WE3Q9[/.`[:'3AJT:P$@W[.#&#WXT+! M@:J-NQ/5Y5]MYA,]$"&H]M4R]"&ZI`LQ+`GFH@5T;1+U2 M_HU;N1!?YN=A?\:5`Z/["$R4%ZD*7?W:R.32Q-=;S8_W?%BA:F@G_HDPM)K# M2_K<#&X/M@.\_>$P?#+$LHH\?';\]R@\A\QBX8*.<=8KGDWW[@7JH$K?9R:W M0^*XY8S#>NR];D6LW['L'A#C1P:HI"B4(0VH5V+_F[73R-PW$1:H>':.J9E? MIJ"S-M`G)LK),-##^!_0HJ6PD0`I7(R7%U*[9G2:Z)L\OK$YP.I M,WTI3F6D>I@J=KUS?T@>:N"6)J.[[XSU:UZQT8CKL#;O$>"F6PX!-T1G`FPY MEP08:Z!;\ST)OE\S-R.)'ABS@;LECDNF5U9*ZS!Q`G>]+_R=1-=5ZQUZQ44D MHV.H,%M_6)_:.ICPQ8R=>I""B$9V#26AFYZ`=E^%.<#AQG,RSYL%]C]G9UKC[L[89?OU$QQ)#?J1FFG)Z\9TAU'>O5UK8V"2C MT])1C%9!D+K84E818[-WXTE^.LTJ&0=K2_('%_U!]DP.JEET,OB_6=S%9YTD M-^1?/Q^CNAA18'HST;E8*PX?@I6K=QX^L\&+F`TEF&,]DVR40<89PZ9M&P)@H,K8!'FJ_$PMW52E6$(SC06)IF.-*NM9)UOA[5B MDMXP/PD/&<&HF071QZDCSP9OO5:4SVB4K]D4+,6M*&(TW09*^67AG6>ET[`Y M;7&8CM[',T%I*PX*(FF).??Y)6R'9Z![TR3PT$NFS-W/@O4X9J/8)&X(0JMY MN[+#C/WOO$^N`IO`XN/>F^M6V`:#GAR?OCT]_.GH[.CX31`BBI$6RFBY:`\8 M88J^"-*W!<)2/'\A&LH9V^'%T4RE>:D[E35'#F("7/\FL`5"P^_12#)+:O=Z MLUIBO1'8[F-[A-6/W8[^L49AXMC!F^JM_!:5-QCF))"<5Y8O/::1(A>>%UFK M=*PULPP2TA0.+Y0?XCM`6Z*L1PL.04-26-E\T[9H1OBHT5]QGD,-U?4>[X+H M1`J"MA=6Z"I3M\>M4!M5P.)@AR@5SW]FE?>M&)\;58D*25 MLN,'[D_UM7@;Q]*:^68R./%8X;+LM'3<$J.QW`C9B]H;P"Z)3:`=572.7&%R_$PB97VM"'T`6"6S[D%WRES9XN MK=+'^2/+<^P&QK+".WU'M\TZ6)]V0*EC$7*=-SL7C?+Y#/Y-I9\,[CQD<86<&R-4<(.VE&(^!A7(9Q?BM=/*3BV&T'8PZN8A1%8UR#TO^J9H"TL>>8\+%8C M,FZW`2_<@29?@[1%C,:=<39RC;0)XU[GL-8H:FVJB\Z-B`]=G_`IN7T3R.&# M*9!(4.%]M%!A:1[UU?GLE*$`.TOJ<5CD!_..`J1BN'`@N[]Z\UB6''UNUIJ= MTJ8J%=A@&!8546YN^8AK#QI8%[/O6L$!QIU'(2L4ALY6L6ONNVY[K$X'7?ZY M\\P,S_$+$_EK)!J]8^$UO%$)^1H.GEIB2LVLQZ5:N:0[?+71H8!B[T'87##/ M)@$V!N1Q"3$_'F'X4KDN4(HS.`5&0MES=3SC" MK.4>7C6IK'R,/Z_8R'(1*DU86+C=>P-T+,O]&!+/*@0FF`C=N3$V\!32N,R`%E61I9E$RNUD_^SY;-Y&Y@%&HV2K8<(22 M>3EE%5%9UJ'RP/FPOU=4,T,A&&;6E6!NU_$YGP0M1S:1'!H!7DDSET4 MW4[/"AL"N)1O2V`9YI1A2"TEFUK=O+!^'$T6.A(4F:DF`9W56CXF'M6IP*?(& M8;()[3KXCDH=IMY:&9*8LR"7GY^,B[+`]OMX*>J=J*J*^]I:S;/$!P^J"/$Q M#5U?7^^88BY-S8WHA2C+:%#.6\'!*USZL6?JFL!IV!1;3=0AK6%;5 MO!RE%T0;_,+NP%(D:Z]!7*#M,?RLIWVE:ME4`0@#!M")S:H M9`2G**H_LI8B9!W5L*](6$:B3%C4S.&?P75,#PJ>]I)E8>J78AB7Y57>.CZ=]X5!3(R1>X>2/ M%%KX/'_A,5$F:/.1\T"M!C+$8(I$$;I@T49I!=J/>F[#L*2!?KBL"?F7C8_( ME>79E?6"?%8[L-,N@GH]]S_34>K=[L*H='C:&*.+IJ,PI@NZPXR\F;$#BUD] M%<:J)\_4^^4.\M'.PV>?2U`GLHS@`I<[$NJ#+5=X+UG>:];@1"%AB"W!\_O) M7.SMVE\^CUP3JL5%O0>36&(70^JHO)!`/:N+H5;O MRCBZ6'*=87!/$%]->C2%PZF'O2_?P27`3L/JSO,L'&A:*=W@YYF&>DAT2F6E< M)=HBB7P2FASS:HQ*=\)6'%YH5124CW6@+O,WE#.LT!'8G!>@_KACUX<22WK0 M%,QEYQ][=V8&D\,/_DWKX*"_\<3'89LREU!2?;_:%1AAH= MNS^JD"-J:\(X_%PWX(2M+QK2 M%3AMM!7PD$&;:*"C;JDX"I/=6OUS%H;V8J,AI"TF<:*-=B.[`/9=UNLWNXE; MR/F%@O-HJ*PK79]*?SXY)6KQ*<)Q4V4CK]?7.;RACT@8+Q%6-Z9=U$ZG"86A M26>.\?9C<_'KL_^#-.X/")KLH5+IR:TWZ+57.8+/=4AJ[5LV4#W(!3-^L,I]H[0 MV!GOT&"2"#_5H(V:K%&0:2X3"!T/#.&`C:30.!)='\C&8+ZU(:1!(:(Y\R&@)#BPTT>.`@"BEOI`L70@X:4>5I6,` M'N)N84'EQ3+;1?GT<;ZJYKHI\+:L'?CR+_3EG?WG`IC!RZ'DI3`0S7@DR!?%)<0*T$TD/'R-;@^)2^+P(%^E"80[1_N0X&;IFB`O^X&4F MX3@#RDP-J^C"C%8RPXS!\U`5H(NY?(%XXJ(T^R2KSK4]KLB6ASPS;1!3+D;D M"Q=$?*CAK?!6!/M^$!47@ALV&*?7XQ4,N#0E"LTD/WP<8"MZY@-$QJ(D_!*D M@?/5U#>+P(ENK44L^.GT"\4%R\9I;BC[7#`47,FE5\K"6@>^;-LQ) M)L5ZQ(UB/%K(H@?T*EBWK'*)6&*4Z7BQNY=[+$W^N:-OGJO8*F;E.5C+&!UU2VIL83O9Z^ENG3.; M@BI_9(5A4?6FH^!M*.20@'48I`^4]#(X/8_S\SLLVIB.'!94\G^T;'J`L*2[T) M:=,+K!D M;70L=77E>#'&$Y$G93[/?%'"=>,BU3(N">GNG`R<=>;NBMY4>76!=_GD)'A6 MILI<+\IQ(US/0^4WP,@#1)6CF$S.65"DWLY&OZ`=+)GJ.#&(+A_2FX*+7SGJ MV;[\VEYE#3M@Y@'VQ%U!T!-)YK=`&W3'^2:?;(R2]X40CZ*G=#5LI:Y^$X!M MIGL#.#:#UU?=B%@G*C>.8YL+!5JI\)UTJ\+>I0`SYB]7N%!YKJZ;%5W,:E[U M167).Y/96QA:C''?W+"`4*8S[&.!;Q:=$':Z/&A@R(Y-#)%K1(ZGWYL'9AAH M6)HH?V(+T;J#A\(7!^;HM^*4%J;\`6V53NW(#KKX@_AD)8Y`U*>7Y8("E\3E MM)5M-4JK.I6=S>MK%!>,%MIG\?5"N&)L@^D#5@:W4B#P=9A0.,^:'%:`CPMG MY+&M>AL7),E"3PL(Q=EV66+/1 MM(S($Y?AI;GONA-P]L\;C0"KKU***RY(D^/0*QH*3-J*[GY%3>VU1#]$RYW8 MZR`B0-L='+:BNUTA>ZDJ@9RT<^SLGYZ\[@]R'ZAISW&S#'DBELO\P:[>D*-M MW'NIDE=9V7Q(_OGS_Z.5/J`=DE%6O:*<7%-"G2;5F)T!'!M1.ZWN_CVN3D13 MPD?:S#L#%KFHU'W,6FJ6F=%@:"14,Z0PZ0I1Q53+3E;)'*PNU2V4BXV%D(2] M8;L%CD7%8VGMB(^H"A3&?C7O[(;PL7`P6H6W>$?MTT(8<+M5B[>;*1;9`9R^ M;4H9>Q.^:[COM0T@QDR,@]:<0M'Q-:1I1NIS4$I\M&AV)/YCNZZ?,E_UU3OJ M(FVT"H,EQM0M'-I;#!V_,0TF-M$E-5IW=DRDYEC;_S%"Y@\M>PO!.8XSD.N0?[?3EOE-(R*;Z*=RVXJQE\X),;E)@X7 MAV8EVF#DZ)%>A7DC-=5CLR>82I4!!X=KFCIG@0E?H?@S35=M&MN*U9`^R_*0 M/%8XBHJ]8V%Q:[?=C*>YBA`Q4S!"S0R@3Z%5!8ET-Y?;C$25M9O.P\*$T:"1 M!%M"8]50$IHSX_0GV4B"D>_U%6M+8I"`LXG74?YFVS70E7HQ!,]I33!N\\4\ M)P^ZBF%ZVZ17X8+=CW7,3IXIE47&"VBL MX06,`2N:9D26#4$J&)FDPGEM]QB<3US*C/;15_-YHHLLEQ^3^7S_Z3R^A"A0 M*OTO8W<2A9>0AQ<2O5(+82O12!N9.WZ;L2'`WDR^TWLI$85I8=PZC)="G*0V M*??GJN28!@Y);4/8;<-S-.H]N+G'7/GIK@'ONZDWNN>C_W(\@RHA=MZ]`OPS M/9!8\J"Z$`L[N&MY[B+^$6E!!R5YETTDAQYW38:W>\,)C65UZ4`!XR^X`@-] M@K'#A].GN1:!L6>L=\`\GTZZ8"PHOVGM3LJS1)'>8Q`'6G@A6`:XV[K\#51F M'`DFXF=<;)NNN"C52DO=-I"K(%?)7A[O;D?TO`,LH:C@!*8/4;T$A7=S84WXGJNK[Q8##%81;]*`S8[9[#71?JZQOGOFQRX/=K?_ M^IY'KP`>C%E-[=IQU4AW(_VAK=POB6"8V!5R=H.>GQW\_#"L$W;,2"]-!S.AM5,GQWQTL M,EJ.O"G:G-)SQ4XXK06"2'LA2UJALWE1:N//[[+'XEU/)D1".\A&[I&$'6V?`[:0AZ? MV6<$B)KR%-A(U7<$'P27:7%@H96$=(V*N8,6RS!PK24*4S3C:1W*H;A-+"P; MW+]FPY&XLHZ;4ZY_C/@A?ETK&/5]YR_MTIHF@^N'R$M;M]9HH?QS95"&<;$H(@!6GN^^7I[''Q6:*QW`+*2XZR^6X\DTHP$&.7G)\.?PO^V`*"<$JFT9X MX4U00V2,#,M5CY.:=13)(:@_*^*DOYJ:%<;YJ]H3WS[*[T7#+Y9!+!&61,:I MQTO#+;D$$&;L5@:!II:VP&E"MZ:O`97MS(W>)[-NG]E&A#D:^[6&.#$;S5W> M*>XH,,U<>MPM"/RZ1W6Q[+4K;2O=P`%6"_#&?O((>Y'Z/A5F+=B8IHN8"XKJ MLU%HTM@WK:-T0.4FI]/P97U.![:%$5V^7M`:):ZY$QZE:(K5]8E;_:;@B+RU M1TN0;!L>+*<&_0UJ)@5WTPYN?=<['/CBG*[VJT(?FF?]XQMP3"K7?UQ<@DKID"M6E>E>YY'#PUWA@2D((,56%4$'A9OZKWK,QF-3 M$?!S2P'R?(V:>0Z!:Y4"3.R=(/:<#6X-756Q=Z#$4=&2].G9I14*@Z4;V2+X M^L&#)X;_G&O.5.?`*,>'5B!G>7\D2%".S-N7ZR[]!2M5V5/-Z6G=BXK"K$LJ M\,W+TN^8"!0"3KG`@PECU2J+%7;3S:`^;<`!]M; MSRTV,"UJ67*..V'%%7",8.RZEQS!>-"M)/YC%AG>AT3;-ZN M/XDO?;#5(ZB.X:5MP6:R#T>ID@IP`4>CKZT.=E*#43&6RRE\;^2L]^5PI]OW MHT)B)[#^!MQ2@6'LB=GKNQ)7ZLB?I4.ZU;\5QO*T79IG=L?EP,?Y`8J@>S!>M*ME0$)5!Z M2I_TR*]!=BP=4X47"OAI&QP+7MX7%:$+!W=3T+RV]35MKQ8J>WUP]O;P])>S MH[>'9P&`UG-W1Y=CUJS"E$L1VFJYM:N-\X2OCN]2%(&*9YA MH*H%*&Z[5IV/DXON-(!?'6/JH7?87V=JH9%/TKD!D`!@_$OAV=M4KV"(O">` MB2H1XN(J#%EM#2@TRL)NKN6YH2(T:#OW]"1.D/BJ`K1Z?%;-BV51[P9+Y1Z* M.-Y.850TUK#C^H+5Y8B[Q76]@TAO`X*GV('_PZ'Y-RQ9LQ)+BBYP?XR.+HPI MBF!KG MZ#IC"#&XDH&2S"JP22T'V%3`C,,_R-[.56*OZ+!IE6LW#%5[G7"[0WNCNEGJ M2O)+V3@+G/(G;3#WS',O[_(6WDS9;K',VX/=>"E`L=PW14BI)*0[@-$/K`4H/%$'!!5E62[W#W-^NU<18CN M=B/S@YA!L*BP'G&7SH9CUM$[(I`QK-$8Q'8-;(>P>(6Y7V].UTVT+^$CYRM( M.;I?#T/),F^NM7*IG9([9@4@0,C]'SV84+`_`Q6@)F(\0;8`<4# M)#\)X`U0Q_53_*Z`!I\F>EGD^!O^.\\(JIJGHA9/D]I]K3";42R?)F7FGQ7Y MM?BHY[\VJI9S49,R".++O'=8ID^WY_/][=_=?FX_MY_;S^WG]G/[N?WRelease-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 19:19:20 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 59ECC106566B; Tue, 21 Aug 2012 19:19:20 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 2D7E88FC0A; Tue, 21 Aug 2012 19:19:20 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q7LJJKBJ046474; Tue, 21 Aug 2012 19:19:20 GMT (envelope-from gabor@freefall.freebsd.org) Received: (from gabor@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q7LJJK5R046469; Tue, 21 Aug 2012 19:19:20 GMT (envelope-from gabor) Date: Tue, 21 Aug 2012 19:19:20 GMT Message-Id: <201208211919.q7LJJK5R046469@freefall.freebsd.org> To: gabor@FreeBSD.org, freebsd-doc@FreeBSD.org, gabor@FreeBSD.org From: gabor@FreeBSD.org Cc: Subject: Re: docs/170831: New documentation: Brazilian Portuguese translation of contributing-ports article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 19:19:20 -0000 Synopsis: New documentation: Brazilian Portuguese translation of contributing-ports article Responsible-Changed-From-To: freebsd-doc->gabor Responsible-Changed-By: gabor Responsible-Changed-When: Tue Aug 21 19:19:11 UTC 2012 Responsible-Changed-Why: Take. http://www.freebsd.org/cgi/query-pr.cgi?pr=170831 From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 19:19:53 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id E29861065674; Tue, 21 Aug 2012 19:19:53 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id B57C78FC0C; Tue, 21 Aug 2012 19:19:53 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q7LJJrVd046598; Tue, 21 Aug 2012 19:19:53 GMT (envelope-from gabor@freefall.freebsd.org) Received: (from gabor@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q7LJJrIb046594; Tue, 21 Aug 2012 19:19:53 GMT (envelope-from gabor) Date: Tue, 21 Aug 2012 19:19:53 GMT Message-Id: <201208211919.q7LJJrIb046594@freefall.freebsd.org> To: gabor@FreeBSD.org, freebsd-doc@FreeBSD.org, gabor@FreeBSD.org From: gabor@FreeBSD.org Cc: Subject: Re: docs/170710: New documentation: Brazilian Portuguese translation of freebsd-questions article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 19:19:54 -0000 Synopsis: New documentation: Brazilian Portuguese translation of freebsd-questions article Responsible-Changed-From-To: freebsd-doc->gabor Responsible-Changed-By: gabor Responsible-Changed-When: Tue Aug 21 19:19:41 UTC 2012 Responsible-Changed-Why: Take. http://www.freebsd.org/cgi/query-pr.cgi?pr=170710 From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 19:54:46 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 934B81065670; Tue, 21 Aug 2012 19:54:46 +0000 (UTC) (envelope-from simon@FreeBSD.org) Received: from emx.nitro.dk (leto.nitro.dk [178.63.52.6]) by mx1.freebsd.org (Postfix) with ESMTP id DF9688FC23; Tue, 21 Aug 2012 19:54:45 +0000 (UTC) Received: from mailscan.leto.nitro.dk (mailscan.leto.nitro.dk [127.0.1.4]) by emx.nitro.dk (Postfix) with ESMTP id BCFE72B753D; Tue, 21 Aug 2012 19:54:44 +0000 (UTC) Received: from emx.nitro.dk ([127.0.1.2]) by mailscan.leto.nitro.dk (mailscan.leto.nitro.dk [127.0.1.4]) (amavisd-new, port 10024) with LMTP id KPPDsfhmSW_A; Tue, 21 Aug 2012 19:54:38 +0000 (UTC) Received: from [192.168.4.24] (unknown [89.100.2.68]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by emx.nitro.dk (Postfix) with ESMTPSA id D78CD2B7532; Tue, 21 Aug 2012 19:54:37 +0000 (UTC) Content-Type: text/plain; charset=iso-8859-1 Mime-Version: 1.0 (Mac OS X Mail 6.0 \(1485\)) From: "Simon L. B. Nielsen" In-Reply-To: <50326A70.5020009@FreeBSD.org> Date: Tue, 21 Aug 2012 20:54:36 +0100 Content-Transfer-Encoding: quoted-printable Message-Id: <1FDFD92B-36C6-4BE8-88FB-8C6D2A759954@FreeBSD.org> References: <50326A70.5020009@FreeBSD.org> To: Gabor Kovesdan X-Mailer: Apple Mail (2.1485) Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 19:54:46 -0000 On 20 Aug 2012, at 17:48, Gabor Kovesdan wrote: > Dear Folks, >=20 > I'm glad to announce that the first milestone of the XML migration is > available for review in the projects/sgml2xml branch. To check it out, > run the following: >=20 > svn co http://svn.freebsd.org/doc/projects/sgml2xml sgml2xml >=20 > The build process - from the end user perspective - works in the same > way. In short, use make all at the proper place, to build only web, = run > make all WEB_ONLY=3Dyes in the htdocs dir, etc. Then use make install = with > DESTDIR defined to install files to the proper place. We really should fix this (the magic of en/htdocs building other = languages too etc; DESTDIR not meaning what it does in base etc.), but = that can be done later. > A rendered version of the website is available here: > http://people.freebsd.org/~gabor/xmlweb/data/ > For the documentation, you can directly go to: > http://people.freebsd.org/~gabor/xmlweb/data/doc/ >=20 > This branch includes the following changes: > - - Documentation is updated from DocBook 4.1/SGML to DocBook 4.2/XML > - - Webpages are updated from HTML 4.01 Transitional to XHTML 1.0 > Transitional I looked at a random page, and the identation for the header is a bit = funny. Is that just an artifact of an automatic conversion or? Example: = http://svnweb.freebsd.org/doc/projects/sgml2xml/en_US.ISO8859-1/htdocs/log= o.sgml?revision=3D39396&view=3Dmarkup > - - Static webpages are now processed by XSLT behind the scenes > - - Webpages are now built with less cycles; tidy has been removed and = the > date processing is now done by XSLT Yay. tidy die die die :-). > - - Generated webpages are now actually valid (they did not use to be) > - - All XSLT stylesheets now pull in a main XSLT, which reduces = duplicated > markup > - - Site map and index are converted to an XML format with an XSLT > transformation that generates the output > - - For docs, there is now only one entity set for both articles and = books > - - Some trademark/legalnotice entities have been merged to a cohesive > single entity file > - - Untranslated entity sets are now always pulled in from the English > tree instead of redundant copies > - - The base and enbase entities are already automatically generated = so > remove inline definitions from individual files > - - Fetch the LEGAL file via http instead of depending on CVS If you are going to change it, could you please change it to use svn and = with a REPO path we can set from the web build wrapper? I would REALLY = like if we could get the web build fixed to never try to get data from = the internet. > - - Convert id names to lowercase to avoid mixing different styles and = for > better readability > - - All PSGML comments are removed since they are mostly useless >=20 > As it has been discussed, the character entities will be dropped. This > is still in progress but it is already a good moment for the rest to = be > reviewed since it is a big change that needs proper review and = testing. > At the same time, this also means that it is not easy to maintain such = a > big changeset in a branch since merging so many files is really > time-consuming so it would be beneficial not to spend more time with > merging this back than necessary. I would like to ask you to review = this > changeset and let me know any type of problems you encounter or any = type > of doubts you have. It would be nice if all translator projects could > check their translations to see if there is any locale-specific = problem. >=20 > Despite the big quantity of the changes, the modernization process of > the doc tree is not complete with this change. First, we still use = Jade > and DSSSL to generate output, which is an SGML tool and works because = of > the fact that XML is a subset of SGML. But it does not really benefit = of Do that mean that the current build dependencies are unchanged? > XML technologies and the DocBook DSSSL stylesheets are quite obsolete. > In a second step, we should migrate to an XSL(T)-based toolset. > Secondly, the DocBook 4.2 schema is quite old, the current DocBook > version is 5.0. But 4.2 is the first XML version and it still works = well > with the old DSSSL stylesheets so this was a safe migration path that > gives us more time for the migration and for QA. Once this branch is > merged back, the migration of the toolset will be started in another > branch. Sure, I think it makes a lot of sense to do that separately later. = Smaller steps makes it much simpler to test verify etc. > Thanks in advance for your review. Thanks for working on this! We were talking on doing this when I was a = new doc committer :-). PS. sorry for not following up on the previous mails wrt. XHTML etc... = limited time unfortunately. --=20 Simon L. B. Nielsen From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 19:57:23 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 61745106566C; Tue, 21 Aug 2012 19:57:23 +0000 (UTC) (envelope-from simon@FreeBSD.org) Received: from emx.nitro.dk (leto.nitro.dk [178.63.52.6]) by mx1.freebsd.org (Postfix) with ESMTP id 181038FC1E; Tue, 21 Aug 2012 19:57:22 +0000 (UTC) Received: from mailscan.leto.nitro.dk (mailscan.leto.nitro.dk [127.0.1.4]) by emx.nitro.dk (Postfix) with ESMTP id E45F52B75A5; Tue, 21 Aug 2012 19:57:21 +0000 (UTC) Received: from emx.nitro.dk ([127.0.1.2]) by mailscan.leto.nitro.dk (mailscan.leto.nitro.dk [127.0.1.4]) (amavisd-new, port 10024) with LMTP id 2F1IebfEMDV7; Tue, 21 Aug 2012 19:57:19 +0000 (UTC) Received: from [192.168.4.24] (unknown [89.100.2.68]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by emx.nitro.dk (Postfix) with ESMTPSA id 53A6B2B759F; Tue, 21 Aug 2012 19:57:19 +0000 (UTC) Content-Type: text/plain; charset=iso-8859-1 Mime-Version: 1.0 (Mac OS X Mail 6.0 \(1485\)) From: "Simon L. B. Nielsen" In-Reply-To: <50326A70.5020009@FreeBSD.org> Date: Tue, 21 Aug 2012 20:57:17 +0100 Content-Transfer-Encoding: quoted-printable Message-Id: References: <50326A70.5020009@FreeBSD.org> To: Gabor Kovesdan X-Mailer: Apple Mail (2.1485) Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: doceng... X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 19:57:23 -0000 On 20 Aug 2012, at 17:48, Gabor Kovesdan wrote: > I'm glad to announce that the first milestone of the XML migration is > available for review in the projects/sgml2xml branch. To check it out, > run the following: [cut] > Regards, > Gabor > (On behalf of doceng@) [separate mail to not confuse different topics] Does that mean that the role of doceng has changed? In the past doceng = has not really been involved in stuff like this (as in, it was much more = limited what doceng did for doc compared to what portmgr does for = ports). If so, the charter should be updated. (and yes, my implicit hint = is that I don't see a point in doceng taking on this new role.) --=20 Simon L. B. Nielsen From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 20:26:04 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id B2F59106566B; Tue, 21 Aug 2012 20:26:04 +0000 (UTC) (envelope-from zeising@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 87F008FC16; Tue, 21 Aug 2012 20:26:04 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q7LKQ4kJ054072; Tue, 21 Aug 2012 20:26:04 GMT (envelope-from zeising@freefall.freebsd.org) Received: (from zeising@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q7LKQ4mY054068; Tue, 21 Aug 2012 20:26:04 GMT (envelope-from zeising) Date: Tue, 21 Aug 2012 20:26:04 GMT Message-Id: <201208212026.q7LKQ4mY054068@freefall.freebsd.org> To: zeising@FreeBSD.org, freebsd-doc@FreeBSD.org, zeising@FreeBSD.org From: zeising@FreeBSD.org Cc: Subject: Re: docs/170822: [PATCH] Committer's Guide; update add/rmport info X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 20:26:04 -0000 Synopsis: [PATCH] Committer's Guide; update add/rmport info Responsible-Changed-From-To: freebsd-doc->zeising Responsible-Changed-By: zeising Responsible-Changed-When: Tue Aug 21 20:26:04 UTC 2012 Responsible-Changed-Why: I'll take it. http://www.freebsd.org/cgi/query-pr.cgi?pr=170822 From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 21:18:31 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9B7571065670; Tue, 21 Aug 2012 21:18:31 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 4BFA58FC15; Tue, 21 Aug 2012 21:18:31 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 8DF1314E7F93; Tue, 21 Aug 2012 23:18:24 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id eEYoUxFZms2l; Tue, 21 Aug 2012 23:18:21 +0200 (CEST) Received: from [192.168.1.101] (D94162B4.catv.pool.telekom.hu [217.65.98.180]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 99E2514E7EF5; Tue, 21 Aug 2012 23:18:21 +0200 (CEST) Message-ID: <5033FB1B.6070004@FreeBSD.org> Date: Tue, 21 Aug 2012 23:18:19 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:13.0) Gecko/20120614 Thunderbird/13.0.1 MIME-Version: 1.0 To: "Simon L. B. Nielsen" References: <50326A70.5020009@FreeBSD.org> <1FDFD92B-36C6-4BE8-88FB-8C6D2A759954@FreeBSD.org> In-Reply-To: <1FDFD92B-36C6-4BE8-88FB-8C6D2A759954@FreeBSD.org> X-Enigmail-Version: 1.4.3 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 21:18:31 -0000 Em 21-08-2012 21:54, Simon L. B. Nielsen escreveu: > > On 20 Aug 2012, at 17:48, Gabor Kovesdan wrote: > >> Dear Folks, >> >> I'm glad to announce that the first milestone of the XML migration is >> available for review in the projects/sgml2xml branch. To check it out, >> run the following: >> >> svn co http://svn.freebsd.org/doc/projects/sgml2xml sgml2xml >> >> The build process - from the end user perspective - works in the same >> way. In short, use make all at the proper place, to build only web, run >> make all WEB_ONLY=yes in the htdocs dir, etc. Then use make install with >> DESTDIR defined to install files to the proper place. > > We really should fix this (the magic of en/htdocs building other languages too etc; DESTDIR not meaning what it does in base etc.), but that can be done later. Agreed. Besides, we have DOCDIR, WEBGRP, DOCGRP. They should just be DESTDIR and DOCGRP. But I think it comes from the times when doc and www were separated more physically. > I looked at a random page, and the identation for the header is a bit funny. Is that just an artifact of an automatic conversion or? Example: http://svnweb.freebsd.org/doc/projects/sgml2xml/en_US.ISO8859-1/htdocs/logo.sgml?revision=39396&view=markup Yes, it was a scripted conversion and because of the indentation of files is not consistent, I couldn't do it in a way that would match all files. > > If you are going to change it, could you please change it to use svn and with a REPO path we can set from the web build wrapper? I would REALLY like if we could get the web build fixed to never try to get data from the internet. I don't think it is (a) entirely possible and I'm not sure if it's (b) practical. (a) You cannot easily build INDEX as part of the doc build and there are some pages that already depend on remote resources. I remember that something fetches some .rdf files and the GNOME newsflash used to pull in some official GNOME news. This part stopped to work so I commented it out. (b) I think depending on having a local svn mirror of ports is worse than just fetching a simple file. Ok, you could set the repo path to the remote repo but that needs setup and fetching from http just works out of the box. What do others think? > Do that mean that the current build dependencies are unchanged? Yes. We went to DocBook 4.2 but it was already a dependency. And I could build everything on freefall. > Thanks for working on this! We were talking on doing this when I was a new doc committer :-). It is indeed quite overdue but the rest will be probably much easier. Gabor From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 21:27:12 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 64214106564A; Tue, 21 Aug 2012 21:27:12 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 3834F8FC08; Tue, 21 Aug 2012 21:27:12 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q7LLRCBo061460; Tue, 21 Aug 2012 21:27:12 GMT (envelope-from eadler@freefall.freebsd.org) Received: (from eadler@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q7LLRCNd061456; Tue, 21 Aug 2012 21:27:12 GMT (envelope-from eadler) Date: Tue, 21 Aug 2012 21:27:12 GMT Message-Id: <201208212127.q7LLRCNd061456@freefall.freebsd.org> To: eadler@FreeBSD.org, freebsd-bugs@FreeBSD.org, freebsd-doc@FreeBSD.org From: eadler@FreeBSD.org Cc: Subject: Re: docs/170814: bad url in docs X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 21:27:12 -0000 Synopsis: bad url in docs Responsible-Changed-From-To: freebsd-bugs->freebsd-doc Responsible-Changed-By: eadler Responsible-Changed-When: Tue Aug 21 21:26:24 UTC 2012 Responsible-Changed-Why: fix assignment http://www.freebsd.org/cgi/query-pr.cgi?pr=170814 From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 21:29:31 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5ABA81065749; Tue, 21 Aug 2012 21:29:31 +0000 (UTC) (envelope-from simon@FreeBSD.org) Received: from emx.nitro.dk (leto.nitro.dk [178.63.52.6]) by mx1.freebsd.org (Postfix) with ESMTP id EBD248FC0A; Tue, 21 Aug 2012 21:29:30 +0000 (UTC) Received: from mailscan.leto.nitro.dk (mailscan.leto.nitro.dk [127.0.1.4]) by emx.nitro.dk (Postfix) with ESMTP id BAB4E2B79FC; Tue, 21 Aug 2012 21:29:29 +0000 (UTC) Received: from emx.nitro.dk ([127.0.1.2]) by mailscan.leto.nitro.dk (mailscan.leto.nitro.dk [127.0.1.4]) (amavisd-new, port 10024) with LMTP id wZpJ3YE8_gJB; Tue, 21 Aug 2012 21:29:27 +0000 (UTC) Received: from [192.168.4.24] (unknown [89.100.2.68]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by emx.nitro.dk (Postfix) with ESMTPSA id 15E862B79F9; Tue, 21 Aug 2012 21:29:27 +0000 (UTC) Content-Type: text/plain; charset=iso-8859-1 Mime-Version: 1.0 (Mac OS X Mail 6.0 \(1485\)) From: "Simon L. B. Nielsen" In-Reply-To: <5033FB1B.6070004@FreeBSD.org> Date: Tue, 21 Aug 2012 22:29:26 +0100 Content-Transfer-Encoding: quoted-printable Message-Id: <8A0FB374-8843-4D85-A787-7DEE341C2EC9@FreeBSD.org> References: <50326A70.5020009@FreeBSD.org> <1FDFD92B-36C6-4BE8-88FB-8C6D2A759954@FreeBSD.org> <5033FB1B.6070004@FreeBSD.org> To: Gabor Kovesdan X-Mailer: Apple Mail (2.1485) Cc: doceng@FreeBSD.org, doc@FreeBSD.org, "Simon L. B. Nielsen" , www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 21:29:31 -0000 On 21 Aug 2012, at 22:18, Gabor Kovesdan wrote: > Em 21-08-2012 21:54, Simon L. B. Nielsen escreveu: >>=20 >> On 20 Aug 2012, at 17:48, Gabor Kovesdan wrote: >>=20 >>> Dear Folks, >>>=20 >>> I'm glad to announce that the first milestone of the XML migration = is >>> available for review in the projects/sgml2xml branch. To check it = out, >>> run the following: >>>=20 >>> svn co http://svn.freebsd.org/doc/projects/sgml2xml sgml2xml >>>=20 >>> The build process - from the end user perspective - works in the = same >>> way. In short, use make all at the proper place, to build only web, = run >>> make all WEB_ONLY=3Dyes in the htdocs dir, etc. Then use make = install with >>> DESTDIR defined to install files to the proper place. >>=20 >> We really should fix this (the magic of en/htdocs building other = languages too etc; DESTDIR not meaning what it does in base etc.), but = that can be done later. >=20 > Agreed. Besides, we have DOCDIR, WEBGRP, DOCGRP. They should just be > DESTDIR and DOCGRP. But I think it comes from the times when doc and = www > were separated more physically. Well, to a degree - it shouldn't be DESTDIR IMO, as DESTDIR in src is by = default, and BINDIR etc. sets where things live relative to that... as = in, paths are basically: ${DESTDIR}${BINDIR}/ls (where BINDIR is /bin) and so on. So IMO, we should use something other than DESTDIR to say = where things live relative to the "root"... anyway, it wasn't that I = wanted to really disuss this now as I don't want to sidetrack the XML = work, I was just reminded that our build system really is a mess :-) (I = tried to rewrite it from scratch once... it's not trivial :-) ). >> I looked at a random page, and the identation for the header is a bit = funny. Is that just an artifact of an automatic conversion or? Example: = http://svnweb.freebsd.org/doc/projects/sgml2xml/en_US.ISO8859-1/htdocs/log= o.sgml?revision=3D39396&view=3Dmarkup >=20 > Yes, it was a scripted conversion and because of the indentation of > files is not consistent, I couldn't do it in a way that would match = all > files. OK, then I think that should just be cleaned up later as we go. >> If you are going to change it, could you please change it to use svn = and with a REPO path we can set from the web build wrapper? I would = REALLY like if we could get the web build fixed to never try to get data = from the internet. >=20 > I don't think it is (a) entirely possible and I'm not sure if it's (b) > practical. > (a) You cannot easily build INDEX as part of the doc build and there = are Eh, you don't need to. That's why we have an override to point the build = at the right INDEX file. We (as in, www.FreeBSD.org) don't fetch it now. > some pages that already depend on remote resources. I remember that > something fetches some .rdf files and the GNOME newsflash used to pull > in some official GNOME news. This part stopped to work so I commented = it Yes, I strongly disagree that we should have that due to the problems = whenever upstream doesn't work. > out. OK, good :-). > (b) I think depending on having a local svn mirror of ports is worse > than just fetching a simple file. Ok, you could set the repo path to = the > remote repo but that needs setup and fetching from http just works out > of the box. > What do others think? I'm fine if you do it for people who want it, but please make an = override which can be used for www.FreeBSD.org etc. Also, there is = nothing which says the the mirror has to be local. If you just make it a = repo path, it will be able to work via HTTP for normal users directly = from an svn mirror too. >> Do that mean that the current build dependencies are unchanged? >=20 > Yes. We went to DocBook 4.2 but it was already a dependency. And I = could > build everything on freefall. Great, that was mostly as we of course need to have any new dependency = installed on all the relevant FreeBSD.org servers. --=20 Simon L. B. Nielsen From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 21:54:24 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 248F7106564A; Tue, 21 Aug 2012 21:54:24 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id C659C8FC0C; Tue, 21 Aug 2012 21:54:23 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 9850614E7F95; Tue, 21 Aug 2012 23:54:22 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 2SxiNSatBkXW; Tue, 21 Aug 2012 23:54:18 +0200 (CEST) Received: from [192.168.1.101] (D94162B4.catv.pool.telekom.hu [217.65.98.180]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 2A6D014E7EF5; Tue, 21 Aug 2012 23:54:18 +0200 (CEST) Message-ID: <50340388.6@FreeBSD.org> Date: Tue, 21 Aug 2012 23:54:16 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:13.0) Gecko/20120614 Thunderbird/13.0.1 MIME-Version: 1.0 To: "Simon L. B. Nielsen" References: <50326A70.5020009@FreeBSD.org> In-Reply-To: X-Enigmail-Version: 1.4.3 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: doceng... X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 21:54:24 -0000 Em 21-08-2012 21:57, Simon L. B. Nielsen escreveu: > Does that mean that the role of doceng has changed? In the past doceng has not really been involved in stuff like this (as in, it was much more limited what doceng did for doc compared to what portmgr does for ports). If so, the charter should be updated. (and yes, my implicit hint is that I don't see a point in doceng taking on this new role.) Well, the charter says doceng@ is responsible for the toolchain and the correct functioning of doc and www. It's subjective but I think that keeping the toolset modern and up to date with technology is also part of that functioning. And it seems that mostly hrs@ and I are pushing this stuff and I talked mostly to him about this apart from the public discussions so I associated the subject with doceng@. I don't care too much if I do it "individually" or on behalf of doceng, I just want to see progress. :) Gabor From owner-freebsd-doc@FreeBSD.ORG Tue Aug 21 22:13:06 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 52BB8106566B for ; Tue, 21 Aug 2012 22:13:06 +0000 (UTC) (envelope-from dhulme@gmail.com) Received: from mail-ob0-f182.google.com (mail-ob0-f182.google.com [209.85.214.182]) by mx1.freebsd.org (Postfix) with ESMTP id 1DC788FC08 for ; Tue, 21 Aug 2012 22:13:05 +0000 (UTC) Received: by obbun3 with SMTP id un3so491690obb.13 for ; Tue, 21 Aug 2012 15:13:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:date:message-id:subject:from:to:content-type; bh=VCuTO4X+YZ3fGESA6FPYjfq/VVf0LP72mMFY3klnLNg=; b=kb9ajxoiI4xR+qqX74xZnj2x3TrtmUEoigDXThcSXeCYVN7ylj6K9UnoNExei4Fup6 CrjjN+OqZPkMjQPA4j9FTsBJlhwt2N5YqOLDe7eKfYvqfrldVo3Ao49Gg00uZdD+ni1p yNkS3g8vxDM0akRGN7EWs7Y4Oaf56yd4xL0BrW6OXBECxpS0mMgiIsXbv7YXN7T0uPw0 NvwL9Tl/Pewo2QHWpI7W/cK18/ENOZECo4zXv3CchfqWo7gmFnYZodiNdSR4wkuIYmFO zfpGhgiOptgDaoeqk0A82+EdKy6e+4ZIDITvk21hLjCvF05dMDu3a4DeIQ/lCVjC2qL9 IhLg== MIME-Version: 1.0 Received: by 10.60.2.193 with SMTP id 1mr14088341oew.29.1345587184596; Tue, 21 Aug 2012 15:13:04 -0700 (PDT) Received: by 10.182.17.161 with HTTP; Tue, 21 Aug 2012 15:13:04 -0700 (PDT) Date: Tue, 21 Aug 2012 15:13:04 -0700 Message-ID: From: Dan Hulme To: doc@FreeBSD.org Content-Type: text/plain; charset=ISO-8859-1 Cc: Subject: http://www.freebsd.org/releases/9.0R/installation.html X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Aug 2012 22:13:06 -0000 It seems two things are missing from the update instructions, here. 1. First, is the issue that is mentioned here: http://lists.freebsd.org/pipermail/freebsd-stable/2011-October/064321.html =================================================== First, a minor change must be made to the freebsd-update code in order for it to accept file names appearing in FreeBSD 9.0 which contain the '%' and '@' characters; without this change, freebsd-update will error out with the message "The update metadata is correctly signed, but failed an integrity check". # sed -i '' -e 's/=_/=%@_/' /usr/sbin/freebsd-update =================================================== This information should be present in the installation instructions, else users (like myself) on Freebsd 8.2 will not be able to update to 9.0. 2. Second, is the issue of the src tree disappearing. The update notifies us that the src tree will be removed, due to a change in the "release packaging." This is fine, but is there some reason freebsd-update cannot download the sources on the next fetch? Even though freebsd-update.conf says to update src, it won't do it unless there is a src tree present. I recommend that the docs be updated to explain how to get your src tree back (and up to date with the current binaries from freebsd-update): =================================================== fetch ftp://ftp.freebsd.org/pub/FreeBSD/releases/i386/9.0-RELEASE/src.txz tar -C / -xvzf src.txz rm src.txz freebsd-update fetch freebsd-update install =================================================== This is the first time I have used freebsd-update, and it is a great utility! I just would like to see the docs be detailed enough to make it possible for users like me to use it. Thanks! Dan From owner-freebsd-doc@FreeBSD.ORG Wed Aug 22 07:34:14 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 65A7E106566B for ; Wed, 22 Aug 2012 07:34:14 +0000 (UTC) (envelope-from member@messaging.zoosk.com) Received: from invite8.zoosk.com (invite8.zoosk.com [70.42.170.141]) by mx1.freebsd.org (Postfix) with ESMTP id 3D8FD8FC0C for ; Wed, 22 Aug 2012 07:34:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; s=omr1prod; d=messaging.zoosk.com; h=To:From:Subject:Content-Type:Content-Transfer-Encoding:Date:List-Unsubscribe:Sender:Message-ID; i=member@messaging.zoosk.com; bh=JhtqU1pfJoXklTGfy4LEzyZGwOI=; b=OKJHfaChvRqqvjuKC9ca9KNrlmUHe1gvCmWCeZnd/OD9qG5vsjjza0+As3gcfZH8bt/x/31kH5hP pk4/rXV55vCkbeajsRAHvfKN8NSis8NT0h/HpzL/ShLDhQ9XapEMIwKL2PuGExjwoF8z+kEsRanO XMVB/9eKY25R2JOCvOw= DomainKey-Signature: a=rsa-sha1; c=nofws; q=dns; s=omr1prod; d=messaging.zoosk.com; b=Cr/2/Dqzr7S4rFi7rPQTnqwje1Z0EeLEFsylXhMKiQ5zVBw0beW3u80lxBwzLCjomkUBQ2BpgQYE J7GD6t9e/eHwcDUe1Xqi/3TVSdEcHT0X7kj0ERlVLjpFOvJ+YBaFUwI8j9e+AhjvK3wUQ8j70nGz WYKMiR8+FXzpeRP5GUk=; Received: by invite8.zoosk.com id h6i5nc1ctks3 for ; Wed, 22 Aug 2012 00:34:08 -0700 (envelope-from ) To: freebsd-doc@freebsd.org From: Tony Yaeyo Content-Transfer-Encoding: 7bit X-virtual-MTA: invite Date: Wed, 22 Aug 2012 00:34:08 -0700 X-SENDEM: =?UTF-8?B?djl2cFJydGxKRXkybFMvMDJHTmp3NHFVcEZMT3FSS011V0tIUFA5OEYxMD0=?= X-SENUID: YtuXVS6EF58iAZD7bLSgtI5Gxid4mOSinaY9jj1o1l+mi8Qd9xfKSA== Sender: member@messaging.zoosk.com Message-ID: <0.0.1.A62.1CD803883D15B40.0@invite8.zoosk.com> MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Subject: Tony Yaeyo wants to share new pictures with you :) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Aug 2012 07:34:14 -0000 Tony Yaeyo has added you as a friend on Zoosk. [1]Tony Yaeyo Is Tony Yaeyo your friend? [2]Yes [3]No This message was sent by a Zoosk user who entered your email address. If you'd prefer not to receive emails when other people send you emails through Zoosk, [4]click here You have received this message at the email address: [5]freebsd-doc@freebsd.org Copyright © 2007-2012 Zoosk, 989 Market St, San Francisco, CA 94103 USA. [6]Privacy Policy Zoosk References 1. https://www.zoosk.com/signup/friend?invite-token=084476dc14b8037fb73dc4c4b50f2847&t_ctr=IN_70_00_en_XX_US_01_A_20120822_07_E&from=find-friends-photo-IN_70_00_en_XX_US_01_A_20120822_07_E 2. https://www.zoosk.com/signup/friend?invite-token=084476dc14b8037fb73dc4c4b50f2847&t_ctr=IN_70_00_en_XX_US_01_A_20120822_07_E&from=find-friends-yes-IN_70_00_en_XX_US_01_A_20120822_07_E 3. https://www.zoosk.com/signup/friend?t_ctr=IN_70_00_en_XX_US_01_A_20120822_07_E&from=find-friends-no-IN_70_00_en_XX_US_01_A_20120822_07_E 4. https://www.zoosk.com/optout.php?with=freebsd-doc%40freebsd.org&key=4b97ca2af95f3c755f6057638b6b562c&from=email_invite 5. mailto:freebsd-doc@freebsd.org 6. http://www.zoosk.com/privacy From owner-freebsd-doc@FreeBSD.ORG Wed Aug 22 10:41:20 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 25EEF1065670 for ; Wed, 22 Aug 2012 10:41:20 +0000 (UTC) (envelope-from dave.evans55@googlemail.com) Received: from mail-ee0-f54.google.com (mail-ee0-f54.google.com [74.125.83.54]) by mx1.freebsd.org (Postfix) with ESMTP id ABC078FC0A for ; Wed, 22 Aug 2012 10:41:19 +0000 (UTC) Received: by eeke52 with SMTP id e52so303014eek.13 for ; Wed, 22 Aug 2012 03:41:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=20120113; h=message-id:date:from:user-agent:mime-version:to:subject :x-enigmail-version:content-type:content-transfer-encoding; bh=oE+19bmYS6KDJ7ybGp3aiY1dL+8fW+QkM7tv7YuZ5P8=; b=DgdTdqzNusHGw4pL1nQgwSsV1SVUe1fxrKDlhCXYNuC3V3vLBNFHA22NVu2vIEP+mj IEvkHY+0VhVfcP1CwrSfzwgIwApX235Rm99pfENkNHHfFMDWa2KEhrqePWui1NtBUmFh Jc9R42abvzCAch0VB1427HkGjw2vsBr+SHxhfz00GkxHLAcCdTziY13Zle7fbJg08gaj W7dp1LuOZzryUxVq6soYcuNfglOGiSYQ5V60YjL/yeuz2Ei3Nzl1nCrwSYKnVhJ5PJyH 5QnMmIAeLZK2cco62ARAGgr6NNaGN98t+AjkF+1hcCjPafssB0J/eMgPyiD+2ilBu9Nc pnjw== Received: by 10.14.224.4 with SMTP id w4mr17917632eep.21.1345632078662; Wed, 22 Aug 2012 03:41:18 -0700 (PDT) Received: from two.pearl ([2a00:b900:1023:0:21d:4fff:fefa:f4a0]) by mx.google.com with ESMTPS id u8sm11760676eel.11.2012.08.22.03.41.17 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 22 Aug 2012 03:41:17 -0700 (PDT) Message-ID: <5034B74C.3020200@googlemail.com> Date: Wed, 22 Aug 2012 11:41:16 +0100 From: David Evans User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.6; rv:14.0) Gecko/20120713 Thunderbird/14.0 MIME-Version: 1.0 To: FBSD Doc project X-Enigmail-Version: 1.4.3 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Aug 2012 10:41:20 -0000 For the Italian web page home, the top menu bar is not not rendered, and Chinese is not in the list of available translations. From owner-freebsd-doc@FreeBSD.ORG Wed Aug 22 23:11:20 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8A529106564A for ; Wed, 22 Aug 2012 23:11:20 +0000 (UTC) (envelope-from lhao62@kimo.com) Received: from smtpa.meduniwien.ac.at (maud.srv.meduniwien.ac.at [149.148.224.13]) by mx1.freebsd.org (Postfix) with ESMTP id 4AD5C8FC17 for ; Wed, 22 Aug 2012 23:11:20 +0000 (UTC) Received: from smtpa.meduniwien.ac.at (localhost [127.0.0.1]) by smtpa.meduniwien.ac.at (Postfix) with SMTP id E52D4626FD for ; Thu, 23 Aug 2012 01:05:04 +0200 (CEST) Received: from SERVER (unknown [69.15.231.133]) by smtpa.meduniwien.ac.at (Postfix) with ESMTPSA id A024A6271A for ; Thu, 23 Aug 2012 01:05:04 +0200 (CEST) Message-ID: <00eeb653-41143-9c737933689583@server> From: "Li Hao" To: freebsd-doc@freebsd.org Date: Wed, 22 Aug 2012 19:01:28 -0400 MIME-Version: 1.0 Content-Type: text/plain Content-Transfer-Encoding: 7bit X-Priority: 3 X-PMX-Version: 5.6.1.2065439, Antispam-Engine: 2.7.2.376379, Antispam-Data: 2012.8.22.225415 Subject: Proposition X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Li Hao List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Aug 2012 23:11:20 -0000 Greetings, I am Mr. Li Hao, CFO of China Merchants Bank, P.R.C. I have a discreet proposition for you to the tune of 105 Million EUR. Please reply for details. Warmest, LH From owner-freebsd-doc@FreeBSD.ORG Thu Aug 23 18:50:44 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id F23CE106564A for ; Thu, 23 Aug 2012 18:50:44 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id A0D8D8FC08 for ; Thu, 23 Aug 2012 18:50:44 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id A0F5314E7FB6; Thu, 23 Aug 2012 20:50:43 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id AXw_SD5G29rq; Thu, 23 Aug 2012 20:50:43 +0200 (CEST) Received: from [192.168.1.101] (D94162B4.catv.pool.telekom.hu [217.65.98.180]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id E686514E7E9E; Thu, 23 Aug 2012 20:50:42 +0200 (CEST) Message-ID: <50367B82.1050809@FreeBSD.org> Date: Thu, 23 Aug 2012 20:50:42 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:13.0) Gecko/20120614 Thunderbird/13.0.1 MIME-Version: 1.0 To: David Evans References: <5034B74C.3020200@googlemail.com> In-Reply-To: <5034B74C.3020200@googlemail.com> X-Enigmail-Version: 1.4.3 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: FBSD Doc project Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 23 Aug 2012 18:50:45 -0000 Em 22-08-2012 12:41, David Evans escreveu: > For the Italian web page home, the top menu bar is not not > rendered, and Chinese is not in the list of available translations. Thank you, I found the reason of the top menu bar rendering problem and as for the language list, it isn't a problem in the XML migration but the Italian translation is simply outdated. Gabor From owner-freebsd-doc@FreeBSD.ORG Fri Aug 24 02:40:05 2012 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 58FE6106566B for ; Fri, 24 Aug 2012 02:40:05 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 29F598FC1A for ; Fri, 24 Aug 2012 02:40:05 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id q7O2e5Zl019155 for ; Fri, 24 Aug 2012 02:40:05 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id q7O2e4J1019154; Fri, 24 Aug 2012 02:40:04 GMT (envelope-from gnats) Resent-Date: Fri, 24 Aug 2012 02:40:04 GMT Resent-Message-Id: <201208240240.q7O2e4J1019154@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Edson Brandi Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 34CC1106564A for ; Fri, 24 Aug 2012 02:37:41 +0000 (UTC) (envelope-from ebrandi@server14.ebrandi.eti.br) Received: from server14.ebrandi.eti.br (forum.fug.com.br [65.254.42.220]) by mx1.freebsd.org (Postfix) with ESMTP id DBF8F8FC14 for ; Fri, 24 Aug 2012 02:37:40 +0000 (UTC) Received: by server14.ebrandi.eti.br (Postfix, from userid 1001) id 087F5194B93; Thu, 23 Aug 2012 23:37:35 -0300 (BRT) Message-Id: <20120824023735.087F5194B93@server14.ebrandi.eti.br> Date: Thu, 23 Aug 2012 23:37:35 -0300 (BRT) From: Edson Brandi To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/170965: New documentation: Brazilian Portuguese translation of new-users article X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Edson Brandi List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 24 Aug 2012 02:40:05 -0000 >Number: 170965 >Category: docs >Synopsis: New documentation: Brazilian Portuguese translation of new-users article >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Fri Aug 24 02:40:04 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Edson Brandi >Release: FreeBSD 9.0-RELEASE-p3 i386 >Organization: The FreeBSD Brazilian Portuguese Documentation Project >Environment: System: FreeBSD server14.ebrandi.eti.br 9.0-RELEASE-p3 FreeBSD 9.0-RELEASE-p3 #0: Tue Jun 12 01:47:53 UTC 2012 root@i386-builder.daemonology.net:/usr/obj/usr/src/sys/GENERIC i386 >Description: Hi, Im sending attached a Brazilian Portuguese version of new-users article, translated by The FreeBSD Brazilian Portuguese Documentation Project (http://doc.fug.com.br) Attached file must be uncompressed inside head/pt_BR.ISO8859-1/articles directory. Thks Edson Brandi Ps: If you have problems to uudecode attached file, you can download tgz file from following url: http://server06.ebrandi.eti.br/articles/new-users_pt_BR.ISO8859-1.tgz >How-To-Repeat: >Fix: begin 644 new-users_pt_BR.ISO8859-1.tgz M'XL(`//D-E```^U]:7/<1I9@?Q5_15IMJ\F..DA9DL'OC_VHL=W-\_>`C7MP_WV?[!@_U'W_Z)/?QR M4W)76S>\@JF(6<7+-!N\;]/O>AWVW_]'KM+N_\_\G9AGN;CY=P`\'CUX,+S_ MW^T_T/O_X/YW][]E^-?]!W]B^S<_E?[U__G^_WGGS^QB*=CS2H@GY\_8,YFT MA2@;WF2R9*\K^;M(FLX]3RK^,S\^KLMXL7SW[]X=?3\YV=YV=O?CZY.(??ETV1 MTW_&]2K/FIU_O+CXZ;>3-QV"AJ`G7KPZOSAY^?*WIV<_OWYS>GY^ M^NS''Q8?[==GKU[^&ORVLW/^YNGY#W?T^R?UHLAW=MZ^>?G;F].7<-?S%[_\ M^,.=R61J_H_S_O7CSW^Z&G4E6)GF;"G;WZ_]T=__WM%[R M2DR+=]-4)I.5`O"D>'=WYW/VW]&_OX2;PBYUK:7_@P/@/X? M/3AX>$O__XSKZ*OQ>(=MP0+8I[(`>-)Q`/@PS`!VQN/CG9VCKP#I+WY]?$1]02F&!V3[GQQ>FX'-JO57*EFIV63-1_8N6BFT]<7 M3][P6O-W5LXE?H9O8`CX[36O.),U*^4E;^!?4=C7 M"7:O!=YV>#15M^ZHYWC;+&6UJ&2[4B/9[XYW[AS-LZIN2EZ(XY.R%'E6BZ.I M^VX'[JC;2O^>`KW+\FAJOL%?^7R.&XI;!\/AT&E:B;H^/A(%S_)C0/ZJ+O^F M_ID`T<""JG0BTO9HJNXXFII'8+AI,)Z>[=1,U_^D%Z2^6[6SE#?B^.`A`P;( M%[(&S@]_'7S__7='4_.KOCD7"YZ7$N`K6);^<+>I>`I3J=[5=UDE2W4C1UPEP#\/!6'`$!I<.NKG3NGX>FF=)7+"&,Q0 M$+4N).-U#3R%_=&*G3N7,KDGDJQ*#IFH&_,0:VM`2KB370):NY7`E2-6BY;!NAI`H-'. MG14H)("/%1\Q^(:U!:Q5@Q]F#9-HS82J3+)=-]<]%DX=)/P\SAI7`Y.X?3H`0$`<,%7D((X%?6I:V,%=$CV%LA[MP M6/-JU&Z(RU52-D=3^Q$0;?>\74LU>@B#]K_;G6I$Y="O0#P&J;?IA8>TKI4$ M=I95BKX`<#E\6;&\7?`*$$4-,>S8&B@7`&/ATOR M!C;;.#R\7(-4AC8]>B%)#Y15>73%=F$.,QB0T`=X[!:O%8-D9/:\3D"GXH_# M.2`KJ`J>BRL..R:L',&;17DF?H,ZH)Z0O.=WKC>DI$A M-+P&COP1M":X#WA:*1)`4[<9O`8*_+O/%^&/VE`1XA+J<4`51^_$A_I#<8S8 M41U-]2?&5_>D%ALHIV!G!Q+H`/ M&@H`F6'X>YVT.:Q%L"(K.]]I06=`"G/`26C0F4^LC(A7R0I1%\3JND^?_O+B MPCT]B%&IJ/,,N0:0MH$JL(.2WS`>3.M95H+QV38@ADHV7@*ZOO]4Q#AK%>.K M0$)EP+#R[".O1E]XQM7GS%BV-SFI2LPLP[C^7#QJ`2YK];]"L5$#4Q08AOTA M[<"GF3RFO_CJ^&E3Y41$^,%\>9(WO>^>"2`(X;Z>VJ$F>O!G>C+C?(D<%V;1 M)J2M`X=;2;710%(SGB]Y!<3^HJY]"C!<"V48K)>DNG1D$`+,$9,E45+WI*(L MX#+`/G",VM-V47()7[D:J7\,C8L<[`^\GP2SXSB@A$E/?*:BRYQ1T'F\.61D M'KF3^&Y(EILQM+H!7[AX@":IQ78T.[*VL7(PY>7!"I>X$ MY!DN!D4:;,W;GA@$^SR[S'+SLD4&/-0N]`W!O*_ZG?MZF3]GI9R5HES"RT*9 MJX?<0G'SQ*,8`3958&3"GEGIYC1E$("@Q"CM<5`6C_HZ9*A[:XF#D^]&'JQ[S1?`+/-M1:Z M`OA7"&<&]`51U@KI;_DET3$OL3&01#%47\3<^`^55]]JI(,[>`\F-DGJY>3@$#B`I9-+@YM$TG03W8.6&2VB;A<`Q\BBZZ7',.@5 MP5MA%<\DZ>R5M]T&S\"(!QYCV8$8TC\(+#P168-PK]?"<$*ZMKZC"]]:N*GI MIQ':RB=TA"$90N>I:)*IWLX)3'Z._AW]&YBY9"XP\W:C5L,.-T`I,27BO%W) M8B*';']SI-W`;$E[>\2F!D8ZP!QP-U&V1WF0>LF^%=XD#T195;, M<+$%95TF8?L%AUO^NK-^Y&K%&CQCG;".E_!J6]0]P1+ MZ1O;;B'H>5*&L0`#$UU,@"0HO*KM7!01LNWRWPRY$@H<@2L=YOO&GN:+"B3@ MH?,N%!*EH>SR/038]93(IS%=T9ECL'OSK/"I`>?O8,5)..,B4".*LQ^)'CE$ MH=IXSY`('"D'34_[=QM4"-!5O@4".?*7-0VPU19ZGY M(>/:GT8*-WDF%+/NH*EPF/C"T#GDAZBRNI$VN^OZS8* M=6WG>U0"NH>@"I,]0P,U)+79P!J*K*Y]@X:U\#?:WC[/J-L>NU`VW&8&.>K2 MM=Y@0S!K%75$AU2I489*#`J$V@_)GD#MX<[,V2@.`&=)C#+MIQ1(KD:C-CZC M#`&V:^Y<)V;W``U_)H9)(YCW7_8\6O`O0#Y1V*YDT&5&>JRD=:,)BEMUU3C= MERPD8BAUU\[5,J5O[!I$DZU%8<72.B]1(V@^.C(D2/,2`N8UZ'$R;N>>V7BVG=UYB*8\E,(#$0C1^N:I2`\,PY*:0XZDM7RX$O\C##Y@'%98,#%L=V9 M+'6[`M#$WS`6C$\`JRY4()C>\2PC21+(;\-AOS+SN(,LWCRJ)S`-9[#=O%;O MMY[8SQ+#7TR6:<`O?6^!)0Q\"@135HG&^(X52E04>B`*4?XJ>>-+RNMM5_0R MPPBMKS&`ZC0XZ;>"?2AOP9ACY7,%)WI M`=7-XDK`:&:/+T4&K`RHW8XQC8T11P"TJX)G_S;\K%-ILO)=[=T'_'1FQLRS M1-9?=F/R&]@8A'TJ0-(LA0UEH&.9ETM@Z2EO,.Y-L+8JA/-H?-'5\1M8G4S: MO,&])29.GG$*K.M]_*.5C3A>`1<'6E\D3^'A!O`Z%00V]?LCW+1GFY MCJ5YND.2ZB7@DX6`88\G>N[JDV>@U')&=%QZ6KUZ&D%)(4Z60VQ\TF"Y( M#@P!*TG!NHPOPS(G)0J\,7Q9.U(V3"K`%INAMYC\A:UZ]NFS-V<_ASDXF,E! MN3#SMC2FQA)[Q',*F1+J5>HY3.%`/[HP<7%"RFOU-A;MN3GP M[%E\KD$6I9&*9Y32FYJ#?!1)P""+K7SI))Y_E(B M%1LOFWX]VG_FMG8%=EN%$??0%<<:;S37CN"])W&3>EDE`UQX MPZ/:]?OA:_NBX*D MB'Z?DVD:4O8+'28,;?FN@\275VP7Q!%&!9V.HC/W9'DIRHSMW0V;UF`1'4I9=T?=A]$*59#?JLT\6RVK@348.U4`A5"@02*D

M#`\-`-+T`+*M@+]H=3(1N;+HZG]^>8U'OC/C0+C]"J;8;Y/(("=_&51 MY;/_.F!`)^BREI5";>?&,>5&$3Y`>J$BYUJG?G:M,OB/+VV0!T>-)10)^5+X M%GAE>9CSGY#01X]S$'+NO--G]+[^856/4YMC@I^T`A-J3Q4/$V,(OT:>!K,Y M4OLD%JGU7J:#?!A1"S;O>F]YON$M_-)+R]CP-ACD#Z>,R?9:$XD&IKV)?!D# MXOTR2Y8W2E!:/I"O>X2BT85@>;,,#'6CE8=1&I<)L6%&'9O":$1?PA)&8=_$ MS)_/AY,ETH076;G$OS%*()5`VXXE&Q@8K\R7`X3/[V\:84@F!4QIT[KG_".% ME(%/H]3O6U*!(75*'AC4F&.K^6N?FQI]H$*G726<3D@/S+(R4`G_N?&/]TNP MS&YX)TXUXK@(]Z:1-??3<"I39=QI3+8I=E_&"O(38P+;E`QQ/7JXTU$[U<8N M,>A:ZEAS]_G`R/5,PD)6PG?V=1Y;`+#BSUVN>6J>E6GT*5C=FL>292'CSR5+ M^;Y<\R36JP;)MUZZ!=A1*V_MD^ZS(014#*;OWLM%AEJZ+9SI$FG"4TH$HM)' M57122),\#93U[.Q\I)RV?;.4C7/V7ZPS#U#"@RG&;(I-?C),B.U:D'[4SSA? MU2R3%NRZ!0]=S)'9ON]R&J.N^7$AER&3^+6H.@YC9O#>R^Z/A>O1V$*GYY#R>3>N7QH,H]'M'Y+!P_CAA1(29`=YY5M& MK`#3ZJOU)K,L\Z7#2+\PHS`N#%AS%2_&Y#>`EBI.-<2E))48JU>N34HR&.95 M_J8V05F1%>$`YF.0E6R+7@@4F%UETDJ,1>Z1K:G50:>%D6M76=$U;#^UU@"9 MMDRS!/`BRS_XR;D[@..EX&4I5:.&8]DV\#V3P%P:D2+>!S_O;'['>R'>??&7 M8&1F^7EON4Y>CQHC&-%U20#E& MY,1CJJ\#J1:7686!27+?R]RT=Z"?7):MZ!9G6\1"4O75I&KG*6B$^Z5*:K;`8,EVAU`?]! MQP?P)HIKV'7H3$TBK\#1I1E1/TQ@6$Q/>N?"E^[:=[NFU-9+#L^S8D4UECKF MXF?5TM0HQ=*R-\RD[5<=>>H4>LVJ3F$'J&13[*`Q52S(^8XM:H7WYG(Q+1!) M%NAO[;LB/2RVBGF#3-%N@-_E`3TJ9K4\!?42&R.LK\YRJ:[$0ZU$6-,0P7^: MW#$1.'FUN:W'%5<4D[`UGV4YI6H8Q[=?,]!U]F,3")6B"&(&!)O2V[#P?E') MNK;.\SR[1$^_,J(,8*FNA6.**(JGE%)/@Z4!9]BXH2>M?'69WH!UP,OM?8XO.?>`Y,\^#[[Q^.V(OS)Z_8_OC@V_'!P_V'!^/O]BPU<%T[8%E8 MM!(`-8<5]2K!\E.NVGJ=9B#:&+/,6M\&5O&*39Y:#*0`-&U^$M@NV=_ M>2.R//]@2`L$W"$[`8UGS:`OD: MW%#@W1SGP&`2QCG0E.UD[)HP$T8:HM$,2B^V<9TJ:+T2H6%+E7X/5#ID'@Q^.QARS2F:0[JR#XY"?5=]+I-_(?H4L+ M=-:%&7^!)16W&R@6>]ND;KB`/& MU)>2F')45\F4;LIFT_(RPZYY]=2\)R@BB%7JZ>B-"ZO&M7A+MHO\7K->&C*U^P912=R&65="M&^V%= M/4107T7!##\U2Y%#B,^9G]-APZO;TQ3F6N&2;ZC*.EDQO5SS[P2V?/%9]8EH M%"=RE75@VP>KKR;T[M/S\#!/F%3"J,Y8>8FF0^_NCKEV`KV\!&!<+9DS,+34 M??ET64NG28)20&I"4%4%L@MT+PO0K/=(#Z0)6F/CAO:RN-RXE\.6HT,$>HA9 M('P:(JQ$+@%1&])E;1PEYG54!4;5)=D-&+`UU(ED(4L+:I5":@+:?5ZN^@\8 MFMYB4[L9R\`!NNI(B)B M;G7>FVJ&`PKR5I[93X/"ST#P6!@X$)8FGRK'=/6&ZV^IEMZZNDW8NTY<='>7 MJ]N4MP6;*N[II*!^IX=`.U#YJ3K_CN@3?1[=1!FCMX0ABL^OI;K:-A;TALKH M,!S'L6^?0'U'&6;.8TP^[UI6-Q[<2K?.TE?5?M@7BVHB,>,1.X_LVKY5#-LE MPK^HL)4Z1(A>DKT;GW2V[9QU;F9-;4$4!G+R<:CF:U\(IOQSIN=W,;O^!.UW M\9C>0`UX"L+`S]#.@NA.E\:X;SUT?6YF-9K@>S$LHFP[N";CH".&8J+HLM3$ MZZ(SG(H\/Y,N'[^_UO:H1C?HCJRM3(KX12@D72?2U"!0PE?9\LHF5=XXFCU^ M_\>GK&3].G3F!:;`W/R$__CJFA.F\HS"S=PD70U-_\:G/+VA>#^M1^G)FJJ5 M8KY-3L%A)VEL&D\.\U.&C<2D%D5[7FJ3RV7F89P)9"EF4&@R1*]>O`@ADH]W MXT#_7]M"E6*3*N&T6Z]PXY,*H%"&(-AZPLS.V(C1=L/:1;BV% M[5!9B.H&DY2V2[1[&8MM;4$HE<#&2.72!EK^R?.>Q>:M6..6(\ROOW(E]D28 M!FFJ>T84-1!)DVF#>H2=L+/"EC-*U0*`L@`'\D5$AX]@'=87J9^@T(O*>BX& M77W%AGP/C%X2LL-[C)-Z(Y+'?A&2/O?6*U@(+%/-J M3-]X#4Z"LA*I&$10+>=H[SOP\:VX(9TVT!>=@<)-K0S6J'9]T2ZZ3GWG:H68 M@LTK`3,`(!>VGT)4]:4>!_T>3X&.YM*A56A7>.G9K@!NUSISK&&%E&T$3]YD MA8S/84\GX_3=[2:$$G6IDQLLWE\HEAK:#P=T_,T=-I4$F7WQ-IIKHCAK&@#H M471)P$!(P_,$7;O]D;`L+-*5QX29MVEF9-K1"]+%A56OY%[OPV:!6"02Z`[R:5>/U2E7$7+5]>XFC1-L+B)9.Q7%? M8>TBHRX6@]&N;O\T)V^R@C8-J=TKO@]/$6$<_7DHL!";,$LQJ[PR,]O&S^@) MCKN*?H6)RV$WI`JRWS:UULE\F+B0U4`:J(2%GFF:,4`'[[7("J!QT;I"-Y'J M^<-9CDDH^C`&S5C])(BB37VU,(VT8*%$:[,GNWYC:YB6:IXL]B)AA3"H!_]A MG?1FQ][5-+E21C,*J)_%'3-;NJ?5,0Z^5]Z\GOT7HBX;S]B]17.HOILT5Y_< M*SUST3/3MRPQC"G-%GX?1AHD5D:&NWV9*1D]4,3FA=N\U'[+HKUE>/'.@IQR M]OV4I>P%][T2_Q/=@CJ7B$4>*II)IQZ;1[7(J-G`M55:L+G_*!676:)F`/:5 M]\GO_7@SB0M$)ZI[PTTVSR]D6S9LW+"B!J*9UPQ7,9VG^VQ:E)^,*-I5HVOO M^X"+Y1?0Z]8FWJF-VXTKSB85C71;I4]NDX\V"ALZK,UY7-.[4WM0HLJ"/I5A MN(OB7M\#O%WXO]N@3;>Q[,$V3C$N`FYH3*W"Q#/-9B6?VJR]QYB2E>-!GX5? M78:;UWJX<'-4EAQJ,H`/"\S[/7/[PC:B MP1()IX6H@W0%C;\@3VYHW[SW*$E"?WZ.)!&Q]`MOU$Y.A;38V/,(!#!PQJ\[ M$Z82"\SGPS1!>Q"-39+V&^JJ0S&+I/_Z;.;O')Z8[NCK+3`-+V2:@R+X]/WUU MZDQZGR&J?FAG=KJ^#\+,G./Q/&`#M*7NAP8B,FN\9@YDW+1>A%W^:#JMN11. MZ\(`O3HXQ<,9`'SF`=#%53N;FF8?MZ&D%(.I@Z)')8#L;B,;]DQ"3Y,%JL0G M,\0!&=PJ(?QY#-&=5&,2R#0R*-WY*9";"&JVM"(^Q!!37<6&3CE3VN.YB4;, M'J*G1W@%N[[B*:+A/V25PI^434S>+UUX@2XES+%/O8Q&8R5X61K*J"`7#._: MA6$[@JYQCXDY=,X#4J\R)'2YFZ\T$!25>8`EN7T.BXO$9:@%4MLLH$"%G]J* M$E\Q]GJ@"Y+%:DR>4*E>M3"6&#>0[*4[D>W8LQA2LX.[3Q7'=!FYCM?HO0R< M2'V0X;)4+S8`*ZR-6^8V<@6FQNCCM53=/]4)1+S"'&I,,]F+D."9/7;-LS5H#)="BOH7'$*IIYR:ED/S^&?_:,Z"$0)7W7T&*]W#JGS753VF'R] MDM(_.H5*GK&6(/6R1ONE)/385)5"]9+#L,S&K=OZ%CR?)6='2UZE[WDECO-5 MLW\TM1_9+E8@X-9T]#W53([L(O?PR]<7!][#>T'R0-UQ$AF5V/""[=8$`-V2 M.^K&2)N=A?DJ'=!//)OY'0RCGZ3[G?M0'TVC4-:74U<83E&=Z^G`Q!1$4\3Q M@'(YTSYR+H:\QI2.J@XSE=K$SWRE5\E13/1,MW3\;0X=U,V6LZY M\'1,=-`@@S.W(8LJO4GI6E97>33!2]1,/G8JB M,`U!Z^0+-+A8@4!OM\Z2<]/7DABKFU7EWX0%8WI#FG9ZV4QY^\B8HK`93QI^ M\TNJBIML#RFN\%@@3U'8MB?D%UG8^$WXZA0SA#YE697)=^SQWO[Z>B]AKC<( M.K9T1E#=SGI-O*T23TO,'#K=NC"=,0T2XXL]!#-&.!` MR@5./`03!'JMIMCXY/D;90-32Q-EK3I1Y;D=4+51O7QINJD'=+^HRA/*89DJ M/;M;"QQ2!YOW.O4XX;$=NDI&\QO;FQ?DC$J?-D*"C6@"7Q^ZXX%SB.HCKD;3E/]X`>8M>X M*+7C6S4LX*"(U'L]EU*:?0P*FH:P@=(_>G7U8:CVZQSCS'6*>Q>O">6@Z1\_QH].R0.]E+T"/:K`#;5AK M?!\P6*2V(\])"C"1Y?@?HL[%!RJF._LK&NO"Z;4.] M4S.]DG=FJU%?8`)L*9K-Y(L9B(CNU2_/"^[TRP27^8$U&93(5%AJ=I"E=_K>PXWX+CM0CMMO=B!L(' M>U78N1B;S1B@;^WR2"D29EV@^TM4-SS/"H;'(^V0WB#J9`F2-3/-QYXUH]:T*&OUB&I M[MZC5`'%^W26AU$NR9^KM\0@P,#&Z..!.)MA#@XIBE7?61CSA'5@0JCD,_E^ MW#'R0">^,XHT9-&/X;3[+]'E;\8[&L[>D9=*ZT1.$8LU^V_X*_P/-G_Z[/3\ MZ9M0?Z'.EG47GKY(=TV=B[@!Y8).V(1L@87R2#4I&2T%%<%[SRDEG/$C[XS6/?1Q9M^[W&*2WX;N]5_?3@BJ#E2FP<9,Y1-:LYWE_1UT` M@WX*/P'S==DNPV$2)6IR83F9B[7$$,*/WW5Z*^CC:YQRO8OM"@#9\W:AHSKZ M:9>?Z+KDF=I8KQ7'0*_XKK+5Z16_=X/AK62%'H^`VA#$4P5OYB_[,QH)&/=N M2YD8Q!?7@#X&]:E!``=\4SW*>^>(1ZSX=5L]B&3,Z+'1'E.>1QL87-33$UV/ M@C)L?4,9B)V>',Z/KI_N>=,I63>LPG\7<`J30&4U_RJ;4Z%":"?X>QZ;#;5, ML63E5R!HV:=.\THS'1,>)G@SD9#L/3+TO>S7!=IAY+10/88]+K2;O+-J<\1# MRMI$17?D)078J@##8!&!$11N$-4)3AV'O(9'#6V@`Y59S_JNFW]WAT5[A\A\ M-@&-`@JR]53A=KNA?N;OA)JK'UL[-<=0W5"W`G@)XWFNQ=HGR1O M;6431HR&6OL,TX`+?U<5- M*9.IB-`>6N'-!34:3%+@W3:NKLQDE?E)(#$1OH;=67TU2#B%_5!'@*P)V0/X M7V([XC[]18B&=+W!XXY&D0!EIR5TT(DXK&[;\SFH\R]S(G3X8U<;;BK;!GM$ MM8-VA3U49L]WF7L^(=4F757!H#P@TR.MZ>6%F2/H];6]AW0W#_BQK.L3SK_;8:>@GR6V&Q*`"&Y,$PBKN M0UJT1MIUF#URAQ+V4+C'UZVR$LM5(2IW=7BJ+1`=+I;08>^T%^DV)I!_OFV' M:U$R'AKD>A@K6O&5G9PH4N&54=+C[8KY;IP,KJRREKW.;X39X8%J*AZ2\/(O MC1Z&_.-M^3%;'4W='3I;2ZH^EUDJ>YTINFQ43X<:+M-BB7L,0`3C.?A*0[VF MJ9NMVHL[:E6S#=L?;M0_F;(22^Z?1N43C*K`=/I7)7)1=4.'`T=^6`[A$P&2 M&:4K=HQ8+=ER\S62W7E$-[6Q058;E$#U/A5>4JJW:S@C(VME`^RL12>]MV<: M7<-T:'W:PMK$%#I*95T7$IV0;(U-!PWJG^I*\'5TL^_[*)VP2`!+XOUOA\Y; M*?ORKG\0W"<50-/A1VNFU/.?=2=F/.2VH7YX"(#R:>A1U$D`5XEH@$:PV]EP MG)J>ZPI*RS=VT4I8\=39HWLJ(&(,_-1KOCDT=QRCXA_#7K14=NL51AWVL=8> M/89-;A#3W)X$46M-U&8:1K!I?SQE?8%8/:2&)$&>3.VJ[_2S,UY5_!J)\R;7 MO],!334+3OR6D+!_I6BH"=9A4,M&#:Q[Z4_S9O5X.H7_3LQ3$UC7].XQ*3N@ MOUN?.9#\F3>VE?NDVGN8_HO.+-4]9SW,W-/%2<(&%YR97?=R7_&T@$XL0P4] MR"UN]D`E;<#DGF#)NRF<]0[]\+GRM3)O_#0XQ(JKR_DG#5-Z):94568\YYU# M:]9H'3,LTMCHQT M9Q4.IE,.GRNYI1M2JU"4&E$NCFNPK,I+]LN_G?YZ_NO/SYXH/^,O!P=O'@&D M9OC7])=_$Q_J#\6S)SOF[E M80+N%F5*-"GO&;^;_Y#9$BPK\'+5NO-^3_[H+%E1.#5^3`X'C>+XP2D]&Z,5 M2H_#(C6?"1MK1L4`#$L.3.8AK5)[*XV#8Y>&-IQYSU"PWQ:^G6$&31LSJ$.& M,C43[/SS!VF'/@33W5Q;$;>2&6(DFN4VK_$%]+AM5;V=3BMM:*! MR>H>%]YA=77E)>VPI[1U7TBG MM_I=J3KW:W8YH?PI3\L]&QPR8I06ZOQMT/2:,`&FVXM%J7%.N==M(FQ_4&`4 MU!!=GV12"W52&>;5*.*I@*=X>K9)?Y/8^(;TZ3PLL`^36U2%;MA`(DI#7DA2 MU7#6OGPN+#=VH6262]V6'/;E<=1("S3:&OEBH".0OY:Z[;7Z///+R)E+4:^$ M"Q&H1`AUJD.X,C_*:BWB^G'7M`MD:'`ZFO=]KY`R?,JB!D8@5:6Z/G!+N1ET M>Q`'.[O[&(UTT^YN!47K"N6CPA\;"_\@&R.8RZ[ODYP%FM?@H=W./TF.Q`V$ M,-!K2#?^)S>VK5GQZL&3I4'BK\]_.GWYNR.,/)B&CUX_8.S\IS>AT,/TB MDYIA$B"$<\9T6Q[;8#5U8KPX><)V!Y8#>@#3'1O-NB/-:?9,5>_`N7]%FXJN MOS7LP11U7?K=_,=]$KMWJO%)I68$QT-0>6.ICN?H&>_=,Y2"=X5[KV!KP(7> M(>)!EV#\15X;[:[0._V]%0\O4FC^RH5Q%*7=KQ6>U-U]G*^K2P3>/AZ1NU:FPX MZ)(4'<<;"WF*A(6DDEE^BX/4&5,EKJ#JH#IUA#XKU6#1B)9Y^1D'RSIM# M#5Z!*(@AJ`YO[H@``OV):EP^F-+D%:XKC[*)V^/3GJJ]=PW(4E"F'_M)ECU? MMBZ,0`YQ9XV::.*HY^2<'K M_H.VAJ1_M%_0,XR2<>X,@L*XNG,3<'!E*ZK_.%""KT3I4P,*6R-CQC>9>S3I\ M>8/M?#Z;UT`:`\)I:A]#I3)L/LHIT\.GO5S3I+O+NP79?G=7];O?$ MTXHZ6QMB7S^RR7]O:]4>9@NE._1%V-8X%+&"]R^%%^<EG'1D7JN/1T)52E\6P+^-J6Q,0)LX\ZT:'Q#+F^*4S1/MDJ[\D2-L./DHR4 M]'$)F#W+R.],X6I.8Z1F4U.H/-WW]AX'ZL.0G4X4;I-).U6CZ'TJ6.A$_O/0 ML)%=V"00"EZO1T"O%321ECH_6^L+H,'& MJ((^UWY\`_;!=1[JM6]`SP854@X>[@<*+:\JL>BRPCX-.A]2%V%JV5:)8/:9 M=6ZDKOK@,DIL*H;2!7O!@DBL@#H:`647*L:086+'\#1%>1F&;==QS3,+'\K, M3Z7E/[J)'HE(?;YED-B`9?3(05-9.2<2**G92F6NH>]&G;E-&6^9+9,KU,&D M9+?7ZE#,).A:[O5P6\-.0)SC=+''0J,=7F86?L-)OU4D%9OI3"[=?E[:B:[) MZJ`\W\:KB'-'?WO8H4*4%Z=O?C9,NCG8WX^@R6"(A%JLQ%JJQ*(?ZVW^GCBU M_=;L3JE87."M"CN=4?YNOU2NUVG-YU74RLWW`=ACDG`A(S\253;^(!@6":=! ML_@M2;]_]&A?-3Q-TGW#AGJ3"_TRKA<3/N/U8NINK:WA,^6:IJ09<=B4"IT, M%!?X>2N!R9>*[`JHU?=9FEYW"NHWB_469+B,=?_Y"$XG<#5C),)-;S3,Y_,S MT1:+9RC)H&Q(D4/;*$=SY M&[65LIY;N8QO0AHQ[326!BT'-C8;L(Q@3:N)`'!2=;W0B_1GC2')0A6QD-I2 MHBCS?&78$J2S*9MY,=X)Z%"/WXL<_A8A6U:Z49#!<^Y@]T04XTO>P3>^, M+`$,GE,S-0I.9L&A7*I]51MM3V[@YZ) M&;D1]U>M]?M=7O=7K?7[75[W5ZWU^UU J>]U>M]?M=7O=7K?7[75[W5ZWU^UU>]U>M]?M=7M]_O5_`1-?85,`\``` ` end >Release-Note: >Audit-Trail: >Unformatted: From owner-freebsd-doc@FreeBSD.ORG Sat Aug 25 15:36:58 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 9DCC2106566B; Sat, 25 Aug 2012 15:36:58 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (gatekeeper.allbsd.org [IPv6:2001:2f0:104:e001::32]) by mx1.freebsd.org (Postfix) with ESMTP id F05D58FC0C; Sat, 25 Aug 2012 15:36:57 +0000 (UTC) Received: from alph.allbsd.org (p2214-ipbf2707funabasi.chiba.ocn.ne.jp [123.225.119.214]) (authenticated bits=128) by mail.allbsd.org (8.14.5/8.14.5) with ESMTP id q7PFaeoS010560 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 26 Aug 2012 00:36:50 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (localhost [127.0.0.1]) (authenticated bits=0) by alph.allbsd.org (8.14.5/8.14.5) with ESMTP id q7PFachK015645; Sun, 26 Aug 2012 00:36:40 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Sun, 26 Aug 2012 00:28:45 +0900 (JST) Message-Id: <20120826.002845.1234591490988245305.hrs@allbsd.org> To: gabor@FreeBSD.org From: Hiroki Sato In-Reply-To: <50326A70.5020009@FreeBSD.org> References: <50326A70.5020009@FreeBSD.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 6.5 on Emacs 23.4 / Mule 6.0 (HANACHIRUSATO) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Sun_Aug_26_00_28_45_2012_928)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: clamav-milter 0.97.4 at gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.2.7 (mail.allbsd.org [133.31.130.32]); Sun, 26 Aug 2012 00:36:50 +0900 (JST) X-Spam-Status: No, score=-98.1 required=13.0 tests=CONTENT_TYPE_PRESENT, ONLY1HOPDIRECT, SAMEHELOBY2HOP, USER_IN_WHITELIST autolearn=no version=3.3.2 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on gatekeeper.allbsd.org Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 25 Aug 2012 15:36:58 -0000 ----Security_Multipart(Sun_Aug_26_00_28_45_2012_928)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Gabor Kovesdan wrote in <50326A70.5020009@FreeBSD.org>: ga> - - For docs, there is now only one entity set for both articles and books ga> - - Some trademark/legalnotice entities have been merged to a cohesive ga> single entity file ga> - - Untranslated entity sets are now always pulled in from the English ga> tree instead of redundant copies ga> - - The base and enbase entities are already automatically generated so ga> remove inline definitions from individual files ga> - - Fetch the LEGAL file via http instead of depending on CVS ga> - - Convert id names to lowercase to avoid mixing different styles and for ga> better readability I am concerned about the impact of this change. There are many links to pages in www.freebsd.org and converting the ids can break them. -- Hiroki ----Security_Multipart(Sun_Aug_26_00_28_45_2012_928)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (FreeBSD) iEYEABECAAYFAlA47y0ACgkQTyzT2CeTzy3AagCgrdhOIQxU7ygrI97ajhSIPLHC bkAAn1MxvgxA8GGof7n/g5k8DNIX+IZX =D2Fb -----END PGP SIGNATURE----- ----Security_Multipart(Sun_Aug_26_00_28_45_2012_928)---- From owner-freebsd-doc@FreeBSD.ORG Sat Aug 25 16:58:19 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7E71B106564A; Sat, 25 Aug 2012 16:58:19 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 2CCB28FC15; Sat, 25 Aug 2012 16:58:18 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 5A92914E7FE1; Sat, 25 Aug 2012 18:58:17 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 3m0eEmkNnsEc; Sat, 25 Aug 2012 18:58:16 +0200 (CEST) Received: from [192.168.1.117] (catv-80-98-232-12.catv.broadband.hu [80.98.232.12]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id C48F314E7C30; Sat, 25 Aug 2012 18:58:16 +0200 (CEST) Message-ID: <50390426.40604@FreeBSD.org> Date: Sat, 25 Aug 2012 18:58:14 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:14.0) Gecko/20120604 Thunderbird/14.0a2 MIME-Version: 1.0 To: Hiroki Sato References: <50326A70.5020009@FreeBSD.org> <20120826.002845.1234591490988245305.hrs@allbsd.org> In-Reply-To: <20120826.002845.1234591490988245305.hrs@allbsd.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 25 Aug 2012 16:58:19 -0000 On 2012.08.25. 17:28, Hiroki Sato wrote: > ga> - - Convert id names to lowercase to avoid mixing different styles and for > ga> better readability > > I am concerned about the impact of this change. There are many links > to pages inwww.freebsd.org and converting the ids can break them. It is an important point but actually they are mostly header id and class names. There were a couple of other ones in these files: art.sgml logo.sgml java/howhelp.sgml The third one is extremely outdated and the first two is about logos and banners, which - I think - is not such type of content that usually people link from outside. With this in mind, do you think it is still a problem? If so, I can revert those files. Gabor From owner-freebsd-doc@FreeBSD.ORG Sat Aug 25 17:59:53 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 17DFC106566B; Sat, 25 Aug 2012 17:59:53 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (gatekeeper.allbsd.org [IPv6:2001:2f0:104:e001::32]) by mx1.freebsd.org (Postfix) with ESMTP id 107B28FC08; Sat, 25 Aug 2012 17:59:51 +0000 (UTC) Received: from alph.allbsd.org (p2214-ipbf2707funabasi.chiba.ocn.ne.jp [123.225.119.214]) (authenticated bits=128) by mail.allbsd.org (8.14.5/8.14.5) with ESMTP id q7PHxYiS039625 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 26 Aug 2012 02:59:44 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (localhost [127.0.0.1]) (authenticated bits=0) by alph.allbsd.org (8.14.5/8.14.5) with ESMTP id q7PHxXZZ017857; Sun, 26 Aug 2012 02:59:34 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Sun, 26 Aug 2012 02:58:45 +0900 (JST) Message-Id: <20120826.025845.2271349946315727916.hrs@allbsd.org> To: gabor@FreeBSD.org From: Hiroki Sato In-Reply-To: <50390426.40604@FreeBSD.org> References: <50326A70.5020009@FreeBSD.org> <20120826.002845.1234591490988245305.hrs@allbsd.org> <50390426.40604@FreeBSD.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 6.5 on Emacs 23.4 / Mule 6.0 (HANACHIRUSATO) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Sun_Aug_26_02_58_46_2012_262)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: clamav-milter 0.97.4 at gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.2.7 (mail.allbsd.org [133.31.130.32]); Sun, 26 Aug 2012 02:59:45 +0900 (JST) X-Spam-Status: No, score=-98.1 required=13.0 tests=CONTENT_TYPE_PRESENT, ONLY1HOPDIRECT, SAMEHELOBY2HOP, USER_IN_WHITELIST autolearn=no version=3.3.2 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on gatekeeper.allbsd.org Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 25 Aug 2012 17:59:53 -0000 ----Security_Multipart(Sun_Aug_26_02_58_46_2012_262)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Gabor Kovesdan wrote in <50390426.40604@FreeBSD.org>: ga> On 2012.08.25. 17:28, Hiroki Sato wrote: ga> > ga> - - Convert id names to lowercase to avoid mixing different styles ga> > and for ga> > ga> better readability ga> > ga> > I am concerned about the impact of this change. There are many links ga> > to pages inwww.freebsd.org and converting the ids can break them. ga> It is an important point but actually they are mostly header id and ga> class names. There were a couple of other ones in these files: ga> art.sgml ga> logo.sgml ga> java/howhelp.sgml ga> ga> The third one is extremely outdated and the first two is about logos ga> and banners, which - I think - is not such type of content that ga> usually people link from outside. With this in mind, do you think it ga> is still a problem? If so, I can revert those files. Ah, what I wanted to point out is that not only in the headers the ids are converted to lower case in the new framework. I also think we can ignore the impact for the headers. As you know, the Jade program uses the upper case because it supports SGML general name normalization for the ids and NAMECASE GENERAL is YES in SGML declaration for HTML. The xsltproc program does not always do so because NAMECASE GENERAL is always NO in XML. -- Hiroki ----Security_Multipart(Sun_Aug_26_02_58_46_2012_262)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (FreeBSD) iEYEABECAAYFAlA5ElYACgkQTyzT2CeTzy19GwCg2LtkLekAy90GC2BE78BBW7mg IukAoLixs79F8xYz0Q081yZ+sk7d3JxJ =MxzV -----END PGP SIGNATURE----- ----Security_Multipart(Sun_Aug_26_02_58_46_2012_262)---- From owner-freebsd-doc@FreeBSD.ORG Sat Aug 25 19:16:26 2012 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B90DA106564A; Sat, 25 Aug 2012 19:16:26 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 63FFF8FC08; Sat, 25 Aug 2012 19:16:26 +0000 (UTC) Received: from server.mypc.hu (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id 7D96214E7F3C; Sat, 25 Aug 2012 21:16:24 +0200 (CEST) X-Virus-Scanned: amavisd-new at server.mypc.hu Received: from server.mypc.hu ([127.0.0.1]) by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id VcVQuIvaRqbm; Sat, 25 Aug 2012 21:16:18 +0200 (CEST) Received: from [192.168.1.101] (D94162B4.catv.pool.telekom.hu [217.65.98.180]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id 25E9814E7C30; Sat, 25 Aug 2012 21:16:17 +0200 (CEST) Message-ID: <50392481.1070708@FreeBSD.org> Date: Sat, 25 Aug 2012 21:16:17 +0200 From: Gabor Kovesdan User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:13.0) Gecko/20120614 Thunderbird/13.0.1 MIME-Version: 1.0 To: Hiroki Sato References: <50326A70.5020009@FreeBSD.org> <20120826.002845.1234591490988245305.hrs@allbsd.org> <50390426.40604@FreeBSD.org> <20120826.025845.2271349946315727916.hrs@allbsd.org> In-Reply-To: <20120826.025845.2271349946315727916.hrs@allbsd.org> X-Enigmail-Version: 1.4.3 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 25 Aug 2012 19:16:26 -0000 Em 25-08-2012 19:58, Hiroki Sato escreveu: > Ah, what I wanted to point out is that not only in the headers the > ids are converted to lower case in the new framework. I also > think we can ignore the impact for the headers. > > As you know, the Jade program uses the upper case because it > supports SGML general name normalization for the ids and NAMECASE > GENERAL is YES in SGML declaration for HTML. The xsltproc program > does not always do so because NAMECASE GENERAL is always NO in > XML. Ok, now I see you are referring to docs not www. I was talking about www because I only did manual conversion there. A side effect of changing the SGML declaration used by Jade to enforce XML syntax is that NAMECASE GENERAL is NO as you said. For now, I don't know what to do with that. If we start using XSLT, we can customize the DocBook XSL stlyesheets to do such a normalization. I think it shouldn't be difficult but I'll have to see how the corresponding parts are written in DocBook XSL. Do you have any suggestions how to handle this for the interim period? Gabor