Thread: pgsql: Fix a whitespace issue with the man pages

pgsql: Fix a whitespace issue with the man pages

From
Peter Eisentraut
Date:
Fix a whitespace issue with the man pages

There is what may actually be a mistake in our markup.  The problem is
in a situation like

<para>
 <command>FOO</command> is ...

there is strictly speaking a line break before "FOO".  In the HTML
output, this does not appear to be a problem, but in the man page
output, this shows up, so you get double blank lines at odd places.

So far, we have attempted to work around this with an XSL hack, but
that causes other problems, such as creating run-ins in places like

<acronym>SQL</acronym> <command>COPY</command>

So fix the problem properly by removing the extra whitespace.  I only
fixed the problems that affect the man page output, not all the
places.

Branch
------
REL9_1_STABLE

Details
-------
http://git.postgresql.org/pg/commitdiff/ad8641d535b46888c2f911a98a9b112771d82af6

Modified Files
--------------
doc/src/sgml/dblink.sgml                          |    6 +--
doc/src/sgml/ref/abort.sgml                       |    3 +-
doc/src/sgml/ref/alter_aggregate.sgml             |    3 +-
doc/src/sgml/ref/alter_collation.sgml             |    3 +-
doc/src/sgml/ref/alter_conversion.sgml            |    3 +-
doc/src/sgml/ref/alter_database.sgml              |    3 +-
doc/src/sgml/ref/alter_default_privileges.sgml    |    3 +-
doc/src/sgml/ref/alter_domain.sgml                |    3 +-
doc/src/sgml/ref/alter_extension.sgml             |    3 +-
doc/src/sgml/ref/alter_foreign_data_wrapper.sgml  |    3 +-
doc/src/sgml/ref/alter_foreign_table.sgml         |    3 +-
doc/src/sgml/ref/alter_function.sgml              |    3 +-
doc/src/sgml/ref/alter_group.sgml                 |    4 +--
doc/src/sgml/ref/alter_index.sgml                 |    3 +-
doc/src/sgml/ref/alter_operator.sgml              |    3 +-
doc/src/sgml/ref/alter_role.sgml                  |    3 +-
doc/src/sgml/ref/alter_sequence.sgml              |    3 +-
doc/src/sgml/ref/alter_server.sgml                |    3 +-
doc/src/sgml/ref/alter_table.sgml                 |    3 +-
doc/src/sgml/ref/alter_tablespace.sgml            |    3 +-
doc/src/sgml/ref/alter_trigger.sgml               |    3 +-
doc/src/sgml/ref/alter_type.sgml                  |    3 +-
doc/src/sgml/ref/alter_user_mapping.sgml          |    3 +-
doc/src/sgml/ref/alter_view.sgml                  |    3 +-
doc/src/sgml/ref/begin.sgml                       |    3 +-
doc/src/sgml/ref/close.sgml                       |    3 +-
doc/src/sgml/ref/cluster.sgml                     |    3 +-
doc/src/sgml/ref/clusterdb.sgml                   |    3 +-
doc/src/sgml/ref/comment.sgml                     |    3 +-
doc/src/sgml/ref/commit.sgml                      |    3 +-
doc/src/sgml/ref/commit_prepared.sgml             |    3 +-
doc/src/sgml/ref/copy.sgml                        |    9 ++---
doc/src/sgml/ref/create_conversion.sgml           |    6 +--
doc/src/sgml/ref/create_domain.sgml               |    6 +--
doc/src/sgml/ref/create_extension.sgml            |    3 +-
doc/src/sgml/ref/create_foreign_data_wrapper.sgml |    9 ++---
doc/src/sgml/ref/create_foreign_table.sgml        |    3 +-
doc/src/sgml/ref/create_function.sgml             |   24 ++++--------
doc/src/sgml/ref/create_index.sgml                |    3 +-
doc/src/sgml/ref/create_language.sgml             |   15 +++-----
doc/src/sgml/ref/create_operator.sgml             |    9 ++---
doc/src/sgml/ref/create_role.sgml                 |    6 +--
doc/src/sgml/ref/create_rule.sgml                 |    6 +--
doc/src/sgml/ref/create_schema.sgml               |    3 +-
doc/src/sgml/ref/create_sequence.sgml             |    6 +--
doc/src/sgml/ref/create_server.sgml               |    3 +-
doc/src/sgml/ref/create_table.sgml                |   19 +++-------
doc/src/sgml/ref/create_table_as.sgml             |   12 ++----
doc/src/sgml/ref/create_tablespace.sgml           |    3 +-
doc/src/sgml/ref/create_trigger.sgml              |    9 ++---
doc/src/sgml/ref/create_user_mapping.sgml         |    3 +-
doc/src/sgml/ref/createdb.sgml                    |    3 +-
doc/src/sgml/ref/declare.sgml                     |    6 +--
doc/src/sgml/ref/delete.sgml                      |    3 +-
doc/src/sgml/ref/discard.sgml                     |    3 +-
doc/src/sgml/ref/do.sgml                          |    4 +-
doc/src/sgml/ref/drop_aggregate.sgml              |    3 +-
doc/src/sgml/ref/drop_cast.sgml                   |    3 +-
doc/src/sgml/ref/drop_collation.sgml              |    3 +-
doc/src/sgml/ref/drop_conversion.sgml             |    3 +-
doc/src/sgml/ref/drop_domain.sgml                 |    3 +-
doc/src/sgml/ref/drop_foreign_data_wrapper.sgml   |    3 +-
doc/src/sgml/ref/drop_foreign_table.sgml          |    3 +-
doc/src/sgml/ref/drop_function.sgml               |    3 +-
doc/src/sgml/ref/drop_index.sgml                  |    3 +-
doc/src/sgml/ref/drop_language.sgml               |    3 +-
doc/src/sgml/ref/drop_operator.sgml               |    3 +-
doc/src/sgml/ref/drop_role.sgml                   |    3 +-
doc/src/sgml/ref/drop_rule.sgml                   |    3 +-
doc/src/sgml/ref/drop_schema.sgml                 |    3 +-
doc/src/sgml/ref/drop_sequence.sgml               |    3 +-
doc/src/sgml/ref/drop_server.sgml                 |    3 +-
doc/src/sgml/ref/drop_table.sgml                  |    3 +-
doc/src/sgml/ref/drop_tablespace.sgml             |    3 +-
doc/src/sgml/ref/drop_trigger.sgml                |    3 +-
doc/src/sgml/ref/drop_type.sgml                   |    3 +-
doc/src/sgml/ref/drop_user_mapping.sgml           |    3 +-
doc/src/sgml/ref/drop_view.sgml                   |    3 +-
doc/src/sgml/ref/dropdb.sgml                      |    3 +-
doc/src/sgml/ref/droplang.sgml                    |    3 +-
doc/src/sgml/ref/dropuser.sgml                    |    3 +-
doc/src/sgml/ref/ecpg-ref.sgml                    |    6 +--
doc/src/sgml/ref/end.sgml                         |    3 +-
doc/src/sgml/ref/fetch.sgml                       |   12 ++----
doc/src/sgml/ref/grant.sgml                       |    3 +-
doc/src/sgml/ref/insert.sgml                      |    3 +-
doc/src/sgml/ref/listen.sgml                      |    3 +-
doc/src/sgml/ref/lock.sgml                        |    3 +-
doc/src/sgml/ref/notify.sgml                      |    3 +-
doc/src/sgml/ref/pg_basebackup.sgml               |    3 +-
doc/src/sgml/ref/pg_ctl-ref.sgml                  |    9 ++---
doc/src/sgml/ref/pg_dump.sgml                     |    8 +---
doc/src/sgml/ref/pg_restore.sgml                  |   12 ++----
doc/src/sgml/ref/prepare_transaction.sgml         |    3 +-
doc/src/sgml/ref/psql-ref.sgml                    |   39 +++++++--------------
doc/src/sgml/ref/reindex.sgml                     |    6 +--
doc/src/sgml/ref/reindexdb.sgml                   |    3 +-
doc/src/sgml/ref/reset.sgml                       |    3 +-
doc/src/sgml/ref/revoke.sgml                      |    3 +-
doc/src/sgml/ref/rollback.sgml                    |    3 +-
doc/src/sgml/ref/rollback_prepared.sgml           |    3 +-
doc/src/sgml/ref/rollback_to.sgml                 |    3 +-
doc/src/sgml/ref/security_label.sgml              |    3 +-
doc/src/sgml/ref/select.sgml                      |   33 ++++++------------
doc/src/sgml/ref/select_into.sgml                 |    3 +-
doc/src/sgml/ref/set.sgml                         |   15 +++-----
doc/src/sgml/ref/show.sgml                        |    6 +--
doc/src/sgml/ref/truncate.sgml                    |    3 +-
doc/src/sgml/ref/unlisten.sgml                    |    3 +-
doc/src/sgml/ref/update.sgml                      |    3 +-
doc/src/sgml/ref/vacuum.sgml                      |    3 +-
doc/src/sgml/ref/vacuumdb.sgml                    |    3 +-
doc/src/sgml/ref/values.sgml                      |    6 +--
doc/src/sgml/spi.sgml                             |   31 ++++------------
doc/src/sgml/stylesheet-man.xsl                   |   13 -------
115 files changed, 194 insertions(+), 413 deletions(-)