Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit322f55b

Browse files
committed
doc:: simplify introductory text
Reported-by: Joshua D. DrakeDiscussion:https://postgr.es/m/5ac2c96d-37a6-18aa-08c4-327a6fbff24b@commandprompt.comAuthor: Joshua D. DrakeBackpatch-through: master
1 parent0ccb657 commit322f55b

File tree

1 file changed

+45
-49
lines changed

1 file changed

+45
-49
lines changed

‎doc/src/sgml/postgres.sgml

Lines changed: 45 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -38,24 +38,22 @@ break is not needed in a wider output rendering.
3838
<partintro>
3939
<para>
4040
Welcome to the <productname>PostgreSQL</productname> Tutorial. The
41-
following few chapters areintended to givea simple introduction
41+
tutorial isintended to givean introduction
4242
to <productname>PostgreSQL</productname>, relational database
43-
concepts, and the SQL language to those who are new to any one of
44-
these aspects. We only assume some general knowledge about how to
45-
use computers. No particular Unix or programming experience is
46-
required. This part is mainly intended to give you some hands-on
47-
experience with important aspects of the
48-
<productname>PostgreSQL</productname> system. It makes no attempt
49-
to be a complete or thorough treatment of the topics it covers.
43+
concepts, and the SQL language. We assume some general knowledge about
44+
how to use computers and no particular Unix or programming experience is
45+
required. This tutorial is intended to provide hands-on experience with
46+
important aspects of the <productname>PostgreSQL</productname> system.
47+
It makes no attempt to be a comprehensive treatment of the topics it covers.
5048
</para>
5149

5250
<para>
53-
After you haveworked through this tutorial youmight want to move
54-
on to reading<xref linkend="sql"/> to gain amore formal knowledge
51+
After you havesuccessfully completed this tutorial youwill want to
52+
read the<xref linkend="sql"/>sectionto gain abetter understanding
5553
of the SQL language, or <xref linkend="client-interfaces"/> for
56-
information about developing applicationsfor
57-
<productname>PostgreSQL</productname>. Those whoset up and
58-
manage their ownserver should also read <xref linkend="admin"/>.
54+
information about developing applicationswith
55+
<productname>PostgreSQL</productname>. Those whoprovision and
56+
manage their ownPostgreSQL installation should also read <xref linkend="admin"/>.
5957
</para>
6058
</partintro>
6159

@@ -73,28 +71,26 @@ break is not needed in a wider output rendering.
7371
This part describes the use of the <acronym>SQL</acronym> language
7472
in <productname>PostgreSQL</productname>. We start with
7573
describing the general syntax of <acronym>SQL</acronym>, then
76-
explain how to create the structures to hold data, how to populate
77-
the database, and how to query it. The middle part lists the
78-
available data types and functions for use in
79-
<acronym>SQL</acronym> commands. The rest treats several
80-
aspects that are important for tuning a database for optimal
81-
performance.
74+
how to create tables, how to populate the database, and how to
75+
query it. The middle part lists the available data types and
76+
functions for use in <acronym>SQL</acronym> commands. Lastly,
77+
we address several aspects of importance for tuning a database.
8278
</para>
8379

8480
<para>
85-
The informationin this partis arranged so that a novice user can
86-
follow it start to endto gain a full understanding of the topics
81+
The information is arranged so that a novice user can
82+
follow itfromstart to endand gain a full understanding of the topics
8783
without having to refer forward too many times. The chapters are
8884
intended to be self-contained, so that advanced users can read the
89-
chapters individually as they choose. The informationin this
90-
part is presentedinanarrativefashion in topical units.
91-
Readers looking for a completedescription of a particular command
92-
should see <xref linkend="reference"/>.
85+
chapters individually as they choose. The informationis presented
86+
in narrativeform with topical units. Readers looking for a complete
87+
description of a particular command are encouraged to review
88+
the <xref linkend="reference"/>.
9389
</para>
9490

9591
<para>
96-
Readersof this partshould know how to connect to a
97-
<productname>PostgreSQL</productname> database and issue
92+
Readers should know how to connect to a
93+
<productname>PostgreSQL</productname> database and issue
9894
<acronym>SQL</acronym> commands. Readers that are unfamiliar with
9995
these issues are encouraged to read <xref linkend="tutorial"/>
10096
first. <acronym>SQL</acronym> commands are typically entered
@@ -125,32 +121,32 @@ break is not needed in a wider output rendering.
125121
<partintro>
126122
<para>
127123
This part covers topics that are of interest to a
128-
<productname>PostgreSQL</productname>databaseadministrator. This includes
129-
installationof thesoftware, set up and configurationofthe
130-
server, management of usersand databases, and maintenance tasks.
131-
Anyone who runs a<productname>PostgreSQL</productname> server, even for
124+
<productname>PostgreSQL</productname> administrator. This includes
125+
installation, configurationof theserver, managementofusers
126+
and databases, and maintenance tasks. Anyone running
127+
<productname>PostgreSQL</productname> server, even for
132128
personal use, but especially in production, should be familiar
133-
withthe topics covered in this part.
129+
withthese topics.
134130
</para>
135131

136132
<para>
137-
The informationin this part is arranged approximately inthe
138-
order in whicha new user should read it.But thechapters are
139-
self-contained andcan be read individually as desired. The
140-
informationinthis part is presented in a narrative fashion in
141-
topical units. Readers looking for a complete description of a
142-
particular command should see<xref linkend="reference"/>.
133+
The informationattempts to be in the order inwhich
134+
a new user should read it.Thechapters are self-contained and
135+
can be read individually as desired. The information is presented
136+
in a narrative formintopical units. Readers looking for a complete
137+
description of a command are encouraged to review the
138+
<xref linkend="reference"/>.
143139
</para>
144140

145141
<para>
146142
The first few chapters are written so they can be understood
147143
without prerequisite knowledge, so new users who need to set
148-
up their own server can begin their exploration withthispart.
149-
The rest of thispart is about tuning and management; that material
144+
up their own server can begin their exploration. The rest ofthis
145+
part is about tuning and management; that material
150146
assumes that the reader is familiar with the general use of
151147
the <productname>PostgreSQL</productname> database system. Readers are
152-
encouragedto look at <xref linkend="tutorial"/> and <xref
153-
linkend="sql"/> for additional information.
148+
encouragedreview the <xref linkend="tutorial"/> and <xref
149+
linkend="sql"/>partsfor additional information.
154150
</para>
155151
</partintro>
156152

@@ -182,13 +178,13 @@ break is not needed in a wider output rendering.
182178
<para>
183179
This part describes the client programming interfaces distributed
184180
with <productname>PostgreSQL</productname>. Each of these chapters can be
185-
read independently.Note that thereare manyother programming
186-
interfaces for client programs that are distributed separately and
181+
read independently.Thereare manyexternal programming
182+
interfaces for client programs that are distributed separately. They
187183
contain their own documentation (<xref linkend="external-projects"/>
188184
lists some of the more popular ones). Readers of this part should be
189-
familiar with using <acronym>SQL</acronym>commandsto manipulate
185+
familiar with using <acronym>SQL</acronym> to manipulate
190186
and query the database (see <xref linkend="sql"/>) and of course
191-
with the programming languagethat the interface uses.
187+
with the programming languageof their choice.
192188
</para>
193189
</partintro>
194190

@@ -206,15 +202,15 @@ break is not needed in a wider output rendering.
206202
<para>
207203
This part is about extending the server functionality with
208204
user-defined functions, data types, triggers, etc. These are
209-
advanced topics which shouldprobablybe approached only after all
205+
advanced topics which should be approached only after all
210206
the other user documentation about <productname>PostgreSQL</productname> has
211207
been understood. Later chapters in this part describe the server-side
212208
programming languages available in the
213209
<productname>PostgreSQL</productname> distribution as well as
214-
general issues concerning server-side programming languages. It
210+
general issues concerning server-side programming. It
215211
is essential to read at least the earlier sections of <xref
216212
linkend="extend"/> (covering functions) before diving into the
217-
material about server-side programming languages.
213+
material about server-side programming.
218214
</para>
219215
</partintro>
220216

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp