Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1v1vtY-00EMck-9f for pgsql-docs@arkaria.postgresql.org; Fri, 26 Sep 2025 00:01:04 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.94.2) (envelope-from ) id 1v1vtW-006rKJ-Vq for pgsql-docs@arkaria.postgresql.org; Fri, 26 Sep 2025 00:01:03 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1v1vtW-006rKB-KO for pgsql-docs@lists.postgresql.org; Fri, 26 Sep 2025 00:01:02 +0000 Received: from mail-vs1-xe2b.google.com ([2607:f8b0:4864:20::e2b]) by makus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.96) (envelope-from ) id 1v1vtU-002S7X-1Y for pgsql-docs@lists.postgresql.org; Fri, 26 Sep 2025 00:01:01 +0000 Received: by mail-vs1-xe2b.google.com with SMTP id ada2fe7eead31-580a1f1f187so670565137.1 for ; Thu, 25 Sep 2025 17:01:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1758844860; x=1759449660; darn=lists.postgresql.org; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=SsAXsw0Gm431iXJO61UoEwnc2Gg47Y063HlOjJ71H1w=; b=lg+E+V65C/TMwfZdZL834a+I35+0gtqaN5j7kBHAXPcMnmruNRAt0dcGhX2YN1M48/ qJ2J/i1Rbtw9qrLVyAMsPOIMTyn+lkmnlNMP/GIYEEaBGmByWsmc4k0yDTMwCBpPdDxI 36Uhf9E6cTKmgVCQPnvOGfghMAalmojPPHJTqCB4Gp/+YwRk5UOR8ZSEn8PsHgetyXSr 1NvqnInkUAuBNBwm9uVVVqg/X0x4ExtnGvIK3mHvnHil31cvaIRFvQohIVNDw1meUNSG vPg7Jo3fYcGJRt90sLlc8zcHdZGvJhHdVNqXxgVyDE/IzFZFXXZROl+r686ADN8/1ape 9Abw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1758844860; x=1759449660; h=to:subject:message-id:date:from:mime-version:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=SsAXsw0Gm431iXJO61UoEwnc2Gg47Y063HlOjJ71H1w=; b=uRTh6sBj5BvkxHZYRKzgkH4Dv1KE87iX6ohw06I5qUAsDAEWd9bTtmIkyGyW3bR/JH XwxmUCiirQT3Qtc2JrVhHaLcVACQibAjNb7iBppmdbww6c9n+NMkRUW+NbKzXD+dXXa8 UaTI74CCwby9Okr2OTkVcyXCQx3UjrXqXGyjlcDHrBmqQuXu6dtlM9xW/lkvJx6gADlo bUzeLeCHN2ttFPF51DOTboVzeSeYQXgTP3BCEHP3FJcr4g+BFC2sRZDVwy05fwHuxGCk i+PEvpT82ii6aLwJMPmAmJyWcgBrPYBYMEoV09kzL1tBejP3dqH993Pdku1Hb43EL2YJ rLjg== X-Gm-Message-State: AOJu0YwfbIAWiC8F560j2CgGx8xAGwVzElfh2SX68QEuFRD/5N8gw0Vu Y26lVx0pnA37NZIiMAL7O/0HFQItDCpVvOahDxbMe7QBz3wP4kp17DBSEHk3F0rQUg5WK0vSgJZ ijiQuKnrpiQCO/24DKj/c4OLxOGxb6eFRDar8Q18QRg== X-Gm-Gg: ASbGncuaS6Wm6M+9Fs4r/rEprRHBBOtRllDjG0gztxO3gp38/49qVG0ehminepIDtmc Z4E2jRNb/LpA25rSP3DjNlz81ELyRuLQ9wQtlNikPbj22HNlvAJQ4CcLwi+hH2iUK8rz4gdRFMe TXf/oRnXX/vlyQ/Jo9OOyf9+BGzesv1rrK6L26tcKk6ejXrFHMrC2HKDdtmgHxTjuO/4GC/WJ6G qt/yc9TvSwCxE4hhL5s8E1Cu9qJwTQFLYEoEurt3oAqeSfbPwoi3ArZbOuYi3DGHZ1lbl6Cg2SP HmpTTml38XHSasioPQtJ5npuy7OkgNIn2pNXeqU= X-Google-Smtp-Source: AGHT+IHwhlmdj3hElcy3iVs/esdRw11kIjJbosdJMc50WxrPUujpz3bPn/jwvvpoMTpiOFg72t7D+Vf10QFVdfqfSJY= X-Received: by 2002:a05:6102:5488:b0:524:3e12:6590 with SMTP id ada2fe7eead31-5acc7d3c6dbmr2163721137.14.1758844859676; Thu, 25 Sep 2025 17:00:59 -0700 (PDT) MIME-Version: 1.0 From: jian he Date: Fri, 26 Sep 2025 08:00:00 +0800 X-Gm-Features: AS18NWA_jqreDe_QSPHJhxRz3Ddx8P7IGwUSQLunXNTqpUONXCP1V4iK28D33cw Message-ID: Subject: make create_table.sgml Synopsis section less wide To: pgsql-docs@lists.postgresql.org Content-Type: multipart/mixed; boundary="0000000000001396f3063fa8fbc0" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --0000000000001396f3063fa8fbc0 Content-Type: text/plain; charset="UTF-8" hi. https://www.postgresql.org/docs/devel/sql-createtable.html Synopsis section, The second line is currently too long, and the explanation for exclude_element (the third line from the bottom) is also quite wide (lengthy), the like_option also too long. I mentioned this earlier, and while working on CREATE TABLE LIKE related features, I came across this minor issue again. If we make it less wide, then we don't need to scroll horizontally. please check the attached screenshot to see the effect of the change what do you think? --0000000000001396f3063fa8fbc0 Content-Type: text/x-patch; charset="US-ASCII"; name="v1-0001-doc-make-create_table.sgml-synopsis-section-less-wide.patch" Content-Disposition: attachment; filename="v1-0001-doc-make-create_table.sgml-synopsis-section-less-wide.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_mfzfmiz70 RnJvbSA2MjdhM2I5MjZhYTYxN2E5YjU5ODY3MmFmYjAxM2ZmZDkxZTMzYjY3IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBqaWFuIGhlIDxqaWFuLnVuaXZlcnNhbGl0eUBnbWFpbC5jb20+ CkRhdGU6IFRodSwgMjUgU2VwIDIwMjUgMjA6NTI6MzcgKzA4MDAKU3ViamVjdDogW1BBVENIIHYx IDEvMV0gZG9jIG1ha2UgY3JlYXRlX3RhYmxlLnNnbWwgc3lub3BzaXMgc2VjdGlvbiBsZXNzIHdp ZGUKCi0tLQogZG9jL3NyYy9zZ21sL3JlZi9jcmVhdGVfdGFibGUuc2dtbCB8IDEyICsrKysrKysr Ky0tLQogMSBmaWxlIGNoYW5nZWQsIDkgaW5zZXJ0aW9ucygrKSwgMyBkZWxldGlvbnMoLSkKCmRp ZmYgLS1naXQgYS9kb2Mvc3JjL3NnbWwvcmVmL2NyZWF0ZV90YWJsZS5zZ21sIGIvZG9jL3NyYy9z Z21sL3JlZi9jcmVhdGVfdGFibGUuc2dtbAppbmRleCBkYzAwMGU5MTNjMS4uYTdkZDYwYTZmZjYg MTAwNjQ0Ci0tLSBhL2RvYy9zcmMvc2dtbC9yZWYvY3JlYXRlX3RhYmxlLnNnbWwKKysrIGIvZG9j L3NyYy9zZ21sL3JlZi9jcmVhdGVfdGFibGUuc2dtbApAQCAtMjIsNyArMjIsMTAgQEAgUG9zdGdy ZVNRTCBkb2N1bWVudGF0aW9uCiAgPHJlZnN5bm9wc2lzZGl2PgogPHN5bm9wc2lzPgogQ1JFQVRF IFsgWyBHTE9CQUwgfCBMT0NBTCBdIHsgVEVNUE9SQVJZIHwgVEVNUCB9IHwgVU5MT0dHRUQgXSBU QUJMRSBbIElGIE5PVCBFWElTVFMgXSA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+dGFi bGVfbmFtZTwvcmVwbGFjZWFibGU+ICggWwotICB7IDxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1l dGVyIj5jb2x1bW5fbmFtZTwvcmVwbGFjZWFibGU+IDxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1l dGVyIj5kYXRhX3R5cGU8L3JlcGxhY2VhYmxlPiBbIFNUT1JBR0UgeyBQTEFJTiB8IEVYVEVSTkFM IHwgRVhURU5ERUQgfCBNQUlOIHwgREVGQVVMVCB9IF0gWyBDT01QUkVTU0lPTiA8cmVwbGFjZWFi bGU+Y29tcHJlc3Npb25fbWV0aG9kPC9yZXBsYWNlYWJsZT4gXSBbIENPTExBVEUgPHJlcGxhY2Vh YmxlPmNvbGxhdGlvbjwvcmVwbGFjZWFibGU+IF0gWyA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFt ZXRlciI+Y29sdW1uX2NvbnN0cmFpbnQ8L3JlcGxhY2VhYmxlPiBbIC4uLiBdIF0KKyAgeyA8cmVw bGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+Y29sdW1uX25hbWU8L3JlcGxhY2VhYmxlPiA8cmVw bGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+ZGF0YV90eXBlPC9yZXBsYWNlYWJsZT4KKyAgICB8 IFsgU1RPUkFHRSB7IFBMQUlOIHwgRVhURVJOQUwgfCBFWFRFTkRFRCB8IE1BSU4gfCBERUZBVUxU IH0gXQorICAgIHwgWyBDT01QUkVTU0lPTiA8cmVwbGFjZWFibGU+Y29tcHJlc3Npb25fbWV0aG9k PC9yZXBsYWNlYWJsZT4gXQorICAgIHwgWyBDT0xMQVRFIDxyZXBsYWNlYWJsZT5jb2xsYXRpb248 L3JlcGxhY2VhYmxlPiBdIFsgPHJlcGxhY2VhYmxlIGNsYXNzPSJwYXJhbWV0ZXIiPmNvbHVtbl9j b25zdHJhaW50PC9yZXBsYWNlYWJsZT4gWyAuLi4gXSBdCiAgICAgfCA8cmVwbGFjZWFibGU+dGFi bGVfY29uc3RyYWludDwvcmVwbGFjZWFibGU+CiAgICAgfCBMSUtFIDxyZXBsYWNlYWJsZT5zb3Vy Y2VfdGFibGU8L3JlcGxhY2VhYmxlPiBbIDxyZXBsYWNlYWJsZT5saWtlX29wdGlvbjwvcmVwbGFj ZWFibGU+IC4uLiBdIH0KICAgICBbLCAuLi4gXQpAQCAtODgsNyArOTEsOCBAQCBjbGFzcz0icGFy YW1ldGVyIj5yZWZlcmVudGlhbF9hY3Rpb248L3JlcGxhY2VhYmxlPiBdIFsgT04gVVBEQVRFIDxy ZXBsYWNlYWJsZSBjbAogCiA8cGhyYXNlPmFuZCA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRl ciI+bGlrZV9vcHRpb248L3JlcGxhY2VhYmxlPiBpczo8L3BocmFzZT4KIAoteyBJTkNMVURJTkcg fCBFWENMVURJTkcgfSB7IENPTU1FTlRTIHwgQ09NUFJFU1NJT04gfCBDT05TVFJBSU5UUyB8IERF RkFVTFRTIHwgR0VORVJBVEVEIHwgSURFTlRJVFkgfCBJTkRFWEVTIHwgU1RBVElTVElDUyB8IFNU T1JBR0UgfCBBTEwgfQoreyBJTkNMVURJTkcgfCBFWENMVURJTkcgfQoreyBDT01NRU5UUyB8IENP TVBSRVNTSU9OIHwgQ09OU1RSQUlOVFMgfCBERUZBVUxUUyB8IEdFTkVSQVRFRCB8IElERU5USVRZ IHwgSU5ERVhFUyB8IFNUQVRJU1RJQ1MgfCBTVE9SQUdFIHwgQUxMIH0KIAogPHBocmFzZT5hbmQg PHJlcGxhY2VhYmxlIGNsYXNzPSJwYXJhbWV0ZXIiPnBhcnRpdGlvbl9ib3VuZF9zcGVjPC9yZXBs YWNlYWJsZT4gaXM6PC9waHJhc2U+CiAKQEAgLTEwNSw3ICsxMDksOSBAQCBXSVRIICggTU9EVUxV UyA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+bnVtZXJpY19saXRlcmFsPC9yZXBsYWNl YWJsZT4sIFJFTQogCiA8cGhyYXNlPjxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1ldGVyIj5leGNs dWRlX2VsZW1lbnQ8L3JlcGxhY2VhYmxlPiBpbiBhbiA8bGl0ZXJhbD5FWENMVURFPC9saXRlcmFs PiBjb25zdHJhaW50IGlzOjwvcGhyYXNlPgogCi17IDxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1l dGVyIj5jb2x1bW5fbmFtZTwvcmVwbGFjZWFibGU+IHwgKCA8cmVwbGFjZWFibGUgY2xhc3M9InBh cmFtZXRlciI+ZXhwcmVzc2lvbjwvcmVwbGFjZWFibGU+ICkgfSBbIENPTExBVEUgPHJlcGxhY2Vh YmxlIGNsYXNzPSJwYXJhbWV0ZXIiPmNvbGxhdGlvbjwvcmVwbGFjZWFibGU+IF0gWyA8cmVwbGFj ZWFibGUgY2xhc3M9InBhcmFtZXRlciI+b3BjbGFzczwvcmVwbGFjZWFibGU+IFsgKCA8cmVwbGFj ZWFibGUgY2xhc3M9InBhcmFtZXRlciI+b3BjbGFzc19wYXJhbWV0ZXI8L3JlcGxhY2VhYmxlPiA9 IDxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1ldGVyIj52YWx1ZTwvcmVwbGFjZWFibGU+IFssIC4u LiBdICkgXSBdIFsgQVNDIHwgREVTQyBdIFsgTlVMTFMgeyBGSVJTVCB8IExBU1QgfSBdCit7IDxy ZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1ldGVyIj5jb2x1bW5fbmFtZTwvcmVwbGFjZWFibGU+IHwg KCA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+ZXhwcmVzc2lvbjwvcmVwbGFjZWFibGU+ ICkgfQorICAgfCBbIENPTExBVEUgPHJlcGxhY2VhYmxlIGNsYXNzPSJwYXJhbWV0ZXIiPmNvbGxh dGlvbjwvcmVwbGFjZWFibGU+IF0KKyAgIHwgWyA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRl ciI+b3BjbGFzczwvcmVwbGFjZWFibGU+IFsgKCA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRl ciI+b3BjbGFzc19wYXJhbWV0ZXI8L3JlcGxhY2VhYmxlPiA9IDxyZXBsYWNlYWJsZSBjbGFzcz0i cGFyYW1ldGVyIj52YWx1ZTwvcmVwbGFjZWFibGU+IFssIC4uLiBdICkgXSBdIFsgQVNDIHwgREVT QyBdIFsgTlVMTFMgeyBGSVJTVCB8IExBU1QgfSBdCiAKIDxwaHJhc2U+PHJlcGxhY2VhYmxlIGNs YXNzPSJwYXJhbWV0ZXIiPnJlZmVyZW50aWFsX2FjdGlvbjwvcmVwbGFjZWFibGU+IGluIGEgPGxp dGVyYWw+Rk9SRUlHTiBLRVk8L2xpdGVyYWw+LzxsaXRlcmFsPlJFRkVSRU5DRVM8L2xpdGVyYWw+ IGNvbnN0cmFpbnQgaXM6PC9waHJhc2U+CiAKLS0gCjIuMzQuMQoK --0000000000001396f3063fa8fbc0--