2-source-navigator tutorial.mht

这是著名的源码浏览工具（不仅仅浏览

<H2 class=3DHeading1><A name=3DpgfId-1003567></A><A =
name=3D17813></A>Using the Symbol=20
Browser</H2>
<P class=3DBody><A name=3DpgfId-1177681></A>After you create the demo =
project, the=20
<SPAN class=3DBold>Symbol Browser</SPAN> window opens. The <SPAN =
class=3DBold>Symbol=20
Browser</SPAN> provides a view of the symbols within the project.</P>
<DIV><IMG=20
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/tutorial-11=
.gif">=20
</DIV>
<OL>
  <LI class=3DNumbered>
  <P class=3DBody><A name=3DpgfId-1222043></A>Click on the icon to the =
left of the=20
  file or symbol name to expand the list view to a tree view of the file =
or=20
  symbol.
  <P>
  <DIV><IMG=20
  =
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/tutorial-12=
.gif">=20
  </DIV>
  <LI class=3DNumberedNext>
  <P class=3DBody><A name=3DpgfId-1222047></A>Double-click on the file =
or symbol=20
  name <KBD class=3DCode>Agent.h</KBD> to open the <SPAN =
class=3DBold>Editor</SPAN>=20
  to the location of the selected file or symbol in the source code.=20
</P></LI></OL>
<P class=3DBody><A name=3DpgfId-1081227></A>For more information on the =
<SPAN=20
class=3DBold>Symbol Browser</SPAN>, see <A class=3DXRef=20
href=3D"http://sourcenav.sourceforge.net/online-docs/userguide/symbrws.ht=
ml#16805">Symbol=20
Browser</A>.</P>
<H2 class=3DHeading1><A name=3DpgfId-1003632></A>Using the Editor</H2>
<P class=3DBody><A name=3DpgfId-1211646></A>Items in the project =
database are=20
hyperlinked to the <SPAN class=3DBold>Editor</SPAN>. When you =
double-click on a=20
symbol anywhere within Source-Navigator, the <SPAN =
class=3DBold>Editor</SPAN>=20
opens to the location of that selected symbol in your source code.</P>
<P class=3DBody><A name=3DpgfId-1211664></A></P>
<P>
<DIV><IMG=20
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/tutorial-13=
.gif">=20
</DIV>
<P class=3DBody><A name=3DpgfId-1222865></A>When you save modified =
source files, the=20
project database is updated and changes are reflected in all of the=20
Source-Navigator tools. </P>
<P class=3DBody><A name=3DpgfId-1223108></A>For more information on the =
<SPAN=20
class=3DBold>Editor</SPAN>, see <A class=3DXRef=20
href=3D"http://sourcenav.sourceforge.net/online-docs/userguide/editor.htm=
l#40005">Editor</A>.</P>
<H3 class=3DHeading2><A name=3DpgfId-1211665></A>Using the Symbol =
Accelerator</H3>
<P class=3DBody><A name=3DpgfId-1222859></A>The <SPAN =
class=3DBold>Symbol=20
Accelerator</SPAN> combo-box in the toolbar allows you to quickly =
navigate=20
through the code. When the <SPAN class=3DBold>Editor</SPAN> is open, the =
Symbol=20
Accelerator lists all of the symbols either within the open file or =
within the=20
entire project. </P>
<DIV><IMG=20
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/tutorial-14=
.gif">=20
</DIV>
<P class=3DBody><A name=3DpgfId-1222856></A>When other browsers are =
open, the Symbol=20
Accelerator lists the components relative to that browser. For instance, =
in the=20
<SPAN class=3DBold>Class Browser</SPAN>, it lists only classes in the =
file or in=20
the project.</P>
<P class=3DBody><A name=3DpgfId-1003693></A>Notice that the Symbol =
Accelerator text=20
field in the toolbar displays the symbol that is referenced as the =
cursor moves=20
through the file.</P>
<H2 class=3DHeading1><A name=3DpgfId-1223096></A>Using the =
Cross-Reference=20
Browser</H2>
<P class=3DBody><A name=3DpgfId-1179097></A>The <SPAN =
class=3DBold>Cross-Reference=20
Browser</SPAN> (also called <SPAN class=3DBold>Xref</SPAN>) helps you to =

understand complex source code by showing the <EM =
class=3DEmphasis>Refers-to</EM>=20
and <EM class=3DEmphasis>Referred-by</EM> relationships between symbols =
in the=20
project. You can traverse the tree, and expand or collapse the elements =
within=20
the tree.</P>
<TABLE border=3D0>
  <CAPTION>
  <P class=3DTableTitle><A name=3DpgfId-1179100></A>Cross-Reference =
Browser=20
  relationships</P></CAPTION>
  <TBODY>
  <TR>
    <TD>
      <P class=3DCellBody><A name=3DpgfId-1179107></A><IMG=20
      =
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/tutorial-15=
.gif"=20
      align=3Dbaseline> &nbsp;</P></TD>
    <TD>
      <P class=3DCellBody><A name=3DpgfId-1179109></A><EM=20
      class=3DEmphasis>Refers-to<BR></EM>shown by blue =
arrows</P></TD></TR>
  <TR>
    <TD>
      <P class=3DCellBody><A name=3DpgfId-1179114></A><IMG=20
      =
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/tutorial-16=
.gif"=20
      align=3Dbaseline> &nbsp;</P></TD>
    <TD>
      <P class=3DCellBody><A name=3DpgfId-1179116></A><EM=20
      class=3DEmphasis>Referred-by<BR></EM>shown by red=20
arrows</P></TD></TR></TBODY></TABLE>
<OL>
  <LI class=3DNumbered>
  <P class=3DBody><A name=3DpgfId-1179118></A>From the <SPAN =
class=3DBold>Symbol=20
  Browser</SPAN>, open the <KBD class=3DCode>Agent.h</KBD> file. </P>
  <LI class=3DNumberedNext>
  <P class=3DBody><A name=3DpgfId-1180018></A>Highlight the class <KBD=20
  class=3DCode>Notifiee</KBD>. </P>
  <LI class=3DNumberedNext>
  <P class=3DBody><A name=3DpgfId-1128639></A>To activate the <SPAN=20
  class=3DBold>Cross-Reference Browser</SPAN>, select the <SPAN=20
  class=3DBold>Xref</SPAN> tab in the <SPAN class=3DBold>Editor</SPAN> =
window. </P>
  <LI class=3DNumberedNext>
  <P class=3DBody><A name=3DpgfId-1223126></A>Add an <SPAN =
class=3DBold>Editor</SPAN>=20
  view to the <SPAN class=3DBold>Cross-Reference Browser</SPAN> window. =
From the=20
  <SPAN class=3DBold>Windows</SPAN> menu, select <SPAN class=3DBold>Add =
View=20
  </SPAN><EM class=3DArrow>-&gt;</EM> <SPAN class=3DBold>Editor</SPAN>. =
</P>
  <LI class=3DNumberedNext>
  <P class=3DBody><A name=3DpgfId-1003800></A>Click on the function<KBD =
class=3DCode>=20
  Notification(mi) Notification</KBD>.
  <P>
  <DIV><IMG=20
  =
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/tutorial-17=
.gif">=20
  </DIV>
  <LI class=3DNumberedNext>
  <P class=3DBody><A name=3DpgfId-1208885></A>Click the <EM=20
  class=3DEmphasis>Refers-to</EM> button. The <SPAN =
class=3DBold>Cross-Reference=20
  Browser</SPAN> view lists the functions that reference <KBD=20
  class=3DCode>Notification(mi) Notification</KBD>. </P>
  <LI class=3DNumberedNext>
  <P class=3DBody><A name=3DpgfId-1003802></A>Click on <KBD =
class=3DCode>Ref(fu)</KBD>=20
  and notice that the <EM class=3DEmphasis>Refers-to</EM> and <EM=20
  class=3DEmphasis>Referred-by</EM> buttons in the toolbar become =
active. Click=20
  the <EM class=3DEmphasis>Referred-by</EM> button.
  <P>
  <DIV><IMG=20
  =
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/tutorial-18=
.gif">=20
  </DIV><A name=3DpgfId-1222208></A>Source-Navigator shows the source =
syntax of=20
  <KBD class=3DCode>Ref(fu)</KBD> in the <SPAN =
class=3DBold>Editor</SPAN> pane, and=20
  shows the functions that reference <KBD =
class=3DCode>Ref(fu)</KBD>.</LI></OL>
<P class=3DBody><A name=3DpgfId-1081213></A>For more information on the =
<SPAN=20
class=3DBold>Cross-Reference Browser</SPAN>, see <A class=3DXRef=20
href=3D"http://sourcenav.sourceforge.net/online-docs/userguide/crossref.h=
tml#35957">Cross-Reference=20
Browser</A>.</P>
<H2 class=3DHeading1><A name=3DpgfId-1003809></A>Using the Class =
Browser</H2>
<P class=3DBody><A name=3DpgfId-1003810></A>The Source-Navigator <SPAN=20
class=3DBold>Class Browser</SPAN> provides a view of classes and their =
attributes.=20
Using the <SPAN class=3DBold>Class Browser</SPAN>, you can analyze the =
members of=20
a selected class based on inheritance tree, scope, member attribute, =
member=20
type, and more.</P>
<P class=3DBody><A name=3DpgfId-1101143></A>Imagine a situation where =
you are=20
investigating the class structures and attributes of classes within your =

project, but want to simultaneously view the declaration or =
implementation of=20
the classes in the source code.</P>
<OL>
  <LI class=3DNumbered>
  <P class=3DBody><A name=3DpgfId-1101149></A>Ensure that <KBD=20
  class=3DCode>Agent.h</KBD> is open. If it is not, select it from the =
<SPAN=20
  class=3DBold>Symbol Browser</SPAN>. </P>
  <LI class=3DNumberedNext>
  <P class=3DBody><A name=3DpgfId-1128728></A>To activate the <SPAN =
class=3DBold>Class=20
  Browser</SPAN>, select the <SPAN class=3DBold>Class</SPAN> tab in the =
<SPAN=20
  class=3DBold>Editor</SPAN> window. </P>
  <LI class=3DNumberedNext>
  <P class=3DBody><A name=3DpgfId-1101013></A>Add an <SPAN =
class=3DBold>Editor</SPAN>=20
  to the <SPAN class=3DBold>Class Browser</SPAN>. From the <SPAN=20
  class=3DBold>Windows</SPAN> menu, select <SPAN class=3DBold>Add View =
</SPAN><EM=20
  class=3DArrow>-&gt;</EM> <SPAN class=3DBold>Editor</SPAN>. </P>
  <LI class=3DNumberedNext>
  <P class=3DBody><A name=3DpgfId-1205715></A>In the <SPAN =
class=3DBold>Symbol=20
  Accelerator</SPAN>, all class components for the entire project are =
listed.=20
  From this list of components, select <KBD =
class=3DCode>AwaitStmt</KBD>. </P>
  <LI class=3DNumberedNext>
  <P class=3DBody><A name=3DpgfId-1222739></A>In the <SPAN =
class=3DBold>Class=20
  Browser</SPAN>, click <KBD class=3DCode>AwaitStmt(md)</KBD> in the =