ʸ���ѥ�����

Documentation sources include plain text files, man pages, and html. However, most new Postgres documentation will be written using the Standard Generalized Markup Language (SGML) DocBook Document Type Definition (DTD). Much of the existing documentation has been or will be converted to SGML.

ʸ���ѥ������ˤϡ�ʿʸ�Υƥ����ȥե����롢�ޥ˥奢��ڡ�����HTML ������ޤ������������ǿ��� Postgres ��ʸ �񲽤ϡ� Standard Generalized Markup Language �� SGML �� DocBook Document Type Definition (DTD) ����Ѥ��Ƶ��Ҥ���Ƥ��ޤ�����¸��ʸ���¿���� SGML ���Ѵ��Ѥߡ��⤷�����ѹ������ͽ��Ǥ���

The purpose of SGML is to allow an author to specify the structure and content of a document (e.g. using the DocBook DTD), and to have the document style define how that content is rendered into a final form (e.g. using Norm Walsh's stylesheets).

SGML ����Ū�ϡ����Ԥ�ʸ��ι�¤�����Ƥ���㤨�С� DocBook DTD ��Ȥäơ� ����Ǥ��뤳�Ȥȡ��ɤ����Ƥ���㤨�� Norm Walsh ��Υ������륷���� ��Ȥäơ˺ǽ����֤��Ѵ����뤫���������ʸ�񥹥��������Ĥ��Ȥ��� ���뤳�ȤǤ���

Documentation has accumulated from several sources. As we integrate and assimilate existing documentation into a coherent documentation set, the older versions will become obsolete and will be removed from the distribution. However, this will not happen immediately, and will not happen to all documents at the same time. To ease the transition, and to help guide developers and writers, we have defined a transition roadmap.

ʸ���ʣ���Υ������򽸤�ƺ���ޤ�����¸��ʸ�����ϩ�����Ȥ���ʸ�� �������硢Ʊ����������Ť��С������Τ�Τ����Ѥ���ʤ��ʤꡢ����ʪ �⤫��������ޤ����������������¨�¤˹Ԥʤ��ޤ��󤷡���ʸ����� ����Ʊ���˹Ԥʤ����Ȥ⤢��ޤ��󡣰ܹԤ��ñ�ˤ��뤿��ˡ������ơ��� ���ɤγ�ȯ�Ԥ��Ԥ�������뤿��ˡ��ܹԤΥ����ɥޥåפ�������Ƥ��� ����

Here is the documentation plan for v6.5:

�С������ 6.5 �Ѥ�ʸ�񲽷ײ�򤳤��˼����ޤ���

• Start compiling index information for the User's and Administrator's Guides.

  �桼�������ɡ����ɥߥ˥��ȥ졼���������Ѥ��ܼ�������Ի���Ϥ�� ��������

• Write more sections for the User's Guide covering areas outside the reference pages. This would include introductory information and suggestions for approaches to typical design problems.

  �桼���������ѤΡ���ե���󥹥ڡ����������ʬ���ϰϤȤ������¿���� �Ʋ������������ˤϡ����֤��Ѥξ���ȡ�ŵ��Ū���߷�����ؤμ�����Ѥ� ��Ƥ�ޤߤޤ���

• Merge information in the existing man pages into the reference pages and User's Guide. Condense the man pages down to reminder information, with references into the primary doc set.

  ��¸�Υޥ˥奢��ڡ�����ξ�����ե���󥹥ڡ����ڤӥ桼�������ɤ� �ޡ������Ʋ��������ޥ˥奢��ڡ�������פ�ʸ�񷲤ؤλ��Ȥ���ä��Ƥ� �������ξ���˶Ž̤����Ʋ�������

• Convert the new sgml reference pages to new man pages, replacing the existing man pages.

  ������ sgml �Υ�ե���󥹥ڡ�����ޥ˥奢��ڡ������Ѵ����Ʋ������� ��¸�ޥ˥奢��ڡ������֤�������Ԥʤ��ޤ���

• Convert all source graphics to CGM format files for portability. Currently we mostly have Applix Graphics sources from which we can generate .gif output. One graphic is only available in .gif and .ps, and should be redrawn or removed.

  �ܿ����Τ���˸��Ȥʤ�������٤Ƥ� CGM �������Ѵ����Ʋ����������ߡ� Applix Graphics ��������Ȥä������ .gif ���Ϥ�������Ƥ��ޤ����� ���ϡ�.gif �� .ps �Ȥ��ä���ľ���������Ǥ�����Ǥ����Τ����� ���Ѥ��Ƥ��ޤ���

; ********** for SGML mode (psgml)

(setq sgml-catalog-files "/usr/lib/sgml/CATALOG")
(setq sgml-local-catalogs "/usr/lib/sgml/CATALOG")

(autoload 'sgml-mode "psgml" "Major mode to edit SGML files." t )

(setq
  auto-mode-alist
  '(("\\.sgml$" . sgml-mode)
   ))

!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"./reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog"
sgml-local-ecat-files:nil
End:
--

!doctype appendix PUBLIC "-//Davenport//DTD DocBook V3.0//EN"