.. index:: doclet
.. _doclet/0:

**object**

``doclet``
==========

Utility object to help automate (re)generating documentation for a project.

| **Author:** Paulo Moura
| **Version:** 0.5
| **Date:** 2017/1/5

| **Compilation flags:**
|    ``static, context_switching_calls``


| **Provides:**
|    :ref:`logtalk::message_tokens//2 <logtalk/0::message_tokens//2>`

Public interface
----------------

.. raw:: html

   <div id="update/0"> </div>

.. index:: update/0
.. _doclet/0::update/0:

``update/0``
^^^^^^^^^^^^

Updates the project documentation, first by calling a sequence of goals and second by executing a sequence of shell commands. Fails if any goal or shell command fails.

| **Compilation flags:**
|    ``static``

| **Mode and number of proofs:**
|    ``update`` - ``zero_or_one``


.. raw:: html

   <div id="doc_goal/1"> </div>

.. index:: doc_goal/1
.. _doclet/0::doc_goal/1:

``doc_goal/1``
^^^^^^^^^^^^^^

Table of goals, typically using the "diagrams" and the "lgtdoc" tools, used to generate the documentation. Goals are called in the order they are defined and in the context of the "user" pseudo-object.

| **Compilation flags:**
|    ``static``

| **Template:**
|    ``doc_goal(Goal)``
| **Mode and number of proofs:**
|    ``doc_goal(?callable)`` - ``one_or_more``


.. raw:: html

   <div id="shell_command/1"> </div>

.. index:: shell_command/1
.. _doclet/0::shell_command/1:

``shell_command/1``
^^^^^^^^^^^^^^^^^^^

Table of shell commands to convert intermediate documentation files into user-friendly documentation. Commands are executed in the order they are defined.

| **Compilation flags:**
|    ``static``

| **Template:**
|    ``shell_command(Command)``
| **Mode and number of proofs:**
|    ``shell_command(?atom)`` - ``one_or_more``


Protected interface
-------------------

(see related entities)

Private predicates
------------------

(see related entities)

Operators
---------

(none)

Remarks
-------

(none)

.. seealso::

   :ref:`lgtdocp <lgtdocp/0>`, :ref:`diagram(Format) <diagram/1>`

