mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Only use SGML indexterm "zone" when we want to get the entire section.

Browse Source 
Some alignment cleanups.
This commit is contained in:
Bruce Momjian 2007-08-31 21:33:48 +00:00
parent 45ebcbcc1f
commit a55eab8921
3 changed files with 175 additions and 164 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/src/sgml/extend.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/extend.sgml,v 1.35 2007/06/06 23:00:35 tgl Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/extend.sgml,v 1.36 2007/08/31 21:33:48 momjian Exp $ -->
<chapter id="extend"> <chapter id="extend">
<title>Extending <acronym>SQL</acronym></title> <title>Extending <acronym>SQL</acronym></title>

140
doc/src/sgml/func.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.391 2007/08/31 04:52:29 momjian Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.392 2007/08/31 21:33:48 momjian Exp $ -->
<chapter id="functions"> <chapter id="functions">
<title>Functions and Operators</title> <title>Functions and Operators</title>
@ -11241,17 +11241,17 @@ select current_date + s.a as dates from generate_series(0,14,7) as s(a);
</tgroup> </tgroup>
</table> </table>
<indexterm zone="functions-info"> <indexterm>
<primary>user</primary> <primary>user</primary>
<secondary>current</secondary> <secondary>current</secondary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>schema</primary> <primary>schema</primary>
<secondary>current</secondary> <secondary>current</secondary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>search path</primary> <primary>search path</primary>
<secondary>current</secondary> <secondary>current</secondary>
</indexterm> </indexterm>
@ -11298,19 +11298,19 @@ SET search_path TO <replaceable>schema</> <optional>, <replaceable>schema</>, ..
</para> </para>
</note> </note>
<indexterm zone="functions-info"> <indexterm>
<primary>inet_client_addr</primary> <primary>inet_client_addr</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>inet_client_port</primary> <primary>inet_client_port</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>inet_server_addr</primary> <primary>inet_server_addr</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>inet_server_port</primary> <primary>inet_server_port</primary>
</indexterm> </indexterm>
@ -11325,11 +11325,11 @@ SET search_path TO <replaceable>schema</> <optional>, <replaceable>schema</>, ..
Unix-domain socket. Unix-domain socket.
</para> </para>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_my_temp_schema</primary> <primary>pg_my_temp_schema</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_is_other_temp_schema</primary> <primary>pg_is_other_temp_schema</primary>
</indexterm> </indexterm>
@ -11343,7 +11343,7 @@ SET search_path TO <replaceable>schema</> <optional>, <replaceable>schema</>, ..
tables from a catalog display.) tables from a catalog display.)
</para> </para>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_postmaster_start_time</primary> <primary>pg_postmaster_start_time</primary>
</indexterm> </indexterm>
@ -11353,7 +11353,7 @@ SET search_path TO <replaceable>schema</> <optional>, <replaceable>schema</>, ..
server started. server started.
</para> </para>
<indexterm zone="functions-info"> <indexterm>
<primary>version</primary> <primary>version</primary>
</indexterm> </indexterm>
@ -11491,25 +11491,25 @@ SET search_path TO <replaceable>schema</> <optional>, <replaceable>schema</>, ..
</tgroup> </tgroup>
</table> </table>
<indexterm zone="functions-info"> <indexterm>
<primary>has_database_privilege</primary> <primary>has_database_privilege</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>has_function_privilege</primary> <primary>has_function_privilege</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>has_language_privilege</primary> <primary>has_language_privilege</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>has_schema_privilege</primary> <primary>has_schema_privilege</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>has_table_privilege</primary> <primary>has_table_privilege</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>has_tablespace_privilege</primary> <primary>has_tablespace_privilege</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_has_role</primary> <primary>pg_has_role</primary>
</indexterm> </indexterm>
@ -11669,22 +11669,22 @@ SELECT relname FROM pg_class WHERE pg_table_is_visible(oid);
</tgroup> </tgroup>
</table> </table>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_conversion_is_visible</primary> <primary>pg_conversion_is_visible</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_function_is_visible</primary> <primary>pg_function_is_visible</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_operator_is_visible</primary> <primary>pg_operator_is_visible</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_opclass_is_visible</primary> <primary>pg_opclass_is_visible</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_table_is_visible</primary> <primary>pg_table_is_visible</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_type_is_visible</primary> <primary>pg_type_is_visible</primary>
</indexterm> </indexterm>
@ -11718,43 +11718,43 @@ SELECT pg_type_is_visible('myschema.widget'::regtype);
this way &mdash; if the name can be recognized at all, it must be visible. this way &mdash; if the name can be recognized at all, it must be visible.
</para> </para>
<indexterm zone="functions-info"> <indexterm>
<primary>format_type</primary> <primary>format_type</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_get_viewdef</primary> <primary>pg_get_viewdef</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_get_ruledef</primary> <primary>pg_get_ruledef</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_get_indexdef</primary> <primary>pg_get_indexdef</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_get_triggerdef</primary> <primary>pg_get_triggerdef</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_get_constraintdef</primary> <primary>pg_get_constraintdef</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_get_expr</primary> <primary>pg_get_expr</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_get_userbyid</primary> <primary>pg_get_userbyid</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_get_serial_sequence</primary> <primary>pg_get_serial_sequence</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>pg_tablespace_databases</primary> <primary>pg_tablespace_databases</primary>
</indexterm> </indexterm>
@ -11923,19 +11923,19 @@ SELECT pg_type_is_visible('myschema.widget'::regtype);
<structname>pg_class</> catalogs. <structname>pg_class</> catalogs.
</para> </para>
<indexterm zone="functions-info"> <indexterm>
<primary>col_description</primary> <primary>col_description</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>obj_description</primary> <primary>obj_description</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>shobj_description</primary> <primary>shobj_description</primary>
</indexterm> </indexterm>
<indexterm zone="functions-info"> <indexterm>
<primary>comment</primary> <primary>comment</primary>
<secondary sortas="database objects">about database objects</secondary> <secondary sortas="database objects">about database objects</secondary>
</indexterm> </indexterm>
@ -12043,15 +12043,15 @@ SELECT pg_type_is_visible('myschema.widget'::regtype);
</tgroup> </tgroup>
</table> </table>
<indexterm zone="functions-admin"> <indexterm>
<primary>SET</primary> <primary>SET</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>SHOW</primary> <primary>SHOW</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>configuration</primary> <primary>configuration</primary>
<secondary sortas="server">of the server</secondary> <secondary sortas="server">of the server</secondary>
<tertiary>functions</tertiary> <tertiary>functions</tertiary>
@ -12091,17 +12091,17 @@ SELECT set_config('log_statement_stats', 'off', false);
</programlisting> </programlisting>
</para> </para>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_cancel_backend</primary> <primary>pg_cancel_backend</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_reload_conf</primary> <primary>pg_reload_conf</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_rotate_logfile</primary> <primary>pg_rotate_logfile</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>signal</primary> <primary>signal</primary>
<secondary sortas="backend">backend processes</secondary> <secondary sortas="backend">backend processes</secondary>
</indexterm> </indexterm>
@ -12175,28 +12175,28 @@ SELECT set_config('log_statement_stats', 'off', false);
subprocess. subprocess.
</para> </para>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_start_backup</primary> <primary>pg_start_backup</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_stop_backup</primary> <primary>pg_stop_backup</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_switch_xlog</primary> <primary>pg_switch_xlog</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_current_xlog_location</primary> <primary>pg_current_xlog_location</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_current_xlog_insert_location</primary> <primary>pg_current_xlog_insert_location</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_xlogfile_name_offset</primary> <primary>pg_xlogfile_name_offset</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_xlogfile_name</primary> <primary>pg_xlogfile_name</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>backup</primary> <primary>backup</primary>
</indexterm> </indexterm>
@ -12350,22 +12350,22 @@ postgres=# select * from pg_xlogfile_name_offset(pg_stop_backup());
the actual disk space usage of database objects. the actual disk space usage of database objects.
</para> </para>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_column_size</primary> <primary>pg_column_size</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_database_size</primary> <primary>pg_database_size</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_relation_size</primary> <primary>pg_relation_size</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_size_pretty</primary> <primary>pg_size_pretty</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_tablespace_size</primary> <primary>pg_tablespace_size</primary>
</indexterm> </indexterm>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_total_relation_size</primary> <primary>pg_total_relation_size</primary>
</indexterm> </indexterm>
@ -12532,7 +12532,7 @@ postgres=# select * from pg_xlogfile_name_offset(pg_stop_backup());
</tgroup> </tgroup>
</table> </table>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_ls_dir</primary> <primary>pg_ls_dir</primary>
</indexterm> </indexterm>
<para> <para>
@ -12541,7 +12541,7 @@ postgres=# select * from pg_xlogfile_name_offset(pg_stop_backup());
<quote><literal>..</></>. <quote><literal>..</></>.
</para> </para>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_read_file</primary> <primary>pg_read_file</primary>
</indexterm> </indexterm>
<para> <para>
@ -12551,7 +12551,7 @@ postgres=# select * from pg_xlogfile_name_offset(pg_stop_backup());
is negative, it is relative to the end of the file. is negative, it is relative to the end of the file.
</para> </para>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_stat_file</primary> <primary>pg_stat_file</primary>
</indexterm> </indexterm>
<para> <para>
@ -12683,7 +12683,7 @@ SELECT (pg_stat_file('filename')).modification;
</tgroup> </tgroup>
</table> </table>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_advisory_lock</primary> <primary>pg_advisory_lock</primary>
</indexterm> </indexterm>
<para> <para>
@ -12697,7 +12697,7 @@ SELECT (pg_stat_file('filename')).modification;
released for other sessions' use. released for other sessions' use.
</para> </para>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_advisory_lock_shared</primary> <primary>pg_advisory_lock_shared</primary>
</indexterm> </indexterm>
<para> <para>
@ -12707,7 +12707,7 @@ SELECT (pg_stat_file('filename')).modification;
Only would-be exclusive lockers are locked out. Only would-be exclusive lockers are locked out.
</para> </para>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_try_advisory_lock</primary> <primary>pg_try_advisory_lock</primary>
</indexterm> </indexterm>
<para> <para>
@ -12718,7 +12718,7 @@ SELECT (pg_stat_file('filename')).modification;
acquired now. acquired now.
</para> </para>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_try_advisory_lock_shared</primary> <primary>pg_try_advisory_lock_shared</primary>
</indexterm> </indexterm>
<para> <para>
@ -12727,7 +12727,7 @@ SELECT (pg_stat_file('filename')).modification;
shared rather than exclusive lock. shared rather than exclusive lock.
</para> </para>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_advisory_unlock</primary> <primary>pg_advisory_unlock</primary>
</indexterm> </indexterm>
<para> <para>
@ -12738,7 +12738,7 @@ SELECT (pg_stat_file('filename')).modification;
and in addition, an SQL warning will be raised by the server. and in addition, an SQL warning will be raised by the server.
</para> </para>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_advisory_unlock_shared</primary> <primary>pg_advisory_unlock_shared</primary>
</indexterm> </indexterm>
<para> <para>
@ -12747,7 +12747,7 @@ SELECT (pg_stat_file('filename')).modification;
except to release a shared advisory lock. except to release a shared advisory lock.
</para> </para>
<indexterm zone="functions-admin"> <indexterm>
<primary>pg_advisory_unlock_all</primary> <primary>pg_advisory_unlock_all</primary>
</indexterm> </indexterm>
<para> <para>

31
doc/src/sgml/libpq.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/libpq.sgml,v 1.239 2007/07/23 10:16:53 mha Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/libpq.sgml,v 1.240 2007/08/31 21:33:48 momjian Exp $ -->
<chapter id="libpq"> <chapter id="libpq">
<title><application>libpq</application> - C Library</title> <title><application>libpq</application> - C Library</title>
@ -2399,12 +2399,16 @@ It is not thread-safe.
<sect2 id="libpq-exec-escape-string"> <sect2 id="libpq-exec-escape-string">
<title>Escaping Strings for Inclusion in SQL Commands</title> <title>Escaping Strings for Inclusion in SQL Commands</title>
<indexterm zone="libpq-exec-escape-string"><primary>PQescapeStringConn</></>
<indexterm zone="libpq-exec-escape-string"><primary>PQescapeString</></>
<indexterm zone="libpq-exec-escape-string"> <indexterm zone="libpq-exec-escape-string">
<primary>escaping strings</> <primary>PQescapeStringConn</primary>
</indexterm>
<indexterm zone="libpq-exec-escape-string">
<primary>PQescapeString</primary>
</indexterm>
<indexterm zone="libpq-exec-escape-string">
<primary>escaping strings</primary>
<secondary>in libpq</secondary> <secondary>in libpq</secondary>
</> </indexterm>
<para> <para>
<function>PQescapeStringConn</function> escapes a string for use within an SQL <function>PQescapeStringConn</function> escapes a string for use within an SQL
@ -2499,8 +2503,8 @@ in favor of <function>PQescapeStringConn</>.
<title>Escaping Binary Strings for Inclusion in SQL Commands</title> <title>Escaping Binary Strings for Inclusion in SQL Commands</title>
<indexterm zone="libpq-exec-escape-bytea"> <indexterm zone="libpq-exec-escape-bytea">
<primary>bytea</> <primary>bytea</primary>
<secondary sortas="libpq">in libpq</> <secondary sortas="libpq">in libpq</secondary>
</indexterm> </indexterm>
<variablelist> <variablelist>
@ -2666,7 +2670,9 @@ void PQfreemem(void *ptr);
<sect1 id="libpq-async"> <sect1 id="libpq-async">
<title>Asynchronous Command Processing</title> <title>Asynchronous Command Processing</title>
<indexterm zone="libpq-async"><primary>nonblocking connection</></> <indexterm zone="libpq-async">
<primary>nonblocking connection</primary>
</indexterm>
<para> <para>
The <function>PQexec</function> function is adequate for submitting commands in The <function>PQexec</function> function is adequate for submitting commands in
@ -3075,7 +3081,10 @@ and then read the response as described above.
<sect1 id="libpq-cancel"> <sect1 id="libpq-cancel">
<title>Cancelling Queries in Progress</title> <title>Cancelling Queries in Progress</title>
<indexterm zone="libpq-cancel"><primary>canceling</><secondary>SQL command</></> <indexterm zone="libpq-cancel">
<primary>canceling</primary>
<secondary>SQL command</secondary>
</indexterm>
<para> <para>
A client application can request cancellation of A client application can request cancellation of
@ -3194,7 +3203,9 @@ in progress on the connection.
<sect1 id="libpq-fastpath"> <sect1 id="libpq-fastpath">
<title>The Fast-Path Interface</title> <title>The Fast-Path Interface</title>
<indexterm zone="libpq-fastpath"><primary>fast path</></> <indexterm zone="libpq-fastpath">
<primary>fast path</primary>
</indexterm>
<para> <para>
<productname>PostgreSQL</productname> provides a fast-path interface to send <productname>PostgreSQL</productname> provides a fast-path interface to send