productname
productname — The formal name of a product.
Synopsis
productname ::=
- Zero or more of:
- text
- Graphic inlines
- Indexing inlines
- Linking inlines
- Ubiquitous inlines
abbrev
acronym
alt
anchor
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
subscript
superscript
trademark
wordasword
xref
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.
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.
- any attribute
Any attribute in any other explicit namespace
- 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
, citation
, citetitle
, contrib
, emphasis
(db.emphasis), entry
, firstterm
(db.firstterm), foreignphrase
(db.foreignphrase), glosssee
, glossseealso
, glossterm
(db.glossterm), info
(db.info), info
(db.titleforbidden.info), info
(db.titleonly.info), info
(db.titleonlyreq.info), info
(db.titlereq.info), inlinestagedir
, line
, link
, literallayout
, member
, meta
(db.meta.content), olink
, orgdiv
, para
, phrase
(db.phrase), primary
, quote
(db.quote), remark
, secondary
, see
, seealso
, simpara
, subtitle
, term
, termdef
, tertiary
, title
, titleabbrev
.
Children
The following elements occur in productname
: text, abbrev
, acronym
, alt
, anchor
, 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
, subscript
, superscript
, trademark
, wordasword
, xref
.
Examples
1 |<article xmlns='http://docbook.org/ns/docbook'>
|<title>Example productname</title>
||
<para><productname class='registered'>Frobozz</productname>: it's not
5 |just for breakfast anymore.
|</para>
||
</article>
Frobozz: it's not just for breakfast anymore.
1 |<article xmlns='http://docbook.org/ns/docbook'>
|<title>Example productname</title>
||
<para><trademark>Frobozz</trademark>: it's not
5 |just for breakfast anymore.
|</para>
||
</article>
Frobozz: it's not just for breakfast anymore.