Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nRNlu-0002OG-6B for pgsql-docs@arkaria.postgresql.org; Tue, 08 Mar 2022 00:32:14 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1nRNls-0004lj-23 for pgsql-docs@arkaria.postgresql.org; Tue, 08 Mar 2022 00:32:12 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nRNlr-0004lZ-KW for pgsql-docs@lists.postgresql.org; Tue, 08 Mar 2022 00:32:11 +0000 Received: from mail-wr1-x42f.google.com ([2a00:1450:4864:20::42f]) by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1nRNlo-0002I2-5p for pgsql-docs@lists.postgresql.org; Tue, 08 Mar 2022 00:32:10 +0000 Received: by mail-wr1-x42f.google.com with SMTP id i8so25886850wrr.8 for ; Mon, 07 Mar 2022 16:32:08 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=1zSvJYMfT1VQzNcrLDhiytFy3rM28U0vxLOE4T/bb1U=; b=cZxDnA4ZqhZDcDvbLRG5J8vpiHeB5o+W+V9kt2d8pcPAcrck4ibOZZtIY8iwEaO6Wb uDIS8UFVpMZbpa9AwFz2aM/zjKkmglATA8JmmgUMbuMCYDuhEJGMSc1H1jpVz0e72A+A 6x1jvBpDUjOGj1+A3EnGXY9nOGlEkMqdfYcckuA+E+j1Mr6dzBuH1kR9utVx1SCKUeuV lMpiLcuh7PfcWUwRWvov+jlV1QiuSEvrbZc6XzZR76/XTlJ3Rw83RZrd/Kk9L0Gzl634 JJJL6R2U0QnHRPkLAA46k1A79lZeAo7YVe0b1P8yL/bp2g13hsFeVotTfkyeRAfVYCoV RoAA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=1zSvJYMfT1VQzNcrLDhiytFy3rM28U0vxLOE4T/bb1U=; b=4lLrgra5t9kjH73W2tljGeEYoduAAVAL2lM5OPy6jjGP5OfdmtYsyfrSmurrrID+3J m4wpYM5+oQ1uxzM5bW82XfvnaHnd7uv3JsJ8NaWztdnYvQfWdkUxNm8ZVtTkVTCUkD2D 69n5udLKf9eCGQ3IHZFzOcSSlkRKV/aG5881QIjqelU9eFj3SSE451YoHQm46twb78jR YFfsxB5ME4pkutHGaIYQJvnESz5h8C5gdiadRXDnF6z/DpUieB0zFZf9BQaXXQH1od7l Q2+unJo7AU4PWDfuIr/lJs738R6AaXI8nWnQzPiP3TIkyYhkUQfuzytPN2vBzAvtED+D SAUw== X-Gm-Message-State: AOAM533/SIgGaLwa9pEQ7lahJPT6Q4wCTJ36gH8HAZIzZhlQliwaU2Nv qxirLWFH6oCFmTVqCy7S/JX/LfUYdZRsDfoWTJZTfio2VNlJlA== X-Google-Smtp-Source: ABdhPJwA0CTG4rFiqWoxNNmh+aa/5VWCPDn+FkE+i4GnVY5r0mXoJKYEjkKUPBl6D7tC7VDGCwgs55cd7APRdild6kc= X-Received: by 2002:a5d:5847:0:b0:1f0:437d:8be with SMTP id i7-20020a5d5847000000b001f0437d08bemr10344772wrf.399.1646699525794; Mon, 07 Mar 2022 16:32:05 -0800 (PST) MIME-Version: 1.0 References: <14aeba35c06421ae40c96f3fc31ce998d50dad41.camel@cybertec.at> In-Reply-To: From: Dong Wook Lee Date: Tue, 8 Mar 2022 09:31:49 +0900 Message-ID: Subject: Re: add free space map link in pg_freespacemap page To: Michael Paquier Cc: pgsql-docs@lists.postgresql.org Content-Type: multipart/alternative; boundary="000000000000496d8c05d9aa1cbd" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --000000000000496d8c05d9aa1cbd Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable I don't know about it, so should I use at FSM for all the acronyms in the section dedicated to acronyms? The pg_freespacemap module provides a means for examining the - free space map (FSM). It provides a function called + free space map (FSM). It provides a function called pg_freespace, or two overloaded functions, to be precise. The functions show the value recorded in the free space map for a given page, or for all pages in the relation. @@ -36,7 +36,7 @@ Returns the amount of free space on the page of the relation, specified - by blkno, according to the FSM. + by blkno, according to the FSM= . @@ -50,7 +50,7 @@ Displays the amount of free space on each page of the relation, - according to the FSM. A set of (blkno bigint, avail int2) + according to the FSM. A set of (blkno bigint, avail int2) tuples is returned, one tuple for each page in the relation. 2022=EB=85=84 3=EC=9B=94 7=EC=9D=BC (=EC=9B=94) =EC=98=A4=ED=9B=84 9:03, Mi= chael Paquier =EB=8B=98=EC=9D=B4 =EC=9E=91=EC=84=B1: > On Mon, Mar 07, 2022 at 11:08:16AM +0100, Laurenz Albe wrote: > > On Sun, 2022-03-06 at 23:42 +0900, Dong Wook Lee wrote: > >> > >> The pg_freespacemap module provides a means fo= r > examining the > >> - free space map (FSM). It provides a function called > >> + free space map (FSM). It provi= des > a function called > >> pg_freespace, or two overloaded functions, to = be > >> precise. The functions show the value recorded in the free space ma= p > for > >> a given page, or for all pages in the relation. > >> > >> so I propose a patch to fix it. > > > > +1 > > Shouldn't you use an here? FSM is a term listed in the > section dedicated to acronyms. > -- > Michael > --000000000000496d8c05d9aa1cbd Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
I don't know about=C2=A0it, so should I use <a= cronym> at FSM for all the acronyms in the section dedicated to acronyms= ?

=C2=A0 <para>
=C2=A0 =C2=A0The <file= name>pg_freespacemap</filename> module provides a means for examin= ing the
- =C2=A0free space map (FSM). It provides a function called
+= =C2=A0<link linkend=3D"storage-fsm">free space map</lin= k> (<acronym>FSM</acronym>). It provides a function called=C2=A0 =C2=A0<function>pg_freespace</function>, or two overlo= aded functions, to be
=C2=A0 =C2=A0precise. The functions show the value= recorded in the free space map for
=C2=A0 =C2=A0a given page, or for al= l pages in the relation.
@@ -36,7 +36,7 @@
=C2=A0 =C2=A0 =C2=A0<li= stitem>
=C2=A0 =C2=A0 =C2=A0 <para>
=C2=A0 =C2=A0 =C2=A0 =C2= =A0Returns the amount of free space on the page of the relation, specified<= br>- =C2=A0 =C2=A0 =C2=A0by <literal>blkno</literal>, according= to the FSM.
+ =C2=A0 =C2=A0 =C2=A0by <literal>blkno</literal&g= t;, according to the <acronym>FSM</acronym>.
=C2=A0 =C2=A0 = =C2=A0 </para>
=C2=A0 =C2=A0 =C2=A0</listitem>
=C2=A0 =C2= =A0 </varlistentry>
@@ -50,7 +50,7 @@
=C2=A0 =C2=A0 =C2=A0<l= istitem>
=C2=A0 =C2=A0 =C2=A0 <para>
=C2=A0 =C2=A0 =C2=A0 = =C2=A0Displays the amount of free space on each page of the relation,
- = =C2=A0 =C2=A0 =C2=A0according to the FSM. A set of <literal>(blkno bi= gint, avail int2)</literal>
+ =C2=A0 =C2=A0 =C2=A0according to the= <acronym>FSM</acronym>. A set of <literal>(blkno bigint,= avail int2)</literal>
=C2=A0 =C2=A0 =C2=A0 =C2=A0tuples is return= ed, one tuple for each page in the relation.
=C2=A0 =C2=A0 =C2=A0 </p= ara>
=C2=A0 =C2=A0 =C2=A0</listitem>

2022=EB=85=84 3=EC=9B= =94 7=EC=9D=BC (=EC=9B=94) =EC=98=A4=ED=9B=84 9:03, Michael Paquier <michael@paquier.xyz>=EB=8B=98=EC=9D=B4 =EC=9E=91=EC=84=B1:
On Mon, Mar 07, 2022 at 11:08:16AM +0100, Laur= enz Albe wrote:
> On Sun, 2022-03-06 at 23:42 +0900, Dong Wook Lee wrote:
>> =C2=A0 <para>
>> =C2=A0 =C2=A0The <filename>pg_freespacemap</filename> = module provides a means for examining the
>> - =C2=A0free space map (FSM). It provides a function called
>> + =C2=A0<link linkend=3D"storage-fsm">free space m= ap</link> (FSM). It provides a function called
>> =C2=A0 =C2=A0<function>pg_freespace</function>, or two= overloaded functions, to be
>> =C2=A0 =C2=A0precise. The functions show the value recorded in the= free space map for
>> =C2=A0 =C2=A0a given page, or for all pages in the relation.
>>
>> so I propose a patch to fix it.
>
> +1

Shouldn't you use an <acronym> here?=C2=A0 FSM is a term listed i= n the
section dedicated to acronyms.
--
Michael
--000000000000496d8c05d9aa1cbd--