.. _ug_flmake_log:

log
===
Many other flmake commands log messages (user-provided or automatically generated) to 
a ``flash.log`` file.  This file serves as a historical record of the commands previously 
executed in this project.  It also is a repository of all previous run ids and the 
associated run directories.  The ``flmake log`` command displays this history in a human
readable form.

**USAGE**:: 

    flmake log [-n <N>]

The optional ``-n`` switch means that the log command will only display the latest
N entries rather than the entire history.

examples
~~~~~~~~
A run, restart, merge scenario::

    Run id: 20a5b5b4
    Run dir: hllc3
    Command: merge
    User: scopatz
    Date: Tue Mar 20 11:13:23 2012
    Log id: df62b8e6-477d-4514-82dd-929724345da3

        merged 9407f646, 78268113 into 20a5b5b4 (hllc3)

    Run id: 78268113
    Run dir: run-78268113
    Command: restart
    User: scopatz
    Date: Mon Mar 19 15:34:11 2012
    Log id: c859bc6f-a3c7-4794-92b5-69ae830207d4

        restarted 9407f646

    Run id: 9407f646
    Run dir: run-9407f646
    Command: run
    User: scopatz
    Date: Fri Mar 16 16:46:07 2012
    Log id: 7a181f8b-7639-4405-b732-b4b03149d1f6

        3rd order HLLC solver with mc slope limiter and cfl=0.4.