Обсуждение: pgsql-server/ oc/src/Makefile oc/src/sgml/Make ...

CVSROOT:    /cvsroot
Module name:    pgsql-server
Changes by:    petere@postgresql.org    03/03/25 11:15:44

Modified files:
    doc/src        : Makefile
    doc/src/sgml   : Makefile advanced.sgml arch-dev.sgml
                     catalogs.sgml charset.sgml ddl.sgml dfunc.sgml
                     dml.sgml ecpg.sgml extend.sgml filelist.sgml
                     func.sgml indices.sgml installation.sgml
                     jdbc.sgml legal.sgml libpq.sgml
                     maintenance.sgml manage-ag.sgml monitoring.sgml
                     mvcc.sgml notation.sgml perform.sgml
                     plpgsql.sgml postgres.sgml query.sgml
                     reference.sgml runtime.sgml
                     standalone-install.sgml start.sgml
                     stylesheet.dsl syntax.sgml trigger.sgml
                     typeconv.sgml user-manag.sgml xaggr.sgml
                     xfunc.sgml
    doc/src/sgml/ref: alter_database.sgml alter_table.sgml
                      alter_user.sgml analyze.sgml begin.sgml
                      checkpoint.sgml cluster.sgml
                      create_aggregate.sgml create_cast.sgml
                      create_conversion.sgml create_database.sgml
                      create_domain.sgml create_function.sgml
                      create_group.sgml create_language.sgml
                      create_opclass.sgml create_operator.sgml
                      create_sequence.sgml create_table.sgml
                      create_trigger.sgml create_type.sgml
                      create_user.sgml drop_aggregate.sgml
                      ecpg-ref.sgml explain.sgml initdb.sgml
                      initlocation.sgml insert.sgml load.sgml
                      pg_config-ref.sgml pg_ctl-ref.sgml
                      pg_dump.sgml pg_restore.sgml pgtclsh.sgml
                      pgtksh.sgml postgres-ref.sgml postmaster.sgml
                      psql-ref.sgml reindex.sgml reset.sgml
                      select.sgml set.sgml set_transaction.sgml
                      show.sgml vacuum.sgml
    src/backend/port: sysv_sema.c sysv_shmem.c
    src/bin/initdb : initdb.sh
Removed files:
    doc/src/sgml   : admin.sgml developer.sgml entities.sgml
                     func-ref.sgml programmer.sgml tutorial.sgml
                     user.sgml

Log message:
    Merge documentation into one book.  (Build with "make html".)  Replace
    vague cross-references with real links.

On Tue, Mar 25, 2003 at 11:15:44AM -0500, Peter Eisentraut - PostgreSQL wrote:
> CVSROOT:    /cvsroot
> Module name:    pgsql-server
> Changes by:    petere@postgresql.org    03/03/25 11:15:44
>
> Modified files:
>     doc/src        : Makefile
[...]
>
> Log message:
>     Merge documentation into one book.  (Build with "make html".)  Replace
>     vague cross-references with real links.

Looks good.  In http://developer.postgresql.org/docs/postgres/ it is
already built, in case anyone cares.

One thing that has always bothered me is that the SET reference page
contains a lot of info on DateStyle that is not in the "Server Runtime
Configuration" page, and there's no crossref between them.  I think the
information should be covered in the latter, not in the SET reference
page.

Also, the libpq Environment Variables section should contain a crossref
to SET.  It is mentioned, but there's no link.

--
Alvaro Herrera (<alvherre[a]dcc.uchile.cl>)
"El realista sabe lo que quiere; el idealista quiere lo que sabe" (Anonimo)

On Tue, 2003-03-25 at 11:15, Peter Eisentraut - PostgreSQL wrote:
>     Merge documentation into one book.  (Build with "make html".)  Replace
>     vague cross-references with real links.

Nice work, Peter.

Two minor suggestions:

(1) It's kinda unfortunate that the "SQL Commands" reference isn't that
obvious from the main TOC, as that's what a lot of people are going to
be coming to the documentation looking. Not sure the best way to fix
that, though.

(2) The Index, List of Figures and List of Examples take up a lot of
room on the main TOC -- is there a way to make these show up in a
separate page, and just include a link to that page from the main TOC?

Cheers,

Neil

> src/backend/port: sysv_sema.c sysv_shmem.c
> src/bin/initdb : initdb.sh

Did you mean to commit the above files, Peter?

Chris