ecFlow's documentation is now on readthedocs!

Manual pages are part of the ecFlow script.(i.e. .ecf or .py, etc). This is to ensure that the manual page is updated when the script is updated. The manual page is a very important operational tool allowing you to view a description of a task, its importance, task dependencies and possibly describing solutions to common problems. The ecFlow pre-processor can be used to extract the manual page from the script file to be viewed by the GUI. The manual page is the text contained within the %manual and %end tags. They can be seen using the manual tab in the info panel in ecflow_ui.


Manual pages are a vital source of information for users. The text on manual pages is not copied into the job-file when ecFlow sends a task into execution. Suites, families, and tasks can have manual pages. Manual pages for tasks are placed in the ecFlow script inside a pair of pre-processor lines as in the following example:

%manual
 OPERATORS: If this task fails, set it complete and report
 next working day
 ANALYST: Check something or do something clever! %end
 ls -l pwd hostname %manual Rest of the manual page is placed here, closer to the code
%end


There can be multiple manual sections in the same file. When viewed they are simply concatenated. This helps in maintaining the manual pages. It is good practice to modify the manual pages when the script is changed.
Viewing manual page from the above ecFlow script would look something like
OPERATORS: If this task fails, set it complete and report the next working day
ANALYST: Check something or do something clever!
Rest of the manual page is placed here, closer to the code
After %manual all pre-processor symbols are ignored until %end is found. Thus you cannot use %comment - %end to un-comment manual pages. Manual pages may have include statements like in the following extract:

%manual
 OPERATORS: If this task fails, set it complete and report
 and next working day 
 ANALYST: Check something or do something clever! 
%include <manual/foo.bar>
%end 
 ls -l
 pwd
 hostname 
%manual
 Rest of the manual page is placed here
%end


For example, standard instructions for operators could be placed in a single file and then included in every task (like contact phone numbers, etc.) How the include file is found is explained in the next section.
Suites and families can also have manual pages. However, these are separate files placed in the suite/family directories e.g. the manual page for a family family1 is a file family1.man in the relevant directory.