5－customizing source-navigator.mht

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

  <KBD class=3DCode>FOO</KBD> might expand to <KBD class=3DCode>BAR =
(5)</KBD> which=20
  might then expand to <KBD class=3DCode>mumble (5, 5, 0)</KBD>; in this =
case=20
  Source-Navigator would only see <KBD class=3DCode>mumble (5, 5, =
0)</KBD>. </P>
  <LI class=3DBullet>
  <P class=3DBody><A name=3DpgfId-998385></A><KBD=20
  class=3DCode>replace<BR>replace</KBD> is just like <KBD =
class=3DCode>define</KBD>,=20
  except that the symbol is not injected into the namespace. Thus, if =
you want=20
  to expand macros, but not have conditional code compiled away, use =
<KBD=20
  class=3DCode>replace</KBD>.
  <P><A name=3DpgfId-998386></A>The macro processor does not support =
<KBD=20
  class=3DCode>include</KBD>, token concatenation, ANSI stringification, =
or other=20
  pre-processor directives. These may be implemented in a future =
release. </P>
  <LI class=3DBullet>
  <P class=3DBody><A name=3DpgfId-998387></A><KBD=20
  class=3DCode>delete<BR></KBD>Source-Navigator lets you use more than =
one macro=20
  file in a project. You can specify a macro in one file and then delete =
it from=20
  the preprocessor namespace using <KBD class=3DCode>delete</KBD> in a =
second=20
  macro file. </P>
  <LI class=3DBullet>
  <P class=3DBody><A name=3DpgfId-998391></A><KBD =
class=3DCode>undef<BR>undef</KBD>=20
  doesn't do any substitution, it just affects the evaluation of <KBD=20
  class=3DCode>#if</KBD>, <KBD class=3DCode>#ifdef</KBD>, and <KBD=20
  class=3DCode>#ifndef</KBD> statements. </P></LI></UL>
<H4 class=3DHeading3><A name=3DpgfId-998393></A>Defining and using <A=20
name=3Dmarker-998392></A>macro files</H4>
<P class=3DBody><A name=3DpgfId-998397></A>As explained above, =
Source-Navigator=20
parses, but does not interpret, macro definitions in your project files. =
It only=20
interprets macro definitions from files you specify explicitly in the =
parser=20
preferences of your project. Because multiple files may be specified, =
you may=20
want to organize your macro files according to global, per-user, and =
per-project=20
divisions. This order is important, because Source-Navigator uses the =
last=20
encountered definition for the macro.</P>
<P class=3DBody><A name=3DpgfId-998401></A>Macro files are ASCII files =
and every=20
non-blank line is a macro directive. Leading blanks and <KBD =
class=3DCode>#</KBD>=20
characters are stripped, and if the first character of a line is an =
apostrophe (=20
<SPAN class=3DBold>'</SPAN> ), the line is treated as a comment. The =
macro file=20
can contain continuation lines, for example:</P><PRE =
class=3DCodeExample><A name=3DpgfId-998402></A>define ABC\
   \
   5</PRE>
<P class=3DBody><A name=3DpgfId-998403></A>Otherwise, the directives are =
interpreted=20
as documented above.</P>
<H4 class=3DHeading3><A name=3DpgfId-998406></A><A =
name=3D25936></A>Others <A=20
name=3Dmarker-998405></A>tab</H4>
<P class=3DFigureTitle><A name=3DpgfId-998411></A><A =
name=3D97692></A>Others Tab of=20
the Preferences Dialog</P>
<DIV><IMG=20
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/customsn-4.=
gif">=20
</DIV>
<P class=3DBody><A name=3DpgfId-998412></A>Build<BR>
<P class=3DBodyHang1>Enter the executable (shell) command used to start =
your <KBD=20
class=3DCode>make</KBD> system.</P>
<P class=3DBody><A name=3DpgfId-998413></A>HTML viewer (UNIX only)<BR>
<P class=3DBodyHang1>Enter the HTML viewer to display online help. From =
<SPAN=20
class=3DBold>Help</SPAN>, select <SPAN class=3DBold>Online =
Manuals</SPAN> to open=20
the viewer, which must be included in your path.</P>
<H5 class=3DHeading4><A name=3DpgfId-998414></A>Bug reports</H5>
<P class=3DBody><A name=3DpgfId-998416></A>Mailhost<BR>
<P class=3DBodyHang1>Source-Navigator supports sending bug report emails =
by SMTP.=20
Enter the name of your SMTP mail server in this field.</P>
<H5 class=3DHeading4><A name=3DpgfId-998420></A>Printer (UNIX only)</H5>
<P class=3DBody><A name=3DpgfId-998422></A>ASCII <A =
name=3Dmarker-998421></A>Print=20
Command<BR>
<P class=3DBodyHang1>Enter the command you use when printing a source =
file from=20
the command line.</P>
<P class=3DBody><A name=3DpgfId-998423></A>Print Command<BR>
<P class=3DBodyHang1>Enter the print command appropriate for your =
system. For=20
example, Linux-based systems use <KBD class=3DCode>lpr</KBD>. </P>
<P class=3DBodyListFollow><A name=3DpgfId-1001748></A>On Windows, =
Source-Navigator=20
uses the Registry to decide how to print.</P>
<H5 class=3DHeading4><A name=3DpgfId-998424></A>Insight Debugger =
command</H5>
<P class=3DBody><A name=3DpgfId-998428></A>Enter the executable (shell) =
command to=20
start Insight.</P>
<H5 class=3DHeading4><A name=3DpgfId-998429></A>Retriever</H5>
<P class=3DBody><A name=3DpgfId-998430></A>Do not display the warning =
dialog for=20
multiple matches<BR>
<P class=3DBodyHang1>Select this if you do not want to be warned when =
the <SPAN=20
class=3DBold>Retriever</SPAN> finds more than one symbol with the name =
you are=20
searching for. See <A class=3DXRef=20
href=3D"http://sourcenav.sourceforge.net/online-docs/userguide/retrvr.htm=
l#40079">Retriever</A>=20
for more information about the <SPAN class=3DBold>Retriever</SPAN>.</P>
<H4 class=3DHeading3><A name=3DpgfId-998435></A><A =
name=3Dmarker-998434></A>Colors=20
&amp; Fonts tab</H4>
<P class=3DBody><A name=3DpgfId-998439></A>Source-Navigator assigns a =
different=20
default color to each component of your source code. To customize these =
colors=20
or choose different fonts, click the <SPAN class=3DBold>Colors &amp; =
Fonts</SPAN>=20
tab of the <SPAN class=3DBold>Preferences</SPAN> dialog.</P>
<P class=3DFigureTitle><A name=3DpgfId-998443></A>Colors &amp; Fonts Tab =
of the=20
Preferences Dialog</P>
<DIV><IMG=20
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/customsn-5.=
gif">=20
</DIV>
<P class=3DBody><A name=3DpgfId-998444></A>From the list of components, =
choose the=20
item you want to change. The current settings appear in the <SPAN=20
class=3DBold>Font</SPAN>, <SPAN class=3DBold>Foreground</SPAN>, and =
<SPAN=20
class=3DBold>Background</SPAN> text boxes, and the word "Sample" =
displays the text=20
with these settings.</P>
<H5 class=3DHeading4><A name=3DpgfId-998446></A><A =
name=3Dmarker-998445></A>Changing=20
Fonts</H5>
<P class=3DBody><A name=3DpgfId-998448></A>Changing the font assigned to =
a component=20
is done differently, depending upon your platform.</P>
<P class=3DBody><A name=3DpgfId-1001758></A>Under UNIX, click the "<SPAN =

class=3DBold>...</SPAN>" button at the end of the <SPAN =
class=3DBold>Font</SPAN>=20
text entry box. The <A name=3Dmarker-998447></A><SPAN =
class=3DBold>Choose=20
Font</SPAN> dialog appears: </P>
<DIV><IMG=20
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/customsn-6.=
gif">=20
</DIV>
<P class=3DBody><A name=3DpgfId-998452></A>Choose the Family, Name, and =
Size of font=20
that you would like, as well as Bold or Italics, if you want to use =
those=20
properties. Click the <SPAN class=3DBold>Apply</SPAN> button to see the =
effect of=20
your changes and, when you are satisfied, click <SPAN =
class=3DBold>OK</SPAN>. Your=20
changes take effect the next time you start Source-Navigator.</P>
<P class=3DBody><A name=3DpgfId-1001770></A>Under Windows, click the =
"<SPAN=20
class=3DBold>...</SPAN>" button at the end of the <SPAN =
class=3DBold>Font</SPAN>=20
text entry box. The <SPAN class=3DBold>Font</SPAN> window appears.</P>
<DIV><IMG=20
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/customsn-7.=
gif">=20
</DIV>
<P class=3DBody><A name=3DpgfId-1001761></A>Choose the Font, Font style, =
and Size of=20
the font to use. Your changes appear in the Sample box. When you are =
satisfied,=20
click <SPAN class=3DBold>OK</SPAN>. Your changes take effect the next =
time you=20
access the item you changed.</P>
<H5 class=3DHeading4><A name=3DpgfId-998457></A><A =
name=3Dmarker-998456></A>Changing=20
Colors</H5>
<P class=3DBody><A name=3DpgfId-998458></A>You may want to change the =
Foreground or=20
Background colors from their default settings if they do not show up =
well on=20
your laptop or CRT display, or if your code colorization conventions do =
not=20
match Source-Navigator's default colors.</P>
<P class=3DBody><A name=3DpgfId-998462></A>To choose a different color =
for any=20
component, you must set new RGB (Red-Green-Blue) values. Click the =
Foreground or=20
Background "<SPAN class=3DBold>...</SPAN>" button. The <A=20
name=3Dmarker-998463></A><SPAN class=3DBold>Choose Color</SPAN> dialog =
appears.</P>
<DIV><IMG=20
src=3D"http://sourcenav.sourceforge.net/online-docs/userguide/customsn-8.=
gif">=20
</DIV>
<P class=3DBody><A name=3DpgfId-998467></A>Move the red, green, and blue =
sliders=20
until the color you want appears in the box at the top of the dialog. =
Click the=20
<SPAN class=3DBold>Apply</SPAN> button to see how your text or =
background looks=20
with the new color. If you are satisfied, click <SPAN =
class=3DBold>OK</SPAN>. Your=20
changes take effect the next time you start Source-Navigator.</P>
<P class=3DBody><A name=3DpgfId-998197></A></P>
<HR align=3Dcenter>

<TABLE class=3DTABLE cellPadding=3D1 width=3D100 align=3Dcenter =
border=3D0>
  <TBODY>
  <TR>
    <TD align=3Dmiddle>
      <P class=3DGotos><A=20
      =
href=3D"http://sourcenav.sourceforge.net/online-docs/userguide/index_ug.h=
tml">Contents</A>=20
      </P></TD>
    <TD align=3Dmiddle>
      <P class=3DGotos><A=20
      =
href=3D"http://sourcenav.sourceforge.net/online-docs/userguide/usingsn.ht=
ml">Previous</A></P></TD>
    <TD align=3Dmiddle>
      <P class=3DGotos><A=20
      =
href=3D"http://sourcenav.sourceforge.net/online-docs/userguide/symbrws.ht=