home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 9 / CDACTUAL9.iso / share / Dos / VARIOS / pascal / DELPHI.SWG / 0034_Delphi Configuration Files.pas < prev    next >
Encoding:
Pascal/Delphi Source File  |  1996-02-21  |  44.2 KB  |  1,210 lines
  1.  
  2. Delphi employs a number of files for its configuration, some
  3. global to the Delphi environment, some project specific.  Chief
  4. among all the configuration files is DELPHI.INI.  DELPHI.INI
  5. resides in the Windows directory and contains most of the
  6. configurable items to be found within Delphi.  Being the largest
  7. Delphi configuration file, DELPHI.INI contains settings to
  8. control the Delphi speed bar, component palette, component
  9. library, gallery, installed experts, editor, printing, tools menu
  10. and all the environment options found on the Environment Options
  11. dialog.  This document will explore DELPHI.INI in depth.
  12.  
  13. DELPHI.CBT is a copy of DELPHI.INI (minus the ReportSmith
  14. section) that is installed along with Delphi and may serve as a
  15. sort of backup for restoring the original Delphi setup.  It
  16. resides in the Windows directory along with DELPHI.INI.  Below is
  17. the ReportSmith section and its one entry that should be placed
  18. in a DELPHI.INI created from DELPHI.CBT.
  19.  
  20. [ReportSmith]
  21. ExePath=C:\RPTSMITH
  22.  
  23.  
  24. Delphi also makes use of Desktop (.DSK) files.  Desktop files,
  25. like most Delphi configuration files, are formatted in the same
  26. manner as .INI files, with section headers and individual
  27. settings in each section.  The purpose of desktop files is to
  28. retain the appearance and content of the Delphi desktop between
  29. sessions or between projects.  Each desktop file contains
  30. information regarding the presence and appearance of the Delphi
  31. main window, the Object Inspector, the Alignment Palette, the
  32. Project Manager, and the Watch, Breakpoint, CallStack, and
  33. component list windows.  Also kept in each desktop file is the
  34. number of editor windows open as well as the names, number and
  35. order of files open in each editor window.
  36.  
  37. If the 'Desktop files' check box (on the Preferences page of the
  38. Environment Options dialog) is checked, Delphi will automatically
  39. create desktop files for each project closed and saved.  Each
  40. desktop file carries the same root name as the saved project
  41. file.  If no project is active when Delphi exits, a default
  42. desktop file, DELPHI.DSK, is created.  The last active project
  43. determines which desktop file Delphi loads at startup.  Again,
  44. if no project was active when Delphi exited last, then DELPHI.DSK
  45. is loaded.  While project specific desktop files reside in the
  46. same directory with the corresponding project, DELPHI.DSK resides
  47. in the \DELPHI\BIN directory.  The PrivateDir setting in the
  48. Globals section of DELPHI.INI may be used to relocate DELPHI.DSK
  49. to a different location.
  50.  
  51.  
  52. Option files (.OPT) are another INI-like file in which Delphi
  53. maintains values directly corresponding to those settings on the
  54. Compiler, Linker, and  Directories/Conditionals pages of the
  55. Project Options dialog.  Each of these pages has a corresponding
  56. section in the option file and each setting has a individual
  57. entry in that section.  Each option file also retains the last
  58. parameter string entered via the Run Parameters dialog.  An
  59. option file is created for each project saved.  Like .DSK files,
  60. the root name of the .OPT file is the same as its corresponding
  61. project and reside in the same directory as that project.
  62.  
  63. A default option file, DEFPROJ.OPT, is created if the Default
  64. check box of the Project Options dialog is checked.  The settings
  65. in DEFPROJ.OPT serve as the default project settings each time a
  66. new project is created.
  67.  
  68.  
  69. Additionally, the Delphi command line compiler, DCC.EXE, supports
  70. the use of the configuration file DCC.CFG.  DCC.CFG is a text
  71. file opened when the command line compiler starts and is used in
  72. addition to options entered on the command line.  Command line
  73. options may be placed in DCC.CFG, each on a separate line.  When
  74. DCC starts, it looks for DCC.CFG in the current directory.  If it
  75. is not found there, the directory in which DCC.EXE resides is
  76. then searched.  A sample DCC.CFG follows:
  77.  
  78. /b
  79. /q
  80. /v
  81. /eC:\DELPHI\WORK
  82.  
  83. The above settings instruct the command line compiler to build
  84. all units (/b), compile without displaying file names and line
  85. numbers (/q), append debug information to the .EXE (/v), and
  86. place the compiled units and exEcutable in the C:\DELPHI\WORK
  87. directory (/eC:\DELPHI\WORK).  The contents of the installed
  88. DCC.CFG are included below to serve in restoring it should it be
  89. deleted or damaged.
  90.  
  91. /m
  92. /cw
  93. /rD:\DELPHI\LIB
  94. /uD:\DELPHI\LIB
  95. /iD:\DELPHI\LIB
  96.  
  97.  
  98. STDVCS.CFG is a file installed with the Client/Server of Delphi,
  99. but is only used in conjunction with the Version Control manager
  100. DLL.  The contents of the installed STDVCS.CFG are included here
  101. to serve in restoring it should it be deleted or damaged.
  102.  
  103. NODELETEWORK WRITEPROTECT
  104. NOCASE VCSID
  105.  
  106. COMMENTPREFIX .PAS = "{ "
  107. COMMENTPREFIX .PRJ = "{ "
  108.  
  109. NOEXPANDKEYWORDS .FRM
  110. NOEXPANDKEYWORDS .EXE
  111. NOEXPANDKEYWORDS .DLL
  112. NOEXPANDKEYWORDS .DOC
  113. NOEXPANDKEYWORDS .ICO
  114. NOEXPANDKEYWORDS .BMP
  115.  
  116. Lastly, MULTIHLP.INI is a file Delphi uses to provide
  117. context-sensitive help across multiple help files.  This file
  118. should not be modified; doing so may cause the Delphi Help system
  119. to behave erratically.  The contents of the installed
  120. MULTIHLP.INI are included here to serve in restoring it should it
  121. be deleted or damaged.
  122.  
  123. [Index Path]
  124. DELPHI.HLP=C:\DELPHI\BIN
  125. WINAPI.HLP=C:\DELPHI\BIN
  126. CWG.HLP=C:\DELPHI\BIN
  127. CWH.HLP=C:\DELPHI\BIN
  128. LOCALSQL.HLP=C:\DELPHI\BIN
  129. VQB.HLP=C:\DELPHI\BIN
  130. SQLREF.HLP=C:\IBLOCAL\BIN
  131. WISQL.HLP=C:\IBLOCAL\BIN
  132. BDECFG.HLP=C:\IDAPI
  133. RPTSMITH.HLP=C:\RPTSMITH
  134. RS_DD.HLP=C:\RPTSMITH
  135. SBL.HLP=C:\RPTSMITH
  136. RS_RUN.HLP=C:\RPTSMITH
  137. DBD.HLP=C:\DBD
  138.  
  139.  
  140. Note:
  141.  
  142. What follows below is a comprehensive dissection of the
  143. DELPHI.INI file.  In order to save space, a few conventions were
  144. observed in the describing possible values for settings.
  145.  
  146. Where only one of a limited set of values is applicable, a pipe
  147. symbol is used to separate each of the possible value, e.g.:
  148.  
  149. MapFile=0|1|2|3
  150.  
  151. allows only the values 0, 1, 2, or 3
  152.  
  153. Where a single value within a range is applicable, the range of
  154. values is presented inside brackets with the minimum and maximum
  155. values separated by two periods, e.g.:
  156.  
  157. GridSizeX=[2..128]
  158.  
  159. permits any value between 2 and 128, inclusively.
  160.  
  161. =================================================================
  162.  
  163. Section: [Globals]  -  The Globals section contains settings not
  164.          included in other sections and that have an effect on
  165.          Delphi as a whole.  Items in the Globals section may be
  166.          changed only by editing DELPHI.INI.
  167. -----------------------------------------------------------------
  168.  
  169. PrivateDir=
  170.  
  171.   This item controls where Delphi both creates and locates
  172.   the files DELPHI.DSK, DELPHI.DMT, DEFPROJ.OPT and STDVCS.CFG.
  173.   The default location is the \DELPHI\BIN directory.  If Delphi
  174.   is run from a read-only directory (or from a CD-ROM) this item
  175.   should be set to a writeable directory, either on a network or
  176.   local drive.  This item should contain a fully qualified path,
  177.   including the drive letter.  Example:
  178.  
  179.     PrivateDir=J:\USERS\JSMITH   ; Private network directory
  180.  
  181.  
  182. HintColor=
  183.  
  184.   This item controls the color of the fly-by hint window for the
  185.   Delphi IDE.  The value may be a decimal or hex constant, or one
  186.   of the symbolic color constants defined in VCL (e.g. clCyan).
  187.   Note that the text in the hint window is always painted using
  188.   clWindowText.  The default value is clYellow.
  189.  
  190. PropValueColor=
  191.  
  192.   This item controls the color of the text in the right-hand
  193.   (value) pane of the Object Inspector. The value may be a
  194.   decimal or hex constant, or one of the symbolic color constants
  195.   defined in VCL (e.g. clBlue).  The default value is
  196.   clWindowText.
  197.  
  198.  
  199.  
  200. Section: [Library]  -  The Library section contains entries for
  201.          those settings found on the Library page of the
  202.          Environment Options dialog (accessed via
  203.          Options|Environment).  The options in this section take
  204.          effect when the Options|Rebuild Library menu option is
  205.          chosen.
  206. -----------------------------------------------------------------
  207.  
  208. SearchPath=
  209.  
  210.   Specifies search paths where the compiler can find the units
  211.   needed to build the component library.  Path names should be
  212.   listed consecutively, separated by a semicolon.  This entry is
  213.   changed via the 'Library Path' combo box.  Example:
  214.  
  215.     SearchPath=D:\DELPHI\LIB;d:\delphi\rcexpert
  216.  
  217.  
  218. ComponentLibrary=
  219.  
  220.   Specifies the name of the active component library.  This item
  221.   is changed via the Options|Open Library menu option.  It may
  222.   also be changed from the 'Library filename' edit of the Install
  223.   Components dialog (accessed via Options|Install Components).
  224.   Example:
  225.  
  226.     ComponentLibrary=D:\DELPHI\BIN\REXPERT.DCL
  227.  
  228. SaveLibrarySource=0|1
  229.  
  230.   Indicates whether Delphi saves the source code for the
  231.   component library when installing new components or rebuilding
  232.   it via Options|Rebuild Library.  A setting of 1 causes the
  233.   project source to be saved using the library file's root name
  234.   with a .DPR extension.  The default value is 0.  This setting
  235.   is changed via the 'Save library source code' check box.
  236.  
  237.  
  238. MapFile=0|1|2|3
  239.  
  240.   Determines the type of map file produced, if any, when the
  241.   component library is rebuilt. The map file is placed in the
  242.   same directory as the library, and it has a .MAP extension.
  243.   The default value is 0.  This setting is changed via the
  244.   'Map file' radio button group.
  245.  
  246.   Option        Effect
  247.   ------------  ------
  248.   0 - Off    Does not produce map file.
  249.   1 - Segments    Linker produces a map file that includes a list
  250.                 of segments, the program start address, and any
  251.                 warning or error messages produced during the
  252.                 link.
  253.   2 - Publics    Linker produces a map file that includes a list
  254.                 of segments, the program start address, any
  255.                 warning or error messages produced during the
  256.                 link, and a list of alphabetically sorted public
  257.                 symbols.
  258.   3 - Detailed    Linker produces a map file that includes a list
  259.                 of segments, the program start address, any
  260.                 warning or error messages produced during the
  261.                 link, a list of alphabetically sorted public
  262.                 symbols, and an additional detailed segment map.
  263.                 The detailed segment map includes the address,
  264.                 length in bytes, segment name, group, and module
  265.  
  266. LinkBuffer=0|1
  267.  
  268.   Specifies the location of the link buffer.  A setting of 1
  269.   causes Delphi to use available disk space for the link buffer;
  270.   0 causes the use of available memory.  The default value is
  271.   0.  This setting is changed via the 'Link Buffer' radio button
  272.   group.
  273.  
  274.  
  275. DebugInfo=0|1
  276.  
  277.   Determines whether the component library file is compiled and
  278.   linked with debug information.  A setting of 1 causes the
  279.   inclusion of debug information.  The default setting is 0.  The
  280.   setting is changed via the 'Compile with debug info' check box.
  281.  
  282.  
  283.  
  284. Section: [Gallery]  -  The Gallery section controls the use and
  285.          base location of the form and project galleries.  It
  286.          contains those settings found in the Gallery: group box
  287.          on the Preferences page of the Environment Options
  288.          dialog.
  289. -----------------------------------------------------------------
  290.  
  291. BaseDir=
  292.  
  293.   Points to the directory where Delphi attempts to find Gallery
  294.   files.  To share a gallery directory with other users, set this
  295.   item to point to a shared network directory.  This item
  296.   should contain a fully qualified path, including the drive
  297.   letter.  This entry may be changed only by editing DELPHI.INI.
  298.   Example:
  299.  
  300.     BaseDir=D:\DELPHI\GALLERY
  301.  
  302. GalleryProjects=0|1
  303.  
  304.   Indicates whether Delphi displays the Browse Gallery dialog box
  305.   when the File|New Project menu option is chosen.  A setting of
  306.   1 causes the Browse Gallery dialog box to display.  The default
  307.   setting is 0.  The setting is changed via the 'Use on New
  308.   Project' check box.
  309.  
  310.  
  311. GalleryForms=0|1
  312.  
  313.   Indicates whether Delphi displays the Browse Gallery dialog box
  314.   when the File|New Form menu option is chosen.  A setting of 0
  315.   prevents the Browse Gallery dialog box from displaying.  The
  316.   default setting is 1.  The setting is changed via the 'Use on
  317.   New Form' check box.
  318.  
  319.  
  320.  
  321. Section: [Experts]  -  The Experts section lists the Experts
  322.          which Delphi will attempt to load and initialize upon
  323.          startup.  Any value may be used on the left of the
  324.          equals sign, as the item name is not interpreted.
  325.          Borland recommends using a combination of the vendor
  326.          name and the product name. Example:
  327.  
  328.   [Experts]
  329.   ComponentWare.CommExpert=c:\delphi\cware\commexpt.dll
  330.   CodeFast.TheExpert=c:\delphi\codefast\codefast.dll
  331.  
  332.  
  333.  
  334. Section: [ReportSmith]  -  The ReportSmith section contains just
  335.          one entry which specifies the directory in which
  336.          ReportSmith is installed.
  337. -----------------------------------------------------------------
  338.  
  339. ExePath=
  340.  
  341.   ExePath indicates the location of RPTSMITH.EXE.  This entry is
  342.   placed in DELPHI.INI at install time and may be changed only by
  343.   editing DELPHI.INI.  Example:
  344.  
  345.     ExePath=D:\RPTSMITH
  346.  
  347.  
  348.  
  349. Section: [Session]  -  The Session section and its one entry
  350.                        identify the active project when Delphi
  351.                        was last closed.
  352. -----------------------------------------------------------------
  353.  
  354. Project=
  355.  
  356.   Identifies the active project when Delphi was last closed.
  357.   This setting is only meaningful if the DesktopFile setting in
  358.   the AutoSave section is set to 1.  This setting also serves to
  359.   identify the project's desktop file (using a .DSK extension).
  360.   This setting is updated automatically when Delphi exits.
  361.   Example:
  362.  
  363.     Project=D:\DELPHI\WORK\MAILAPP.DPR
  364.  
  365.  
  366.  
  367. Section: [MainWindow]  -  The MainWindow section defines
  368.          characteristics of the Delphi main window as they relate
  369.          to the speedbar and component palette.  The SpeedBar
  370.          Layout section details the actual contents of the
  371.          speedbar.  Likewise, the <libraryname>.Palette section
  372.          details the actual contents of the component palette.
  373. -----------------------------------------------------------------
  374.  
  375. Split=[-1..400]
  376.  
  377.   Indicates the horizontal position if the vertical bar
  378.   separating the speedbar and component palette.  The default
  379.   value is 183.  This setting is changed by moving the split bar
  380.   with the mouse.
  381.  
  382.  
  383. SpeedHints=0|1
  384.  
  385.   Determines whether hints are displayed as the mouse passes over
  386.   buttons on the speedbar.  A setting of 0 prevents the display
  387.   of speedbar hints.  The default setting is 1.  This setting is
  388.   changed using the Show Hints menu option of the speedbar
  389.   speedmenu.
  390.  
  391.  
  392. PaletteHints=0|1
  393.  
  394.   Determines whether hints are displayed as the mouse passes over
  395.   buttons on the palette.  A setting of 0 prevents the display
  396.   of palette hinsts.  The default setting is 1.  This setting is
  397.   changed using the Show Hints menu option of the palette
  398.   speedmenu.
  399.  
  400.  
  401. Speedbar=0|1
  402.  
  403.   When set to 0, prevents the display of the speedbar.  The
  404.   default setting is 1.  This setting is changed via the
  405.   View|Speedbar menu option or via the Hide option of the
  406.   speedbar speedmenu.
  407.  
  408.  
  409. Palette=0|1
  410.  
  411.   When set to 0, prevents the display of the component palette.
  412.   The default setting is 1.  This setting is changed via the
  413.   View|Component Palette menu option or via the Hide option of
  414.   the component palette speedmenu.
  415.  
  416.  
  417.  
  418. Section: [Speedbar Layout]  -  The Speedbar Layout details the
  419.          specific contents of the speedbar.  The contents of this
  420.          section are changed via the Configure option of the
  421.          speedbar speedmenu.
  422. -----------------------------------------------------------------
  423.  
  424. Count=[0..52]
  425.  
  426.   Specifies the number of buttons on the speedbar.  The default
  427.   is 14.
  428.  
  429.  
  430. Button[0..51]=n,x,y
  431.  
  432.   This entry appears once for each button on the speedbar.  Each
  433.   button entry is uniquely numbered, the first being Button0.
  434.   The number n identifies a unique pre-defined id code.  The
  435.   x value is a number specifying the horizontal position of the
  436.   button on the speedbar.  The y value is a number specifying the
  437.   vertical position of the button on the speedbar.  Below is a
  438.   listing of the default speedbutton set and their corresponding
  439.   menu options.
  440.  
  441.     Button0=30001,4,2        ; File|Open Project...
  442.     Button1=30002,27,2       ; File|Save Project
  443.     Button2=30007,4,25       ; File|Open File...
  444.     Button3=30008,27,25      ; File|Save File
  445.     Button4=30009,50,2       ; File|Add File...
  446.     Button5=30010,50,25      ; File|Remove File...
  447.     Button6=30069,79,2       ; View|Units...
  448.     Button7=30070,102,2      ; View|Forms...
  449.     Button8=30068,79,25      ; View|Toggle Form/Unit
  450.     Button9=30004,102,25     ; File|New Form
  451.     Button10=30090,131,2     ; Run|Run
  452.     Button11=30093,154,2     ; Run|Program Pause
  453.     Button12=30092,131,25    ; Run|Trace Into
  454.     Button13=30091,154,25    ; Run|Step Over
  455.  
  456. Section: [Desktop]  -  The Desktop section contains a single
  457.          entry that determines which desktop settings are saved
  458.          when Delphi exits.  This section and its one entry is
  459.          only meaningful if the DesktopFile entry in the AutoSave
  460.          section is 1.
  461. -----------------------------------------------------------------
  462.  
  463. SaveSymbols=0|1
  464.  
  465.   Determines if browser symbol information is saved along with
  466.   Desktop information when Delphi exits.  This setting is changed
  467.   via the 'Desktop contents:' radio button group box.  The
  468.   default setting is 1.
  469.  
  470.   Option                   Effect
  471.   ------                   ------
  472.   0 - Desktop only         Saves directory information, open
  473.                            files in the editor, and open windows.
  474.   1 - Desktop and symbols  Saves desktop information and browser
  475.                            symbol information from the last
  476.                            successful compile.
  477.  
  478.  
  479. Section: [AutoSave]  -  The Autosave section determines which
  480.          files and options are saved automatically when the
  481.          current project is run or when Delphi exits.  This
  482.          section corresponds to the 'Autosave options:' group box
  483.          of the Preferences page of the Environment Options
  484.          Dialog.
  485. -----------------------------------------------------------------
  486.  
  487. EditorFiles=0|1
  488.  
  489.   When set to 1, causes Delphi to save all modified files in the
  490.   Code Editor when Run|Run, Run|Trace Into, Run|Step Over, or
  491.   Run|Run To Cursor are chosen, or when Delphi exits.  The
  492.   default setting is 0.  This setting is changed via the 'Editor
  493.   files' check box on the Preferences page of the Environment
  494.   Options Dialog.
  495.  
  496.  
  497. DesktopFile=0|1
  498.  
  499.   When set to 0, prevents Delphi from saving the arrangement of
  500.   the desktop when a project is closed or when Delphi exits.  The
  501.   default setting is 1.  This setting is changed via the
  502.   'Desktop' check box on the Preferences page of the Environment
  503.   Options Dialog.
  504.  
  505.   Note: Further discussion regarding desktop files are discussed
  506.   below under Desktop (.DSK) files.
  507.  
  508. Section: [FormDesign]  -  The FormDesgin section contains those
  509.          settings that control the appearance and behavior of a
  510.          forms grid at design time.  This section corresponds to
  511.          the 'Form designer:' group box of the Preferences page
  512.          of the Environment Options Dialog.
  513. -----------------------------------------------------------------
  514.  
  515. DisplayGrid=0|1
  516.  
  517.   Determines the design time visibility of the dots that comprise
  518.   the form grid.  A setting of 0 avoids grid display.  The
  519.   default setting is 1.  This setting is changed via the 'Display
  520.   grid' check box.
  521.  
  522.  
  523. SnapToGrid=0|1
  524.  
  525.   Indicates whether components are automatically aligned with the
  526.   grid when components are moved with the mouse.  A setting of 0
  527.   avoids grid alignment.  The default setting is 1.  This setting
  528.   is changed via the 'Snap to grid' check box.
  529.  
  530.  
  531. GridSizeX=[2..128]
  532.  
  533.   Sets grid spacing in pixels along the x-axis.  The default
  534.   value is 8.  This setting is changed via the 'Grid Size X'
  535.   edit.
  536.  
  537.  
  538. GridSizeY=[2..128]
  539.  
  540.   Sets grid spacing in pixels along the y-axis.  The default
  541.   value is 8.  This setting is changed via the 'Grid Size Y'
  542.   edit.
  543.  
  544.  
  545. DefaultFont=
  546.  
  547.   This item controls the default font for new forms.  The name
  548.   of the font, the font size, and optionally the style of the
  549.   font may be entered, each separated by commas. (Supported font
  550.   styles are "bold" and "italic.")  This setting may be changed
  551.   only by editing DELPHI.INI.  Example:
  552.  
  553.     DefaultFont=MS Sans Serif, 8, bold, italic
  554.  
  555.  
  556.  
  557. Section: [Debugging]  -  The Debugging section contains those
  558.          settings that control integrated debugging and the
  559.          appearance of Delphi during project execution.  This
  560.          section corresponds to the 'Debugging:' group box of the
  561.          Preferences page of the Environment Options Dialog.
  562.  
  563. -----------------------------------------------------------------
  564.  
  565.  
  566. IntegratedDebugging=0|1
  567.  
  568.   Allows or prevents the uses of the Delphi Integrated Debugger.
  569.   A setting of 0 prevents integrated debugging.  The default
  570.   setting is 1.  This setting is changed via the 'Integrated
  571.   Debugging' check box.
  572.  
  573.  
  574. DebugMainBlock=0|1
  575.  
  576.   When set to 1, causes the debugger to stop at the first unit
  577.   initialization that contains debug information.  The default
  578.   setting is 0.  This setting is changed via the 'Step program
  579.   block' check box.
  580.  
  581.  
  582. BreakOnExceptions=0|1
  583.  
  584.   When set to 1, stops the application when an exception is
  585.   encountered and displays the following the exception class,
  586.   exception message and the location of the exception.  When
  587.   set to 0, exceptions do not stop the running application.
  588.   The default setting is 1.  This setting is changed via the
  589.   'Break on exception' check box.
  590.  
  591.  
  592. MinimizeOnRun=0|1
  593.  
  594.   When set to 1, minimizes Delphi when the current project is
  595.   executed.  The default is 0.  This setting is changed via the
  596.   'Minimize on run' check box.
  597.  
  598.  
  599. HideDesigners=0|1
  600.  
  601.   When set to 1, hides designer windows, such as the Object
  602.   Inspector and Form window, while the application is running.
  603.   The default setting is 1.  This setting is changed via the
  604.   'Hide designers on run' check box.
  605.  
  606.  
  607. NoResetWarning=0|1
  608.  
  609.   When set to 1, prevents Delphi from presenting a warning
  610.   message when Program Reset is selected.  The default setting is
  611.   0.  This setting may be changed only by editing DELPHI.INI.
  612.  
  613.  
  614. Section: [Compiling]  -  The compiling section contains a single
  615.          entry that determines whether the user is presented with
  616.          a dialog that reports compiler progress.  This section
  617.          corresponds to the 'Compiling:' group box of the
  618.          Preferences page of the Environment Options Dialog.
  619. -----------------------------------------------------------------
  620.  
  621. ShowCompilerProgress=0|1
  622.  
  623.   Specifies whether compilation progress is reported.  A setting
  624.   of 1 causes Delphi to display a window detailing compilation
  625.   progress.  The default setting is 0.  This setting is changed
  626.   via the 'Show compiler progress' check box.
  627.  
  628.  
  629.  
  630. Section: [Browser]  -  The Browser section contains settings that
  631.          are found on the Browser page of the Environment Options
  632.          dialog.  These settings specify how ObjectBrowser
  633.          functions and what symbol information is displayed.
  634. -----------------------------------------------------------------
  635.  
  636. Filters=
  637.  
  638.   This setting determines which filters are active in the Object
  639.   Browser.  The value is the sum of the values listed below for
  640.   each filter desired.
  641.  
  642.     Value   Filter
  643.     -----   ------
  644.         2   Constants
  645.         4   Types
  646.         8   Variables
  647.        16   Functions and Procedures
  648.        32   Properties
  649.       128   Inherited
  650.       256   Virtuals only
  651.      1024   Private
  652.      2048   Protected
  653.      4096   Public
  654.      8192   Published
  655.  
  656.   The default setting is 15806, which activates all filters.
  657.   Each filter corresponds to a check box in the 'Symbol filters:'
  658.   group box.  For example, the following setting activates the
  659.   Properties, Public and Published filters:
  660.  
  661.     Filters=12320  ; 8192 + 4096 + 32 = 12320
  662.  
  663.  
  664. InitialView=1|2|3
  665.  
  666.   InitialView determines the type of information the browser
  667.   displays when first opened.  The default setting is 2.  This
  668.   setting is changed via the 'Initial view:' radio button group
  669.   box.
  670.  
  671.     Value  Viewed
  672.     -----  ------
  673.         1  Units
  674.         2  Objects
  675.         3  Globals
  676.  
  677. Sort=0|1
  678.  
  679.   When set to 1, causes Delphi to display symbols in alphabetical
  680.   order by symbol name.  When set to 0, symbols display in order
  681.   of declaration.  The default setting is 0.  This setting is
  682.   changed via the 'Sort always' check box.
  683.  
  684.  
  685. QualifiedSymbols=0|1
  686.  
  687.   When set to 1, causes Delphi to display the qualified
  688.   identifier for a symbol.  When set to 0, only the symbol name
  689.   is displayed.  The default setting is 0.  This setting is
  690.   changed via the 'Qualified symbols' check box.
  691.  
  692.  
  693. CollapsedNodes=
  694.  
  695.   Specifies which branches of the object tree hierarchy are
  696.   collapsed when the ObjectBrowser is started.  This entry is a
  697.   list of class names, separated by separated by semicolons.
  698.   This setting is changed via the 'Collapse Nodes:' combo box.
  699.   Example:
  700.  
  701.     CollapsedNodes=Exception;TComponent
  702.  
  703.  
  704. ShowHints=0|1
  705.  
  706.   Determines whether hints are displayed as the mouse passes over
  707.   filter buttons.  A setting of 0 prevents the display of filter
  708.   hints.  The default setting is 1.  This setting is
  709.   changed using the Show Hints menu option of the ObjectBrowser
  710.   speedmenu.
  711.  
  712. Section: [Custom Colors]  -  The Custom colors section lists up
  713.          to sixteen user defined colors.  Each color is specified
  714.          as a six-digit hexadecimal RGB value.  An unused color
  715.          entry is indicated by the hexadecimal value FFFFFFFF.
  716.          Entries in this section are created and updated via the
  717.          Color dialog of any components Color property (accessed
  718.          by double-clicking the entry area of the Color
  719.          property).
  720. -----------------------------------------------------------------
  721.  
  722. Color[A..P]=
  723.  
  724.   Specifies an individual RGB value for a user defined color.
  725.  
  726. Section: [Print Selection]  -  The Print Selection section
  727.          contains those options that appear when the File|Print
  728.          menu option is chosen.  These settings correspond to the
  729.          options displayed in the 'Options:' group box.
  730. -----------------------------------------------------------------
  731.  
  732. HeaderPage=0|1
  733.  
  734.   When set to 1, Delphi includes the name of the file, current
  735.   date, and page number at the top of each page.  The default
  736.   setting is 0.  This setting is changed via the 'Header/page
  737.   number' check box.
  738.  
  739.  
  740. LineNumbers=0|1
  741.  
  742.   When set to 1, Delphi places line numbers in the left margin of
  743.   the printed output.  The default setting is 0.  This setting is
  744.   changed via the 'Line numbers' check box.
  745.  
  746. SyntaxPrinting=0|1
  747.  
  748.   When set to 1, Delphi uses bold, italic, and underline
  749.   characters to indicate elements with syntax highlighting.  When
  750.   set to 0, Delphi uses no special formatting when printing.  The
  751.   default value is 1.  This setting is changed via the 'Syntax
  752.   print' check box.
  753.  
  754.  
  755. UseColor=0|1
  756.  
  757.   When set to 1, causes Delphi to print colors that match colors
  758.   on screen.  This option requires that the current printer
  759.   support color.  The default value is 0.  This setting is
  760.   changed via the 'Use Color' check box.
  761.  
  762.  
  763. WrapLines=0|1
  764.  
  765.   When set to 1, causes Delphi to use multiple lines to print
  766.   characters beyond the page width.  When set to 0, code lines
  767.   are truncated and characters beyond the page width do not
  768.   print.   The default value is 0.  This setting is changed via
  769.   the 'wrap lines' check box.
  770.  
  771.  
  772. LeftMargin=[0..79]
  773.  
  774.   Specifies the number of character spaces used as a margin
  775.   between the left edge of the page and the beginning of each
  776.   line.  The default value is 0.  This setting is changed via the
  777.   'Left margin' edit.
  778.  
  779.  
  780.  
  781. Section: [Highlight]  -  The Highlight section contain those
  782.          settings that determine the syntax and context specific
  783.          colors used in the Code Editor.  The settings in this
  784.          section are changed via the Editor Colors page of the
  785.          Environment Options dialog.
  786. -----------------------------------------------------------------
  787.  
  788. ColorSpeedSetting=0|1|2|3
  789.  
  790.   Determines which color scheme was last selected.  Changing this
  791.   setting directly does not affect the actual colors used for
  792.   individual elements.  The Color SpeedSetting combo box does not
  793.   save color schemes; it only serves as a quick means of setting
  794.   all color elements at once.  The default setting is 0.  The
  795.   table below shows each value's corresponding speedsetting.
  796.  
  797.   Value  SpeedSetting
  798.   -----  ------------
  799.       0  Defaults
  800.       1  Classic
  801.       2  Twilight
  802.       3  Ocean
  803.  
  804.  
  805. <Element color>=
  806.  
  807.   All the color entries correspond to a single color element.
  808.   Each color element entry uses the following format:
  809.  
  810.     <Element name>=fRGB,bRGB,attr,deffore,defback,fcell,bcell
  811.  
  812.     Value code  Meaning
  813.     ----------  -------
  814.     fRGB        Foreground RGB value
  815.     bRGB        Background RGB value
  816.     attr        Text attribute; zero or more of B, I and U
  817.     deffore     Use default foreground color (1=yes, 0=no)
  818.     defback     Use default background color (1=yes, 0=no)
  819.     fcell       Foreground color grid cell number
  820.     bcell       Background color grid cell number
  821.  
  822. Section: [Editor]  -  This section describes the appearance and
  823.          behavior of the Delphi Code Editor.  Settings from both
  824.          the Editor options and Editor display pages are detailed
  825.          here.
  826. -----------------------------------------------------------------
  827.  
  828. DefaultWidth=
  829. DefaultHeight=
  830.  
  831.   These two items, if present, control the initial width and
  832.   height of the Delphi Code Editor window.  Delphi does not
  833.   update these values, but it does read them each time a Code
  834.   Editor is created.  The default width is 406; the default
  835.   height is 234.  These settings may be changed only by editing
  836.   DELPHI.INI.
  837.  
  838.  
  839. FontName=
  840. FontSize=
  841.  
  842.   These settings specify the name and size, respectively, of a
  843.   mono-spaced font that the Code Editor uses to display text.
  844.   Courier New is the default font, 10 the default size.  These
  845.   entries may be changed via the 'Editor font:' and 'Size:' combo
  846.   boxes on the Editor display page.
  847.  
  848.  
  849. BlockIndent=[1..16]
  850.  
  851.   Specifies the number of spaces to indent a marked block.  The
  852.   default value is 1.  This setting may be changed via the 'Block
  853.   indent' combo box on the Editor display page.
  854.  
  855.  
  856. UndoLimit=[0..]
  857.  
  858.   Specifies the number of keystrokes that can be undone, which is
  859.   limited by available memory.  The default value is 32,767.
  860.   This setting may be changed via the 'Undo limit:' combo box on
  861.   the Editor Options page.
  862.  
  863.  
  864. TabRack=
  865.  
  866.   Determines the columns at which the cursor will move to each
  867.   time the Tab key is pressed.  Each successive tab stop must be
  868.   separated by a space and must be larger than its predecessor.
  869.   If only one number is specified, tab stops are spaced apart
  870.   evenly, using that number.  If two numbers are specified then
  871.   tab stops occur at the specified positions and at positions
  872.   that mark the difference between the two values.  The default
  873.   tab stops are 9 and 17.  This setting may be changed via the
  874.   'Tab stops:' combo box on the Editor Options page.  Note:
  875.   this option has no effect if the smart tabs setting is enabled.
  876.  
  877.  
  878. RightMargin=[0..1024]
  879.  
  880.   Specifies the right margin of the Code Editor.  The default
  881.   value is 80.  The valid range is 0 to 1024.  This setting may
  882.   be changed via the 'Right margin:' combo box on the Editor
  883.   display page.
  884.  
  885.  
  886. Extensions=
  887.  
  888.  Combo Box
  889.   Specifies file masks of those files that will display with
  890.   syntax highlighting.  Typically, only specific extensions are
  891.   included.  The default setting is
  892.   '*.PAS;*.DPR;*.DFM;*.INC;*.INT'.  This setting may be changed
  893.   via the 'Syntax extensions:' combo box on the Editor Options
  894.   page.  Example:
  895.  
  896.     Extensions=*.PAS;*.DPR;*.SRC
  897.  
  898.  
  899. FindTextAtCursor=0|1
  900.  
  901.   When set to 1, causes Delphi to Place the text at the cursor
  902.   into the 'Text To Find' combo box in the Find Text dialog box
  903.   when the Search|Find menu option is chosen.   When set to 0,
  904.   the default setting, the search text must be typed in.  This
  905.   entry may be changed via the 'Find text at cursor' check box
  906.   on the Editor Options page.
  907.  
  908.  
  909. BRIEFRegularExpressions=0|1
  910.  
  911.   When set to 1, permits the use of Brief-style regular
  912.   expressions when searching for text.  The default setting is 0.
  913.   This entry may be changed via the 'BRIEF regular expressions'
  914.   check box on the Editor Options page.
  915.  
  916.  
  917. PreserveLineEnds=0|1
  918.  
  919.   Determines whether end-of-line characters are changed to
  920.   carriage return/line feed pairs or are preserved.  When
  921.   set to 0, Delphi converts end-of-line characters to carriage
  922.   return/line feed pairs.  The default value is 1.  This
  923.   entry may be changed via the 'Preserve Line Ends' check box
  924.   on the Editor display page.
  925.  
  926.  
  927. FullZoom=0|1
  928.  
  929.   Determines whether the Code Editor fills the entire screen when
  930.   maximized.  When set to 0 (the default), the Code Editor does
  931.   not cover the Delphi main window when maximized.  A setting of
  932.   1 allows the Code Editor window to encompass the entire screen.
  933.   This setting may be changed via the 'Zoom to full screen' check
  934.   box on the Editor Display page.
  935.  
  936.  
  937. DoubleClickLine=0|1
  938.  
  939.   When set to 1, causes Delphi to highlight the whole line when
  940.   the user double-clicks any character in the line.  When set to
  941.   0 (the default), only the selected word is highlighted.  This
  942.   entry may be changed via the 'Double click line' check box on
  943.   the Editor Options page.
  944.  
  945.  
  946. BRIEFCursors=0|1
  947.  
  948.   Determines whether Delphi uses BRIEF-style cursor shapes in the
  949.   Code Editor.  A setting of 1 causes Delphi to use Brief-style
  950.   cursors.  The default setting is 0.  This setting may be
  951.   changed via the 'BRIEF cursor shapes' check box on the Editor
  952.   Display page.
  953.  
  954.  
  955. ForceCutCopyEnabled=0|1
  956.  
  957.   When set to 1, enables the Edit|Cut and Edit|Copy menu options,
  958.   even when no text is selected.  The default setting is 0.  This
  959.   entry may be changed via the 'Force cut and copy enabled' check
  960.   box on the Editor Options page.
  961.  
  962.  
  963. KeyBindingSet=0|1|2|3
  964.  
  965.   Determines which pre-defined key mapping set Delphi recognizes.
  966.   The default setting is 0.  This setting may be changed via the
  967.   'Keystroke mapping:' list box on the Editor Display page.  The
  968.   table below identifies the appropriate mapping for the desired
  969.   value.
  970.  
  971.     Value  Mapping
  972.     -----  -------
  973.         0  Default
  974.         1  Classic
  975.         2  Brief
  976.         3  Epsilon
  977.  
  978.  
  979. Mode=
  980.  
  981.   This setting determines the state of sixteen of the options
  982.   available on the Editor Options page and two of the options on
  983.   the Editor Display page.  The value is the sum of the values
  984.   listed below for each check box checked.  Unless noted, all
  985.   the options below correspond to a similarly named check box on
  986.   the Editor Options page.
  987.  
  988.          1  Insert mode - Inserts text at the cursor without
  989.             overwriting existing text.
  990.          2  Auto indent mode - Positions the cursor under the
  991.             first nonblank character of the preceding nonblank
  992.             line when Enter is pressed.
  993.          4  Use tab character - Inserts tab character.  If
  994.             disabled, inserts space characters.  This option and
  995.             the Smart Tabs option are mutually exclusive.
  996.             enabled, this option is off.
  997.         16  Backspace un-indents - Aligns the insertion point to
  998.             the previous indentation level (out-dents it) when
  999.             Backspace is pressed, if the cursor is on the first
  1000.             nonblank character of a line.
  1001.         32  Keep trailing blanks - Saves trailing spaces and tabs
  1002.             present at the end of a line.
  1003.         64  Optimal fill - Begins every auto-indented line with
  1004.             the minimum number of characters possible, using tabs
  1005.             and spaces as necessary.
  1006.        128  Cursor through tabs - Enables the arrow keys to move
  1007.             the cursor to the beginning of each tab.
  1008.        256  Group undo - Undoes the last editing command as well
  1009.             as any subsequent editing commands of the same type
  1010.             when Alt+Backspace, Ctrl+Z is pressed or the
  1011.             Edit|Undo menu option is chosen.
  1012.        512  Persistent blocks - Keeps marked blocks selected even
  1013.             when the cursor is moved, until a new block is
  1014.             selected.
  1015.       1024  Overwrite blocks - Replaces a marked block of text
  1016.             with whatever is typed next.  If Persistent Blocks is
  1017.             also selected, text entered is added to the currently
  1018.             selected block.
  1019.       4096  Create backup file - Creates a backup file when
  1020.             source files are saved.  This item is set via the
  1021.             'Create backup file' check box on the Editor Display
  1022.             page.
  1023.       8192  Use Syntax highlight - Enables syntax highlighting.
  1024.      16384  Visible right margin - Enables the display of a line
  1025.             at the right margin of the Code Editor.  This item is
  1026.             set via the 'Visible right margin' check box on the
  1027.             Editor Display page.
  1028.      32768  Smart tabs - Tabs to the first non-whitespace
  1029.             character in the preceding line.  This option and
  1030.             the Smart Tabs option are mutually exclusive.
  1031.     131072  Cursor beyond EOF - Allows cursor positioning beyond
  1032.             the end-of-file.
  1033.     262144  Undo after save - Allows retrieval of changes after a
  1034.             save.
  1035.  
  1036.  
  1037. EditorSpeedSetting=0|1|2|3
  1038.  
  1039.   Determines which editor emulation scheme was last selected.
  1040.   Changing this setting directly does not affect the actual
  1041.   keystroke mapping or the editor options used.  The Editor
  1042.   SpeedSetting combo box does not save emulation schemes; it
  1043.   only serves as a quick means of setting many editor options at
  1044.   once.  The default setting is 0.  The table below shows each
  1045.   value's corresponding speedsetting.
  1046.  
  1047.     Value  SpeedSetting
  1048.     -----  ------------
  1049.         0  Default keymapping
  1050.         1  IDE classic
  1051.         2  Brief emulation
  1052.         3  Epsilon emulation
  1053.  
  1054.  
  1055. Section: [<Library name>.Palette]  -  This section describes the
  1056.          content of the Component Palette.  Each entry name in
  1057.          this section matches a single page name on the component
  1058.          palette.  The value for each entry is a list of the
  1059.          component type names that appear on that page, each
  1060.          separated by a semicolon.  This section appears once for
  1061.          each component library configured via the Palette page
  1062.          of the Environment Options dialog.
  1063.  
  1064.  
  1065.  
  1066. Section: [Transfer]  -  The Transfer section defines those items
  1067.          that appear on the Tools menu.  Entries in this section
  1068.          are defined when using the Tool Properties dialog.  The
  1069.          Tool Properties dialog is itself accessed via the
  1070.          Options|Tools menu option.
  1071. -----------------------------------------------------------------
  1072.  
  1073. Count=
  1074.  
  1075.   Specifies the number of items that should appear on the Tools
  1076.   menu.  This item is changed by adding or removing programs from
  1077.   the Tools Options dialog.
  1078.  
  1079. Title#=
  1080. Path#=
  1081. WorkingDir#=
  1082. Params#=
  1083.  
  1084.   These entries appear once each for every item on the Tools
  1085.   menu.  Each item name is immediately followed by a number
  1086.   indicating its position in the Tools menu, zero being the
  1087.   first.
  1088.  
  1089.     Title#       Specifies the text that actually appears on the
  1090.                  Tools menu.
  1091.     Path#=       Specifies the full path to the program that the
  1092.                  menu option will execute.
  1093.     WorkingDir#  Determines the current directory when the
  1094.                  program starts.
  1095.     Params#      Specifies the parameters to pass to the program
  1096.                  at startup.
  1097.  
  1098.  
  1099. Section: [Closed Files]  -  The Closed Files section lists the
  1100.          full path name of the last three closed project files.
  1101.          The files are listed in the order of most recently used
  1102.          first.  Each entry takes the form
  1103.  
  1104.            File_#=<projectname>.DPR,col1,row1,col2,row2
  1105.  
  1106.          where # is either 0, 1 or 2.  Col1 identifies the first
  1107.          visible column in the code editor, row1 the first
  1108.          visible row.  Col2 is the cursor column, row2 the cursor
  1109.          row.
  1110.  
  1111.  
  1112. Section: [VBX]  -  The VBX section contains various settings that
  1113.          are available when installing a VBX into the Delphi
  1114.          Component Library.
  1115. -----------------------------------------------------------------
  1116.  
  1117. VBXDir=
  1118.  
  1119.   Contains the last location from which a VBX was installed.
  1120.   This value is saved automatically by Delphi upon installing a
  1121.   VBX.
  1122.  
  1123. UnitDir=
  1124.  
  1125.   Specifies the last location in which Delphi placed a source
  1126.   unit for use with the previously installed VBX.  This value is
  1127.   saved automatically by Delphi upon installing a VBX.
  1128.  
  1129.  
  1130. PalettePage=BVSP
  1131.  
  1132.   This entry retains the last specified name of the component
  1133.   palette page onto which Delphi placed the most recently
  1134.   installed VBX.  This value is saved automatically by Delphi
  1135.   upon installing a VBX.
  1136.  
  1137.  
  1138.  
  1139. Section: [Version Control]
  1140. -----------------------------------------------------------------
  1141.  
  1142. VCSManager=
  1143.  
  1144.   This item specifies the fully qualified path of a Version
  1145.   Control manager DLL.  Delphi Client/Server, which includes team
  1146.   support, supplies a Version Control manager by the name
  1147.   STDVCS.DLL, located in the \BIN directory.  Example:
  1148.  
  1149.     VCSManager=d:\delphi\bin\stdvcs.dll
  1150.  
  1151.  
  1152.  
  1153. Section: [Resource Expert]  -  The Resource Expert section
  1154.          appears only if the Delphi Resource Expert is installed.
  1155.          This section has but one entry.
  1156. -----------------------------------------------------------------
  1157.  
  1158. RCIncludePath=
  1159.  
  1160.   Specifies the list of directories (separated by semicolons)
  1161.   that the expert should search to find any include files needed
  1162.   for resource file conversion.  Example:
  1163.  
  1164.     RCIncludePath=D:\DELPHI\WORK;D:\RESOURCE\INCLUDE
  1165.  
  1166.  
  1167. Section: [History_##]  -  A number of history sections, each with
  1168.          a unique number following the underscore, reside in
  1169.          DELPHI.INI.  Each history section corresponds directly
  1170.          to a particular combo box in a Delphi dialog.  Each
  1171.          section contains at least one entry; the Count entry,
  1172.          indicating the number of history items in the section.
  1173.          Each actual history item is named by an H, followed by
  1174.          its order in the history list, H0 being first.  The
  1175.          table below indicates to which combo box the particular
  1176.          section belongs.  Only those histories saved by Delphi
  1177.          are listed.
  1178.  
  1179.   Section       Combo box location
  1180.   -----------   -------------------------------------------------
  1181.   [History_0]   'Text to find', Find Text or Replace Text dialog
  1182.   [History_1]   'Replace with', Replace Text dialog
  1183.   [History_2]   'Output directory', Directory/conditionals page
  1184.                 of Project Options dialog
  1185.   [History_3]   'Search path', Directory/conditionals page of
  1186.                 Project Options dialog
  1187.   [History_7]   'Conditionals', Directory/conditionals page of
  1188.                 Project Options dialog
  1189.   [History_8]   'Undo Limit', Editor options page of Environment
  1190.                 Options dialog
  1191.   [History_9]   'Right margin', Editor display page of
  1192.                 Environment Options dialog
  1193.   [History_10]  'Tab stops', Editor options page of Environment
  1194.                 Options dialog
  1195.   [History_11]  'Syntax extensions', Editor options page of
  1196.                 Environment Options dialog
  1197.   [History_12]  'Enter new line number', Go to Line Number dialog
  1198.   [History_18]  'Block indent', Editor options page of
  1199.                 Environment Options dialog
  1200.   [History_20]  'File name', Open Project dialog
  1201.   [History_23]  'File name', Install VBX file dialog
  1202.   [History_25]  'File name', Unit file name dialog (under
  1203.                 Install VBX)
  1204.   [History_33]  'Collapse nodes', Browser page of Environment
  1205.                 Options dialog
  1206.   [History_34]  'Library path', Library page of Environment
  1207.                 Options dialog
  1208.   [History_35]  'File name', Open Library dialog
  1209.   [History_36]  'File name', Save Project1 As  dialog
  1210.