Skip to content

Commit a6554df

Browse files
peterepetere
committed
In an effort to reduce the total number of chapters, combine the small
chapters on extending types, operators, and aggregates into the extending functions chapter. Move the information on how to call table functions into the queries chapter. Remove some outdated information that is already present in a better form in other parts of the documentation.
1 parent 730840c commit a6554df

File tree

11 files changed

+963
-1345
lines changed

11 files changed

+963
-1345
lines changed

‎doc/src/sgml/Makefile

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
#
33
# PostgreSQL documentation makefile
44
#
5-
# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.56 2003/03/25 16:15:35 petere Exp $
5+
# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.57 2003/04/10 01:22:44 petere Exp $
66
#
77
#----------------------------------------------------------------------------
88

@@ -77,7 +77,7 @@ all: html
7777

7878
.PHONY: html
7979

80-
html: postgres.sgml $(ALLSGML) stylesheet.dsl catalogs.gif connections.gif
80+
html: postgres.sgml $(ALLSGML) stylesheet.dsl
8181
@rm -f *.html
8282
$(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -i output-html -t sgml $<
8383

@@ -114,22 +114,16 @@ features-unsupported.sgml: $(top_srcdir)/src/backend/catalog/sql_feature_package
114114
%.rtf: %.sgml $(ALLSGML) stylesheet.dsl
115115
$(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t rtf -V rtf-backend -i output-print $<
116116

117-
postgres.rtf: catalogs.gif connections.gif
118-
119117
# TeX
120118
# Regular TeX and pdfTeX have slightly differing requirements, so we
121119
# need to distinguish the path we're taking.
122120

123121
%.tex-ps: %.sgml $(ALLSGML) stylesheet.dsl
124122
$(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t tex -V tex-backend -i output-print -V texdvi-output -o $@ $<
125123

126-
postgres.tex-ps: catalogs.eps connections.eps
127-
128124
%.tex-pdf: %.sgml $(ALLSGML) stylesheet.dsl
129125
$(JADE) $(JADEFLAGS) $(SGMLINCLUDE) $(CATALOG) -d stylesheet.dsl -t tex -V tex-backend -i output-print -V texpdf-output -o $@ $<
130126

131-
postgres.tex-pdf: catalogs.pdf connections.pdf
132-
133127
%.dvi: %.tex-ps
134128
@rm -f $*.aux $*.log
135129
jadetex $<

‎doc/src/sgml/arch-pg.sgml

Lines changed: 0 additions & 116 deletions
This file was deleted.

‎doc/src/sgml/dfunc.sgml

Lines changed: 11 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/dfunc.sgml,v 1.24 2003/03/25 16:15:35 petere Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/dfunc.sgml,v 1.25 2003/04/10 01:22:44 petere Exp $
33
-->
44

55
<sect2 id="dfunc">
@@ -14,7 +14,8 @@ $Header: /cvsroot/pgsql/doc/src/sgml/dfunc.sgml,v 1.24 2003/03/25 16:15:35 peter
1414
</para>
1515

1616
<para>
17-
For more information you should read the documentation of your
17+
For information beyond what is contained in this section
18+
you should read the documentation of your
1819
operating system, in particular the manual pages for the C compiler,
1920
<command>cc</command>, and the link editor, <command>ld</command>.
2021
In addition, the <productname>PostgreSQL</productname> source code
@@ -47,13 +48,10 @@ $Header: /cvsroot/pgsql/doc/src/sgml/dfunc.sgml,v 1.24 2003/03/25 16:15:35 peter
4748
here.
4849
</para>
4950

50-
<para>
51-
5251
<!--
53-
Note: Reading GNU Libtool sources is generally a good way of figuring out
54-
this information. The methods used within
55-
<productname>PostgreSQL</> source code are not
56-
necessarily ideal.
52+
Note: Reading GNU Libtool sources is generally a good way of
53+
figuring out this information. The methods used within PostgreSQL
54+
source code are not necessarily ideal.
5755
-->
5856

5957
<variablelist>
@@ -160,7 +158,7 @@ cc -shared -o foo.so foo.o
160158
<indexterm><primary>MacOS X</></>
161159
<listitem>
162160
<para>
163-
Here is a sample. It assumes the developer tools are installed.
161+
Here is an example. It assumes the developer tools are installed.
164162
<programlisting>
165163
cc -c foo.c
166164
cc -bundle -flat_namespace -undefined suppress -o foo.so foo.o
@@ -271,17 +269,13 @@ gcc -shared -o foo.so foo.o
271269
</varlistentry>
272270

273271
</variablelist>
274-
</para>
275272

276273
<tip>
277274
<para>
278-
If you want to package your extension modules for wide distribution
279-
you should consider using <ulink
280-
url="http://www.gnu.org/software/libtool/"><productname>GNU
281-
Libtool</productname></ulink> for building shared libraries. It
282-
encapsulates the platform differences into a general and powerful
283-
interface. Serious packaging also requires considerations about
284-
library versioning, symbol resolution methods, and other issues.
275+
If this is too complicated for you, you should consider using
276+
<ulink url="http://www.gnu.org/software/libtool/"><productname>GNU
277+
Libtool</productname></ulink>, which hides the platform differences
278+
behind a uniform interface.
285279
</para>
286280
</tip>
287281

0 commit comments

Comments
 (0)