v3-0002-Replace-log-record-with-WAL-record-in-docs.patch
application/octet-stream
Filename: v3-0002-Replace-log-record-with-WAL-record-in-docs.patch
Type: application/octet-stream
Part: 1
Patch
Format: format-patch
Series: patch v3-0002
Subject: Replace log record with WAL record in docs
| File | + | − |
|---|---|---|
| doc/src/sgml/backup.sgml | 2 | 2 |
| doc/src/sgml/ref/pg_waldump.sgml | 2 | 2 |
| doc/src/sgml/wal.sgml | 3 | 3 |
From 0b07cced29ef034107d81c3d4e4560f5a4819c98 Mon Sep 17 00:00:00 2001
From: Bharath Rupireddy <bharath.rupireddyforpostgres@gmail.com>
Date: Wed, 2 Mar 2022 06:08:08 +0000
Subject: [PATCH v3] Replace log record with WAL record in docs
---
doc/src/sgml/backup.sgml | 4 ++--
doc/src/sgml/ref/pg_waldump.sgml | 4 ++--
doc/src/sgml/wal.sgml | 6 +++---
3 files changed, 7 insertions(+), 7 deletions(-)
diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml
index 0d69851bb1..dd8640b092 100644
--- a/doc/src/sgml/backup.sgml
+++ b/doc/src/sgml/backup.sgml
@@ -482,8 +482,8 @@ tar -cf backup.tar /usr/local/pgsql/data
<para>
At all times, <productname>PostgreSQL</productname> maintains a
<firstterm>write ahead log</firstterm> (WAL) in the <filename>pg_wal/</filename>
- subdirectory of the cluster's data directory. The log records
- every change made to the database's data files. This log exists
+ subdirectory of the cluster's data directory. The WAL records
+ capture every change made to the database's data files. This log exists
primarily for crash-safety purposes: if the system crashes, the
database can be restored to consistency by <quote>replaying</quote> the
log entries made since the last checkpoint. However, the existence
diff --git a/doc/src/sgml/ref/pg_waldump.sgml b/doc/src/sgml/ref/pg_waldump.sgml
index 5735a161ce..8136244502 100644
--- a/doc/src/sgml/ref/pg_waldump.sgml
+++ b/doc/src/sgml/ref/pg_waldump.sgml
@@ -156,7 +156,7 @@ PostgreSQL documentation
<listitem>
<para>
WAL location at which to start reading. The default is to start reading
- the first valid log record found in the earliest file found.
+ the first valid WAL record found in the earliest file found.
</para>
</listitem>
</varlistentry>
@@ -166,7 +166,7 @@ PostgreSQL documentation
<term><option>--timeline=<replaceable>timeline</replaceable></option></term>
<listitem>
<para>
- Timeline from which to read log records. The default is to use the
+ Timeline from which to read WAL records. The default is to use the
value in <replaceable>startseg</replaceable>, if that is specified; otherwise, the
default is 1.
</para>
diff --git a/doc/src/sgml/wal.sgml b/doc/src/sgml/wal.sgml
index 2bb27a8468..2677996f2a 100644
--- a/doc/src/sgml/wal.sgml
+++ b/doc/src/sgml/wal.sgml
@@ -296,12 +296,12 @@
transaction processing. Briefly, <acronym>WAL</acronym>'s central
concept is that changes to data files (where tables and indexes
reside) must be written only after those changes have been logged,
- that is, after log records describing the changes have been flushed
+ that is, after WAL records describing the changes have been flushed
to permanent storage. If we follow this procedure, we do not need
to flush data pages to disk on every transaction commit, because we
know that in the event of a crash we will be able to recover the
database using the log: any changes that have not been applied to
- the data pages can be redone from the log records. (This is
+ the data pages can be redone from the WAL records. (This is
roll-forward recovery, also known as REDO.)
</para>
@@ -838,7 +838,7 @@
segment files, normally each 16 MB in size (but the size can be changed
by altering the <option>--wal-segsize</option> <application>initdb</application> option). Each segment is
divided into pages, normally 8 kB each (this size can be changed via the
- <option>--with-wal-blocksize</option> configure option). The log record headers
+ <option>--with-wal-blocksize</option> configure option). The WAL record headers
are described in <filename>access/xlogrecord.h</filename>; the record
content is dependent on the type of event that is being logged. Segment
files are given ever-increasing numbers as names, starting at
--
2.25.1