The Annotated C++ Reference Manual

The Annotated C++ Reference Manual is a foundational technical book that served as a crucial de facto standard for the C++ programming language prior to the establishment of a formal ISO standard. Authored by Bjarne Stroustrup, the creator of C++, and Margaret A. Ellis, it was published in 1990 by Addison-Wesley. The work provided the most authoritative and detailed specification of the language's features at the time, extensively annotated with insights and rationale directly from its designer.

Background and publication history

The book emerged during a critical period in the evolution of C++, following the release of the influential second edition of Stroustrup's The C++ Programming Language in 1991 and preceding the lengthy process of ANSI and ISO standardization. It was conceived to document the language as implemented by the CFront compiler and to clarify many ambiguities present in earlier references. Published by Addison-Wesley as part of their professional computing series, the manual was based on the working papers circulated within the ANSI C++ standards committee, known as X3J16. Its creation was a direct response to the growing need for a stable, unambiguous reference among compiler implementers and advanced developers in the software industry.

Structure and content

The core of the manual is a detailed, clause-by-clause reference for the C++ language, meticulously organized similarly to a formal standard. It covers all major language components, including the C++ grammar, the semantics of declarations, the behavior of classes, and the rules for operator overloading and templates. A significant portion is dedicated to explaining the ARM C++ memory model, exception handling specifications, and the intricacies of name resolution. The text serves as a precise specification, defining permissible constructs and their interpretations, which made it indispensable for teams working on compilers like Borland C++, Microsoft Visual C++, and GNU Compiler Collection.

Annotations and commentary

What distinguished this work from a dry specification were the extensive annotations provided by Stroustrup and Ellis. These notes, set in a distinct typeface, offer the rationale behind design decisions, historical context for specific features, and warnings about potentially confusing or underspecified areas of the language. The commentary often explains why certain features, such as multiple inheritance or templates, were included and how their implementation interacted with other elements like the Standard Template Library concepts being developed at AT&T Bell Labs. These insights provided readers with a unique view into the language's design philosophy, directly from its principal architect.

Impact and reception

Upon its release, The Annotated C++ Reference Manual was immediately hailed as an essential resource. It became the definitive guide for compiler writers, ensuring a greater degree of consistency between different implementations from vendors like IBM, Sun Microsystems, and Hewlett-Packard. The book profoundly influenced the culture of C++ programming, setting expectations for precision and depth in technical documentation. Its authoritative status was acknowledged by major figures in the field and it was frequently cited in academic papers and advanced programming texts. The manual solidified C++'s position as a serious language for large-scale software engineering projects.

Relationship to the C++ standard

This manual is directly ancestral to the first official ISO/IEC 14882 standard for C++, published in 1998. The ANSI/ISO committee used the annotated reference manual as its primary base document during the standardization process. Many of the annotations and clarifications found their way directly into the normative text of the final C++98 standard. While the formal ISO standard eventually superseded it, the ARM (as it is often abbreviated) remains a vital historical document for understanding the design intent behind many language features, and its influence is still evident in modern C++ standards like C++11 and C++20.