<!doctype html public "-//W30//DTD W3 HTML 2.0//EN">
<HTML>
<!-- This file was generated using SDF 2.001 by
Ian Clatworthy (ianc@mincom.com). SDF is freely
available from http://www.mincom.com/mtr/sdf. -->
<HEAD>
<TITLE>SDF 2.001: SDF Reference: subsections Macro</TITLE>
</HEAD>
<BODY BGCOLOR="ffffff">
<DIV CLASS="header">
<P><IMG SRC="../sdflogo.gif" ALIGN="Right"></P>
<DIV CLASS="navigate">
<P ALIGN="Center"><A HREF="re_sdf.html">Contents</A> | <A HREF="in_mac.html">Parent Topic</A> | <A HREF="mslide_u.html">Previous Topic</A> | <A HREF="mundef.html">Next Topic</A> <BR><A HREF="../index.html">Home</A> | <A HREF="../catalog.html">Catalog</A></P>
</DIV>
<BR CLEAR="Right">
</DIV>
<DIV CLASS="main">
<H1>6.40. subsections Macro</H1>
<HR>
<H2><A NAME="Interface">Interface</A></H2>
<P>The general syntax is:</P>
<PRE>
!<STRONG>subsections</STRONG> labels [; prefix] [; layout]
</PRE>
<P>The arguments are:</P>
<TABLE CLASS="columns" BORDER>
<TR CLASS="heading">
<TD>
<STRONG>Name</STRONG>
</TD>
<TD>
<STRONG>Type</STRONG>
</TD>
<TD>
<STRONG>Default</STRONG>
</TD>
<TD>
<STRONG>Rule</STRONG>
</TD>
</TR>
<TR>
<TD>
labels
</TD>
<TD>
string
</TD>
<TD>
</TD>
<TD>
</TD>
</TR>
<TR>
<TD>
prefix
</TD>
<TD>
string
</TD>
<TD>
Topic
</TD>
<TD>
<Topic|Noprefix|noprefix>
</TD>
</TR>
<TR>
<TD>
layout
</TD>
<TD>
string
</TD>
<TD>
Left
</TD>
<TD>
<Left|Center|Right|None|left|center|right|none>
</TD>
</TR>
</TABLE>
<P>See <A HREF="in_macif.html">Understanding Macro Interfaces</A>, if necessary.</P>
<HR>
<H2><A NAME="Description">Description</A></H2>
<P>The <EM>subsections</EM> macro specifies the subsections in a topic.</P>
<HR>
<H2><A NAME="Examples">Examples</A></H2>
<P>Typical usage is:</P>
<PRE>
H1: MyApp
!subsections "Purpose,Usage,Description,Examples"
</PRE>
<P>In this case, the <A HREF="../ref/msubsect.html">subsections</A> macro changes the <EM>id</EM> generated for the headings listed to:</P>
<PRE>
MyApp - <EM>heading</EM>
</PRE>
<P>For HTML, it will also generate a line of jumps to the headings.</P>
<HR>
<H2><A NAME="Limitations & Future Directions">Limitations & Future Directions</A></H2>
<P><EM>html</EM> is currently the only target for which a jump line is generated.</P>
</DIV>
<DIV CLASS="footer">
<DIV CLASS="navigate">
<P ALIGN="Center"><A HREF="re_sdf.html">Contents</A> | <A HREF="in_mac.html">Parent Topic</A> | <A HREF="mslide_u.html">Previous Topic</A> | <A HREF="mundef.html">Next Topic</A> <BR><A HREF="../index.html">Home</A> | <A HREF="../catalog.html">Catalog</A></P>
</DIV>
</DIV>
</BODY>
</HTML>