Commit a55eab89 authored by Bruce Momjian's avatar Bruce Momjian

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

Some alignment cleanups.
parent 45ebcbcc
<!-- $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>
......
<!-- $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); ...@@ -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</>, .. ...@@ -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</>, .. ...@@ -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</>, .. ...@@ -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</>, .. ...@@ -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</>, .. ...@@ -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); ...@@ -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); ...@@ -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); ...@@ -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); ...@@ -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); ...@@ -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); ...@@ -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()); ...@@ -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()); ...@@ -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()); ...@@ -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()); ...@@ -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; ...@@ -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; ...@@ -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; ...@@ -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; ...@@ -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; ...@@ -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; ...@@ -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; ...@@ -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>
......
<!-- $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. ...@@ -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</>. ...@@ -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); ...@@ -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. ...@@ -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. ...@@ -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
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment