Editing Manual (section)

==Calling existing Madagascar programs==
===Finding out what program you need===
# [http://reproducibility.org/rsflog/index.php?/archives/128-How-do-I-find-programs-in-madagascar.html sfdoc -k]
# [[Task-centric program list]] and all its subordinate nodes
# Collection of 2-3 page reproducible papers -- "How to do raytracing in Madagascar"; "How to do modeling in Madagascar"; etc
# [[SU to m8r dictionary]]
# [[SEPlib to m8r dictionary]]
# Other such dictionaries, for free or proprietary seismic processing packages. Such dictionaries are also useful because they will highlight algorithms/utilities present in such packages but missing from m8r.

This chapter is now just a sketch, should get quite big. Users approach tools in a task-centric fashion, i.e. Q1:"how do I do X with Madagascar?", A1:"With feature Y"; Q2: "How do I use feature Y to this end?" M8r is very good at answering Q2, but people ask Q1 first. Many of the reproducible papers included so far contain cutting-edge research. Users learning how to use Madagascar need to start with something much more simple, where they do not have to focus on understanding research on top of understanding software.

===Learning how to use a given program===
# Command-line self-doc
# Local html self-doc (<tt>$RSFROOT/doc/index.html</tt>). Contains all programs installed on the user's machine and only those programs.
# [http://reproducibility.org/RSF/ Online self-doc]
# The wiki [[Guide_to_madagascar_programs|Guide to Programs]].
# Series of dedicated reproducible papers that present the theory behind specific geophysical programs and demonstrate it with various types of inputs and combination of parameters, like [http://www.reproducibility.org/RSF/book/sep/fkamo/paper_html/paper.html this paper] does for SEPlib's AMO program.
# Combining together multiple programs -- the reproducible papers; pointer to relevant section of the manual ("Exploring reproducible papers")