From owner-freebsd-doc@FreeBSD.ORG Wed May 29 06:06:41 2013 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 2F6F892C for ; Wed, 29 May 2013 06:06:41 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-we0-x230.google.com (mail-we0-x230.google.com [IPv6:2a00:1450:400c:c03::230]) by mx1.freebsd.org (Postfix) with ESMTP id BB99DC38 for ; Wed, 29 May 2013 06:06:40 +0000 (UTC) Received: by mail-we0-f176.google.com with SMTP id p58so5818026wes.21 for ; Tue, 28 May 2013 23:06:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=MjARbZKL5WLOj/7xbd9fnJfB+AofjyNf3JBCSKpSEXQ=; b=rzg4bgdCVF2NVMsb3meGW/VgRzmQ6TwejRRgnLR+UgaqWpqU1QhdfeN3p//CL80+KA x6+90c9Tbp/JumqzYzf5g1eaVBOzUL34y54pCKc0WwSaeY9Ud2CwJ8wgFxFtkEPSM7iD ql6qLlrlWIXiKnpWFUxNPes8Jclz/MBNJMzrg= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type:x-gm-message-state; bh=MjARbZKL5WLOj/7xbd9fnJfB+AofjyNf3JBCSKpSEXQ=; b=eok6iRMT2e02afx5aV1ke/XHCjRMyvURAXseiIYKWRBnQ7EptuVr7ncrvZ2tae5dJi ffzRyl1PUtx8U2WxOSkO4kUWmuY8Rph+X2kailZa37qeo8NksJlnwNJFwIia6Vbu9cP4 Ndf8ug+vRE0rpzJbheX72M4M1dNkwWjqEFEwratewXfbvbshraWcFDpNfALUyndwIwDc 6kmBhxMVKwX9st20N1+CrQAGzO5FgPZfVTuflZJ19vb7qzgpBczTr0q17f1g0ex/RMGC BEuCLArsA67xlXxUKXWQ0gqAg6FDuDQa9YmmCTV3ggVL/Zb8v9Ephp3WekyxbnHO9UN4 D61A== X-Received: by 10.180.109.48 with SMTP id hp16mr899602wib.24.1369807599630; Tue, 28 May 2013 23:06:39 -0700 (PDT) MIME-Version: 1.0 Received: by 10.194.86.197 with HTTP; Tue, 28 May 2013 23:06:09 -0700 (PDT) In-Reply-To: References: <519FA4FE.4030305@FreeBSD.org> <51A51C40.1030205@FreeBSD.org> From: Eitan Adler Date: Wed, 29 May 2013 08:06:09 +0200 Message-ID: Subject: Re: RFC: Upgrading to DocBook 5.0 To: Warren Block Content-Type: text/plain; charset=UTF-8 X-Gm-Message-State: ALoCoQlWXiAKe68wxR0cAoJaCKWloFT368Fvv0GDYbnUvpKITD1IVgUG0dzs5IfxZsyJWpNkU5Kt Cc: doc@freebsd.org, Gabor Kovesdan X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 29 May 2013 06:06:41 -0000 On 29 May 2013 02:24, Warren Block wrote: > On Tue, 28 May 2013, Gabor Kovesdan wrote: > >> I have a patch to preview how it would look like: >> http://kovesdan.org/patches/fbsd-docbook5.diff >> >> Please comment on this. It is very important to discuss this kind of >> changes. > > > I think that keeping up with DocBook versions is important. > > Leaving out the systemitem class simplifies markup. One nice thing about > those classes is that they remove ambiguity during editing. Without them, it > may be difficult to tell from context whether a systemitem is a username or > a directory name, for example. Although if that is not clear from context, > it suggests the text needs improvement. Agreed. Unless the class could be used to provide additional formatting options I don't see the need for it here. It provides semantic value, but I don't think much is gained from that here. -- Eitan Adler