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 E1QpyEc-0002by-Ch@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
------
master

Details
-------
http://git.postgresql.org/pg/commitdiff/6ef24487967692604b07a4a54e71821a60fb729a

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: itagaki@pgfoundry.org (User Itagaki)
Date:
Subject: reorg - pg_reorg: Fix docs.
Next
From: Peter Eisentraut
Date:
Subject: pgsql: Fix a whitespace issue with the man pages