*!  Robert  A. Yaffee    6 Dec 2012   a program to include a subtitle in a chunk of a computer program
{smcl}

{cmd:help subtitle}

{hline}

{title:subtitle}


{title:Syntax}
{p 8 17 2}
{cmd:subtitle} "  text you wish to use as a subtitle    "



{title:Description}
{pstd}{cmd:subtitle} permits the user to add an elaboration of the primary
objective, secondary objective, prerequisits for this chunk of analysis or
to document the following section in the user's own words.

{pstd}{cmd:subtitle} prefaces the user-defined subtitle with information about
the current date and time, the working directory, the stata data file being used,
the Stata version, the machine operating system and the amount of memory being
used.


{title: Examples}

{phang} subtitle "Primary Objective: this segment prepares the data for mapping " {p_end}

Output:
{hline}
A preamble precedes the subtitle.  It's information includes the Date and time,
the working directory, the Stata data file begin used, by the Stata version
as well as the operating system being used, along with the machine type, the
number of processors.

Primary Objective: this segment prepares the data for mapping
{hline}

{phang} subtitle "Secondary Objective: the Haversine formula is used." {p_end}

Output:
{hline}
                  Preambular information


Secondary Objective: the Haversine formula is used.
{hline}

{title:Author}

{phang}  Robert A. Yaffee,  New York University {break}
bob.yaffee@nyu.edu{p_end}

p_end}