/usr/share/doc/adabrowse/versions.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<HTML>

<HEAD>
  <TITLE>AdaBrowse Version History</TITLE>
  <META NAME="description" CONTENT="AdaBrowse Version History">
  <LINK REL="stylesheet" HREF="gal.css" TYPE="text/css">
</HEAD>

<BODY BGCOLOR="#FFFFF4">

<TABLE WIDTH="100%" BORDER=0 CELLSPACING=0 CELLPADDING=5 CLASS="title">
<TR>
  <TD>
	<H1 ALIGN="CENTER">AdaBrowse Version History</H1>
  </TD>
</TR>
</TABLE>


<TABLE BORDER=1 WIDTH="100%">
<TR><TH>Version</TH><TH>Date</TH><TH>Description</TH></TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">4.0.3</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">22-Feb-2005</TD>
  <TD>
    Three minor bug fixes:
    <UL>
      <LI><CODE>Description.Library = Inside</CODE> works now correctly.
      <LI>Indices honor <CODE>Index_XRef</CODE> (again).
      <LI>The Makefile should work now even if the current directory is not
          in the <CODE>PATH</CODE>. (Uses <CODE>./get_gcc</CODE> now.)
    </UL>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">4.0.2</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">19-Nov-2003</TD>
  <TD>
    <P>
    New <CODE>-X</CODE> option for definition of "environment" variables. (As
    in GNAT.)
    </P>
    <P>
    Code clean-up: added license pragmas (GNAT specific) to all units; separated
    some purely ASIS stuff into a new Asis2 subsystem, which is GMGPL'ed and
    intended for separate release.
    </P>
    <P>
    Correction in the Makefile to split $PATH correctly on Unix, where the path
    separator is ':', not ';'!
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">4.0.1</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">22-Aug-2003</TD>
  <TD>
    <P>
    Minor improvement in the generated HTML: width specification for indentation
    table cells is now relative ("2%") instead of absolute (10). Solves a minor
    display problem on IE 5.0.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">4.0</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">11-Jul-2003</TD>
  <TD>
    <P>
    New major feature: AdaBrowse supports now the GNAT project manager, including
    naming schemes defined in project files! Requires GNAT 3.15p or later. If built
    from the sources, project file support will only be included if compiled with
    GNAT 3.15p or later and the compiler sources are available.
    </P>
    <P>
    Major overhaul of the index generation part of AdaBrowse. Newly, indices can be
    defined by the user using expressions of boolean predicates to define what goes
    into an index.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">3.4.2</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">26-Jun-2003</TD>
  <TD>
    <P>
    Work-around for yet another bug in ASIS: the transitive closure of "with"es (used
    when the "<CODE>-all</CODE> was given on the command-line) returned by ASIS-for-GNAT
    3.16a doesn't contain implicitly "with"ed parents of explicitly "with"ed child units.
    AdaBrowse now compensates for this bug.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">3.4.1</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">07-Jun-2003</TD>
  <TD>
    <P>
    Work-around for yet another bug in ASIS: the text span returned by ASIS-for-GNAT
    for private type declarations with more than one discriminant ends at the first
    semicolon, i.e. after the first discriminant. AdaBrowse now compensates for this
    bug.
    </P>
    <P>
    Improved handling of casing in unit indices (including the "known children" section
    of parent units). If the source contained inconsistent casing, this could re-appear
    in these indices, although AdaBrowse tries hard to make casing consistent everywhere.
    </P>
    <P>
    By default, AdaBrowse no longer processes the private parts of task and protected
    declarations. Use the "<CODE>-private</CODE>" command-line option to make it process
    them. (AdaBrowse <EM>always</EM> processes private <EM>compilation units</EM>, though.
    This is on purpose: if you ask it to process such a unit, you most probably have a
    good reason to do so, and I don't like tools second-guessing the user's intentions.)
    </P>
    <P>
    General minor code clean-up.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">3.4</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">30-May-2003</TD>
  <TD>
    <P>
    Correction in AdaBrowse and work-around for yet another bug in ASIS-for-GNAT so that
    the "<CODE>private</CODE>" keyword in private compilation unit declarations is no longer
    swallowed. Also added a new <CODE>PRIVATE</CODE> boolean attribute to the <CODE>UNIT</CODE>
    and <CODE>CHILD</CODE> elements in the generated XML; bumped the DTD version to 1.1. Made
    corresponding documentation changes.
    </P>
    <P>
    Version number changed to 3.4 instead of 3.3.1 because of the change in the DTD.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">3.3</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">28-Apr-2003</TD>
  <TD>
    <P>
    Minor changes to work around a bug in GNAT 3.16a and another bug in ASIS-for-GNAT 3.16a.
    </P>
    <P>
    ASIS-for-GNAT 3.16a claims in its version string to be an ASIS for GNAT 5.00 (which is
    the (forthcoming) gcc 3.x-based GNAT). However, the ASIS library only checks the version
    of the tree file, it no longer requires the compiler version to match the ASIS library
    version exactly.
    </P>
    <P>
    The only reason for incrementing the version number to 3.3 instead of 3.2.1 is the fairly
    long time (five months) between these two versions.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">3.2</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">26-Nov-2002</TD>
  <TD>
    <P>
    Change in the global type index; contains now also subtypes.
    </P>
    <P>
    New command line option "<CODE>-private</CODE>" for making AdaBrowse process the private
    parts of packages, too.
    </P>
    <P>
    AdaBrowse 3.2 is the first version for GNAT 3.15p.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">3.1</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">11-Nov-2002</TD>
  <TD>
    <P>
    Minor correction in associating comments with "<CODE>use</CODE>" or "<CODE>use type</CODE>"
    clauses: the key <CODE>Description.Clause</CODE> newly applies only to interior clauses;
    a new key <CODE>Description.Context_Clause</CODE> governs finding descriptions for the
    context clauses as a whole.
    </P>
    <P>
    Also corrected the documentation: it had "<CODE>Description.Clauses</CODE>" instead of
    "<CODE>Description.Clause</CODE>" (singular).
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">3.0</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">30-Aug-2002</TD>
  <TD>
    <P>
    Complete refactoring of the output part of AdaBrowse. Previously, tree traversals and
    output generation were intermingled; now they're cleanly separated, which opens the
    way to the next major improvement:
    </P>
    <P>
    AdaBrowse now not only can generate HTML output, but also XML output! There's a DTD for
    this XML in the distribution. The generated XML can then be further processed by whatever
    tool you like, and it can be parsed by any XML 1.0 compliant off-the-shelf XML parser.
    The XML file contains all the structure and information found in the HTML output, including
    all cross-references. Hence, to generate documentation in e.g. docbook or texinfo format,
    use AdaBrowse to generate XML, and then generate your favorite format from that. Saves you
    the trouble of having to write an Ada 95 parser, and saves me the trouble of having to
    provide a potentially unbounded set of special-purpose formatters for any imaginable
    output format.
    </P>
    <P>
    Minor improvements in cross-reference generation for implicitly inherited subprograms
    and enumeration literals; the cross-reference newly goes to the explicit declaration
    (if there is one) the item is inherited from. Also improved cross-references to items
    in generic instantiations, which now can point to the corresponding item from
    the generic template even in the case of nested generics.
    </P>
    <P>
    Cross-references in HTML now by default use both the line <EM>and</EM> the column number,
    whereas previous versions only used the line number. <STRONG>Warning:</STRONG> this makes
    HTML files generated by AdaBrowse 3.0 incompatible with files generated by earlier versions!
    To get the old, line-number-only behavior, use the new command-line option <CODE>-l</CODE>.
    </P>
    <P>
    Bug correction in the handling of the <CODE>Path</CODE> and the <CODE>[No_]XRef</CODE> and
    <CODE>Include</CODE>/<CODE>Exclude</CODE> keys, which contrary to the documentation just
    ignored later definitions for the same unit prefix. Now they all honor the last definition
    for any particular prefix.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">2.13</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">09-July-2002</TD>
  <TD>
    Minor code clean-up; as well as a minor change to the <CODE>[No_]XRef</CODE> and
    <CODE>Include</CODE>/<CODE>Exclude</CODE> keys, which now do <EM>longest</EM>
    prefix matching on the unit names.
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">2.12</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">04-July-2002</TD>
  <TD>
    <P>
    The generated HTML files now include a default style specification that can be
    overridden by style rules in an external style sheet specified by a "<CODE>-s</CODE>"
    command-line option or the <CODE>Style_Sheet</CODE> key in a configuration file.
    </P>
    <P>
    New configuration file keys <CODE>XRef</CODE> and <CODE>Include</CODE> to specify
    exceptions to the sets of units defined by the <CODE>No_XRef</CODE> and
    <CODE>Exclude</CODE> keys.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">2.11</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">03-July-2002</TD>
  <TD>
    <P>
    Minor correction in the "<CODE>Path</CODE>" keys in configuration files (2.1
    had a bug making this work only if the unit name prefix was all lowercase.)
    </P>
    <P>
    New command line option "<CODE>-g</CODE>" and config file key "<CODE>Refs_To_Standard</CODE>"
    to make AdaBrowse generate cross-refences to items from the standard library.
    </P>
    <P>
    Major speed-up: previous versions opened and closed ASIS contexts each and every
    time. Newly, this is only done if a recompilation was necessary. (ASIS-for-GNAT
    seems to have a huge memory leak when a context is closed.)
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">2.1</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">01-July-2002</TD>
  <TD>
    <P>
    Major re-haul of the formatting of descriptions:
    </P>
    <UL>
      <LI>Introduction of <A HREF="adabrowse_ug.html#userdef_params">parameters</A> for
          user-defined HTML mark-up, i.e. user-defind tags may now have attributes,
          which can be referenced in the replacement.
      <LI>Addition of <A HREF="adabrowse_ug.html#Comment_Format">user-defineable
          formatting rules</A>, which in the extreme make it possible to completely
          replace the default formatting (by running an external command).
    </UL>
    <P>
    Also, generally cleaned up the formatting code and corrected a few problem cases
    in HTML generation (such as superfluous or even plain wrongly placed
    <CODE>&lt;P&gt;</CODE> tags, or character entities given in hexadecimal format,
    or a typo which made AdaBrowse emit a <CODE>MTEA</CODE> tag instead of a
    <CODE>META</CODE> tag, or a new <CODE>&lt;!DOCTYPE</CODE> element, which uses
    "W3C" instead of "IETF" now and specifies "HTML 4.01 Transitional" instead of
    "HTML 4.0").
    </P>
    <P>
    Some re-factoring and speed optimizations (the latter both within AdaBrowse and
    also for typical loading of the generated HTML pages: previous versions enclosed
    descriptions in yet another table, V3.0 now uses a <CODE>DIV</CODE> element for
    the same purpose, which usually renders faster than a table).
    </P>
    <P>
    Restructured a large part of the <A HREF="adabrowse_ug.html">User's Guide</A>.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">2.01</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">03-May-2002</TD>
  <TD>
    Code clean-up and minor improvement of environment variable substitution.
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">2.0</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">02-May-2002</TD>
  <TD>
    <P>
    AdaBrowse now supports <EM>user-defined</EM> HTML mark-up: you can define your own
    tags! See the <A HREF="adabrowse_ug.html#userdef">user's guide</A> for more information.
    </P>
    <P>
    AdaBrowse now does <EM><A HREF="adabrowse_ug.html#subst">environment variable substitution</A></EM>
    on some entries in configuration files, and one configuration file may now
    <EM>include</EM> another one.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.61</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">26-Apr-2002</TD>
  <TD>
    Another work-around for a bug in ASIS-for-GNAT, which sometimes crashes on generic
    parameter associations in an instantiation, if named notation is chosen and the
    formal parameter name is an operator symbol.
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.6</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">24-Apr-2002</TD>
  <TD>
    <P>
    Minor change in the algorithm for finding descriptions such that it properly handles
    trailing comments, too.
    </P>
    <P>
    Also, if AdaBrowse is running in file input mode <EM>and</EM> the <CODE>-all</CODE>
    option was given, previous versions processed units referenced by several
    units multiple times, causing warnings if <CODE>-x</CODE> was given and also causing
    these multiply processed units to appear multiple times in the indices. This has been
    corrected now; any unit in a run of AdaBrowse will be processed at most once.
    </P>
    <P>
    Finally, yet another work-around for yet another bug in ASIS-for-GNAT, which returns
    bogus information of "<CODE>String</CODE>" in "<CODE>Some_Const : <STRONG>constant</STRONG>
    String := ...</CODE>".
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.51</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">08-Apr-2002</TD>
  <TD>
    <P>
    Code clean-up such that gcc -gnatwa -gnaty3abefhiklmprt is silent. (The style
    checks are the same as plain -gnaty, but without -gnatyc and -gnatys because
    I don't like these.)
    </P>
    <P>
    Also, replaced the license on the <CODE>gal*.*</CODE> and <CODE>util*.*</CODE>
    units: these no longer use the Ada Community License (the one the Booch components
    use) but the GNAT modified GPL. See the <A HREF="adabrowse_ug.html#License">user's guide</A>
    for comments.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.5</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">03-Apr-2002</TD>
  <TD>
    <P>
    New options "<CODE>-p</CODE>" and "<CODE>-t</CODE>" to generate subprogram
    and type indices (global, over all units processed).
    </P>
    <P>
    Also, a minor correction in the generation of structured indices to correctly
    handle cases where child units without their parents appear in the index.
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.4</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">26-Mar-2002</TD>
  <TD>
    AdaBrowse can now handle unit specifications given by krunched file names. See the
    <A HREF="adabrowse_ug.html#F_Option">user's guide</A> for more information.
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.36</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">25-Mar-2002</TD>
  <TD>
    <P>
    Another work-around for a bug in ASIS-for-GNAT 3.14p: ASIS goes into an endless
    loop (or blocks otherwise) on the source "<CODE><STRONG>pragma</STRONG> Inline
    (&quot;&amp;&quot;);</CODE>" if the operator references more than one function,
    and some of these functions are predefined operators. The work-around in AdaBrowse
    is never to try to generate a cross-reference for operators in pragmas.
    </P>
    <P>
    Also corrected a layout error in the generated HTML for task types without task
    definition as in "<CODE><STRONG>task type</STRONG> X (A : Integer);</CODE>".
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.35</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">21-Mar-2002</TD>
  <TD>
    Bug-fix in finding the primitive operations: AdaBrowse failed sometimes with an
    exception.
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.34</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">20-Mar-2002</TD>
  <TD>
    Another work-around for a bug in ASIS-for-GNAT 3.14p: ASIS fails on record components
    having a type specified with an attribute, as in "<CODE><STRONG>record</STRONG> X :
    Integer'<STRONG>Base</STRONG>; <STRONG>end record</STRONG>;</CODE>".
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.33</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">19-Mar-2002</TD>
  <TD>
    Bug fix: AdaBrowse crashed on object renaming declarations.
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.32</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">18-Mar-2002</TD>
  <TD>
    <P>
  	AdaBrowse newly replaces <EM>pairs</EM> of "<CODE>@</CODE>" without white-space in between by
  	the HTML tags <CODE>&lt;CODE&gt;</CODE> and <CODE>&lt;/CODE&gt;</CODE>, respectively.
  	Hence one can use "<CODE>@Some_Var@</CODE>" as a shortcut for
  	"<CODE>&lt;CODE&gt;Some_Var&lt;/CODE&gt;</CODE>" in an Ada comment.
  	See the <A HREF="adabrowse_ug.html#Comment_Format">user's guide</A> for more information.
  	</P>
  	<P>
  	AdaBrowse now allows line comments starting with "#" in the input file in
  	<A HREF="adabrowse_ug.html#F_Option">file input mode</A>.
  	</P>
  	<P>
  	Improved the User's Guide, especially section 5.3.
  	</P>
  	<P>
    Bug correction: if a comment contains a "&amp;" that already is the start
    of a named character entity (e.g. "&amp;lt;", or "&amp;#34;"), then do <EM>not</EM>
    replace the "&amp;" by "&amp;amp;".
    </P>
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.31</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">15-Mar-2002</TD>
  <TD>
    <CODE>-i</CODE> and <CODE>-is</CODE> now optionally take a filename argument
    specifying the filename of the index; "<CODE>-</CODE>" makes it write the index
    to <CODE>stdout</CODE>.
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.3</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">14-Mar-2002</TD>
  <TD>
    Uses some packages from my Util subsystem now. As a result, configuration file
    syntax has changed slightly (it allows now trailing comments on a line,
    and also supports line continuations.) Also extended the <CODE>-f</CODE>
    and <CODE>-o</CODE> options for the new "<A HREF="adabrowse_ug.html#F_Option">file input mode</A>".
    Also added <CODE>-i</CODE> and <CODE>-is</CODE> options for index generation.
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.21</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">05-Mar-2002</TD>
  <TD>
    Some improvements in finding primitive operations, as well a work-around for
    yet another bug in ASIS-for-GNAT 3.14p.
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.2</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">26-Feb-2002</TD>
  <TD>
    AdaBrowse now takes apart the source completely.
    First "fully javadoc-like" version.
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.1</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">06-Feb-2002</TD>
  <TD>
    Internal version, never released. Major code clean-up. New options <CODE>-q</CODE> and <CODE>-x</CODE>,
    many new keys in configuration files for customizing cross-reference generation
    and finding descriptions.
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.01</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">04-Feb-2002</TD>
  <TD>
    Improved error message, added <CODE>-a</CODE>/<CODE>-all</CODE>/<CODE>--all</CODE> option,
    tries to create tree files (by calling GNAT) if
    initially opening the library unit failed. I.e. it
    is no longer necessary to create the tree files
    by hand! AdaBrowse can do it for you now.
  </TD>
</TR>
<TR>
  <TD ALIGN="RIGHT" VALIGN="TOP">1.0</TD>
  <TD ALIGN="CENTER" VALIGN="TOP">02-Feb-2002</TD>
  <TD>
    Initial public release
  </TD>
</TR>
</TABLE>

<HR>
<!--================================================================-->
<TABLE BORDER=0 CELLSPACING=0 CELLPADDING=5 WIDTH="100%" CLASS="footer">
<TR>
  <TD WIDTH="100%" ALIGN="left" NOWRAP>
       <FONT SIZE=-1>Copyright &copy; 2002-2005 by Thomas Wolf. All rights
       reserved.
       </FONT>
       <BR>
       <FONT SIZE=-1>TW, Feb 22, 2005</FONT>
  </TD>
</TR>
</TABLE>

</BODY>
</HTML>
adabrowse 4.0.3-8 / usr / share / doc / adabrowse / versions.html
