Documentation|Material: Minor de::Material apidoc tweaks

doomsday/engine/include/resource/material.h

@@ -392,7 +392,8 @@ class Material : public de::MapElement
     bool isSkyMasked() const;
 
     /// Returns @c true if the material has one or more (light) decorations.
-    bool hasDecorations() const;
+    /// Equivalent to @code decorationCount() != 0; @endcode
+    inline bool hasDecorations() const { return decorationCount() != 0; }
 
     /// Returns @c true if one or more of the material's layers are glowing.
     bool hasGlow() const;
@@ -415,20 +416,20 @@ class Material : public de::MapElement
      * Choose/create a variant of the material which fulfills @a spec and then
      * immediately prepare it for render (e.g., upload textures if necessary).
      *
-     * @note A convenient shorthand of the call tree:
-     * <pre>
-     *    chooseVariant( @a spec, @c true )->prepare( @a forceSnapshotUpdate )
-     * </pre>
+     * Intended as a convenient shorthand of the call tree:
+     * @code
+     *    chooseVariant(@a spec, true)->prepare(@a forceSnapshotUpdate)
+     * @endcode
      *
-     * @param spec  Specification for the derivation of @a material.
+     * @param spec  Specification with which to derive the variant.
      * @param forceSnapshotUpdate  @c true= Force an update of the variant's
      *      state snapshot. The snapshot is automatically updated when first
      *      prepared for a new render frame. Typically the only time force is
      *      needed is when the material variant has changed since.
      *
      * @return  Snapshot for the chosen and prepared variant of Material.
      *
-     * @see chooseVariant(), Variant::prepare()
+     * @see Materials::variantSpecForContext(), chooseVariant(), Variant::prepare()
      */
     inline de::MaterialSnapshot const &prepare(de::MaterialVariantSpec const &spec,
                                                bool forceSnapshotUpdate = false)

doomsday/engine/src/resource/material.cpp

@@ -511,11 +511,6 @@ void Material::clearVariants()
     d->clearVariants();
 }
 
-bool Material::hasDecorations() const
-{
-    return d->decorations.count() != 0;
-}
-
 int Material::getProperty(setargs_t &args) const
 {
     switch(args.prop)