problems in vacuumdb.1

Поиск
Список
Период
Сортировка
Искать

problems in vacuumdb.1

От:
esr@thyrsus.com
Дата:
This is automatically generated email about problems in a man page for which
you appear to be responsible.  If you are not the right person or list, tell
me and I will attempt to correct my database.

See http://catb.org/~esr/doclifter/problems.html for details on how and
why these patches were generated.  Feel free to email me with any questions.
Note: These patches do not change the mod date of any manual page.  You
may wish to do that by hand.

Problems with vacuumdb.1:

1. Broken command synopsis syntax.  This may mean you're using a
construction in the command synopsis other than the standard
[ ] | { }, or it may mean you have running text in the command synopsis
section (the latter is not technically an error, but it's impossible
to translate into DocBook markup).

--- vacuumdb.1-orig	2004-07-29 09:57:38.442563992 -0400
+++ vacuumdb.1	2004-07-29 09:57:55.544964032 -0400
@@ -5,7 +5,7 @@
 
 .SH SYNOPSIS
 .sp
-\fBvacuumdb\fR\fR [ \fR\fB\fIconnection-option\fB\fR...\fB \fR\fR]\fR \fR[\fR \fB--full\fR\fR | \fR\fB-f\fR\fR ]\fR \fR[\fR \fB--verbose\fR\fR | \fR\fB-v\fR\fR ]\fR \fR[\fR \fB--analyze\fR\fR | \fR\fB-z\fR\fR ]\fR\fR [ \fR\fB--table | -t \fItable\fB\fR [ \fB( \fIcolumn\fB [,...] ) \fR]\fB \fR\fR]\fR\fR [ \fR\fB\fIdbname\fB \fR\fR]\fR
+\fBvacuumdb\fR\fR [ \fR\fB\fIconnection-option\fB\fR...\fB \fR\fR]\fR \fR[\fR \fB--full\fR\fR | \fR\fB-f\fR\fR ]\fR \fR[\fR \fB--verbose\fR\fR | \fR\fB-v\fR\fR ]\fR \fR[\fR \fB--analyze\fR\fR | \fR\fB-z\fR\fR ]\fR\fR [ \fR\fB--table | -t \fItable\fB\fR [ \fBcolumnspecs \fR]\fB \fR\fR]\fR\fR [ \fR\fB\fIdbname\fB \fR\fR]\fR
 
 \fBvacuumdb\fR\fR [ \fR\fB\fIconnection-options\fB\fR...\fB \fR\fR]\fR \fR[\fR \fB--all\fR\fR | \fR\fB-a\fR\fR ]\fR \fR[\fR \fB--full\fR\fR | \fR\fB-f\fR\fR ]\fR \fR[\fR \fB--verbose\fR\fR | \fR\fB-v\fR\fR ]\fR \fR[\fR \fB--analyze\fR\fR | \fR\fB-z\fR\fR ]\fR
 .SH "DESCRIPTION"
-----------------------------

--
                             Eric S. Raymond

Re: problems in vacuumdb.1

От:
Peter Eisentraut <peter_e@gmx.net>
Дата:
esr@thyrsus.com wrote:
> Problems with vacuumdb.1:
>
> 1. Broken command synopsis syntax.  This may mean you're using a
> construction in the command synopsis other than the standard
> [ ] | { }, or it may mean you have running text in the command
> synopsis section (the latter is not technically an error, but it's
> impossible to translate into DocBook markup).

Look at the original DocBook source:

  
   vacuumdb
   connection-option
   --full-f
   --verbose-v
   --analyze-z
   --table | -t table
    ( column 
[,...] )
   
   dbname
   
   vacuumdb
   connection-options
   --all-a
   --full-f
   --verbose-v
   --analyze-z
  

If you have a suggestion how to mark up the [, ...] then we would 
welcome it, but I don't think your proposed patch will do it.

-- 
Peter Eisentraut
http://developer.postgresql.org/~petere/
FAQ