ANN: AdaBrowse 2.1

ANN: AdaBrowse 2.1

[Thomas Wolf]

I've published version 2.1 of AdaBrowse. It's available at
the URL

  http://home.tiscalinet.ch/t_wolf/tw/ada95/adabrowse/

in source form and as a pre-built executable for Win NT/2k
and GNAT 3.14p.

Changes from the previous version (2.01):

- Start tags of user-defined HTML entities may now have
  attributes, which can be referenced in the replacement.

- AdaBrowse 2.1 supports user-defined formatting rules for
  descriptions, giving lots of flexibility in particular for
  generating HTML from legacy code.

- Some corrections in HTML generation: no more misplaced <P>
  tags, typo correction (2.01 generated a MTEA tag instead of
  META), improved handling of unknown tags, sxtray end tags,
  and of character entities, new "<!DOCTYPE" string.

- The makefile now tries to figure out the name of the compiler
  called by gnatmake, and sets up AdaBrowse to use that as the
  default name. As a result, the default compile command will
  generally be "gcc -c -gnatc -gnatt", but on some Linux
  systems, it should be "gnatgcc -c -gnatc -gnatt".
    (Note: I don't have a Linux system at hand. Could somebody
  who has successfully built AdaBrowse 2.1 on Linux and who
  has a setup where the Ada-enabled gcc is called gnatgcc please
  tell me whether this works? See file ad-setup.ads after
  having run make; it should have "gnatgcc" as the compiler
  name!)
    Also note: in any case, you can still override the default
  by giving an explicit compile command in a configuration file.

AdaBrowse 2.1 has passed all my regression tests; the generated
HTML has been verified to be compliant to the "HTML 4.01
Transient" DTD.

See the included user's guide on how and where to submit bug
reports.

On a side-note: the Util subsystem (a collection of generally
useful Ada 95 packages, published under the GMGPL) used by
AdaBrowse and available at the URL

  http://home.tiscalinet.ch/t_wolf/tw/ada95/util/

also has been updated. It includes now many more useful
utility packages, such a thick (stream-based) binding to
the popen/pclose routines available on Win32 and Linux,
extended calendar support, time formatting operations,
utility string operations, operations on path names,
a configuration file reader, environment variable
substitution, and much, much more...

The full AdaBrowse-generated reference for these packages
also is online

  http://home.tiscalinet.ch/t_wolf/tw/ada95/util/doc/

This documentation is also included in the tarball.

-- 
-----------------------------------------------------------------
Thomas Wolf                          e-mail: t_wolf@angelfire.com

Re: AdaBrowse 2.1

[David Botton]

I've made available the GNAT-3.14p Runtime on AdaPower at
http://www.adapower.com/lang/gnatrun/packages.html using AdaBrowse 2.01 (I
didn't have a chance to update yet to the new version).

Check this out!

I love AdaBrowse... Thanks!

and you will too!!

...end of infomertial....

David Botton



"Thomas Wolf" <t_wolf@angelfire.com> wrote in message
news:MPG.178bb55a24a7f0da989690@news.ip-plus.net...
>
> I've published version 2.1 of AdaBrowse. It's available at
> the URL
>
>   http://home.tiscalinet.ch/t_wolf/tw/ada95/adabrowse/
>
> in source form and as a pre-built executable for Win NT/2k
> and GNAT 3.14p.
>
> Changes from the previous version (2.01):
>
> - Start tags of user-defined HTML entities may now have
>   attributes, which can be referenced in the replacement.
>
> - AdaBrowse 2.1 supports user-defined formatting rules for
>   descriptions, giving lots of flexibility in particular for
>   generating HTML from legacy code.
>
> - Some corrections in HTML generation: no more misplaced <P>
>   tags, typo correction (2.01 generated a MTEA tag instead of
>   META), improved handling of unknown tags, sxtray end tags,
>   and of character entities, new "<!DOCTYPE" string.
>
> - The makefile now tries to figure out the name of the compiler
>   called by gnatmake, and sets up AdaBrowse to use that as the
>   default name. As a result, the default compile command will
>   generally be "gcc -c -gnatc -gnatt", but on some Linux
>   systems, it should be "gnatgcc -c -gnatc -gnatt".
>     (Note: I don't have a Linux system at hand. Could somebody
>   who has successfully built AdaBrowse 2.1 on Linux and who
>   has a setup where the Ada-enabled gcc is called gnatgcc please
>   tell me whether this works? See file ad-setup.ads after
>   having run make; it should have "gnatgcc" as the compiler
>   name!)
>     Also note: in any case, you can still override the default
>   by giving an explicit compile command in a configuration file.
>
> AdaBrowse 2.1 has passed all my regression tests; the generated
> HTML has been verified to be compliant to the "HTML 4.01
> Transient" DTD.
>
> See the included user's guide on how and where to submit bug
> reports.
>
> On a side-note: the Util subsystem (a collection of generally
> useful Ada 95 packages, published under the GMGPL) used by
> AdaBrowse and available at the URL
>
>   http://home.tiscalinet.ch/t_wolf/tw/ada95/util/
>
> also has been updated. It includes now many more useful
> utility packages, such a thick (stream-based) binding to
> the popen/pclose routines available on Win32 and Linux,
> extended calendar support, time formatting operations,
> utility string operations, operations on path names,
> a configuration file reader, environment variable
> substitution, and much, much more...
>
> The full AdaBrowse-generated reference for these packages
> also is online
>
>   http://home.tiscalinet.ch/t_wolf/tw/ada95/util/doc/
>
> This documentation is also included in the tarball.
>
> --
> -----------------------------------------------------------------
> Thomas Wolf                          e-mail: t_wolf@angelfire.com
>

Re: AdaBrowse 2.1

[David C. Hoos, Sr.]

David,

What you've posted is definitely _not_ from GNAT-3.14p, as
the revision numbers and copyright dates are all much later in what you
posted than they are in GNAT-3.14p


----- Original Message ----- 
From: "David Botton" <David@Botton.com>
Newsgroups: comp.lang.ada
To: <comp.lang.ada@ada.eu.org>
Sent: July 02, 2002 9:18 PM
Subject: Re: AdaBrowse 2.1


> I've made available the GNAT-3.14p Runtime on AdaPower at
> http://www.adapower.com/lang/gnatrun/packages.html using AdaBrowse 2.01 (I
<snip>

Re: AdaBrowse 2.1

[Thomas Wolf]

David@Botton.com wrote:
> I've made available the GNAT-3.14p Runtime on AdaPower at
> http://www.adapower.com/lang/gnatrun/packages.html using AdaBrowse 2.01
> (I didn't have a chance to update yet to the new version).

Nice. I also noted that the GWindows reference has been generated
with AdaBrowse.

Hm. I somehow didn't think that anybody would like to process the
standard Ada library with AdaBrowse -- I myself tried once, and
was disappointed because (at least the GNAT) sources do contain
only very few comments. It would have been nice if these sources
included the relevant RM paragraphs as comments. Then one could
get a really useful HTML docu...

After having looked at the generated docu, I decided to add a
-g command-line option to AdaBrowse that makes it generate
cross-references to items from the standard library, too.
(It didn't do that until now, because I had problems dealing
with implicit items from Standard. Also, part of the reason for
this restriction was that early versions of AdaBrowse couldn't
deal with krunched filenames, and GNAT's whole standard library
uses krunched names...)

Hence, the current version of AdaBrowse is 2.11, available now
at the URL

  http://home.tiscalinet.ch/t_wolf/tw/ada95/adabrowse/

AdaBrowse 2.11 has passed all my regression tests (which now
include generating a full docu for the standard lib of GNAT
3.14p).

New features:

1. A -g command-line switch. If set, AdaBrowse generates cross-
   references to items from the standard library (except those
   from package Standard), too.
2. A new configuration file key "Refs_To_Standard"; its value
   must be "True" or "False" (without the quotes). If True,
   same as "-g" on the command line. If False, switches off
   generation of cross-refs to standard items.
3. Bug correction: 2.1 had a bug which made it handle "Path"
   prefixes case-sensitively. Would work only if the unit name
   prefix in the key was given in all lowercase. I.e.
   "Path.Ada = ..." wouldn't work, but "Path.ada = ..." worked.
   This is corrected in 2.11; both work now.
4. Major speed improvement: AdaBrowse tries to minimize the
   number of times ASIS contexts are opened and closed. This
   appears to be a time-consuming operation in ASIS-for-GNAT,
   and also seems to incur memory leaks.

BTW, I tried generating the HTML docu for GNAT's standard lib
using (on Win 2k)

set SRCS=x:\gnat\lib\gcc-lib\pentium-mingw32msv\2.8.1\adainclude

for %%i in (%SRCS%\*.ads) do \
gcc -c -gnatg -gnatc -gnatt -I%SRCS% -I- %%i

ls -1 *.adt | %ADABROWSE_HOME%\adabrowse -g -f- -T. -I%SRCS% \
-o.\AdaBrowse_Output\ -is -t -p

In other words, I first generated all the *.adt files, and then
let adabrowse run on all of them. Before the speed optimization
(#4 above), that took 92 minutes and AdaBrowse used up 180Mb of
virtual memory on my machine. After the optimization, this now
takes about 1 minute and uses some 5Mb of memory.

-- 
-----------------------------------------------------------------
Thomas Wolf                          e-mail: t_wolf@angelfire.com