database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-10-25 13:17:41 +03:00
Code Activity

Convert documentation to DocBook XML

Browse Source 
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
This commit is contained in:
Peter Eisentraut
2017-11-23 09:39:47 -05:00
parent 2f8d6369e6
commit 3c49c6facb
346 changed files with 4260 additions and 4588 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
doc/src/sgml/intro.sgml
View File

@@ -23,13 +23,13 @@
<itemizedlist>
<listitem>
<para>
<xref linkend="tutorial"> is an informal introduction for new users.
<xref linkend="tutorial"/> is an informal introduction for new users.
</para>
</listitem>
<listitem>
<para>
<xref linkend="sql"> documents the <acronym>SQL</acronym> query
<xref linkend="sql"/> documents the <acronym>SQL</acronym> query
language environment, including data types and functions, as well
as user-level performance tuning. Every
<productname>PostgreSQL</productname> user should read this.
@@ -38,7 +38,7 @@
<listitem>
<para>
<xref linkend="admin"> describes the installation and
<xref linkend="admin"/> describes the installation and
administration of the server. Everyone who runs a
<productname>PostgreSQL</productname> server, be it for private
use or for others, should read this part.
@@ -47,7 +47,7 @@
<listitem>
<para>
<xref linkend="client-interfaces"> describes the programming
<xref linkend="client-interfaces"/> describes the programming
interfaces for <productname>PostgreSQL</productname> client
programs.
</para>
@@ -56,7 +56,7 @@
<listitem>
<para>
<xref linkend="server-programming"> contains information for
<xref linkend="server-programming"/> contains information for
advanced users about the extensibility capabilities of the
server. Topics include user-defined data types and
functions.
@@ -65,7 +65,7 @@
<listitem>
<para>
<xref linkend="reference"> contains reference information about
<xref linkend="reference"/> contains reference information about
SQL commands, client and server programs. This part supports
the other parts with structured information sorted by command or
program.
@@ -74,7 +74,7 @@
<listitem>
<para>
<xref linkend="internals"> contains assorted information that might be of
<xref linkend="internals"/> contains assorted information that might be of
use to <productname>PostgreSQL</productname> developers.
</para>
</listitem>