Browse Books

Reviewer: John Lloyd

This hefty book is without a doubt the best reference book on SGML currently available. I highly recommend the book for anyone implementing an SGML system, or who otherwise needs a complete and precise understanding of SGML. The only way to get such an understanding is by referring to the SGML standard ISO 8879, but that document is very difficult to use by itself. The SGML Handbook , presents the standard in its entirety, but with introductory material, annotations, cross-references, and an index thus making it much easier to work with. For an author or other person who only needs a basic understanding of SGML clearly presented and without being bothered by all the details, there are better books. The boo k is divided into 5 parts, titled as follows: Tutorials A Structured Overview of SGML ISO 8879 Annotated ISO 8879 Annexes Appendices The tutorials introduce the basic concepts of generalized markup and the Standard Generalized Markup Language. It is difficult for me to evaluate how good an introduction this would be for someone who is new to the subject since I was already very familiar with SGML. For someone who just wants an introduction, I would recommend starting elsewhere, but if you want to have just one book on SGML, I think the introductory material here is suitable for someone getting started. The structured overview is a systematic presentation of SGML concepts without the syntactic details. It is essentially material extracted from ISO 8879 that has been reorganized. I have not found myself using this section, but perhaps it would be useful for someone new to SGML. The heart of the book is Part Three, which presents the complete text of ISO 8879 along with annotations, and more importantly, extensive cross-references. Anyone who has attempted working from the standard alone can appreciated how important these cross-references are. The standard is for the most part a series of syntax productions where to understand a production you must understand each of the syntactic variables used in it. However, the definitions of these variables, which themselves are often comprised of additional variables, are scattered throughout the document, and there is no easy way to locate them. With The SGML Handbook , the standard is extensively cross-reference both within itself, and also to the tutorials and overview. When I need to know the details of the standard in a particular area, I usually start with the index, and then work from the cross-references, and can fairly quickly learn what I need. This has not been the case with any other book on SGML that I have seen. The annotations of Part Three are sometimes very useful as well. The standard is difficult to follow in a lot of places, and having annotations embodied in the text is often very helpful. The fact that the author was at the center of the development of SGML from the beginning allows him to present interesting explanations that otherwise could be missed. Part four, annexes to the standard, provides additional reference material that is good to have for the sake of completeness. The appendices provide some history and background for the development of SGML and make interesting reading. Finally, there is a thorough index. The SGML Handbook is far from perfect. There are still areas where after reading everything one can find in the cross-references, the exact meaning of the standard is not clear. There are many topics which I wish were dealt with in one place instead of being spread throughout the book. There is very little in the book which would help a novice distinguish the truly necessary and useful concepts from the esoteric. However, it still stands as the best reference book on SGML currently available.

Reviewer: B. Tommie Usdin

Standard Generalized Markup Language (SGML) is defined here as “a language for representing documents that are acted on by text processing applications.” This is as good a one-sentence definition as I have seen; SGML is too complex a concept to summarize easily. The SGML approach to describing structured information grew out of older concepts of generic markup for typography. SGML is frequently used when text is likely to be presented in multiple formats (such as a printed book and a hypertext CD-ROM) or exchanged among unlike computer systems (such as between fabricator and purchaser database systems), or when documents will be revised over an extended period of time. SGML applications include electronic documents, hypermedia, and synchronized multilingual documents. SGML is the text encoding component of the Department of Defense Computer-aided Acquisition and Logistics Support (CALS) initiative. ISO 8879 is the international standard for SGML. ISO 8879 defines SGML through a series of logical productions. The standard, while precise and specific, is not easily read or understood. This book is, in essence, a 664-page definition and explanation of the SGML standard, by the editor of that standard. This handbook is divided into four parts: “Tutorials,” “A Structured Overview of SGML,” “ISO 8879 Annotated,” and “ISO 8879 Annexes.” It also has four appendices, extensive tables of contents, and indexes. Some of the tutorials and the ISO 8879 annexes are simply reprinted from the international standard. The bulk of the book consists of original material, annotations, material so transformed by sequence and presentation that it is essentially new, and an integration of material available elsewhere only as separate documents. The most innovative and valuable part of the handbook is Part 2, the “Structured Overview of SGML.” This material is a retelling of the SGML story, using the definitions from ISO 8879. In ISO 8879 the definitions are presented in alphabetical order. In alphabetical order, these definitions are confusing and often appear cryptic if not circular. Goldfarb has divided the topics addressed in ISO 8879 into logical groups, which he presents from most general to most specific. The subtopics included in each of these groups are elucidated by presenting the ISO 8879 definitions in a cumulative sequence, with brief introductory remarks and short transitional paragraphs. Goldfarb has created a smooth and cohesive explanation of SGML from an inaccessible reference document, primarily through the use of sequence and the addition of headings. This is a brilliant pedagogical feat and a ringing indictment of alphabetical order. Few, if any, aspects of the standard are not covered by the definitions, so this structured overview is a complete explanation of SGML in narrative form. Most SGML novices and nonmathematicians will find this description of SGML less intimidating and easier to understand than the standard itself. The full text of the standard appears in Part 3. This text incorporates the amendment of 1988 and the clarifications recommended by the SGML Special Working Group in 1990. (To my knowledge, no other source contains the fully integrated text of the standard with the amendment and recommended clarifications.) The text is heavily annotated. Annotations introduce each section and subsection and many of the individual subparagraphs and productions. The annotations include plain English descriptions of the productions, descriptions of why the various features of SGML were included, historical notes on the genesis of many features, and examples of the use of various aspects of SGML. The author's opinions, both on aspects of the standard and on common applications of SGML, are liberally incorporated. He gives advice on when to use various features and when to avoid them, and provides warnings on practices that while valid may cause unanticipated difficulties in practice. The full text (unannotated) of the three tutorial annexes from ISO 8879, “Generalized Markup,” “Basic Concepts,” and “Additional Concepts,” begins Part 1, “Tutorials.” Part 1 also includes a new tutorial on the LINK feature of SGML. To quote from this tutorial, the SGML LINK feature “lets you specify formatting (or any other process) without distorting the logical structure markup. In a nutshell, LINK lets you associate processing-oriented attributes with a start-tag without actually putting them there. Or, to put it another way, LINK allows you to associate style sheets and procedures with elements.” The LINK tutorial is clear and straightforward. While it does not cover all of the ways applications are currently using LINK, it is a good start toward understanding this most complex subtopic of SGML. Part 4, “The ISO 8879 Annexes,” contains the full text (unannotated) of the nontutorial annexes to ISO 8879. A full table of contents to these annexes is provided, and they are included in the overall index. The appendices include a history of SGML and a list of sources for further information about SGML. The history of SGML is a reprint of a 1989 SGML Users' Group document, which has been widely reprinted. It is a dry version of the history; not inaccurate, but lacking all hint of controversy, difficulty, or personality. I am disappointed that this book does not add a little more detail and color to the recorded history of SGML. The “Sources of SGML Information” appendix is the weakest part of the handbook; the lists of people and organizations who provide SGML information, of SGML books, and of publications relating to SGML are short and briefly annotated. This book is the most heavily indexed and cross-ref erenced volume in my collection. The tables of contents for the parts are up to five levels deep and constitute an admirable summary of the book, and of SGML, in themselves. The book contains an extensive index, not only to the headings within the text but to the minutiae, as well as a “reference button” system of cross-references within the volume. The typography of the handbook is self-conscious and complex, but easy to understand. The major distinction made typographically is between the official text of ISO 8879 and the annotations. The handbook would be a must-have in every SGML reference collection if all it contained was the integrated annotated text of the standard. In addition, the structured overview of SGML is the best technical explanation of SGML I have seen. While the handbook is not presented as a textbook, I have already ordered a set to use as the text in a DTD construction class, and also plan on using it when teaching SGML basics.