文書化用ソース

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"