How to Create a Package Command Help Page
|
Template Instructions
|
|
|
To create a Package Command help page using the template:
|
2.
|
Save the worksheet with an appropriate name.
|
3.
|
Replace <Package_Name> with the name of the package; <Command_Name> with the name of the package command; and <one line description of the command> with a brief description of the command. Remove the angle brackets (< >) surrounding each field.
|
|
|
Help Page Template Sections
|
|
|
Calling Sequence
|
|
•
|
Use the format specified for the calling sequences. Replace <Command_Name>, <param1>, and <param2> with the appropriate name and parameters for your command.
|
•
|
Use one calling sequence per distinct general calling sequence. Add more calling sequences if required.
|
|
|
Parameters
|
|
•
|
Sort parameters to match order in which they appear as you read calling sequences.
|
•
|
Replace param1, <data type>, and <parameter description> with your information.
|
•
|
If a parameter is optional, use the following format.
|
•
|
If optional equations (opts) can be specified, use the following format.
|
|
|
Description
|
|
•
|
Use one or more of the following structures for the first bullets in the description. This will describe the functionality of the command.
|
•
|
If optional equations (opts) can be specified, use the following format.
|
•
|
Include the following statement as one of the last points in the description section, with the appropriate information filled in.
|
|
This command is part of the <Package_Name> package, so it can be used in the form <Command_Name>(..) only after executing the command with(<Package_Name>). However, it can always be accessed through the long form of the command by using <Package_Name>[<Command_Name>](..).
|
|
|
Examples
|
|
•
|
The first command should be the with(<Package_Name>) command.
|
•
|
Include both simple and complicated examples. Include examples of optional parameters or multiple calling sequences when applicable.
|
•
|
If you will be saving your help page in .mws format, you must use 1-D math to enter your examples. If you will be saving the help page in .mw format, you can choose 1-D math, 2-D math, or a mixture of input forms.
|
•
|
Add comments for each example.
|
|
|
See Also
|
|
•
|
The package name is usually in this list, for ease of navigation.
|
|
|
|
Download Help Document
Was this information helpful?