Wording improvements for pg_ctl manual page.

This commit is contained in:
Bruce Momjian 2010-12-22 09:11:33 -05:00
parent de9a4c27fe
commit 28d5c565ce

View File

@ -487,7 +487,7 @@ PostgreSQL documentation
<para> <para>
The existence of this file in the data directory is used to help The existence of this file in the data directory is used to help
<application>pg_ctl</application> determine if the server is <application>pg_ctl</application> determine if the server is
currently running or not. currently running.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -536,8 +536,8 @@ PostgreSQL documentation
</para> </para>
<para> <para>
An example of starting the server, blocking until the server has An example of starting the server, and waiting until the server is
come up is: accepting connection:
<screen> <screen>
<prompt>$</prompt> <userinput>pg_ctl -w start</userinput> <prompt>$</prompt> <userinput>pg_ctl -w start</userinput>
</screen> </screen>
@ -555,11 +555,12 @@ PostgreSQL documentation
<refsect2 id="R2-APP-PGCTL-4"> <refsect2 id="R2-APP-PGCTL-4">
<title>Stopping the Server</title> <title>Stopping the Server</title>
<para> <para>
To stop the server, use:
<screen> <screen>
<prompt>$</prompt> <userinput>pg_ctl stop</userinput> <prompt>$</prompt> <userinput>pg_ctl stop</userinput>
</screen> </screen>
stops the server. Using the <option>-m</option> switch allows one The <option>-m</option> option allows control over
to control <emphasis>how</emphasis> the backend shuts down. <emphasis>how</emphasis> the server shuts down.
</para> </para>
</refsect2> </refsect2>
@ -568,7 +569,7 @@ PostgreSQL documentation
<para> <para>
Restarting the server is almost equivalent to stopping the Restarting the server is almost equivalent to stopping the
server and starting it again server and starting it again,
except that <command>pg_ctl</command> saves and reuses the command line options that except that <command>pg_ctl</command> saves and reuses the command line options that
were passed to the previously running instance. To restart were passed to the previously running instance. To restart
the server in the simplest form, use: the server in the simplest form, use:
@ -579,14 +580,14 @@ PostgreSQL documentation
<para> <para>
To restart the server, To restart the server,
waiting for it to shut down and come up again: waiting for it to shut down and restart:
<screen> <screen>
<prompt>$</prompt> <userinput>pg_ctl -w restart</userinput> <prompt>$</prompt> <userinput>pg_ctl -w restart</userinput>
</screen> </screen>
</para> </para>
<para> <para>
To restart using port 5433 and disabling <function>fsync</> after restarting: To restart using port 5433 and disabe <function>fsync</> upon restart:
<screen> <screen>
<prompt>$</prompt> <userinput>pg_ctl -o "-F -p 5433" restart</userinput> <prompt>$</prompt> <userinput>pg_ctl -o "-F -p 5433" restart</userinput>
</screen> </screen>
@ -597,7 +598,7 @@ PostgreSQL documentation
<title>Showing the Server Status</title> <title>Showing the Server Status</title>
<para> <para>
Here is a sample status output from Here is sample status output from
<application>pg_ctl</application>: <application>pg_ctl</application>:
<screen> <screen>
<prompt>$</prompt> <userinput>pg_ctl status</userinput> <prompt>$</prompt> <userinput>pg_ctl status</userinput>