Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gkfJe-0000fx-E2 for pgsql-hackers@arkaria.postgresql.org; Sat, 19 Jan 2019 01:20:54 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1gkfJc-0001eF-Tp for pgsql-hackers@arkaria.postgresql.org; Sat, 19 Jan 2019 01:20:52 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gkfJc-0001dk-8K for pgsql-hackers@lists.postgresql.org; Sat, 19 Jan 2019 01:20:52 +0000 Received: from bay.acenet.us ([173.230.252.50]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gkfJZ-0004uK-I4 for pgsql-hackers@postgresql.org; Sat, 19 Jan 2019 01:20:51 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=anastigmatix.net; s=default; h=Content-Transfer-Encoding:Content-Type: In-Reply-To:MIME-Version:Date:Message-ID:From:Cc:References:To:Subject:Sender :Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help: List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=ITX0n6ffHZTtIqg8KppqNnInK5vdw0bahYcbZjsvWVE=; b=cBpwXPG2QdTxllHrQmS5KQkRtg L1X+Z9Ii+/zEPiFSkrhQuxuMbSGRN4HBzHJvFIvkyVue+bbIQmHp7CgX3kRZS2sP7ckEXqIlGx+Y1 lhCjafZEbnxw+qr+5eGDDR9naG/gDYct0Xfnc7p86zzC/dhJaY77b/hqwOAv1WXUQlEkQ5goHmAaz RDgbE9kIH9U34/VI/vHe2UR3eyfzVY6pK7LDew121pahevNPaSE9fzq9RprQtStF6R6xu7RejZJHT F8zCiUQkcL63vSrDIX7o+HOI7zjOsjHoT2SKbTczlGnoRmmmC8vnR1FULhyaNJ7oOFonuuM0RpYRp SfPqxwDw==; Received: from [192.182.57.242] (port=48878) by bay.acenet.us with esmtpsa (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128) (Exim 4.91) (envelope-from ) id 1gkfJV-0094hj-HS; Fri, 18 Jan 2019 20:20:46 -0500 Subject: House style for DocBook documentation? To: Pavel Stehule References: <20181025194720.ylmw64xqlnjr5wja@alvherre.pgsql> <45C74339-3531-46BD-A595-37183C6730A1@winand.at> <5C283168.8060001@anastigmatix.net> <5C291741.9060506@anastigmatix.net> <5C298BCB.4060704@anastigmatix.net> <5C382028.8020704@anastigmatix.net> <5C382766.2080409@anastigmatix.net> Cc: Markus Winand , Alvaro Herrera , Tom Lane , PostgreSQL Hackers From: Chapman Flack Message-ID: <5C427B6C.7050301@anastigmatix.net> Date: Fri, 18 Jan 2019 20:20:44 -0500 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.7.0 MIME-Version: 1.0 In-Reply-To: <5C382766.2080409@anastigmatix.net> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-OutGoing-Spam-Status: No, score=-100.2 X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - bay.acenet.us X-AntiAbuse: Original Domain - postgresql.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - anastigmatix.net X-Get-Message-Sender-Via: bay.acenet.us: authenticated_id: chap@anastigmatix.net X-Authenticated-Sender: bay.acenet.us: chap@anastigmatix.net X-Source: X-Source-Args: X-Source-Dir: X-From-Rewrite: unmodified, already matched List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk Hi, Is there, somewhere, a written-up "house style" for what DocBook 4.2 elements to use for which types of content in the manual? In func.sgml I'm seeing what looks like a variety of examples, and I'm not sure which ones to try to follow. Thanks, -Chap