pgsql: Fix a whitespace issue with the man pages - Mailing list pgsql-committers

From Peter Eisentraut
Subject pgsql: Fix a whitespace issue with the man pages
Date
Msg-id E1QpyEk-0002cK-PC@gemulon.postgresql.org
Whole thread Raw
List pgsql-committers
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(-)


pgsql-committers by date:

Previous
From: Peter Eisentraut
Date:
Subject: pgsql: Fix a whitespace issue with the man pages
Next
From: Peter Eisentraut
Date:
Subject: pgsql: Rename "Example" sections to "Examples" in dblink chapter