--------------------------------------------------------------------------------
--  Copyright (c) 2012 Sierra Wireless.
--  All rights reserved. This program and the accompanying materials
--  are made available under the terms of the Eclipse Public License v1.0
--  which accompanies this distribution, and is available at
--  http://www.eclipse.org/legal/epl-v10.html
-- 
--  Contributors:
--       Kevin KIN-FOO <kkinfoo@sierrawireless.com>
--           - initial API and implementation and initial documentation
--------------------------------------------------------------------------------
return 
[[<dl class="function">
<dt>
# --
# -- Resolve item type definition
# --
# local typedef = _item:resolvetype()

# --
# -- Show item type for internal type
# --
#if _item.type and (not typedef or typedef.tag ~= 'functiontypedef') then
#  --Show link only when available 
#  local link = fulllinkto(_item.type)
#  if link then
    <em>$( link )</em>
#  else
    <em>$(prettyname(_item.type))</em>
#  end
#end
<a id="$(anchor(_item))" >
<strong>$( prettyname(_item) )</strong>
</a>
</dt>
<dd>
# local ignoredescription = false
# if _item.shortdescription then
    $( format(_item.shortdescription) )
#   ignoredescription = true
# end
# if _item.description and #_item.description > 0 then
    $( format(_item.description) )
#   ignoredescription = true
# end
#
# --
# -- For function definitions, describe parameters and return values
# --
#if typedef and typedef.tag == 'functiontypedef' then
#  local fdef = typedef
  $( applytemplate(fdef, i,nil,isinvokable(_item),ignoredescription) )
#else
#--
#-- Show usage samples for item which is not a function
#--
#  if _item.metadata and _item.metadata.usage then
  $( applytemplate(_item.metadata.usage, i) )
#  end
#end
#
</dd>
</dl>]]