database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-10-27 00:12:01 +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

10
doc/src/sgml/sources.sgml
View File

@@ -207,7 +207,7 @@ ereport(ERROR,
<replaceable>n</replaceable> is the integer value that determines which plural
form is needed, and the remaining arguments are formatted according
to the selected format string. For more information see
<xref linkend="nls-guidelines">.
<xref linkend="nls-guidelines"/>.
</para>
</listitem>
<listitem>
@@ -234,7 +234,7 @@ ereport(ERROR,
<function>errdetail_plural(const char *fmt_singular, const char *fmt_plural,
unsigned long n, ...)</function> is like <function>errdetail</function>, but with
support for various plural forms of the message.
For more information see <xref linkend="nls-guidelines">.
For more information see <xref linkend="nls-guidelines"/>.
</para>
</listitem>
<listitem>
@@ -255,7 +255,7 @@ ereport(ERROR,
*fmt_plural, unsigned long n, ...)</function> is like
<function>errdetail_log</function>, but with support for various plural forms of
the message.
For more information see <xref linkend="nls-guidelines">.
For more information see <xref linkend="nls-guidelines"/>.
</para>
</listitem>
<listitem>
@@ -404,7 +404,7 @@ ereport(level, (errmsg_internal("format string", ...)));
<para>
Advice about writing good error messages can be found in
<xref linkend="error-style-guide">.
<xref linkend="error-style-guide"/>.
</para>
</sect1>
@@ -853,7 +853,7 @@ BETTER: unrecognized node type: 42
<para>
Keep in mind that error message texts need to be translated into other
languages. Follow the guidelines in <xref linkend="nls-guidelines">
languages. Follow the guidelines in <xref linkend="nls-guidelines"/>
to avoid making life difficult for translators.
</para>
</simplesect>