Safari Books Online is a digital library providing on-demand subscription access to thousands of learning resources.
reference Formatting reference pages may require a fairly sophisticated processing system. Much of the meta-information about a reference page (its name, type, purpose, title, and classification) is stored in wrappers near the beginning of the refentry . Common presentational features, such as titles and running heads, may require data from several of these wrappers plus some generated text. Other formatting often re- quires that these elements be reordered. See Also refdescriptor , refname Examples See refentry for examples that use this element. reference Synopsis A collection of reference entries reference ::= (((( title & titleabbrev ? & subtitle ?), info ? db.titleforbidden.info ) | info db.titlereq.info ), partintro ?, refentry +) Attribute synopsis Common attributes and common linking attributes. Additional attributes: · label · status Additional constraints · If this element is the root element, it must have a version attribute. Description A reference is a collection of refentry s. In a book , a reference can occur at either the part or the chapter level. Reference pages are usually bound together by topic; in traditional UNIX documenta- tion they are most frequently bound into volumes. See manvolnum . Processing expectations Formatted as a displayed block. A reference often introduces a forced page break and may start on the next recto page. Frequently, it also produces a separator page, on which may be printed the content of the partintro . Attributes Common attributes and common linking attributes. label Specifies an identifying string for presentation purposes DocBook Element Reference | 353