NAME

       source-highlight-ide - A Qt4 IDE for GNU Source-Highlight.

SYNOPSIS

       source-highlight-ide

DESCRIPTION

       Sourcehighlightide  is an IDE for GNU Source-highlight.  It can be useful when you have to
       develop a new language definition file, modify an  existing  one,  or,  most  importantly,
       debug a language definition file.

       Basic Usage

       Source-Highlight-Ide  can be used as an editor for Source-Highlight .lang definition files
       (left text edit); moreover, an example input file can be opened  (right  text  edit,  top)
       that  will  be  used  to  produce  html  highlighted output (right text edit, bottom); the
       highlighted output can be seen both in source format (html) and in a preview format.

       This way, while writing the language definition file, it is also possible to check on-the-
       fly whether the output is the one expected. The highlighting can be performed by using the
       menu or the toolbar button.

       Source-Highlight-Ide is a MDI application, thus, several .lang  definition  files  can  be
       opened.

       Source-Highlight Settings

       Source-highlight  library  uses  a  path  (called  data  dir)  to  search for the language
       definition file, output format definition files, style files, etc. This path must  be  set
       correctly  otherwise  highlighting features will not work. In a standard installation this
       path should already be set appropriately. However, if you use a non standard  installation
       of  source-highlight,  this  path  might  not  be set correctly (a symptom is when you get
       errors when trying to perform highlighting, or a message box shows up when you run Source-
       Highlight-Ide).

       You  can  set  this  path  using the Settings -> Source-highlight Settings menu. This will
       bring a dialog where you can set the path (or choose it with the  browse  button);  notice
       that  the  dialog  also  checks  whether  the  currently selected path is a valid path for
       source-highlight.  Although you  can  use  Source-Highlight-Ide  for  testing  a  language
       definition  file  while  you're  editing  it,  the  feature that can be most useful is the
       debugging mechanism.

       Debug

       You start debugging by using the button "Debug", and  then  press  "Step"  for  formatting
       element  by element the parts of the input file that is to be formatted. You can interrupt
       the debugging by using the button "Stop".

       During debuggin, the debugging frame will appear  under  the  lang  definition  file  text
       editor ("Debugging Info").

       The  debugging  steps  at  each matched regular expression and the one that was matched is
       shown in the debugger frame and the text editor  of  the  language  definition  file  will
       position  in  the  corresponding  line. In the "highlighted output" part you can check the
       pieces of the input file that are being formatted.

       Notice that if the language definition file includes another one, the editor  window  will
       open  the  included  file  containing  the  current  matched  regular expression. When the
       debugging finishes, the original lang file will be shown in the text editor.

SEE ALSO

       http://srchighliteide.sourceforge.net/
       http://www.gnu.org/software/src-highlite

AUTHORS

       Lorenzo Bettini <http://www.lorenzobettini.it>

                                            2010-03-13                    source-highlight-ide(1)