summaryrefslogtreecommitdiff
path: root/doc/src/sgml/oid2name.sgml
AgeCommit message (Collapse)Author
2023-10-27|--- gitweb subject length limit ----------------|-email limit-|Bruce Momjian
doc: fix first-person wording Reported-by: [email protected] Discussion: https://postgr.es/m/[email protected] Backpatch-through: master
2020-03-09Doc: fix some description of environment variables with frontend toolsMichael Paquier
This addresses a couple of issues in the documentation: - Description of PG_COLOR was missing for some tools (pg_archivecleanup and pg_test_fsync), while the other descriptions had grammar mistakes. - pgbench supports more environment variables: PGUSER, PGHOST and PGPORT. - vacuumlo, oid2name and pgbench support coloring (HEAD only) Author: Michael Paquier Reviewed-by: Fabien Coelho, Daniel Gustafsson, Juan José Santamaría Flecha Discussion: https://postgr.es/m/[email protected] Backpatch-through: 12
2018-08-28Rework option set of oid2nameMichael Paquier
oid2name has done little effort to keep an interface consistent with other binary utilities: - -H was used instead of -h/-host. This option is now marked as deprecated, still its output is accepted to be backward-compatible. - -P has been removed from the code, and was still documented. - All options gain long aliases, making connection options more similar to other binaries. - Document environment variables which could be used: PGHOST, PGPORT and PGUSER. A basic set of TAP tests is added on the way, and documentation is cleaned up to be more consistent with other things. Author: Tatsuro Yamada Reviewed-by: Michael Paquier Discussion: https://postgr.es/m/[email protected]
2017-11-23Convert documentation to DocBook XMLPeter Eisentraut
Since some preparation work had already been done, the only source changes left were changing empty-element tags like <xref linkend="foo"> to <xref linkend="foo"/>, and changing the DOCTYPE. The source files are still named *.sgml, but they are actually XML files now. Renaming could be considered later. In the build system, the intermediate step to convert from SGML to XML is removed. Everything is build straight from the source files again. The OpenSP (or the old SP) package is no longer needed. The documentation toolchain instructions are updated and are much simpler now. Peter Eisentraut, Alexander Lakhin, Jürgen Purtz
2017-10-17Don't use SGML empty tagsPeter Eisentraut
For DocBook XML compatibility, don't use SGML empty tags (</>) anymore, replace by the full tag name. Add a warning option to catch future occurrences. Alexander Lakhin, Jürgen Purtz
2014-02-24doc: Improve DocBook XML validityPeter Eisentraut
DocBook XML is superficially compatible with DocBook SGML but has a slightly stricter DTD that we have been violating in a few cases. Although XSLT doesn't care whether the document is valid, the style sheets don't necessarily process invalid documents correctly, so we need to work toward fixing this. This first commit moves the indexterms in refentry elements to an allowed position. It has no impact on the output.
2012-06-17Make documentation of --help and --version options more consistentPeter Eisentraut
Before, some places didn't document the short options (-? and -V), some documented both, some documented nothing, and they were listed in various orders. Now this is hopefully more consistent and complete.
2012-05-19Some reference page improvementsPeter Eisentraut
initdb: Add -T option oid2name: Put options in some non-random order pg_dump: Put --section option in the right place And some additional markup and terminology improvements.
2012-05-09Split contrib documentation into extensions and programsPeter Eisentraut
Create separate appendixes for contrib extensions and other server plugins on the one hand, and utility programs on the other. Recast the documentation of the latter as refentries, so that man pages are generated.
2011-05-08Add xreflabels to /contrib manuals so links appear correct. Also updateBruce Momjian
README.links to explain xref properly.
2010-09-20Remove cvs keywords from all files.Magnus Hagander
2010-08-17Spell and markup checkingPeter Eisentraut
2010-07-29Fix indentation of verbatim block elementsPeter Eisentraut
Block elements with verbatim formatting (literallayout, programlisting, screen, synopsis) should be aligned at column 0 independent of the surrounding SGML, because whitespace is significant, and indenting them creates erratic whitespace in the output. The CSS stylesheets already take care of indenting the output. Assorted markup improvements to go along with it.
2010-05-25Modify pg_standby, pgbench, and pg_upgrade manual pages to be consistentBruce Momjian
in their display of command-line options with other client applications.
2010-05-20Show oid2name command-line arguments in documentation like we do forBruce Momjian
non-contrib command-line tools (no longer in a single table display).
2010-05-19Restore oid2name doc change.Bruce Momjian
2010-05-19Add command-line documentation for pg_upgrade.Bruce Momjian
2007-12-11Remove the -P options of oid2name and pgbench, as they are securityTom Lane
hazards. Instead teach these programs to prompt for a password when necessary, just like all our other programs. I did not bother to invent -W switches for them, since the return on investment seems so low.
2007-12-10Make an editorial pass over the newly SGML-ified contrib documentation.Tom Lane
Fix lots of bad markup, bad English, bad explanations. Second round of commits. pgcrypto and pgstandby still to go...
2007-11-11Remove tabs from SGML files.Bruce Momjian
2007-11-10Move most /contrib README files into SGML. Some still need conversionBruce Momjian
or will never be converted.