In Mathematica 10.0 user help ref/menuitem/MakeTemplate, it shows the following simple instructions for creating an input template for my user-defined functions:
To define a function template for a user-defined function, make the
template the first statement in the usage message for the function.
For example, to define the template f[a,b] for the function f, you
could use the following command: f::usage="f[a,b] is an example of a
That seems to work if the usage string is very short and simple, like this example from one of my functions:
OrificeDP::usage = "OrificeDP[Q, DesignQ, DesignDP] Returns the differential pressure across an orifice at a flow rate, given a design differential pressure at a design flow rate.";
However, I generally like to provide a lot more info in the usage statements, so that if I type ?OrificeDP, I actually get helpful info. Here's an example of that type of statement. When I try to use Make Template in a notebook with this one, it doesn't work.
OrificeFlow::usage = "OrificeFlow[OrificeBore, PipeID, P1, P2, Density, Viscosity, OrificeDischargeCoefficient_:0.62] calculates the flow rate of an
incompressible fluid through an orifice installed in a pipeline. Uses Eq.6-111 from Perry's Chemical
Engineer's Handbook, 7th ed. The orifice coefficient is entered as an optional argument with a default value of 0.62,
which is normally valid if the Reynolds number is > 20,000. The Reynolds number is calculated in the module and an
error message is displayed if it is < 20000. P2 is the recovered downstream pressure, which is
converted in the module to the vena contracta pressure for use in Eq.6-111.\n
Default units: Flow -> Gallons/Minutes, OrificeBore, PipeID -> Inches; P1, P2 -> PoundsForce/Inches^2; Density -> Pounds/Feet^3,
Viscosity -> Centipoise
Input: Numeric value in default units or Quantity in any consistent units.
Is anyone able to provide help on how to write the usage statements so that they work with Make Template and also provide the detailed information I need when I type ?OrificeFlow?