Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit ffb8f73

Browse files
peterepetere
committed
Bunch of copy fitting and style sheet tweakage to get decent looking print
output (from pdfjadetex). Also updated instructions to install documentation processing toolchain.
1 parent 2f1c24c commit ffb8f73

26 files changed

+482
-387
lines changed

‎doc/src/sgml/Makefile

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
#
99
#
1010
# IDENTIFICATION
11-
# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.41 2001/10/04 22:25:48 petere Exp $
11+
# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.42 2001/10/09 18:45:59 petere Exp $
1212
#
1313
#----------------------------------------------------------------------------
1414

@@ -123,6 +123,9 @@ $(addsuffix .tex, $(ALLBOOKS)): %.tex: %.sgml $(ALLSGML) stylesheet.dsl
123123
# TeX transforms '--' into en-dashes. This hack should go away when
124124
# OpenJade is fixed (ver. 1.4?)
125125
$(PERL) -pi -e 's/\-\-/\\mbox{}-\\mbox{}-\\mbox{}/g' $@
126+
$(PERL) -pi -e 's/\<\</\\mbox{}<\\mbox{}<\\mbox{}/g' $@
127+
$(PERL) -pi -e 's/\>\>/\\mbox{}>\\mbox{}>\\mbox{}/g' $@
128+
$(PERL) -pi -e "s/\'\'/\\\\mbox{}'\\\\mbox{}'\\\\mbox{}/g" $@
126129

127130
%.dvi: %.tex
128131
jadetex $<

‎doc/src/sgml/charset.sgml

Lines changed: 39 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/charset.sgml,v 2.11 2001/10/04 22:26:27 petere Exp $ -->
1+
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/charset.sgml,v 2.12 2001/10/09 18:45:59 petere Exp $ -->
22

33
<chapter id="charset">
44
<title>Localization</>
@@ -293,7 +293,7 @@ perl: warning: Falling back to the standard locale ("C").
293293
values in the following table:
294294

295295
<table tocentry="1">
296-
<title><productname>Postgres</productname> Character Set Encodings</title>
296+
<title>Character Set Encodings</title>
297297
<titleabbrev>Encodings</titleabbrev>
298298
<tgroup cols="2">
299299
<thead>
@@ -451,7 +451,7 @@ $ psql -l
451451
and frontend for some encodings.
452452

453453
<table tocentry="1">
454-
<title><productname>Postgres</productname> Client/Server Character Set Encodings</title>
454+
<title>Client/Server Character Set Encodings</title>
455455
<titleabbrev>Communication Encodings</titleabbrev>
456456
<tgroup cols="2">
457457
<thead>
@@ -618,38 +618,47 @@ RESET CLIENT_ENCODING;
618618
These are good sources to start learning about various kinds of encoding
619619
systems.
620620

621-
<itemizedlist>
622-
<listitem>
623-
<para>
624-
<ulink url="ftp://ftp.ora.com/pub/examples/nutshell/ujip/doc/cjk.inf"
625-
>ftp://ftp.ora.com/pub/examples/nutshell/ujip/doc/cjk.inf</ulink>
626-
Detailed explanations of <literal>EUC_JP</literal>, <literal>EUC_CN</literal>, <literal>EUC_KR</literal>, <literal>EUC_TW</literal>
627-
appear in section 3.2.
628-
</para>
629-
</listitem>
630-
631-
<listitem>
632-
<para>
633-
Unicode: <ulink url="http://www.unicode.org/">http://www.unicode.org/</ulink>
634-
The homepage of Unicode.
635-
</para>
636-
</listitem>
637-
638-
<listitem>
639-
<para>
640-
<literal>RFC 2044</literal>
641-
<literal>UTF</literal>-8 is defined here.
642-
</para>
643-
</listitem>
644-
</itemizedlist>
621+
<variablelist>
622+
<varlistentry>
623+
<term><ulink url="ftp://ftp.ora.com/pub/examples/nutshell/ujip/doc/cjk.inf"
624+
>ftp://ftp.ora.com/pub/examples/nutshell/ujip/doc/cjk.inf</ulink></term>
625+
626+
<listitem>
627+
<para>
628+
Detailed explanations of <literal>EUC_JP</literal>,
629+
<literal>EUC_CN</literal>, <literal>EUC_KR</literal>,
630+
<literal>EUC_TW</literal> appear in section 3.2.
631+
</para>
632+
</listitem>
633+
</varlistentry>
634+
635+
<varlistentry>
636+
<term><ulink url="http://www.unicode.org/">http://www.unicode.org/</ulink></term>
637+
638+
<listitem>
639+
<para>
640+
The web site of the Unicode Consortium
641+
</para>
642+
</listitem>
643+
</varlistentry>
644+
645+
<varlistentry>
646+
<term>RFC 2044</term>
647+
648+
<listitem>
649+
<para>
650+
<acronym>UTF</acronym>-8 is defined here.
651+
</para>
652+
</listitem>
653+
</varlistentry>
654+
</variablelist>
645655
</para>
646656
</sect2>
647657

648658
<sect2>
649659
<title>History</title>
650660

651-
<para>
652-
<programlisting>
661+
<literallayout class="monospaced">
653662
Dec 7, 2000
654663
* An automatic encoding translation between Unicode and other
655664
encodings are implemented
@@ -728,8 +737,7 @@ Mar 10, 1998 PL2 released
728737
* fix problems concerning 8-bit single byte characters
729738

730739
Mar 1, 1998 PL1 released
731-
</programlisting>
732-
</para>
740+
</literallayout>
733741
</sect2>
734742

735743
<sect2>

‎doc/src/sgml/cvs.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/cvs.sgml,v 1.18 2001/09/23 01:16:35 momjian Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/cvs.sgml,v 1.19 2001/10/09 18:45:59 petere Exp $
33
CVS code repository
44
Thomas Lockhart
55
-->
66

7-
<appendix label="DG1" id="cvs">
7+
<appendix id="cvs">
88
<docinfo>
99
<authorgroup>
1010
<author>

‎doc/src/sgml/datatype.sgml

Lines changed: 26 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$Header: /cvsroot/pgsql/doc/src/sgml/datatype.sgml,v 1.65 2001/10/03 05:24:22 thomas Exp $
2+
$Header: /cvsroot/pgsql/doc/src/sgml/datatype.sgml,v 1.66 2001/10/09 18:45:59 petere Exp $
33
-->
44

55
<chapter id="datatype">
@@ -168,8 +168,8 @@ $Header: /cvsroot/pgsql/doc/src/sgml/datatype.sgml,v 1.65 2001/10/03 05:24:22 th
168168
</row>
169169

170170
<row>
171-
<entry><type>numeric(<replaceable>p</replaceable>,<replaceable>s</replaceable>)</type></entry>
172-
<entry><type>decimal(<replaceable>p</replaceable>,<replaceable>s</replaceable>)</type></entry>
171+
<entry><type>numeric(<replaceable>p</replaceable>, <replaceable>s</replaceable>)</type></entry>
172+
<entry><type>decimal(<replaceable>p</replaceable>, <replaceable>s</replaceable>)</type></entry>
173173
<entry>exact numeric with selectable precision</entry>
174174
</row>
175175

@@ -648,30 +648,33 @@ NUMERIC
648648
In the current implementation, specifying
649649

650650
<programlisting>
651-
CREATE TABLE <replaceable class="parameter">tablename</replaceable> (<replaceable class="parameter">colname</replaceable> SERIAL);
651+
CREATE TABLE <replaceable class="parameter">tablename</replaceable> (
652+
<replaceable class="parameter">colname</replaceable> SERIAL
653+
);
652654
</programlisting>
653655

654656
is equivalent to specifying:
655657

656658
<programlisting>
657659
CREATE SEQUENCE <replaceable class="parameter">tablename</replaceable>_<replaceable class="parameter">colname</replaceable>_seq;
658-
CREATE TABLE <replaceable class="parameter">tablename</replaceable>
659-
(<replaceable class="parameter">colname</replaceable> integer DEFAULT nextval('<replaceable class="parameter">tablename</replaceable>_<replaceable class="parameter">colname</replaceable>_seq') UNIQUE NOT NULL);
660+
CREATE TABLE <replaceable class="parameter">tablename</replaceable> (
661+
<replaceable class="parameter">colname</replaceable> integer DEFAULT nextval('<replaceable class="parameter">tablename</replaceable>_<replaceable class="parameter">colname</replaceable>_seq') UNIQUE NOT NULL
662+
);
660663
</programlisting>
661664

662665
Thus, we have created an integer column and arranged for its default
663666
values to be assigned from a sequence generator. UNIQUE and NOT NULL
664667
constraints are applied to ensure that explicitly-inserted values
665668
will never be duplicates, either.
669+
</para>
666670

667-
<caution>
671+
<important>
668672
<para>
669673
The implicit sequence created for the <type>serial</type> type will
670674
<emphasis>not</emphasis> be automatically removed when the
671675
table is dropped.
672676
</para>
673-
</caution>
674-
</para>
677+
</important>
675678

676679
<para>
677680
The type names <type>serial</type> and <type>serial4</type> are
@@ -974,7 +977,7 @@ SELECT b, char_length(b) FROM test2;
974977
<para>
975978
<table tocentry="1">
976979
<title>Date/Time Types</title>
977-
<tgroup cols="4">
980+
<tgroup cols="6">
978981
<thead>
979982
<row>
980983
<entry>Type</entry>
@@ -2563,18 +2566,25 @@ SELECT * FROM test1 WHERE a;
25632566
The <type>macaddr</> type stores MAC addresses, i.e., Ethernet
25642567
card hardware addresses (although MAC addresses are used for
25652568
other purposes as well). Input is accepted in various customary
2566-
formats, including <literal>'08002b:010203'</>,
2567-
<literal>'08002b-010203'</>, <literal>'0800.2b01.0203'</>,
2568-
<literal>'08-00-2b-01-02-03'</>, and
2569-
<literal>'08:00:2b:01:02:03'</>, which would all specify the same
2569+
formats, including
2570+
2571+
<simplelist>
2572+
<member><literal>'08002b:010203'</></member>
2573+
<member><literal>'08002b-010203'</></member>
2574+
<member><literal>'0800.2b01.0203'</></member>
2575+
<member><literal>'08-00-2b-01-02-03'</></member>
2576+
<member><literal>'08:00:2b:01:02:03'</></member>
2577+
</simplelist>
2578+
2579+
which would all specify the same
25702580
address. Upper and lower case is accepted for the digits
25712581
<literal>a</> through <literal>f</>. Output is always in the
2572-
latter of the given forms.
2582+
last of the shown forms.
25732583
</para>
25742584

25752585
<para>
25762586
The directory <filename class="directory">contrib/mac</filename>
2577-
in the <productname>Postgres</productname> source distribution
2587+
in the <productname>PostgreSQL</productname> source distribution
25782588
contains tools that can be used to map MAC addresses to hardware
25792589
manufacturer names.
25802590
</para>

‎doc/src/sgml/developer.sgml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/Attic/developer.sgml,v 1.5 2001/06/02 18:25:16 petere Exp $ -->
1+
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/Attic/developer.sgml,v 1.6 2001/10/09 18:45:59 petere Exp $ -->
22
<!-- PostgreSQL Developer's Guide -->
33

44
<book id="developer">
@@ -9,10 +9,10 @@
99
&legal;
1010

1111
<abstract>
12-
<simpara>
12+
<para>
1313
This document contains assorted information that can be of use to
1414
<productname>PostgreSQL</> developers.
15-
</simpara>
15+
</para>
1616
</abstract>
1717
</bookinfo>
1818

@@ -25,10 +25,10 @@
2525
&page;
2626
&geqo;
2727
&nls;
28-
<![%single-book;[
29-
&biblio;
30-
]]>
3128
<!-- appendices -->
3229
&cvs;
3330
&docguide;
31+
<![%single-book;[
32+
&biblio;
33+
]]>
3434
</book>

0 commit comments

Comments
 (0)