-
+
Documentation
languages are applications of the Standard Generalized
Markup Language,
SGML, which is
essentially a language for describing other languages. In what
- follows, the terms DocBook and SGML are both used, but technically
- they are not interchangeable.
+ follows, the terms DocBook and
SGML are both
+ used, but technically they are not interchangeable.
The
PostgreSQL distribution includes a
parsed DTD definitions file reference.ced.
- You may find that when using PSGML, a comfortable way of working
- with these separate files of book parts is to insert a proper
- DOCTYPE declaration while you're editing them.
- If you are working on this source, for instance, it is an
- appendix chapter, so you would specify the document as an
- appendix
instance of a DocBook document by making
- the first line look like this:
+ You may find that when using
PSGML, a
+ comfortable way of working with these separate files of book
+ parts is to insert a proper DOCTYPE
+ declaration while you're editing them. If you are working on
+ this source, for instance, it is an appendix chapter, so you
+ would specify the document as an appendix
instance
+ of a DocBook document by making the first line look like this:
<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook V4.2//EN">
Other Emacs modes
-
GNU Emacs ships with a different
SGML
- mode, which is not quite as powerful as
+
GNU Emacs ships with a different
+
SGML mode, which is not quite as powerful as
PSGML, but it's less confusing and
lighter weight. Also, it offers syntax highlighting (font lock),
which can be very helpful.
- For Emacs, add the following (or something similar)
- to your ~/.emacs
+ For
Emacs, add the following (or
+ something similar) to your ~/.emacs
initialization file:
set tabstop=4
- or equivalently from within vi, try
+ or equivalently from within
vi, try
:set ts=4
Use lower case for message wording, including the first letter of a
primary error message. Use upper case for SQL commands and key words if
- they appear in the message.
+ they appear in the message.
- Rationale: Else no one will know what foo.bar.baz
is.
+ Rationale: Otherwise no one will know what foo.bar.baz>
+ refers to.