From owner-freebsd-doc@FreeBSD.ORG Sat Nov 29 01:44:58 2008 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 087DA106564A for ; Sat, 29 Nov 2008 01:44:58 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: from fg-out-1718.google.com (fg-out-1718.google.com [72.14.220.158]) by mx1.freebsd.org (Postfix) with ESMTP id 7F13E8FC14 for ; Sat, 29 Nov 2008 01:44:57 +0000 (UTC) (envelope-from pali.gabor@googlemail.com) Received: by fg-out-1718.google.com with SMTP id l26so1080554fgb.35 for ; Fri, 28 Nov 2008 17:44:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :organization:user-agent:mime-version:to:subject:x-enigmail-version :content-type:content-transfer-encoding:sender; bh=cBD8VEYJW8fhfkDJ1uZRBPYMa7tbjvvmkOa5TaK10zM=; b=SN0JbpCjU/YzeSIadqvWNYLcG+kR+9UDDAvY7VMtTDhyXOlVZdukNdznkx3f5HpFdp YeitoIf3Y0ChzGAlvjEjahD5YiU8dFt+CCaCmFHMF5EEhAV0Hlm1WBneYwnpihKU2+HY MGX3klpXRhGw52pgXTsxzjWw/a8t8tOy6W0Nk= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=message-id:date:from:organization:user-agent:mime-version:to :subject:x-enigmail-version:content-type:content-transfer-encoding :sender; b=NLQS/ZlK0Ma2BUEI6WPJaubalPIDwLQHkLJKRCdUrE5lD7lNPmRcsPdo2lvS7hZX75 cJlPF6YfaG/bo8f8DCWxlNT1tjc7wt86DJ08DUmXsUmLSycDIMpIJiRIDxxA8CmfxPzf HgZbwDWrL8qj/pZXXaFr2JjmC+XfmEoQ6iWrc= Received: by 10.102.234.20 with SMTP id g20mr3398418muh.116.1227923096125; Fri, 28 Nov 2008 17:44:56 -0800 (PST) Received: from ?192.168.1.110? (catv-89-132-186-236.catv.broadband.hu [89.132.186.236]) by mx.google.com with ESMTPS id i5sm1989133mue.26.2008.11.28.17.44.55 (version=TLSv1/SSLv3 cipher=RC4-MD5); Fri, 28 Nov 2008 17:44:55 -0800 (PST) Message-ID: <49309E91.7050006@FreeBSD.org> Date: Sat, 29 Nov 2008 02:44:49 +0100 From: Gabor PALI Organization: The FreeBSD Project User-Agent: Thunderbird 2.0.0.17 (X11/20081023) MIME-Version: 1.0 To: freebsd-doc@freebsd.org X-Enigmail-Version: 0.95.7 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Sender: =?UTF-8?B?UMOBTEkgR8OhYm9yIErDoW5vcw==?= Subject: RFR: A Pack of Patches for Chapter "SGML Markup" in FDP Primer 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, 29 Nov 2008 01:44:58 -0000 Hello, I encountered some interesting parts in the SGML Markup chapter [1] during translation of the FDP Primer [2], so I decided to fix them up and send the corresponding patch in small pieces to this list. I would like you to check and comment these patches before I commit them. My proposed changes are as follows: http://people.freebsd.org/~pgj/patches/2008/11/29/doc.en.books.fdp-primer.sgml-markup.patch/1.diff I think there is no need for this "baroque" notation, since I could not find any other instances in the document. http://people.freebsd.org/~pgj/patches/2008/11/29/doc.en.books.fdp-primer.sgml-markup.patch/2.diff Oh, yeah. Ports Collection should be capitalized. http://people.freebsd.org/~pgj/patches/2008/11/29/doc.en.books.fdp-primer.sgml-markup.patch/3.diff I think word "of" should be "or" because we are talking about "rowspan and/or colspan attributes", so it would rhyme with "number of rows or columns" or "number of rows and/or columns". http://people.freebsd.org/~pgj/patches/2008/11/29/doc.en.books.fdp-primer.sgml-markup.patch/4.diff In my opinion, some literals and attributes want a element. http://people.freebsd.org/~pgj/patches/2008/11/29/doc.en.books.fdp-primer.sgml-markup.patch/5.diff Remove leftovers of the first-person narration, add more generalization to the text, refer to the Handbook just as an example. Update path and names of the Handbook sources. http://people.freebsd.org/~pgj/patches/2008/11/29/doc.en.books.fdp-primer.sgml-markup.patch/6.diff Add some missing text to the
example. http://people.freebsd.org/~pgj/patches/2008/11/29/doc.en.books.fdp-primer.sgml-markup.patch/7.diff I think there is no example of tables with borders, however the text mentions it. Perhaps it would be a better idea to show a table with borders and a table without borders. http://people.freebsd.org/~pgj/patches/2008/11/29/doc.en.books.fdp-primer.sgml-markup.patch/8.diff Simplify some parts of the manual page markup example, and fix all sendmail-related manual page sections from 8 to 1 (Whoops). http://people.freebsd.org/~pgj/patches/2008/11/29/doc.en.books.fdp-primer.sgml-markup.patch/9.diff Host bento.FreeBSD.org does not exist. Replace it with pointyhat. Let us have a working example. http://people.freebsd.org/~pgj/patches/2008/11/29/doc.en.books.fdp-primer.sgml-markup.patch/10.diff I think the example for elements includes some unnecessary tags :) http://people.freebsd.org/~pgj/patches/2008/11/29/doc.en.books.fdp-primer.sgml-markup.patch/11.diff Add missing parentheses. Thanks for the replies. Regards, :g [1] http://www.freebsd.org/doc/en/books/fdp-primer/sgml-markup.html [2] http://www.freebsd.org/doc/en/books/fdp-primer/