productname

productname — The formal name of a product.

Synopsis

productname ::= [-]

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • class (enumeration)
    • “copyright”
    • “registered”
    • “service”
    • “trade”

Description

A productname is the formal name of any product. Identifying a product this way may be useful if you need to provide explicit disclaimers about product names or information.

For example, the copyright statement in most books includes a notice similar to this:

Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this book, and O’Reilly Media, Inc. was aware of a trademark claim, the designations have been printed in caps or initial caps.

If every product name were coded as a productname, you could automatically generate a complete list of all the product names and mention them explicitly in the notice.

In running prose, the distinction between an application and a productname may be very subjective.

Processing expectations

Formatted inline.

Two of the values of the class attribute on productname, Trade and Registered, make assertions about trademarks. DocBook also has a trademark element; presumably the same markup is intended regardless of which one is used.

The service and copyright values should also generate the anticipated marks, if appropriate.

Attributes

Common attributes and common linking attributes.

class

Specifies the class of product name

Enumerated values:
“copyright”

A name with a copyright

“registered”

A name with a registered copyright

“service”

A name of a service

“trade”

A name which is trademarked

Parents

These elements contain productname: biblioentry, bibliomixed, bibliomset, biblioset, bridgehead, caption (db.html.caption), citation, citetitle, classsynopsisinfo, contrib, emphasis (db.emphasis), entry, firstterm (db.firstterm), foreignphrase (db.foreignphrase), funcsynopsisinfo, glosssee, glossseealso, glossterm (db.glossterm), info (db.info), info (db.titleforbidden.info), info (db.titleonly.info), info (db.titleonlyreq.info), info (db.titlereq.info), link, literallayout, member, merge, olink, orgdiv, para, phrase (db.phrase), primary, primaryie, programlisting, quote (db.quote), refdescriptor, refentrytitle, refname, refpurpose, remark, screen, secondary, secondaryie, see, seealso, seealsoie, seeie, seg, segtitle, simpara, subtitle, synopsis, td, term, termdef, tertiary, tertiaryie, th, title, titleabbrev, tocentry.

Children

The following elements occur in productname: text, abbrev, acronym, alt, anchor, annotation, biblioref, coref, date, emphasis (db._emphasis), firstterm (db._firstterm), footnote, footnoteref, foreignphrase (db._foreignphrase), glossterm (db._glossterm), indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), inlinemediaobject, link, olink, phrase (db._phrase), quote (db._quote), remark, replaceable, subscript, superscript, trademark, wordasword, xref.

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example productname</title>

<para><productname class='registered'>Frobozz</productname>: it's not
just for breakfast anymore.
</para>

</article>

Frobozz®: it's not just for breakfast anymore.

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example productname</title>

<para><trademark>Frobozz</trademark>: it's not
just for breakfast anymore.
</para>

</article>

Frobozz™: it's not just for breakfast anymore.

Last revised by Norman Walsh on (git hash: 4460ecff4b65268b558037cbda9fadcfb9e3e09a 7c5a17532e372309975fdbdf572c92cf383a8b5d d8336abc499f0c937e6dbe0a81964bf398e6987d)