Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from ) id 1ZKTU9-0003vf-Re for pgsql-docs@arkaria.postgresql.org; Wed, 29 Jul 2015 15:41:38 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.84) (envelope-from ) id 1ZKTU9-0006Xl-95 for pgsql-docs@arkaria.postgresql.org; Wed, 29 Jul 2015 15:41:37 +0000 Received: from makus.postgresql.org ([2001:4800:1501:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.84) (envelope-from ) id 1ZKTON-0005DW-WA for pgsql-docs@postgresql.org; Wed, 29 Jul 2015 15:35:40 +0000 Received: from mail-vn0-x229.google.com ([2607:f8b0:400c:c0f::229]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.84) (envelope-from ) id 1ZKTOG-0006sS-US for pgsql-docs@postgresql.org; Wed, 29 Jul 2015 15:35:38 +0000 Received: by vnds125 with SMTP id s125so3309740vnd.1 for ; Wed, 29 Jul 2015 08:35:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=GnvDYUQa2ZS//FMmVw+DH89Gg/oBjFQHRfLssdPck/I=; b=zdYPgMD06M8wuMm6L8/AkfMQlK1ez8qJ8jtrsCKxsAD1XQa89aaJqExkq0OGFj3SzU knEstfgwOngH6mu6NoxG0VBZ52fUuyda1shGF3cc9V6CMstZ0TnBhagQXC7ojODPDSy3 pDmmOwTyoXFViPi9ggyEWPSsyuJhiZV5SMi4zIVVcDqXRsbda3ght3dsdnaZxlc71dpC Thq1INGtLfd1RKwVvrYO8EUo9OHU8l64sqA4YMIfm2IqpFNg5cuU8Ga05MsRFECOTXXB 7zV+blIIt7cmRQXTp9+mduZ6Ehew8/f+6Wd+iFuQiAyEz6vU/LguC3TD3AvDXo1ixcXN Y7OQ== MIME-Version: 1.0 X-Received: by 10.52.107.196 with SMTP id he4mr54668065vdb.29.1438184131453; Wed, 29 Jul 2015 08:35:31 -0700 (PDT) Received: by 10.31.1.215 with HTTP; Wed, 29 Jul 2015 08:35:31 -0700 (PDT) In-Reply-To: References: Date: Wed, 29 Jul 2015 11:35:31 -0400 Message-ID: Subject: Re: bgworker / SPI docs patches From: Robert Haas To: Craig Ringer Cc: pgsql-docs Content-Type: text/plain; charset=UTF-8 X-Pg-Spam-Score: -2.0 (--) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-docs Precedence: bulk Sender: pgsql-docs-owner@postgresql.org On Tue, Feb 17, 2015 at 3:29 AM, Craig Ringer wrote: > After spending a while working on the BDR extension I've found that the > current documentation on the SPI and bgworkers could use some more detail. > > In the process I've put cross reference labels in for most chapter headings, > as I got sick of seeing "Chapter 33" (or whatever) everywhere in the docs. > I'd like to progressively add them to every section, refentry, chapter, etc > that has an id. > > I hope this is useful. Per Peter, 0001 is not wanted. I tend to agree with him on that point of style. Patch 0002 makes the docs build fail unless 0001 is applied first, so I can't pursue that unless you want to revise that accordingly. I've committed 0003, and will look at 0004 next. -- Robert Haas EnterpriseDB: http://www.enterprisedb.com The Enterprise PostgreSQL Company -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs